### Tool 159: SNMP Get

### Description:

      This tool requests a GET on a SNMP server. It permits to retrieve the
      value of one item.

      Parameter --oid is the oid to query. An oid is for example
      '.1.3.6.1.2.1.1.4.0'.

      Parameter --version defines SNMP version to use (from 1 to 3).
      Versions 1 and 2 need --community parameter to set community name.
      Version 3 requires --username and --password. Parameter --authmd5
      indicates if md5 authentication is used. Parameters
      --authoritativeengineid, --authoritativeengineboots,
      --authoritativeenginetime, --contextengineid and --contextname are
      optional version 3 parameters.
      Parameter --display shows packets.

      Parameter --dst-ip is the address of remote host/server.
      Parameter --dst-port is the port number where to connect.
      Optional parameter --src-ip defines the local IP address to use.
      Optional parameter --src-port defines the local port number to use.
      Optional parameter --ip4opts permits to add IP4 options encoded as
      mixed.
      Optional parameter --ip6exts permits to add IP6 options encoded as
      mixed (first byte is the next header number).
      Optional parameters --device, --src-eth and --dst-eth permits to
      create a virtual client using fake addresses (in this case, tool have
      to be run with admin privilege in order to sniff and spoof at
      Ethernet level).

### Synonyms:

snmpget

### Usage:

netwox 159 -i ip [-c password] -q oid [-d device] [-E eth] [-e eth] [-I ip] [-P port] [-p port] [-o ip4opts] [-O ip6exts] [-v uint32] [-m|+m] [-u login] [-w password] [-A mixed_data] [-B uint32] [-M uint32] [-C mixed_data] [-N data] [-T uint32] [-y|+y]

### Parameters:

parameter | description | example
`-i|--dst-ip ip` | destination IP address | 5.6.7.8
`-c|--community password` | SNMPv1/v2 community | public
`-q|--oid oid` | OID to query | .1.3.6.1.2.1.1.4.0
`-d|--device device` | device name | Eth0
`-E|--src-eth eth` | source ethernet address | 0:2:3:4:5:6
`-e|--dst-eth eth` | destination ethernet address | 0:8:9:a:b:c
`-I|--src-ip ip` | source IP address | 192.168.100.200
`-P|--src-port port` | source port number | 0
`-p|--dst-port port` | destination port number | 161
`-o|--ip4opts ip4opts` | IPv4 options |
`-O|--ip6exts ip6exts` | IPv6 extensions |
`-v|--version uint32` | SNMP version (1, 2 or 3) | 1
`-m|--md5auth|+m|--no-md5auth` | SNMPv3 auth using MD5 | This boolean is set. Use + or --no- to unset it.
`-u|--username login` | SNMPv3 username |
`-w|--password password` | SNMPv3 password |
`-A|--authoritativeengineid mixed_data` | SNMPv3 authoritativeengineid |
`-B|--authoritativeengineboots uint32` | SNMPv3 authoritativeengineboots | 0
`-M|--authoritativeenginetime uint32` | SNMPv3 authoritativeenginetime | 0
`-C|--contextengineid mixed_data` | SNMPv3 contextengineid |
`-N|--contextname data` | SNMPv3 contextname |
`-T|--timeout uint32` | timeout in ms | 10000
`-y|--display|+y|--no-display` | display packets |

### Examples:

netwox 159 -i "5.6.7.8" -q ".1.3.6.1.2.1.1.4.0"
netwox 159 --dst-ip "5.6.7.8" --oid ".1.3.6.1.2.1.1.4.0"