00001 /*_############################################################################ 00002 _## 00003 _## notification_originator.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 #ifndef _notification_originator_h_ 00092 #define _notification_originator_h_ 00093 00094 #include <agent_pp/agent++.h> 00095 #include <agent_pp/mib.h> 00096 00097 #define mpV1 0 00098 #define mpV2c 1 00099 #define mpV3 3 00100 00101 #ifdef AGENTPP_NAMESPACE 00102 namespace Agentpp { 00103 #endif 00104 00105 00106 /*--------------------- class NotificationOriginator ---------------------*/ 00107 00118 class AGENTPP_DECL NotificationOriginator: public NotificationSender { 00119 00120 public: 00124 NotificationOriginator(); 00125 00129 virtual ~NotificationOriginator(); 00130 00146 void generate(Vbx*, int, const Oidx&, const Oidx&, const NS_SNMP OctetStr&); 00147 00162 void generate(Vbx*, int, const Oidx&, 00163 unsigned int, const NS_SNMP OctetStr&); 00164 00185 virtual int notify(const NS_SNMP OctetStr&, const Oidx&, 00186 Vbx*, int, unsigned int=0); 00187 00205 virtual boolean add_v1_trap_destination(const NS_SNMP UdpAddress& addr, 00206 const NS_SNMP OctetStr &name, 00207 const NS_SNMP OctetStr &tag, 00208 const NS_SNMP OctetStr &community); 00209 virtual boolean add_v2_trap_destination(const NS_SNMP UdpAddress& addr, 00210 const NS_SNMP OctetStr &name, 00211 const NS_SNMP OctetStr &tag, 00212 const NS_SNMP OctetStr &community); 00213 virtual boolean add_v3_trap_destination(const NS_SNMP UdpAddress& addr, 00214 const NS_SNMP OctetStr &name, 00215 const NS_SNMP OctetStr &tag, 00216 const NS_SNMP OctetStr &secName); 00219 #ifdef _SNMPv3 00220 00226 void set_local_engine_id(const NS_SNMP OctetStr& id) 00227 { if (localEngineID) { delete localEngineID; } 00228 localEngineID = new NS_SNMP OctetStr(id); } 00229 #endif 00230 00231 protected: 00232 00233 class NotificationOriginatorParams { 00234 public: 00235 NotificationOriginatorParams(Vbx* _vbs, int _size, const Oidx& _id, 00236 unsigned int _timestamp, 00237 const Oidx& _enterprise, 00238 const NS_SNMP OctetStr& _contextName) : 00239 vbs(_vbs), size(_size), id(_id), timestamp(_timestamp), 00240 enterprise(_enterprise), contextName(_contextName) 00241 { target = 0; } 00242 00243 Vbx* vbs; 00244 int size; 00245 Oidx id; 00246 unsigned int timestamp; 00247 Oidx enterprise; 00248 NS_SNMP OctetStr contextName; 00249 NS_SNMP OctetStr securityName; 00250 int securityModel; 00251 int securityLevel; 00252 int mpModel; 00253 #ifdef _SNMPv3 00254 NS_SNMP UTarget* target; 00255 #else 00256 NS_SNMP CTarget* target; 00257 #endif 00258 00259 private: 00260 NotificationOriginatorParams(); 00261 }; 00262 00280 int generate(Vbx*, int, const Oidx&, unsigned int, 00281 const Oidx&, const NS_SNMP OctetStr&); 00282 00300 boolean check_access(ListCursor<MibTableRow>& cur, NotificationOriginatorParams& nop); 00301 00319 int send_notify(ListCursor<MibTableRow>& cur, NotificationOriginatorParams& nop, int notify); 00320 00321 #ifdef _SNMPv3 00322 NS_SNMP OctetStr* localEngineID; 00323 #endif 00324 }; 00325 #ifdef AGENTPP_NAMESPACE 00326 } 00327 #endif 00328 #endif