Module org.snmp4j

Package org.snmp4j.tools.console

Class SnmpCommand

java.lang.Object

org.snmp4j.tools.console.SnmpCommand

All Implemented Interfaces:

Runnable, EventListener, CommandResponder, TransportListener

public class SnmpCommand
extends Object
implements Runnable, CommandResponder, TransportListener

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) class	SnmpCommand.CVSTableListener
(package private) static class	SnmpCommand.FilterPrintStream
class	SnmpCommand.SnmpCommandMessageDispatcher
(package private) class	SnmpCommand.TextTableListener
(package private) class	SnmpCommand.WalkCounts

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	ADDRESS_PARAMETER
private static final String	ALL_OPTIONS
(package private) OctetString	authoritativeEngineID
(package private) OctetString	authPassphrase
(package private) OID	authProtocol
private static final String	BULK_OPTIONS
(package private) String	command
private static final String[][]	COMMANDS
(package private) OctetString	community
private static final String	CONSOLE_OPTIONS
(package private) OctetString	contextEngineID
(package private) OctetString	contextName
private static final int	CVS_TABLE
private static final int	DEFAULT
(package private) int	engineBootCount
private static PrintStream	err
private static ResourceBundle	help
private static final int	LISTEN
(package private) OctetString	localEngineID
(package private) OID	lowerBoundIndex
(package private) int	maxSizeResponsePDU
(package private) int	numDispatcherThreads
private static final int	OID_FIND
private static final String	OID_PARAMETER
private static final String	OIDLIST_PARAMETER
private static final int	OP_USM_DH_KEY
private static final int	OP_USM_DH_KICKSTART_INIT
private static final int	OP_USM_DH_KICKSTART_RUN
private static final int	OP_USM_KEY
private static final int	OP_USM_USER
protected int	operation
private static final String	OPT_OID_PARAMETER
private static final String	OPT_OIDLIST_PARAMETER
private static final String	OPTIONS
private static PrintStream	out
private static boolean	packetDumpEnabled
(package private) PDUFactory	pduFactory
(package private) int	pduType
(package private) OctetString	privPassphrase
(package private) OID	privProtocol
(package private) int	retries
private int	returnCode
(package private) OctetString	securityName
(package private) Map<String,List<Object>>	settings
private static boolean	silent
private static final int	SMI_DUMP
private static final int	SNAPSHOT_CREATION
private static final int	SNAPSHOT_DUMP
(package private) File	snapshotFile
(package private) Snmp	snmp
private static final String	SNMP_OPTIONS
private static final String	SNMPV3_ONLY_OPTIONS
private static int	stdoutWidth
(package private) TimeTicks	sysUpTime
private static final int	TABLE
private static final String	TABLE_OPTIONS
private static int[]	tabs
(package private) Target<?>	target
private static final int	TIME_BASED_CVS_TABLE
(package private) int	timeout
private static final String	TLS_OPTIONS
private static final String	TRAP_OPTIONS
(package private) OID	trapOID
(package private) OID	upperBoundIndex
(package private) boolean	useDenseTableOperation
private static final String	V3_AUTH_PRIV_PROTOCOL
private static final String	V3_OPTIONS
(package private) Vector<VariableBinding>	vbs
(package private) int	version
private static final int	WALK
private static final String	WALK_OPTIONS

Constructor Summary

Constructors

Constructor	Description
SnmpCommand(String command, Map<String,List<Object>> args)

Method Summary

Modifier and Type	Method	Description
private void	addUsmUser(Snmp snmp)
private void	assignOptions(Map<String,List<Object>> args)
private void	checkTrapVariables(List<VariableBinding> vbs, int pduType, OID trapOID, TimeTicks sysUpTime)
private void	createSnapshot(List<?> snapshot)
private int	dumpSnapshot()
String	example(String prefix, String command)
private static String	format(int indentation, String s, int tabNo, int firstLineOffset)
private static Address	getAddress(String transportAddress)
private static int	getTabPosition(int tabNo)
private byte[]	getUserEngineID()
private static List<VariableBinding>	getVariableBindings(String[] args, int position)
String	help(String prefix, String command, boolean listOptionsDetails, boolean withDescription)
int	listen()
static void	main(String[] args)
private void	optionDetailList(int indentation, String prefix, StringBuffer buf, SortedMap<String,ArgumentParser.ArgumentFormat> soptions)
private String	optionList(int indentation, String prefix, String command)
private String	options(int indentation, String prefix, String command)
private void	parseOIDs(Map<String,List<Object>> args)
protected static void	printReport(PDU response)
static void	printUsage()
protected static void	printVariableBindings(PDU response)
protected static void	printVersion()
void	processMessage(TransportMapping<?> sourceTransport, Address destAddress, byte[] message)
<A extends Address> void	processMessage(TransportMapping<? super A> sourceTransport, A incomingAddress, ByteBuffer wholeMessage, TransportStateReference tmStateReference)	Processes an incoming message.
<A extends Address> void	processPdu(CommandResponderEvent<A> e)	Process an incoming request, report or notification PDU.
void	run()
private String[]	selectFormat(String command)
PDU	send()
static String	spaces(int n)
private static String	tab(int offset, int position, int tabNo)
int	table()
private PDU	walk(Snmp snmp, PDU request, Target<?> target, List<VariableBinding> snapshot)
private static String	wrap(int offset, String s, int maxLineLength, int firstLineOffset)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

OPTIONS

private static final String OPTIONS

See Also:

• Constant Field Values

CONSOLE_OPTIONS

private static final String CONSOLE_OPTIONS

See Also:

• Constant Field Values

V3_AUTH_PRIV_PROTOCOL

private static final String V3_AUTH_PRIV_PROTOCOL

See Also:

• Constant Field Values

V3_OPTIONS

private static final String V3_OPTIONS

See Also:

• Constant Field Values

TRAP_OPTIONS

private static final String TRAP_OPTIONS

See Also:

• Constant Field Values

TLS_OPTIONS

private static final String TLS_OPTIONS

See Also:

• Constant Field Values

SNMP_OPTIONS

private static final String SNMP_OPTIONS

See Also:

• Constant Field Values

SNMPV3_ONLY_OPTIONS

private static final String SNMPV3_ONLY_OPTIONS

See Also:

• Constant Field Values

BULK_OPTIONS

private static final String BULK_OPTIONS

See Also:

• Constant Field Values

TABLE_OPTIONS

private static final String TABLE_OPTIONS

See Also:

• Constant Field Values

WALK_OPTIONS

private static final String WALK_OPTIONS

See Also:

• Constant Field Values

ADDRESS_PARAMETER

private static final String ADDRESS_PARAMETER

See Also:

• Constant Field Values

OID_PARAMETER

private static final String OID_PARAMETER

See Also:

• Constant Field Values

OPT_OID_PARAMETER

private static final String OPT_OID_PARAMETER

See Also:

• Constant Field Values

OIDLIST_PARAMETER

private static final String OIDLIST_PARAMETER

See Also:

• Constant Field Values

OPT_OIDLIST_PARAMETER

private static final String OPT_OIDLIST_PARAMETER

See Also:

• Constant Field Values

ALL_OPTIONS

private static final String ALL_OPTIONS

See Also:

• Constant Field Values

COMMANDS

private static final String[][] COMMANDS

DEFAULT

private static final int DEFAULT

See Also:

• Constant Field Values

WALK

private static final int WALK

See Also:

• Constant Field Values

LISTEN

private static final int LISTEN

See Also:

• Constant Field Values

TABLE

private static final int TABLE

See Also:

• Constant Field Values

CVS_TABLE

private static final int CVS_TABLE

See Also:

• Constant Field Values

TIME_BASED_CVS_TABLE

private static final int TIME_BASED_CVS_TABLE

See Also:

• Constant Field Values

SNAPSHOT_CREATION

private static final int SNAPSHOT_CREATION

See Also:

• Constant Field Values

SNAPSHOT_DUMP

private static final int SNAPSHOT_DUMP

See Also:

• Constant Field Values

OID_FIND

private static final int OID_FIND

See Also:

• Constant Field Values

SMI_DUMP

private static final int SMI_DUMP

See Also:

• Constant Field Values

OP_USM_USER

private static final int OP_USM_USER

See Also:

• Constant Field Values

OP_USM_KEY

private static final int OP_USM_KEY

See Also:

• Constant Field Values

OP_USM_DH_KEY

private static final int OP_USM_DH_KEY

See Also:

• Constant Field Values

OP_USM_DH_KICKSTART_INIT

private static final int OP_USM_DH_KICKSTART_INIT

See Also:

• Constant Field Values

OP_USM_DH_KICKSTART_RUN

private static final int OP_USM_DH_KICKSTART_RUN

See Also:

• Constant Field Values

packetDumpEnabled

private static boolean packetDumpEnabled

target

Target<?> target

authProtocol

OID authProtocol

privProtocol

OID privProtocol

privPassphrase

OctetString privPassphrase

authPassphrase

OctetString authPassphrase

community

OctetString community

authoritativeEngineID

OctetString authoritativeEngineID

contextEngineID

OctetString contextEngineID

contextName

OctetString contextName

securityName

OctetString securityName

localEngineID

OctetString localEngineID

sysUpTime

TimeTicks sysUpTime

trapOID

OID trapOID

version

int version

engineBootCount

int engineBootCount

retries

int retries

timeout

int timeout

pduType

int pduType

maxSizeResponsePDU

int maxSizeResponsePDU

vbs

Vector<VariableBinding> vbs

snapshotFile

File snapshotFile

operation

protected int operation

numDispatcherThreads

int numDispatcherThreads

useDenseTableOperation

boolean useDenseTableOperation

stdoutWidth

private static int stdoutWidth

lowerBoundIndex

OID lowerBoundIndex

upperBoundIndex

OID upperBoundIndex

pduFactory

PDUFactory pduFactory

snmp

Snmp snmp

settings

Map<String,List<Object>> settings

command

String command

err

private static PrintStream err

out

private static PrintStream out

help

private static ResourceBundle help

tabs

private static int[] tabs

silent

private static boolean silent

returnCode

private int returnCode

Constructor Details

SnmpCommand

public SnmpCommand(String command,
 Map<String,List<Object>> args)
            throws IOException

Throws:

IOException

Method Details

assignOptions

private void assignOptions(Map<String,List<Object>> args)

parseOIDs

private void parseOIDs(Map<String,List<Object>> args)
                throws IllegalArgumentException

Throws:

IllegalArgumentException

addUsmUser

private void addUsmUser(Snmp snmp)

help

public String help(String prefix,
 String command,
 boolean listOptionsDetails,
 boolean withDescription)

example

public String example(String prefix,
 String command)

optionList

private String optionList(int indentation,
 String prefix,
 String command)

options

private String options(int indentation,
 String prefix,
 String command)

optionDetailList

private void optionDetailList(int indentation,
 String prefix,
 StringBuffer buf,
 SortedMap<String,ArgumentParser.ArgumentFormat> soptions)

selectFormat

private String[] selectFormat(String command)

tab

private static String tab(int offset,
 int position,
 int tabNo)

getTabPosition

private static int getTabPosition(int tabNo)

format

private static String format(int indentation,
 String s,
 int tabNo,
 int firstLineOffset)

wrap

private static String wrap(int offset,
 String s,
 int maxLineLength,
 int firstLineOffset)

spaces

public static String spaces(int n)

send

public PDU send()
         throws IOException

Throws:

IOException

checkTrapVariables

private void checkTrapVariables(List<VariableBinding> vbs,
 int pduType,
 OID trapOID,
 TimeTicks sysUpTime)

printReport

protected static void printReport(PDU response)

processPdu

public <A extends Address> void processPdu(CommandResponderEvent<A> e)

Description copied from interface: CommandResponder

Process an incoming request, report or notification PDU.

Specified by:

processPdu in interface CommandResponder

Type Parameters:

A - type of the peer Address.

Parameters:

e - a CommandResponderEvent instance containing the PDU to process and some additional information returned by the message processing model that decoded the SNMP message.

printVariableBindings

protected static void printVariableBindings(PDU response)

table

public int table()
          throws IOException

Throws:

IOException

createSnapshot

private void createSnapshot(List<?> snapshot)

dumpSnapshot

private int dumpSnapshot()

walk

private PDU walk(Snmp snmp,
 PDU request,
 Target<?> target,
 List<VariableBinding> snapshot)
          throws IOException

Throws:

IOException

getVariableBindings

private static List<VariableBinding> getVariableBindings(String[] args,
 int position)

getAddress

private static Address getAddress(String transportAddress)

listen

public int listen()
           throws IOException

Throws:

IOException

main

public static void main(String[] args)

run

public void run()

Specified by:

run in interface Runnable

getUserEngineID

private byte[] getUserEngineID()

printVersion

protected static void printVersion()

printUsage

public static void printUsage()
                       throws IOException

Throws:

IOException

processMessage

public <A extends Address> void processMessage(TransportMapping<? super A> sourceTransport,
 A incomingAddress,
 ByteBuffer wholeMessage,
 TransportStateReference tmStateReference)

Description copied from interface: TransportListener

Processes an incoming message.

Specified by:

processMessage in interface TransportListener

Type Parameters:

A - the Address type.

Parameters:

sourceTransport - a TransportMapping instance denoting the transport that received the message and that will be used to send any responses to this message. The sourceTransport has to support the incomingAddress's implementation class.

incomingAddress - the Address from which the message has been received.

wholeMessage - an ByteBuffer containing the received message.

tmStateReference - the transport model state reference as defined by RFC 5590.

processMessage

public void processMessage(TransportMapping<?> sourceTransport,
 Address destAddress,
 byte[] message)