| .\" /************************************************************ |
| .\" Copyright 1997 Niels Baggesen |
| .\" |
| .\" All Rights Reserved |
| .\" |
| .\" Permission to use, copy, modify, and distribute this software and its |
| .\" documentation for any purpose and without fee is hereby granted, |
| .\" provided that the above copyright notice appear in all copies. |
| .\" |
| .\" I DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING |
| .\" ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL |
| .\" I BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR |
| .\" ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, |
| .\" WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, |
| .\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS |
| .\" SOFTWARE. |
| .\" ******************************************************************/ |
| .TH SNMPTABLE 1 "8 November 1997" |
| .UC 4 |
| .SH NAME |
| snmptable - obtain and print an SNMP table |
| .SH SYNOPSIS |
| snmptable [common arguments] [options] tableID |
| .SH DESCRIPTION |
| Snmptable is an SNMP application that uses the GETNEXT Request to query for |
| information on a network entity. |
| The \fItableID\fR must specify an SNMP table. |
| .PP |
| .I snmptable |
| has the following special options: |
| .IP "-f F" |
| \fIF\fR is a string used to separate table columns. |
| With this option, each table entry will be printed in compact form, just with |
| the string given to separate the columns (useful if you want to import it |
| into a database). |
| Otherwise it is printed in nicely aligned columns. |
| .IP "-w W" |
| \fIW\fR 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 |
| max \fIW\fR characters. |
| .IP "-x" |
| this option prepends the index of the entry to all printed lines |
| .IP "-b" |
| brief heading. Any common prefix of the table field names will be |
| deleted |
| .IP "-h" |
| do not print the headings |
| .IP "-H" |
| print only the table heading |
| .PP |
| .SH EXAMPLES |
| $ snmptable localhost public at.attable |
| |
| SNMP table: at.atTable |
| |
| atIfIndex atPhysAddress atNetAddress |
| 1 8:0:20:20:0:ab 130.225.243.33 |
| .PP |
| $ snmptable localhost public -f + at.attable |
| |
| SNMP table: at.atTable |
| |
| atIfIndex+atPhysAddress+atNetAddress |
| 1+8:0:20:20:0:ab+130.225.243.33 |
| .PP |
| .SH "BUGS" |
| The test for tableID actually specifying a table is rather heuristic. |
| Note also, that the test requires the defining MIB file to be loaded. |
| .PP |
| .SH "SEE ALSO" |
| snmpcmd(1), variables(5). |
