Usage: snmpdelta [-Cf] [-CF commandFile] [-Cl] [-CL SumFileName]
[-Cs] [-Ck] [-Ct] [-CS] [-Cv vars/pkt] [-Cp period]
[-CP peaks] [OPTIONS] AGENT oid [oid ...]
Version: 5.9.5.2
Web: http://www.net-snmp.org/
Email: net-snmp-coders@lists.sourceforge.net
OPTIONS:
-h, --help display this help message
-H display configuration file directives understood
-v 1|2c|3 specifies SNMP version to use
-V, --version display package version number
SNMP Version 1 or 2c specific
-c COMMUNITY set the community string
SNMP Version 3 specific
-a PROTOCOL set authentication protocol (MD5|SHA|SHA-224|SHA-256|SHA-384|SHA-512)
-A PASSPHRASE set authentication protocol pass phrase
-e ENGINE-ID set security engine ID (e.g. 800000020109840301)
-E ENGINE-ID set context engine ID (e.g. 800000020109840301)
-l LEVEL set security level (noAuthNoPriv|authNoPriv|authPriv)
-n CONTEXT set context name (e.g. bridge1)
-u USER-NAME set security name (e.g. bert)
-x PROTOCOL set privacy protocol (DES|AES|AES-192|AES-256)
-X PASSPHRASE set privacy protocol pass phrase
-Z BOOTS,TIME set destination engine boots/time
General communication options
-r RETRIES set the number of retries
-t TIMEOUT set the request timeout (in seconds)
Debugging
-d dump input/output packets in hexadecimal
-D[TOKEN[,...]] turn on debugging output for the specified TOKENs
(ALL gives extremely verbose debugging output)
General options
-m MIB[:...] load given list of MIBs (ALL loads everything)
-M DIR[:...] look in given list of directories for MIBs
(default: $HOME/.snmp/mibs:/usr/share/snmp/mibs)
-P MIBOPTS Toggle various defaults controlling MIB parsing:
u: allow the use of underlines in MIB symbols
c: disallow the use of "--" to terminate comments
d: save the DESCRIPTIONs of the MIB objects
e: disable errors when MIB symbols conflict
w: enable warnings when MIB symbols conflict
W: enable detailed warnings when MIB symbols conflict
R: replace MIB symbols from latest module
-O OUTOPTS Toggle various defaults controlling output display:
0: print leading 0 for single-digit hex characters
a: print all strings in ascii format
b: do not break OID indexes down
e: print enums numerically
E: escape quotes in string indices
f: print full OIDs on output
n: print OIDs numerically
p PRECISION: display floating point values with specified PRECISION (printf format string)
q: quick print for easier parsing
Q: quick print with equal-signs
s: print only last symbolic element of OID
S: print MIB module-id plus last element
t: print timeticks unparsed as numeric integers
T: print human-readable text along with hex strings
u: print OIDs using UCD-style prefix suppression
U: don't print units
v: print values only (not OID = value)
x: print all strings in hex format
X: extended index format
-I INOPTS Toggle various defaults controlling input parsing:
b: do best/regex matching to find a MIB node
h: don't apply DISPLAY-HINTs
r: do not check values for range/type legality
R: do random access to OID labels
u: top-level OIDs must have '.' prefix (UCD-style)
s SUFFIX: Append all textual OIDs with SUFFIX before parsing
S PREFIX: Prepend all textual OIDs with PREFIX before parsing
-L LOGOPTS Toggle various defaults controlling logging:
e: log to standard error
o: log to standard output
n: don't log at all
f file: log to the specified file
s facility: log to syslog (via the specified facility)
(variants)
[EON] pri: log to standard error, output or /dev/null for level 'pri' and above
[EON] p1-p2: log to standard error, output or /dev/null for levels 'p1' to 'p2'
[FS] pri token: log to file/syslog for level 'pri' and above
[FS] p1-p2 token: log to file/syslog for levels 'p1' to 'p2'
snmpdelta specific options
-Cf Don't fix errors and retry the request.
-Cl write configuration to file
-CF config load configuration from file
-Cp period specifies the poll period
-CP peaks reporting period in poll periods
-Cv vars/pkt number of variables per packet
-Ck keep seconds in output time
-Cm show max values
-CS log to a sum file
-Cs show timestamps
-Ct get timing from agent
-CT print output in tabular form
-CL sumfile specifies the sum file name
Options (38)
| Option | Description | Source |
|---|---|---|
-h, --help | display this help message | help |
-H | display configuration file directives understood | help |
-v 1|2c|3 | specifies SNMP version to use | help |
-V, --version | display package version number | help |
-c COMMUNITY | set the community string | help |
-a PROTOCOL | set authentication protocol (MD5|SHA|SHA-224|SHA-256|SHA-384|SHA-512) | help |
-A PASSPHRASE | set authentication protocol pass phrase | help |
-e ENGINE-ID | set security engine ID (e.g. 800000020109840301) | help |
-E ENGINE-ID | set context engine ID (e.g. 800000020109840301) | help |
-l LEVEL | set security level (noAuthNoPriv|authNoPriv|authPriv) | help |
-n CONTEXT | set context name (e.g. bridge1) | help |
-u USER-NAME | set security name (e.g. bert) | help |
-x PROTOCOL | set privacy protocol (DES|AES|AES-192|AES-256) | help |
-X PASSPHRASE | set privacy protocol pass phrase | help |
-Z BOOTS | set destination engine boots/time | help |
-r RETRIES | set the number of retries | help |
-t TIMEOUT | set the request timeout (in seconds) | help |
-d | dump input/output packets in hexadecimal | help |
-D TOKEN | turn on debugging output for the specified TOKENs (ALL gives extremely verbose debugging output) | help |
-m MIB[:... | load given list of MIBs (ALL loads everything) | help |
-M DIR[:... | look in given list of directories for MIBs (default: $HOME/.snmp/mibs:/usr/share/snmp/mibs) | help |
-P MIBOPTS | Toggle various defaults controlling MIB parsing: u: allow the use of underlines in MIB symbols c: disallow the use of "--" to terminate comments d: save the DESCRIPTIONs of the MIB objects e: disable… | help |
-O OUTOPTS | Toggle various defaults controlling output display: 0: print leading 0 for single-digit hex characters a: print all strings in ascii format b: do not break OID indexes down e: print enums numerically… | help |
-I INOPTS | Toggle various defaults controlling input parsing: b: do best/regex matching to find a MIB node h: don't apply DISPLAY-HINTs r: do not check values for range/type legality R: do random access to OID… | help |
-L LOGOPTS | Toggle various defaults controlling logging: e: log to standard error o: log to standard output n: don't log at all f file: log to the specified file s facility: log to syslog (via the specified… | help |
-Cf | Don't fix errors and retry the request. | help + man |
-Cl | Tells snmpdelta to write it's configuration to files whose names correspond to the MIB instances monitored. | help + man |
-CF config | Tells snmpdelta to read it's configuration from the specified file. | help + man |
-Cp period | Specifies the number of seconds between polling periods. | help + man |
-CP peaks | Specifies the reporting period in number of polling periods. | help + man |
-Cv vars/pkt | Specifies the maximum number of oids allowed to be packaged in a single PDU. | help + man |
-Ck | When the polling period (-Cp) is an increment of 60 seconds and the timestamp is displayed in the output (-Cs), then the default display shows the timestamp in the format hh:mm mm/dd. | help + man |
-Cm | Prints the max value ever attained. | help + man |
-CS | Generates a "sum count" in addition to the individual instance counts. | help + man |
-Cs | Flag will display a timestamp. | help + man |
-Ct | Flag will determine time interval from the monitored entity. | help + man |
-CT | Makes snmpdelta print its output in tabular form. | help + man |
-CL sumfile | specifies the sum file name | help |
Examples (3) from the manual page, untested
snmpdelta -c public -v 1 -Cs localhost IF-MIB::ifInUcastPkts.3 IF-MIB::ifOutUcastPkts.3snmpdelta -c public -v 1 -Cs -CT localhost IF-MIB:ifInUcastPkts.3 IF-MIB:ifOutcastPkts.3snmpdelta -c public -v 1 -Ct -Cs -CS -Cm -Cl -Cp 60 -CP 60
The following example uses a number of options.