OS Manuals

/usr/bin/snmpps

Network management utilities using SNMP

From net-snmp-tools 5.9.5.2-r12 (os), captured 2026-11-05 by running snmpps --help (exit 1). permalink

Usage: snmpps [-Cp] [-Ca] [-C m | n | t] AGENT[OPTIONS] AGENT

  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'

snmpps options:
	-Cp	Show hrSWRunPath instead of hrSWRunName
	-Ca	Show hrSWRunParameters in addition to hrSWRunName/Path
	-Ct	Sort processes according to CPU time used
	-Cm	Sort processes according to memory usage
	-Cn	Sort processes by PID number (default)
Options (30)
OptionDescriptionSource
-h, --helpdisplay this help messagehelp
-Hdisplay configuration file directives understoodhelp
-v 1|2c|3specifies SNMP version to usehelp
-V, --versiondisplay package version numberhelp
-c COMMUNITYset the community stringhelp
-a PROTOCOLset authentication protocol (MD5|SHA|SHA-224|SHA-256|SHA-384|SHA-512)help
-A PASSPHRASEset authentication protocol pass phrasehelp
-e ENGINE-IDset security engine ID (e.g. 800000020109840301)help
-E ENGINE-IDset context engine ID (e.g. 800000020109840301)help
-l LEVELset security level (noAuthNoPriv|authNoPriv|authPriv)help
-n CONTEXTset context name (e.g. bridge1)help
-u USER-NAMEset security name (e.g. bert)help
-x PROTOCOLset privacy protocol (DES|AES|AES-192|AES-256)help
-X PASSPHRASEset privacy protocol pass phrasehelp
-Z BOOTSset destination engine boots/timehelp
-r RETRIESset the number of retrieshelp
-t TIMEOUTset the request timeout (in seconds)help
-ddump input/output packets in hexadecimalhelp
-D TOKENturn 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 MIBOPTSToggle 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 OUTOPTSToggle 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 INOPTSToggle 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 LOGOPTSToggle 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
-CpShow hrSWRunPath in addition to hrSWRunNamehelp + man
-CaShow hrSWRunParameters in addition to hrSWRunName/Pathhelp + man
-CtSort processes according to CPU time usedhelp + man
-CmSort processes according to memory usagehelp + man
-CnSort processes by PID number (default)help + man
Examples (1) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.