SNMP编程

开发平台：
C/C++

corba.idl：源码内容
							/* $Id: corba.idl,v 1.5 2002/05/01 10:29:21 mahesh Exp $ */
/*
 * @(#) corba.idl 
 * Copyright (c) 1999 Adventnet, Inc. All Rights Reserved.
 * Please read the associated COPYRIGHTS file for more details.
 *
 * ADVENTNET, INC. MAKES NO REPRESENTATIONS OR WARRANTIES  ABOUT THE
 * SUITABILITY OF THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING
 BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS
 * FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.  ADVENTNET, INC. SHALL
 * NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF
 * USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE  OR ITS DERIVATIVES.
 */                                
#pragma javaPackage "com.adventnet.snmp"
module corba
{
	typedef sequence<string> stringSeq;
	typedef sequence<stringSeq> stringMatrix;
	typedef sequence<octet> octetSeq;
	exception SnmpException
	{
		string reason;
	};
	struct RequestEvent
	{
		stringSeq values;
		stringSeq objectNames;
		octet requestType;
		long reqid;
		stringSeq varBinds;
		string error;
	};
	struct ResultEvent
	{
		stringSeq response;
		string error;
	};
	
	struct TableEvent
	{
		long startRow;
		long endRow;
		long Type;
		long column;
		string error;
	};
	struct TrapEvent
	{
		string remoteHost;
		string enterprise;
		long trapType;
		long specificType;
		string error;
		string trapName;
		string trapDescr;
	};
	interface SnmpTableEvent
	{
	};
	interface ResultListener
	{
		void setResult( in ResultEvent e );
		void setNumericResult( in long j );
		void setStringResult( in string s );
	};
	interface SnmpTarget
	{
		boolean getDebug();
		long getErrorCode();
		void setAttemptComplete( in boolean completeState );
		void setVarBindCount(in long count);
		long getVarBindCount();
		boolean getAttemptComplete();
          
		
		// get the name by which this object is identified
		string getName();
		void loadMibs( in string mibs ) raises (SnmpException);
		// SNMP operations
		string snmpGet();
		stringSeq snmpGetList();
		string snmpGetNext();
		stringSeq snmpGetNextList();
		string snmpSet( in string val ) raises ( SnmpException );
		string snmpSetWithType(in string val, in octet type )
					raises (SnmpException);
		stringSeq snmpSetList( in stringSeq val )
					raises (SnmpException);
		void snmpSendTrap( in string enterprise, in string agenthost,
				 in long genericType, in long specificType, in long uptime, in stringSeq values ) raises (SnmpException);
		// operations on the variable list
		long addObjectID( in string oid );
		string getObjectID( in long index );
		void setObjectID( in string oid );
		stringSeq getObjectIDList();
		void setObjectIDAtIndex( in long index, in string oid );
		void setObjectIDList( in stringSeq oidList );
		void setDebug( in boolean debug );
		void setMibModules( in string mibs );
		string getMibModules();
		// operations on the Target object
		string getTargetHost();
		void setTargetHost( in string host );
		long getTargetPort();
		void setTargetPort( in long port );
		string getCommunity();
		void setCommunity( in string community );
		string getWriteCommunity();
		void setWriteCommunity( in string community );
		long getTimeout();
		void setTimeout( in long timeoutval );
		long getRetries();
		void setRetries( in long retryVal );
		long getMaxRepetitions();
		void setMaxRepetitions( in long maxVal );
		long getNonRepeaters( );
		void setNonRepeaters( in long maxVal );
		stringMatrix snmpGetBulkList();
		long getSnmpVersion( );
		void setSnmpVersion( in long version );
		string getErrorString( );
		boolean getAttemptPartial( );
		void setAttemptPartial( in boolean partialState );
		boolean getSendTimeoutEvents();
		void setSendTimeoutEvents( in boolean flag );
		void addResultListener( in ResultListener l );
		void removeResultListener( in ResultListener l );
		stringMatrix snmpGetAllList();
 		long getMaxNumRows();
  	void setMaxNumRows(in long maxRows);
		// Some SNMPv3 related API methods.
		void create_v3_tables();
		string getContextName();
		void setContextName( in string cName);
		string getContextID();
		void setContextID( in string ctxtID);
		string getPrincipal();
		void setPrincipal(in string s);
		long getAuthProtocol();
		void setAuthProtocol(in long protocol);
		string getAuthPassword();
		void setAuthPassword(in string password);
		string getPrivPassword();
		void setPrivPassword(in string password);
	
		void initSecurityProvider () raises (SnmpException);
		long getSecurityModel ();
		void setSecurityModel (in long securityModel);
		boolean isSupportedSecurityModel (in long securityModel);
		
	};
	interface SnmpTarget;
	interface SnmpTableListener;
	interface SnmpTable : corba::SnmpTarget
	{
		long getRowCount();
		long getColumnCount();
		string getColumnName( in long index );
		boolean isCellEditable( in long row, in long col );
		string getValueAt( in long row, in long col );
		void setValueAt( in any obj, in long row, in long col );
		void addSnmpTableListener( in SnmpTableListener l );
		void removeSnmpTableListener( in SnmpTableListener l );
		string getTableOID();
		void setTableOID( in string oid ) raises (SnmpException);
		long getDataType();
		void setDataType( in long type );
		long getPollInterval();
		void setPollInterval( in long i );
		boolean getPerformSets();
		void getPerformSetsActivate( in boolean allowSets );
		const long STRING_DATA = 1;
		const long SNMP_VARIABLE_DATA = 3;
		const long SNMP_VARIABLE_BINDING_DATA = 3;
		stringMatrix getNotAccessibleIndex();
		stringSeq getNotAccessibleIndexColumns();
	};
	interface TrapListener
	{
		void receivedTrap( in TrapEvent e );
	};
	interface SnmpTrapReceiver
	{
		string getName();
		void loadMibs( in string mibs ) raises (SnmpException);
		void addTrapListener( in TrapListener l );
		void removeTrapListener( in TrapListener l );
		void setDebug( in boolean debug );
		string getMibModules();
		void setMibModules( in string mibs );
		stringSeq getLocalAddresses();
		void setLocalAddresses( in stringSeq addresses );
		long getPort( );
		void setPort( in long port );
		string getCommunity();
		void setCommunity( in string community );
		long getSnmpVersion();
		void setSnmpVersion( in long version );
		void setPrincipal(in string principal);
		void setAuthProtocol(in long protocol);
		void setAuthPassword(in string passwd);
		void setPrivPassword(in string passwd);
		void createUserEntry(in octetSeq engineID, in octet secLevel);
		void initSecurityProvider () raises (SnmpException);
		long getSecurityModel ();
		void setSecurityModel (in long securityModel);
		boolean isSupportedSecurityModel (in long securityModel);
		
	};
	interface SnmpTableListener
	{
		void tableChanged( in TableEvent e );
	};
	interface SnmpPoller : corba::SnmpTarget
	{
		//string getName();
		boolean getPollingStatus();
		void stopPolling();
		void restartPolling();
		long getPollInterval();
		void setPollInterval( in long i );
		void setAbsoluteCounters( in boolean absoluteCounters );
	};
	interface ResultListener;
	interface SnmpRequestServer
	{
		string getName();
		void loadMibs( in string mibs ) raises (SnmpException);
		void addResultListener( in ResultListener l );
		void removeResultListener( in ResultListener l );
		long addObjectID( in string s );
		string getObjectIDAtIndex( in long index );
		string getObjectID( );
		void setObjectID( in string s );
		void setObjectIDAtIndex( in long index, in string s );
		stringSeq getObjectIDList();
		void setObjectIDList( in stringSeq OIDlist );
		string getTargetHost( );
		void setTargetHost( in string hostname );
		long getTargetPort();
		void setTargetPort( in long index );
		string getCommunity();
		void setCommunity( in string s );
		string getWriteCommunity();
		void setWriteCommunity( in string s );
		long getTimeout();
		void setTimeout( in long timeoutVal );
		long getRetries();
		void setRetries( in long numRetries );
		long getMaxRepetitions( );
		void setMaxRepetitions( in long numMaxRepetitions );
		long getNonRepeaters( );
		void setNonRepeaters( in long numMaxRepetitions );
		long sendGetBulkRequestList();
		long getSnmpVersion();
		void setSnmpVersion( in long version );
		// Some SNMP V3 methods.
		string getPrincipal();
		void setPrincipal(in string uName);
		long getAuthProtocol();
		void setAuthProtocol(in long protocol);
		string getAuthPassword();  
		void setAuthPassword(in string password);
		string getPrivPassword();
		void setPrivPassword(in string password);
		octetSeq getEngineID();
		void setEngineID(in octetSeq engID);
		string getSecurityLevel();
		void setSecurityLevel(in octet sLevel);
		long create_v3_tables();
		void initSecurityProvider () raises (SnmpException);
		long getSecurityModel ();
		void setSecurityModel (in long securityModel);
		string getErrorString();
		boolean getAttemptPartial();
		void setAttemptPartial( in boolean b );
		boolean getSendTimeoutEvents( );
		void setSendTimeoutEvents( in boolean b );
		void setDebug( in boolean debug );
		string getMibModules();
		void setMibModules( in string mibs );
		// NOTE: RequestEvent is com.adventnet.snmp.beans.RequestEvent
		long addRequest( in RequestEvent e );
		long sendGetRequest();
		long sendGetRequestList();
		long sendGetNextRequest();
		long sendGetNextRequestList();
		long sendSetRequestOfType( in string value, in octet type ) raises (SnmpException);
		long sendSetRequest( in string value ) raises (SnmpException);
		long sendSetRequestList( in stringSeq valueList ) raises (SnmpException);
		void sendTrap( in string enterprise, in string agenthost,
				in long genericType, in long specificType, in long uptime,
				in stringSeq values ) raises (SnmpException);
	
	};
	interface SnmpFactory
	{
		SnmpTarget createTarget();
		void destroyTarget(in string name );
		SnmpRequestServer createRequestServer();
		void destroyRequestServer( in string name );
		SnmpPoller createPoller();
		void destroyPoller( in string name );
		SnmpTrapReceiver createTrapReceiver();
		void destroyTrapReceiver( in string name );
		SnmpTable createTable();
		void destroyTable( in string name );
	};
};

						