org.rhq.plugins.www.snmp

Interface SNMPSession

public interface SNMPSession

Generic interface for any version of the SNMP protocol. Use SNMPClient.getSession(java.lang.String, java.lang.Integer, java.lang.String, org.rhq.plugins.www.snmp.SNMPClient.SNMPVersion, long, int) to get an instance of a class that implements this interface.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes the session and all underlying resources.
List<SNMPValue>	getBulk(String mibName) TODO
List<SNMPValue>	getColumn(String mibName) Retrieves all values from a column of an SNMP table (i.e.
SNMPValue	getNextValue(String mibName) Retrieve the variable that logically next after the specified MIB name or OID.
SNMPValue	getSingleValue(String mibName) Retrieves the variable with the the specified MIB name or OID.
Map<String,SNMPValue>	getTable(String mibName, int index) TODO
boolean	ping() Pings the agent associated with this session to see if it is responsive.

Method Detail

getSingleValue

@NotNull
SNMPValue getSingleValue(String mibName)
                         throws SNMPException

Retrieves the variable with the the specified MIB name or OID.

Parameters:

mibName - the name of the variable to retrieve

Returns:

a SNMPValue object representing the value of the variable.

Throws:

SNMPException - if an error occurs communicating with the SNMP agent.

getNextValue

@NotNull
SNMPValue getNextValue(String mibName)
                       throws SNMPException

Retrieve the variable that logically next after the specified MIB name or OID.

Parameters:

mibName - the name of the MIB variable at which to start looking

Returns:

An SNMPValue object representing the value of the specified MIB name, or if not found, the next logical MIB name.

Throws:

SNMPException - if an error occurs communicating with the SNMP agent.

getColumn

@NotNull
List<SNMPValue> getColumn(String mibName)
                          throws SNMPException

Retrieves all values from a column of an SNMP table (i.e. returns the subtree of values rooted at the specified MIB name or OID).

Parameters:

mibName - The name of the column of the SNMP table.

Returns:

a List of SNMPValue objects representing the values found in the column.

Throws:

SNMPException - if an error occurs communicating with the SNMP agent.

getTable

@NotNull
Map<String,SNMPValue> getTable(String mibName,
                                     int index)
                               throws SNMPException

TODO

Parameters:

mibName - the MIB name of the table

index -

Returns:

Throws:

SNMPException - if an error occurs communicating with the SNMP agent.

getBulk

@NotNull
List<SNMPValue> getBulk(String mibName)
                        throws SNMPException

TODO

Parameters:

mibName - the MIB name of the starting OID

Returns:

Throws:

SNMPException - if an error occurs communicating with the SNMP agent.

ping

boolean ping()

Pings the agent associated with this session to see if it is responsive.

Returns:

true if the agent responds, or false otherwise

close

void close()

Closes the session and all underlying resources.