{{tag>netadmin sysadmin snmp réseau network}}

====== snmpget ======

**snmpget** permet de récupérer la valeur d'un OID (une feuille).

===== Syntaxe générale =====

<code bash>
$ snmpget <options> serveur oid
</code>

Les options communes:
  * **-c** le community name, utilisé dans les version 1, 2 et 2c du protocole
  * **-u** securityName utilisé dans la version 3 du protocole
  * **-v** spécifier la version du protocole

La liste exhaustive des options communes aux commandes du paquetage NET-SNMP est présente dans le manuel:

<code bash>
$ man snmpcmd
</code>

===== Affichage =====

Pour traduire les OID numériques les commandes s'appuient sur le fichier de configuration **/etc/snmp/snmp.conf**. Cette traduction est déconseillée sur les commandes en production car elle augmente fortement le temps d’exécution cependant elle peut être utile lors des phases de conception/débogage.

Les options générales peuvent être redéfinies:
  * via la variable d'environnement MIBDIRS,
  * via les arguments à l'invocation de la commande.


L'argument -O (output) permet de spécifier le format de la sortie:

^ -On  | sortie numérique pas de traduction.                          |
^ -Of  | Afficher la liste complète des objets traduits.              |


Les arguments -m et -M permettent de redéfinir respectivement les modules et les répertoires contenant les MIBs depuis la ligne de commande:

<code bash>
snmpget -m SNMPv2-MIB -Of -v1 -c public host.localdomain .iso.org.dod.internet.mgmt.mib-2.system.sysUpTime.0
</code>

===== Exemples =====

SNMPv1 / SNMPv2
<code bash>
$ snmpget -v1 -c public host.localdomain .1.3.6.1.4.1.24681.1.2.6.0
</code>

SNMPv3
<code bash>
$ snmpget -v3 -u username host.localdomain .1.3.6.1.4.1.24681.1.2.6.0
</code>