00001 /*_############################################################################ 00002 _## 00003 _## mib_complex_entry.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 _mib_complex_entry_h_ 00093 #define _mib_complex_entry_h_ 00094 00095 #include <agent_pp/mib_entry.h> 00096 #include <agent_pp/mib.h> 00097 00098 #ifdef AGENTPP_NAMESPACE 00099 namespace Agentpp { 00100 #endif 00101 00102 /*------------------------ class MibComplexEntry ------------------------*/ 00103 00114 class AGENTPP_DECL MibComplexEntry: public MibEntry { 00115 friend class Mib; 00116 public: 00126 MibComplexEntry(const Oidx&, mib_access); 00127 00134 MibComplexEntry(const MibComplexEntry&); 00135 00139 virtual ~MibComplexEntry(); 00140 00141 00150 virtual mib_type type() const { return AGENTPP_COMPLEX; } 00151 00158 virtual MibEntry* clone() = 0; 00159 00173 virtual Oidx find_succ(const Oidx&, Request* req = 0) = 0; 00174 00175 // interfaces dispatch table <-> management instrumentation 00176 00183 virtual void get_request(Request*, int) = 0; 00184 00191 virtual void get_next_request(Request*, int) = 0; 00192 00201 virtual int commit_set_request(Request*, int) 00202 { return SNMP_ERROR_COMITFAIL; } 00203 00213 virtual int prepare_set_request(Request*, int&) 00214 { return SNMP_ERROR_NOT_WRITEABLE; } 00215 00224 virtual int undo_set_request(Request*, int&) 00225 { return SNMP_ERROR_SUCCESS; } 00226 00233 virtual void cleanup_set_request(Request*, int&) { } 00234 00242 virtual boolean serialize(char*&, int&) { return FALSE; } 00243 00255 virtual boolean deserialize(char*, int&) { return FALSE; } 00256 00263 virtual boolean is_empty() { return FALSE; } 00264 00265 00266 // communication between mib objects 00267 00276 virtual OidxPtr max_key() { return &upperBound; } 00277 00278 protected: 00279 Oidx upperBound; 00280 }; 00281 00282 00283 /*------------------------ class MibStaticEntry ------------------------*/ 00284 00293 class AGENTPP_DECL MibStaticEntry: public Vbx { 00294 public: 00295 MibStaticEntry(const Vbx& v): Vbx(v) { } 00296 MibStaticEntry(const Oidx& o, const NS_SNMP SnmpSyntax& v): Vbx(o) 00297 { set_value(v); } 00298 MibStaticEntry(const MibStaticEntry& other): Vbx(other) { } 00299 00300 OidxPtr key() { return (Oidx*)&iv_vb_oid; } 00301 }; 00302 00303 /*------------------------ class MibStaticTable ------------------------*/ 00304 00330 #if !defined (AGENTPP_DECL_TEMPL_OIDLIST_MIBSTATICENTRY) 00331 #define AGENTPP_DECL_TEMPL_OIDLIST_MIBSTATICENTRY 00332 AGENTPP_DECL_TEMPL template class AGENTPP_DECL OidList<MibStaticEntry>; 00333 #endif 00334 00335 class AGENTPP_DECL MibStaticTable: public MibComplexEntry { 00336 public: 00344 MibStaticTable(const Oidx&); 00345 00352 MibStaticTable(MibStaticTable&); 00353 00357 virtual ~MibStaticTable(); 00358 00365 virtual MibEntry* clone() { return new MibStaticTable(*this); } 00366 00374 virtual void add(const MibStaticEntry&); 00375 00382 virtual void remove(const Oidx&); 00383 00400 virtual MibStaticEntry* get(const Oidx&, boolean suffixOnly=FALSE); 00401 00415 virtual Oidx find_succ(const Oidx&, Request* req = 0); 00416 00423 virtual void get_request(Request*, int); 00424 00431 virtual void get_next_request(Request*, int); 00432 00433 protected: 00434 00435 OidList<MibStaticEntry> contents; 00436 }; 00437 #ifdef AGENTPP_NAMESPACE 00438 } 00439 #endif 00440 00441 #endif