snmpgettab(1M)                  TCP/IP R4.11                  snmpgettab(1M)


NAME
       snmpgettab - get MIB-Tables from SNMP agent

SYNOPSIS
       snmpgettab [-n][-t][-help] host community table

   where:
       host is a hostname or Internet address
       community is a community string
       table is a mib table.

DESCRIPTION
       Use the snmpgettab command to retrieve tables (subtrees) of objects
       from an SNMP agent.  The snmpgettab command sends a request for all
       the objects that comprise a row from table.  The agent authenticates
       the request by checking that community has read access for the
       requested information.  If the community does not have read access,
       the agent will discard the request and snmpgettab will fail because
       of a timeout.  If the community has read access, the agent will
       return the values for all the requested objects.  The snmpgettab
       command prints the agent's response and builds a new request for the
       next row.  This continues until the entire table is traversed.

       Unlike snmpgetmany, snmpgettab traverses tables in a row-wise
       fashion, which should be easier to read.  Additionally, snmpgettab is
       more efficient than snmpgetmany because snmpgettab requests multiple
       objects in each network request.  However, snmpgettab is limited to
       specific tables, while snmpgetmany can be used to obtain arbitrary
       subtrees of information.

       Specify the host as either a hostname or an Internet address in dot-
       notation.

       The community string is a text string used by the agent to
       authenticate the request.  You must configure the agent to allow read
       access to community for the operation to be successful.

       The table is specified as a text string representing a MIB Table.
       Use the -help option to get a list of supported tables.

       Options are:

       -n     Display Object ID's in a numeric format instead of translating
              them into a symbolic name.

       -t     Display the data type of the object in addition to it's name
              and value.

       -help  Prints a list of supported tables.

EXAMPLES
       This example shows how to use snmpgettab to request the
       ipNetToMediaTable (arp) table.
       $ snmpgettab myhost public ipNetToMediaTable
       ipNetToMediaIfIndex.1.128.222.8.1 = 1
       ipNetToMediaPhysAddress.1.128.222.8.1 = 08 00 20 00 e7 c9
       ipNetToMediaNetAddress.1.128.222.8.1 = 128.222.8.1
       ipNetToMediaType.1.128.222.8.1 = 3

       ipNetToMediaIfIndex.1.128.222.8.29 = 1
       ipNetToMediaPhysAddress.1.128.222.8.29 = 02 cf 1f b0 30 24
       ipNetToMediaNetAddress.1.128.222.8.29 = 128.222.8.29
       ipNetToMediaType.1.128.222.8.29 = 3

       ipNetToMediaIfIndex.1.224.0.0.5 = 1
       ipNetToMediaPhysAddress.1.224.0.0.5 = 01 00 5e 00 00 05
       ipNetToMediaNetAddress.1.224.0.0.5 = 224.0.0.5
       ipNetToMediaType.1.224.0.0.5 = 2

       ipNetToMediaIfIndex.1.224.0.0.6 = 1
       ipNetToMediaPhysAddress.1.224.0.0.6 = 01 00 5e 00 00 06
       ipNetToMediaNetAddress.1.224.0.0.6 = 224.0.0.6
       ipNetToMediaType.1.224.0.0.6 = 2

DIAGNOSTICS
       Exit status is 0 upon success.

       Exit status is -1 if there are errors parsing the command line.

       Exit status is 1 if there is an error returned from the agent.

SEE ALSO
       snmpgetone(1M), snmpgetnext(1M), snmpsetany(1M), snmptraprecv(1M),
       snmptrapsend(1M), snmpgetmany(1M), snmpd(1M), snmpdfiles(4),
       snmpd.conf(4).


Licensed material--property of copyright holder(s)