00001 /*_############################################################################ 00002 _## 00003 _## snmp_request.h 00004 _## 00005 _## 00006 _## AGENT++ API Version 3.5.30 00007 _## ----------------------------------------------- 00008 _## Copyright (C) 2000-2009 Frank Fock, Jochen Katz 00009 _## 00010 _## LICENSE AGREEMENT 00011 _## 00012 _## WHEREAS, Frank Fock and Jochen Katz are the owners of valuable 00013 _## intellectual property rights relating to the AGENT++ API and wish to 00014 _## license AGENT++ subject to the terms and conditions set forth below; 00015 _## and 00016 _## 00017 _## WHEREAS, you ("Licensee") acknowledge that Frank Fock and Jochen Katz 00018 _## have the right to grant licenses to the intellectual property rights 00019 _## relating to AGENT++, and that you desire to obtain a license to use 00020 _## AGENT++ subject to the terms and conditions set forth below; 00021 _## 00022 _## Frank Fock and Jochen Katz grants Licensee a non-exclusive, 00023 _## non-transferable, royalty-free license to use AGENT++ and related 00024 _## materials without charge provided the Licensee adheres to all of the 00025 _## terms and conditions of this Agreement. 00026 _## 00027 _## By downloading, using, or copying AGENT++ or any portion thereof, 00028 _## Licensee agrees to abide by the intellectual property laws and all 00029 _## other applicable laws of Germany, and to all of the terms and 00030 _## conditions of this Agreement, and agrees to take all necessary steps 00031 _## to ensure that the terms and conditions of this Agreement are not 00032 _## violated by any person or entity under the Licensee's control or in 00033 _## the Licensee's service. 00034 _## 00035 _## Licensee shall maintain the copyright and trademark notices on the 00036 _## materials within or otherwise related to AGENT++, and not alter, 00037 _## erase, deface or overprint any such notice. 00038 _## 00039 _## Except as specifically provided in this Agreement, Licensee is 00040 _## expressly prohibited from copying, merging, selling, leasing, 00041 _## assigning, or transferring in any manner, AGENT++ or any portion 00042 _## thereof. 00043 _## 00044 _## Licensee may copy materials within or otherwise related to AGENT++ 00045 _## that bear the author's copyright only as required for backup purposes 00046 _## or for use solely by the Licensee. 00047 _## 00048 _## Licensee may not distribute in any form of electronic or printed 00049 _## communication the materials within or otherwise related to AGENT++ 00050 _## that bear the author's copyright, including but not limited to the 00051 _## source code, documentation, help files, examples, and benchmarks, 00052 _## without prior written consent from the authors. Send any requests for 00053 _## limited distribution rights to fock@agentpp.com. 00054 _## 00055 _## Licensee hereby grants a royalty-free license to any and all 00056 _## derivatives based upon this software code base, that may be used 00057 _## as a SNMP agent development environment or a SNMP agent development 00058 _## tool. 00059 _## 00060 _## Licensee may modify the sources of AGENT++ for the Licensee's own 00061 _## purposes. Thus, Licensee may not distribute modified sources of 00062 _## AGENT++ without prior written consent from the authors. 00063 _## 00064 _## The Licensee may distribute binaries derived from or contained within 00065 _## AGENT++ provided that: 00066 _## 00067 _## 1) The Binaries are not integrated, bundled, combined, or otherwise 00068 _## associated with a SNMP agent development environment or SNMP agent 00069 _## development tool; and 00070 _## 00071 _## 2) The Binaries are not a documented part of any distribution material. 00072 _## 00073 _## 00074 _## THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED 00075 _## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 00076 _## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 00077 _## IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 00078 _## INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 00079 _## (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 00080 _## SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 00081 _## HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 00082 _## STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 00083 _## IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 00084 _## POSSIBILITY OF SUCH DAMAGE. 00085 _## 00086 _## 00087 _## Stuttgart, Germany, Fri May 29 22:36:02 CEST 2009 00088 _## 00089 _##########################################################################*/ 00090 00091 00092 #ifndef snmp_request_h_ 00093 #define snmp_request_h_ 00094 00095 #include <snmp_pp/snmperrs.h> 00096 #include <snmp_pp/address.h> 00097 #include <snmp_pp/target.h> 00098 #include <agent_pp/snmp_pp_ext.h> 00099 #include <snmp_pp/snmp_pp.h> 00100 00101 #define MIN_REQUEST_ID 10000 00102 #define DEFAULT_RETRIES 1 00103 #define DEFAULT_TIMEOUT 900 00104 00105 #ifdef AGENTPP_NAMESPACE 00106 namespace Agentpp { 00107 #endif 00108 00109 00110 class AGENTPP_DECL InformInfo { 00111 00112 public: 00113 InformInfo(NS_SNMP CTarget&, Vbx*, int, const Oidx&); 00114 ~InformInfo(); 00115 00116 NS_SNMP CTarget target; 00117 Vbx* vbs; 00118 int sz; 00119 Oidx oid; 00120 }; 00121 00122 00123 class AGENTPP_DECL SnmpRequest { 00124 friend class SnmpRequestV3; 00125 public: 00126 static int process(int, const NS_SNMP UdpAddress&, Vbx*, int& sz, Vbx*, int&, 00127 const NS_SNMP OctetStr&, const int=0, const int=0); 00128 static int process_trap(NS_SNMP SnmpTarget&, Vbx*, int sz, 00129 const Oidx&, const Oidx&, boolean = FALSE); 00130 00131 static int get (const NS_SNMP UdpAddress&, Vbx*, int sz, int&); 00132 static int next(const NS_SNMP UdpAddress&, Vbx*, int sz, int&); 00133 static int getbulk(const NS_SNMP UdpAddress&, Vbx*, int& sz, Vbx*, int&, 00134 const int, const int); 00135 static int set (const NS_SNMP UdpAddress&, Vbx*, int sz, int&); 00136 00137 static int get (const NS_SNMP UdpAddress&, Vbx*, int sz, int&, const NS_SNMP OctetStr&); 00138 static int next(const NS_SNMP UdpAddress&, Vbx*, int sz, int&, const NS_SNMP OctetStr&); 00139 static int getbulk(const NS_SNMP UdpAddress&, Vbx*, int& sz, Vbx*, int&, 00140 const NS_SNMP OctetStr&, const int, const int); 00141 static int gettable(const NS_SNMP UdpAddress&, Vbx*, int sz, Vbx*, int&, 00142 const NS_SNMP OctetStr&, const int); 00143 static int set (const NS_SNMP UdpAddress&, Vbx*, int sz, int&, const NS_SNMP OctetStr&); 00144 00145 static int trap(NS_SNMP SnmpTarget&, Vbx*, int sz, const Oidx&, const Oidx&); 00146 static void inform(NS_SNMP CTarget&, Vbx*, int sz, const Oidx&); 00147 00148 protected: 00149 static Snmpx *get_new_snmp(int &status); 00150 }; 00151 00152 #ifdef _SNMPv3 00153 00162 class AGENTPP_DECL SnmpRequestV3 { 00163 00164 public: 00172 SnmpRequestV3(); 00176 ~SnmpRequestV3(); 00177 00190 static int send(NS_SNMP UTarget&, Pdux&); 00191 00202 int send_request(NS_SNMP UTarget&, Pdux&); 00203 00204 protected: 00205 00206 Snmpx* snmp; 00207 }; 00208 #endif 00209 #ifdef AGENTPP_NAMESPACE 00210 } 00211 #endif 00212 #endif