// $Id$ // ============================================================================ // // = LIBRARY // asnmp // // = FILENAME // walk.cpp // // = DESCRIPTION // Sample application demonstrating synchronous Snmp::get, get_next API // to access an SNMP Version 1 agent. // // = AUTHOR // Peter E. Mellquist original code // Michael R MacFaden mrm@cisco.com rework API/ACE integration // // ============================================================================ /*=================================================================== Copyright (c) 1996 Hewlett-Packard Company ATTENTION: USE OF THIS SOFTWARE IS SUBJECT TO THE FOLLOWING TERMS. Permission to use, copy, modify, distribute and/or sell this software and/or its documentation is hereby granted without fee. User agrees to display the above copyright notice and this license notice in all copies of the software and any documentation of the software. User agrees to assume all liability for the use of the software; Hewlett-Packard makes no representations about the suitability of this software for any purpose. It is provided "AS-IS without warranty of any kind,either express or implied. User hereby grants a royalty-free license to any and all derivatives based upon this software code base. =====================================================================*/ #include "asnmp/snmp.h" #include "ace/Argv_Type_Converter.h" #include "ace/Get_Opt.h" // FUZZ: disable check_for_streams_include #include "ace/streams.h" ACE_RCSID(walk, walk, "$Id$") // // SNMPv1 Walk Mib Application // class walkapp { public: walkapp(int argc, char **argv); // process command line args int valid() const; // verify transaction can proceed int run(); // issue transaction static void usage(); // operator help message private: walkapp(const walkapp&); UdpAddress address_; Pdu pdu_; // construct a request Pdu Oid oid_; OctetStr community_; Snmp snmp_; UdpTarget target_; int valid_; }; // main entry point int ACE_TMAIN( int argc, ACE_TCHAR *argv[]) { walkapp get(argc, argv); if (get.valid()) return get.run(); else walkapp::usage(); return 1; } int walkapp::valid() const { return valid_; } walkapp::walkapp(int argc, char *argv[]): valid_(0) { Oid req, def_oid("1.3.6.1.2.1.1.1.0"); // default begin walk with MIBII if ( argc < 2) return; address_ = argv[argc - 1]; if ( !address_.valid()) { cout << "ERROR: Invalid IPv4 address or DNS hostname: " \ << argv[argc] << "\n"; return; } ACE_Argv_Type_Converter to_tchar (argc, argv); ACE_Get_Arg_Opt get_opt (argc, to_tchar.get_TCHAR_argv (), ACE_TEXT ("o:c:r:t:")); for (int c; (c = get_opt ()) != -1; ) switch (c) { case 'o': req = ACE_TEXT_TO_CHAR_IN (get_opt.opt_arg()); if (req.valid() == 0) cout << "ERROR: oid value: " << ACE_TEXT_TO_CHAR_IN (get_opt.opt_arg()) << "is not valid. using default.\n"; break; case 'c': community_ = ACE_TEXT_TO_CHAR_IN (get_opt.opt_arg()); target_.set_read_community(community_); break; case 'r': target_.set_retry(ACE_OS::atoi (get_opt.opt_arg())); break; case 't': target_.set_timeout(ACE_OS::atoi (get_opt.opt_arg())); break; default: break; } Vb vb; // construct a Vb object if (req.valid()) vb.set_oid( req); // set the Oid portion of the Vb else { vb.set_oid( def_oid); // set the Oid portion of the Vb } pdu_ += vb; vb.get_oid(oid_); // store for later use valid_ = 1; } void walkapp::usage() { cout << "Usage:\n"; cout << "walk [options] dotted-quad | DNSName[:port]\n"; cout << " -o OID starts with oid after 1.3.6.1.2.1.1.1.0 (mibII sysDescr.0) \n"; cout << " -c Community_name, default is 'public' \n"; cout << " -r N retries default is N = 1 retry\n"; cout << " -t N timeout in seconds default is 1 second" << endl; } // // simple mib iterator class // class MibIter { public: // Pdu must contain initial oid to begin with MibIter(Snmp *snmp, Pdu& pdu, UdpTarget* target); int next(Vb& vb, char *&err_reason); // return next oid in mib private: Snmp *snmp_; UdpTarget *target_; Pdu pdu_; Vb vb_; int first_; // flag to obtain first entry int valid_; // flag to obtain first entry }; MibIter::MibIter(Snmp* snmp, Pdu& pdu, UdpTarget *target): snmp_(snmp), target_(target), pdu_(pdu), first_(0), valid_(0) { // verify we have a valid oid to begin iterating with Oid oid; Vb vb; pdu.get_vb(vb, 0); vb.get_oid(oid); if (oid.valid()) valid_ = 1; } // return vb of next oid in agent tree, return 1 else return 0, reason set int MibIter::next(Vb& vb, char *& reason) { int rc; if (valid_ == 0) // not valid object return -1; // 1. poll for value if (first_ == 0) { rc = snmp_->get( pdu_, *target_); first_++; } else { rc = snmp_->get_next( pdu_, *target_); } if (rc != SNMP_CLASS_SUCCESS) { reason = const_cast (snmp_->error_string()); return 0; } // 2. check for problems if (pdu_.get_error_status()) { reason = const_cast (pdu_.agent_error_reason()); return 0; } // 3. return vb to caller pdu_.get_vb(vb, 0); Oid nextoid; vb.get_oid(nextoid); // and setup next oid to get Vb nextvb(nextoid); pdu_.delete_all_vbs(); pdu_ += nextvb; // can't do set_vb as there are no entries to replace return 1; // ok } int walkapp::run() { //----------[ create a ASNMP session ]----------------------------------- if ( snmp_.valid() != SNMP_CLASS_SUCCESS) { cout << "\nASNMP:ERROR:Create session failed: "<< snmp_.error_string()<< "\n"; return 1; } //--------[ build up ASNMP object needed ]------------------------------- if (address_.get_port() == 0) address_.set_port(DEF_AGENT_PORT); target_.set_address( address_); // make a target using the address //-------[ issue the request, blocked mode ]----------------------------- cout << "\nASNMP:INFO:SNMP Version " << (target_.get_version()+ 1) << \ " WALK SAMPLE PROGRAM \nOID: " << oid_.to_string() << "\n"; target_.get_address(address_); // target updates port used int rc; const char *name = address_.resolve_hostname(rc); cout << "Device: " << address_ << " "; cout << (rc ? "<< did not resolve via gethostbyname() >>" : name) << "\n"; cout << "[ Retries=" << target_.get_retry() << " \ Timeout=" << target_.get_timeout() <<" ms " << "Community=" << \ community_.to_string() << " ]"<< endl; MibIter iter(&snmp_, pdu_, &target_); char *err_str = 0; Vb vb; unsigned ctr = 0; while (iter.next(vb, err_str)) { cout << "\tOid = " << vb.to_string_oid() << "\n"; cout << "\tValue = " << vb.to_string_value() << "\n"; ctr++; } if (!err_str) { cout << "ERROR: walk: " << err_str << endl; return 0; } cout << "ASNMP:INFO:command completed normally. ACE Rocks...\n"<< endl; return 0; }