snmptable
(1)
Name
snmptable - retrieve an SNMP table and display it in tabular
form
Synopsis
snmptable [COMMON OPTIONS] [-Cb] [-CB] [-Ch] [-CH] [-Ci]
[-Cf STRING] [-Cw WIDTH] AGENT TABLE-OID
Description
Net-SNMP SNMPTABLE(1)
NAME
snmptable - retrieve an SNMP table and display it in tabular
form
SYNOPSIS
snmptable [COMMON OPTIONS] [-Cb] [-CB] [-Ch] [-CH] [-Ci]
[-Cf STRING] [-Cw WIDTH] AGENT TABLE-OID
DESCRIPTION
snmptable is an SNMP application that repeatedly uses the
SNMP GETNEXT or GETBULK requests to query for information on
a network entity. The parameter TABLE-OID must specify an
SNMP table.
snmptable is an SNMP application that repeatedly uses the
SNMP GETNEXT or GETBULK requests to query for information
on a network entity. The parameter TABLE-OID must specify
an SNMP table.
AGENT identifies a target SNMP agent, which is instrumented
to monitor the gievn objects. At its simplest, the AGENT
specification will consist of a hostname or an IPv4 address.
In this situation, the command will attempt communication
with the agent, using UDP/IPv4 to port 161 of the given tar-
get host. See snmpcmd(1) for a full list of the possible
formats for AGENT.
OPTIONS
COMMON OPTIONS
Please see snmpcmd(1) for a list of possible values
for COMMON OPTIONS as well as their descriptions.
-Cb Display only a brief heading. Any common prefix of
the table field names will be deleted.
-CB Do not use GETBULK requests to retrieve data, only
GETNEXT.
-Cc CHARS
Print table in columns of CHARS characters width.
-Cf STRING
The string STRING is used to separate table columns.
With this option, each table entry will be printed
in compact form, just with the string given to sepa-
rate the columns (useful if you want to import it
into a database). Otherwise it is printed in nicely
aligned columns.
-Ch Display only the column headings.
-CH Do not display the column headings.
V5.4.1 Last change: 25 Jul 2003 1
Net-SNMP SNMPTABLE(1)
-Ci This option prepends the index of the entry to all
printed lines.
-Cl Left justify the data in each column.
-Cr REPEATERS
For GETBULK requests, REPEATERS specifies the max-
repeaters value to use. For GETNEXT requests,
REPEATERS specifies the number of entries to
retrieve at a time.
-Cw WIDTH
Specifies the width of the lines when the table is
printed. If the lines will be longer, the table
will be printed in sections of at most WIDTH charac-
ters. If WIDTH is less than the length of the con-
tents of a single column, then that single column
will still be printed.
EXAMPLES
$ snmptable -v 2c -c public localhost at.atTable
SNMP table: at.atTable RFC1213-MIB::atTable
atIfIndex atPhysAddress atNetAddress
1 8:0:20:20:0:ab 130.225.243.33
$ snmptable -v 2c -c public -Cf + localhost at.atTable
SNMP table: at.atTable
atIfIndex+atPhysAddress+atNetAddress
1+8:0:20:20:0:ab+130.225.243.33
$ snmptable localhost -Cl -CB -Ci -OX -Cb -Cc 16 -Cw 64 ifTable
SNMP table: ifTable
Index Descr Type Mtu
Speed PhysAddress AdminStatus OperStatus
LastChange InOctets InUcastPkts InNUcastPkts
InDiscards InErrors InUnknownProtos OutOctets
OutUcastPkts OutNUcastPkts OutDiscards OutErrors
OutQLen Specific
index: [1]
1 lo softwareLoopbac 16436
10000000 up up
? 2837283786 3052466 ?
0 0 ? 2837283786
3052466 ? 0 0
0 zeroDotZero
V5.4.1 Last change: 25 Jul 2003 2
Net-SNMP SNMPTABLE(1)
index: [2]
2 eth0 ethernetCsmacd 1500
10000000 0:5:5d:d1:f7:cf up up
? 2052604234 44252973 ?
0 0 ? 149778187
65897282 ? 0 0
0 zeroDotZero
BUGS
The test for TABLE-OID actually specifying a table is rather
heuristic. Note also that the test requires the defining
MIB file to be loaded.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+-----------------------------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------------------------------+
|Availability | system/management/snmp/net-snmp/documentation |
+---------------+-----------------------------------------------+
|Stability | Volatile |
+---------------+-----------------------------------------------+
SEE ALSO
snmpcmd(1), variables(5).
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
http://ftp.ntua.gr/mirror/net-snmp/OldFiles/net-
snmp-5.4.x/5.4.1/net-snmp-5.4.1.tar.gz
Further information about this software can be found on the
open source community website at http://www.net-snmp.org/.
V5.4.1 Last change: 25 Jul 2003 3