|
Packit Service |
b38f0b |
.\" /************************************************************
|
|
Packit Service |
b38f0b |
.\" Copyright 1997 Niels Baggesen
|
|
Packit Service |
b38f0b |
.\"
|
|
Packit Service |
b38f0b |
.\" All Rights Reserved
|
|
Packit Service |
b38f0b |
.\"
|
|
Packit Service |
b38f0b |
.\" Permission to use, copy, modify, and distribute this software and its
|
|
Packit Service |
b38f0b |
.\" documentation for any purpose and without fee is hereby granted,
|
|
Packit Service |
b38f0b |
.\" provided that the above copyright notice appear in all copies.
|
|
Packit Service |
b38f0b |
.\"
|
|
Packit Service |
b38f0b |
.\" I DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
|
|
Packit Service |
b38f0b |
.\" ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
|
|
Packit Service |
b38f0b |
.\" I BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
|
|
Packit Service |
b38f0b |
.\" ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
|
|
Packit Service |
b38f0b |
.\" WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
|
|
Packit Service |
b38f0b |
.\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
|
|
Packit Service |
b38f0b |
.\" SOFTWARE.
|
|
Packit Service |
b38f0b |
.\" ******************************************************************/
|
|
Packit Service |
b38f0b |
.\" Portions of this file are copyrighted by:
|
|
Packit Service |
b38f0b |
.\" Copyright Copyright 2003 Sun Microsystems, Inc. All rights reserved.
|
|
Packit Service |
b38f0b |
.\" Use is subject to license terms specified in the COPYING file
|
|
Packit Service |
b38f0b |
.\" distributed with the Net-SNMP package.
|
|
Packit Service |
b38f0b |
.\" ******************************************************************/
|
|
Packit Service |
b38f0b |
.TH SNMPTABLE 1 "25 Jul 2003" VVERSIONINFO "Net-SNMP"
|
|
Packit Service |
b38f0b |
.SH NAME
|
|
Packit Service |
b38f0b |
snmptable - retrieve an SNMP table and display it in tabular form
|
|
Packit Service |
b38f0b |
.SH SYNOPSIS
|
|
Packit Service |
b38f0b |
.B snmptable
|
|
Packit Service |
b38f0b |
[COMMON OPTIONS] [\-Cb] [\-CB] [\-Ch] [\-CH] [\-Ci] [\-Cf STRING] [\-Cw WIDTH]
|
|
Packit Service |
b38f0b |
AGENT TABLE\-OID
|
|
Packit Service |
b38f0b |
.SH DESCRIPTION
|
|
Packit Service |
b38f0b |
.B snmptable
|
|
Packit Service |
b38f0b |
is an SNMP application that repeatedly uses the SNMP GETNEXT or
|
|
Packit Service |
b38f0b |
GETBULK requests to query for information on a network entity. The
|
|
Packit Service |
b38f0b |
parameter TABLE\-OID must specify an SNMP table.
|
|
Packit Service |
b38f0b |
|
|
Packit Service |
b38f0b |
AGENT identifies a target SNMP agent, which is instrumented
|
|
Packit Service |
b38f0b |
to monitor the given objects. At its simplest, the AGENT
|
|
Packit Service |
b38f0b |
specification will consist of a hostname or an IPv4
|
|
Packit Service |
b38f0b |
address. In this situation, the command will attempt
|
|
Packit Service |
b38f0b |
communication with the agent, using UDP/IPv4 to port 161
|
|
Packit Service |
b38f0b |
of the given target host. See
|
|
Packit Service |
b38f0b |
.I snmpcmd(1)
|
|
Packit Service |
b38f0b |
for a full list of
|
|
Packit Service |
b38f0b |
the possible formats for AGENT.
|
|
Packit Service |
b38f0b |
.SH OPTIONS
|
|
Packit Service |
b38f0b |
.TP 8
|
|
Packit Service |
b38f0b |
.B COMMON OPTIONS
|
|
Packit Service |
b38f0b |
Please see
|
|
Packit Service |
b38f0b |
.I snmpcmd(1)
|
|
Packit Service |
b38f0b |
for a list of possible values for COMMON OPTIONS
|
|
Packit Service |
b38f0b |
as well as their descriptions.
|
|
Packit Service |
b38f0b |
.TP
|
|
Packit Service |
b38f0b |
.B \-Cb
|
|
Packit Service |
b38f0b |
Display only a brief heading. Any common prefix of the table field
|
|
Packit Service |
b38f0b |
names will be deleted.
|
|
Packit Service |
b38f0b |
.TP
|
|
Packit Service |
b38f0b |
.B \-CB
|
|
Packit Service |
b38f0b |
Do not use GETBULK requests to retrieve data, only GETNEXT.
|
|
Packit Service |
b38f0b |
.TP
|
|
Packit Service |
b38f0b |
.BI \-Cc " CHARS"
|
|
Packit Service |
b38f0b |
Print table in columns of
|
|
Packit Service |
b38f0b |
.I CHARS
|
|
Packit Service |
b38f0b |
characters width.
|
|
Packit Service |
b38f0b |
.TP
|
|
Packit Service |
b38f0b |
.BI \-Cf " STRING"
|
|
Packit Service |
b38f0b |
The string
|
|
Packit Service |
b38f0b |
.I STRING
|
|
Packit Service |
b38f0b |
is used to separate table columns. With this option, each table entry
|
|
Packit Service |
b38f0b |
will be printed in compact form, just with the string given to
|
|
Packit Service |
b38f0b |
separate the columns (useful if you want to import it into a
|
|
Packit Service |
b38f0b |
database). Otherwise it is printed in nicely aligned columns.
|
|
Packit Service |
b38f0b |
.TP
|
|
Packit Service |
b38f0b |
.B \-Ch
|
|
Packit Service |
b38f0b |
Display
|
|
Packit Service |
b38f0b |
.I only
|
|
Packit Service |
b38f0b |
the column headings.
|
|
Packit Service |
b38f0b |
.TP
|
|
Packit Service |
b38f0b |
.B \-CH
|
|
Packit Service |
b38f0b |
Do not display the column headings.
|
|
Packit Service |
b38f0b |
.TP
|
|
Packit Service |
b38f0b |
.B \-Ci
|
|
Packit Service |
b38f0b |
This option prepends the index of the entry to all printed lines.
|
|
Packit Service |
b38f0b |
.TP
|
|
Packit Service |
b38f0b |
.B \-Cl
|
|
Packit Service |
b38f0b |
Left justify the data in each column.
|
|
Packit Service |
b38f0b |
.TP
|
|
Packit Service |
b38f0b |
.BI \-Cr " REPEATERS"
|
|
Packit Service |
b38f0b |
For GETBULK requests,
|
|
Packit Service |
b38f0b |
.I REPEATERS
|
|
Packit Service |
b38f0b |
specifies the max-repeaters value to use. For GETNEXT requests,
|
|
Packit Service |
b38f0b |
.I REPEATERS
|
|
Packit Service |
b38f0b |
specifies the number of entries to retrieve at a time.
|
|
Packit Service |
b38f0b |
.TP
|
|
Packit Service |
b38f0b |
.BI \-Cw " WIDTH"
|
|
Packit Service |
b38f0b |
Specifies the width of the lines when the table is printed.
|
|
Packit Service |
b38f0b |
If the lines will be longer, the table will be printed in sections of
|
|
Packit Service |
b38f0b |
at most
|
|
Packit Service |
b38f0b |
.I WIDTH
|
|
Packit Service |
b38f0b |
characters. If
|
|
Packit Service |
b38f0b |
.I WIDTH
|
|
Packit Service |
b38f0b |
is less than the length of the contents of
|
|
Packit Service |
b38f0b |
a single column, then that single column will still be printed.
|
|
Packit Service |
b38f0b |
.PP
|
|
Packit Service |
b38f0b |
Note that
|
|
Packit Service |
b38f0b |
.B snmptable
|
|
Packit Service |
b38f0b |
REQUIRES an argument specifying the agent to query
|
|
Packit Service |
b38f0b |
and exactly one OID argument, as described in the
|
|
Packit Service |
b38f0b |
.I snmpcmd(1)
|
|
Packit Service |
b38f0b |
manual page. This OID \fBmust\fP be that of a MIB table object.
|
|
Packit Service |
b38f0b |
.SH EXAMPLES
|
|
Packit Service |
b38f0b |
$ snmptable \-v 2c \-c public localhost at.atTable
|
|
Packit Service |
b38f0b |
|
|
Packit Service |
b38f0b |
SNMP table: at.atTable RFC1213\-MIB::atTable
|
|
Packit Service |
b38f0b |
|
|
Packit Service |
b38f0b |
atIfIndex atPhysAddress atNetAddress
|
|
Packit Service |
b38f0b |
1 8:0:20:20:0:ab 130.225.243.33
|
|
Packit Service |
b38f0b |
.PP
|
|
Packit Service |
b38f0b |
$ snmptable \-v 2c \-c public \-Cf + localhost at.atTable
|
|
Packit Service |
b38f0b |
|
|
Packit Service |
b38f0b |
SNMP table: at.atTable
|
|
Packit Service |
b38f0b |
|
|
Packit Service |
b38f0b |
atIfIndex+atPhysAddress+atNetAddress
|
|
Packit Service |
b38f0b |
1+8:0:20:20:0:ab+130.225.243.33
|
|
Packit Service |
b38f0b |
.PP
|
|
Packit Service |
b38f0b |
.nf
|
|
Packit Service |
b38f0b |
$ snmptable localhost \-Cl \-CB \-Ci \-OX \-Cb \-Cc 16 \-Cw 64 ifTable
|
|
Packit Service |
b38f0b |
|
|
Packit Service |
b38f0b |
SNMP table: ifTable
|
|
Packit Service |
b38f0b |
|
|
Packit Service |
b38f0b |
Index Descr Type Mtu
|
|
Packit Service |
b38f0b |
Speed PhysAddress AdminStatus OperStatus
|
|
Packit Service |
b38f0b |
LastChange InOctets InUcastPkts InNUcastPkts
|
|
Packit Service |
b38f0b |
InDiscards InErrors InUnknownProtos OutOctets
|
|
Packit Service |
b38f0b |
OutUcastPkts OutNUcastPkts OutDiscards OutErrors
|
|
Packit Service |
b38f0b |
OutQLen Specific
|
|
Packit Service |
b38f0b |
|
|
Packit Service |
b38f0b |
index: [1]
|
|
Packit Service |
b38f0b |
1 lo softwareLoopbac 16436
|
|
Packit Service |
b38f0b |
10000000 up up
|
|
Packit Service |
b38f0b |
? 2837283786 3052466 ?
|
|
Packit Service |
b38f0b |
0 0 ? 2837283786
|
|
Packit Service |
b38f0b |
3052466 ? 0 0
|
|
Packit Service |
b38f0b |
0 zeroDotZero
|
|
Packit Service |
b38f0b |
|
|
Packit Service |
b38f0b |
index: [2]
|
|
Packit Service |
b38f0b |
2 eth0 ethernetCsmacd 1500
|
|
Packit Service |
b38f0b |
10000000 0:5:5d:d1:f7:cf up up
|
|
Packit Service |
b38f0b |
? 2052604234 44252973 ?
|
|
Packit Service |
b38f0b |
0 0 ? 149778187
|
|
Packit Service |
b38f0b |
65897282 ? 0 0
|
|
Packit Service |
b38f0b |
0 zeroDotZero
|
|
Packit Service |
b38f0b |
.PP
|
|
Packit Service |
b38f0b |
.SH "BUGS"
|
|
Packit Service |
b38f0b |
The test for
|
|
Packit Service |
b38f0b |
.I TABLE\-OID
|
|
Packit Service |
b38f0b |
actually specifying a table is rather heuristic. Note also that the
|
|
Packit Service |
b38f0b |
test requires the defining MIB file to be loaded.
|
|
Packit Service |
b38f0b |
.PP
|
|
Packit Service |
b38f0b |
.SH "SEE ALSO"
|
|
Packit Service |
b38f0b |
snmpcmd(1), variables(5).
|