pysnmpbulkwalk - En ligne dans le Cloud

PROGRAMME:

Nom

pysnmpcmd - options et comportement communs à la plupart des outils de ligne de commande PySNMP

SYNOPSIS

pysnmpcmd [OPTIONS] AGENT [PARAMETRES]

DESCRIPTION

Cette page de manuel décrit les options courantes des commandes PySNMP : pysnmpbulkwalk,
pysnmpget, pysnmpset, pysnmptraduire, pysnmpwalk. Les applications en ligne de commande utilisent le
Protocole SNMP pour communiquer avec une entité réseau compatible SNMP, un agent. Individuel
les applications prennent généralement (mais pas nécessairement) des paramètres supplémentaires qui sont donnés
après la spécification de l'agent. Ces paramètres sont documentés dans les pages de manuel pour
chaque application.

OPTIONS

-a protocole d'authentification
Définir le protocole d'authentification (MD5 ou SHA) utilisé pour le SNMPv3 authentifié
des messages.

-A mot de passe authentifié
Définissez la phrase de passe d'authentification utilisée pour les messages SNMPv3 authentifiés.

-c Communautés
Définissez la chaîne de communauté pour les transactions SNMPv1/v2c.

-d Videz (en hexadécimal) les paquets SNMP bruts envoyés et reçus.

-D JETON[,...]
Activer la sortie de débogage pour le donné JETON(s). Essayer TOUTE pour extrêmement verbeux
sortie.

-e ID moteur
Définissez l'ID moteur (de sécurité) faisant autorité utilisé pour les messages de REQUÊTE SNMPv3. Il est
généralement pas nécessaire de le spécifier, car il sera généralement découvert
automatiquement.

-E ID moteur
Définissez le contexte engineID utilisé pour les messages SNMPv3 REQUEST scopedPdu. Si non
spécifié, ce sera par défaut l'engineID faisant autorité.

-h, --Aidez-moi
Affichez un bref message d'utilisation, puis quittez.

-H Afficher une liste des directives du fichier de configuration comprises par la commande puis
Sortie.

-I [hu]
Spécifie les options d'analyse d'entrée. Voir CONTRIBUTION OPTIONS ci-dessous.

-l niveausec
Définissez le niveau de sécurité utilisé pour les messages SNMPv3 (noAuthNoPriv|authNoPriv|authPriv).
Une ou des phrases de passe appropriées doivent être fournies lors de l'utilisation d'un niveau supérieur à
noAuthNoPriv.

-m LISTE MIB
Spécifie une liste séparée par deux points de modules MIB (pas de fichiers) à charger pour cela
.

Le mot-clé spécial TOUTES est utilisé pour charger tous les modules MIB dans la recherche du répertoire MIB
liste. Tout fichier dont le nom ne commence pas par "." sera analysé comme s'il s'agissait d'un
fichier MIB.

-M LISTE DES RÉPERTOIRES
Spécifie une liste de répertoires séparés par deux points pour rechercher des MIB. Notez que les MIB
spécifié à l'aide de l'option -m sera chargé à partir de l'un des répertoires répertoriés par
l'option -M (ou équivalents).

-n nom de contexte
Définissez le contextName utilisé pour les messages SNMPv3. Le contextName par défaut est le vide
chaîne de caractères "".

-O [abeEfnqQsStTuUvxX]
Spécifie les options d'impression de sortie. Voir SORTIE OPTIONS ci-dessous.

-r tentatives
Spécifie le nombre de tentatives à utiliser dans les demandes. La valeur par défaut est 5.

-t temps mort
Spécifie le délai d'attente en secondes entre les tentatives. La valeur par défaut est 1.

-u nomsec
Définissez le securityName utilisé pour les messages SNMPv3 authentifiés.

-v 1 | 2c | 3
Spécifie la version du protocole à utiliser : 1 (RFC 1155-1157), 2c (RFC 1901-1908) ou
3 (RFC 2571-2574). La valeur par défaut est généralement la version 3.

-V, --version
Affichez les informations de version de l'application, puis quittez.

-x privProtocole
Définissez le protocole de confidentialité (DES ou AES) utilisé pour les messages SNMPv3 cryptés.

-X mot de passe privé
Définissez la phrase de passe de confidentialité utilisée pour les messages SNMPv3 cryptés.

-Z bottes, temps
Définissez les paramètres engineBoots et engineTime utilisés pour les messages SNMPv3 authentifiés. Cette
va initialiser la notion locale des agents boots/time avec un authentifié
valeur stockée dans l'écran LCD. Il n'est généralement pas nécessaire de spécifier cette option, car
ces valeurs seront généralement découvertes automatiquement.

AGENT CARACTÉRISTIQUES

La corde AGENT dans les SYNOPSIS ci-dessus spécifie l'entité SNMP distante avec laquelle
communiquer. Cette spécification prend la forme :

[ :]

Dans sa forme la plus simple, le AGENT La spécification peut consister en un nom d'hôte ou une adresse IPv4 dans
la notation standard "dotted quad". Dans ce cas, la communication sera tentée en utilisant
UDP/IPv4 sur le port 161 de l'hôte donné. Sinon, le partie de la
La spécification est analysée selon le tableau suivant :

le format

nom d'hôte udp[:port] or adresse IPv4[:port]

Noter que les chaînes sont insensibles à la casse de sorte que, par exemple, "tcp"
et "TCP" sont équivalents. Voici quelques exemples, accompagnés de leur interprétation :

nom d'hôte : 161 effectuer une requête à l'aide de datagrammes UDP/IPv4 pour nom d'hôte sur le port 161.
Le ":161" est redondant ici car c'est le port SNMP par défaut
dans tout les cas.

udp:nom d'hôte identique à la spécification précédente. Le "udp:" est redondant
ici puisque UDP/IPv4 est le transport par défaut.

SORTIE OPTIONS

Le format de la sortie des commandes SNMP peut être contrôlé à l'aide de divers paramètres de
le -O drapeau. Les effets de ces sous-options peuvent être vus par comparaison avec les
sortie par défaut suivante (sauf indication contraire) :
$ snmpget -c public -v 1 localhost sysUpTime.0
SNMPv2-MIB::sysUpTime.0 = Timeticks : (14096763) 1 jour, 15:09:27.63

-Oa Afficher les valeurs de chaîne sous forme de chaînes ASCII (sauf si un DISPLAY-HINT est défini pour
l'objet MIB correspondant). Par défaut, la bibliothèque tente de déterminer
si la valeur est une chaîne imprimable ou binaire, et l'affiche en conséquence.

Cette option n'affecte pas les objets qui do avoir un indice d'affichage.

-Ob Afficher les index de table numériquement, plutôt que d'essayer d'interpréter l'instance
sous-identificateurs sous forme de chaîne ou de valeurs OID :
$ snmpgetnext -c public -v 1 localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0."wes" = xxx
$ snmpgetnext -c public -v 1 -Ob localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB :: vacmSecurityModel.0.3.119.101.115 = xxx

-Oe Supprime les étiquettes symboliques des valeurs d'énumération :
$ snmpget -c public -v 1 localhost ipForwarding.0
IP-MIB::ipForwarding.0 = ENTIER : la transmission(1)
$ snmpget -c public -v 1 -Oe hôte local ipForwarding.0
IP-MIB::ipForwarding.0 = ENTIER : 1

-OE Modifie les chaînes d'index pour échapper les guillemets :
$ snmpgetnext -c public -v 1 localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0."wes" = xxx
$ snmpgetnext -c public -v 1 -OE localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0.\"wes\" = xxx

Cela permet à la sortie d'être réutilisée dans les commandes shell.

-De Incluez la liste complète des objets MIB lors de l'affichage d'un OID :
.iso.org.dod.internet.mgmt.mib-2.system.sysUpTime.0 =
Horaires : (14096763) 1 jour, 15:09:27.63

-Au Affiche l'OID numériquement :
.1.3.6.1.2.1.1.3.0 = Timeticks : (14096763) 1 jour, 15:09:27.63

-Oq Supprime le signe égal et les informations de type lors de l'affichage des valeurs varbind :
SNMPv2-MIB::sysUpTime.0 1:15:09:27.63

-QO Supprime les informations de type lors de l'affichage des valeurs varbind :
SNMPv2-MIB::sysUpTime.0 = 1:15:09:27.63

-Tu Affichez le nom de l'objet MIB (plus une instance ou d'autres sous-identifiants) :
sysUpTime.0 = Timeticks : (14096763) 1 jour, 15:09:27.63

-SE Affichez le nom de la MIB, ainsi que le nom de l'objet :
SNMPv2-MIB::sysUpTime.0 = Timeticks : (14096763) 1 jour, 15:09:27.63

Il s'agit du format de sortie OID par défaut.

-Ot Afficher les valeurs TimeTicks sous forme de nombres bruts :
SNMPv2-MIB ::sysUpTime.0 = 14096763

-OT Si les valeurs sont imprimées sous forme de chaînes hexadécimales, affichez également une version imprimable.

-Ou Afficher l'OID dans le style UCD traditionnel (hérité du CMU d'origine
code). Cela signifie supprimer une série de préfixes "standard" de l'OID, et
afficher la liste restante des noms d'objet MIB (plus tout autre sous-identifiant) :
system.sysUpTime.0 = Timeticks : (14096763) 1 jour, 15:09:27.63

-OU N'imprimez pas le suffixe UNITS à la fin de la valeur.

-Ov Affichez uniquement la valeur varbind, pas l'OID :
$ snmpget -c public -v 1 -Oe hôte local ipForwarding.0
ENTIER: la transmission(1)

-Bœuf Afficher les valeurs de chaîne sous forme de chaînes hexadécimales (sauf s'il existe un DISPLAY-HINT défini pour
l'objet MIB correspondant). Par défaut, la bibliothèque tente de déterminer
si la valeur est une chaîne imprimable ou binaire, et l'affiche en conséquence.

Cette option n'affecte pas les objets qui do avoir un indice d'affichage.

-BŒUF Affichez les index de table dans une sortie plus « de type programme », imitant un
format d'index de style tableau :
$ snmpgetnext -c public -v 1 localhost ipv6RouteTable
IPv6-MIB::ipv6RouteIfIndex.63.254.1.0.255.0.0.0.0.0.0.0.0.0.0.0.64.1 = ENTIER : 2
$ snmpgetnext -c public -v 1 -OE localhostipv6RouteTable
IPv6-MIB::ipv6RouteIfIndex[3ffe:100:ff00:0:0:0:0:0][64][1] = INTEGER: 2

La plupart de ces options peuvent également être configurées via des jetons de configuration. Voir le
snmp.conf(5) page de manuel pour plus de détails.

CONTRIBUTION OPTIONS

L'interprétation des noms d'objet d'entrée et les valeurs à attribuer peuvent être contrôlées
en utilisant divers paramètres de la -I drapeau. Le comportement par défaut sera décrit au
fin de cette section.

-Ib spécifie que le nom donné doit être considéré comme une expression régulière, pour correspondre
(insensible à la casse) par rapport aux noms d'objet dans l'arborescence MIB. Le "meilleur" match sera
être utilisé - calculé comme celui qui correspond le plus au début de la
nom du nœud et le plus élevé dans l'arborescence. Par exemple, l'objet MIB
vacmSecurityModel peut correspondre à l'expression vacmsecuritymodel (nom complet,
mais cas différent), ou vacm.*model (modèle d'expression régulière).

Noter que '.' est un caractère spécial dans les modèles d'expressions régulières, donc le
expression ne peut pas spécifier de sous-identificateurs d'instance ou plus d'un nom d'objet. UNE
L'expression "meilleure correspondance" ne sera appliquée qu'aux noms d'objets MIB uniques. Pour
exemple, l'expression sys*ontact.0 ne correspondrait pas à l'instance sysContact.0
(bien que sys*contact correspondrait à sysContact). De même, spécifier un module MIB
nom ne réussira pas (donc SNMPv2-MIB::sys.*ontact ne correspondrait pas non plus).

-Oh désactive l'utilisation des informations DISPLAY-HINT lors de l'attribution des valeurs. Cela ferait
nécessitent ensuite de fournir la valeur brute :
snmpset ... HOST-RESSOURCES-MIB::hrSystemData.0
x "07 D2 0C 0A 02 04 06 08"
au lieu d'une version formatée :
snmpset ... HOST-RESSOURCES-MIB::hrSystemDate.0
= 2002-12-10,2:4:6.8

-Ir désactive la vérification des index de table et de la valeur à attribuer par rapport aux
définitions MIB. Cela entraînera (espérons-le) l'agent distant signaler un
demande invalide, plutôt que de la vérifier (et de la rejeter) avant qu'elle ne soit envoyée au
agent à distance.

Les contrôles locaux sont plus efficaces (et les diagnostics fournis ont également tendance à être plus
précis), mais la désactivation de ce comportement est particulièrement utile lors du test du
agent à distance.

-ALLER active la recherche "à accès aléatoire" des noms MIB. Plutôt que de fournir un chemin OID complet
à l'objet MIB souhaité (ou en qualifiant cet objet avec un module MIB explicite
name), l'arborescence MIB sera recherchée pour le nom d'objet correspondant. Ainsi
.iso.org.dod.internet.mib-2.system.sysDescr.0 (ou SNMPv2-MIB::sysDescr.0) peut être
spécifié simplement comme sysDescr.0.

Mise en garde:
Étant donné que les noms d'objets MIB ne sont pas globalement uniques, cette approche peut renvoyer un
objet MIB différent selon les fichiers MIB qui ont été chargés.

Les MIB-MODULE :: objectName la syntaxe a l'avantage d'identifier de manière unique un
objet MIB particulier, tout en étant légèrement plus efficace (et automatiquement
chargement du fichier MIB nécessaire si nécessaire).

-Est SUFFIXE
ajoute le suffixe spécifié à chaque OID textuel donné sur la ligne de commande. Ceci peut
être utilisé pour récupérer plusieurs objets de la même ligne d'un tableau, en spécifiant un
valeur de l'indice commun.

-EST PRÉFIXE
ajoute le préfixe spécifié à chaque OID textuel donné sur la ligne de commande. Ceci peut
être utilisé pour spécifier un nom de module MIB explicite pour tous les objets récupérés (ou
pour les dactylos incurablement paresseux).

-jeu permet l'approche traditionnelle de style UCD pour interpréter les OID d'entrée. Cette
suppose que les OID sont enracinés au point 'mib-2' dans l'arborescence (à moins qu'ils ne commencent
avec un '.' explicite ou inclure un nom de module MIB). Donc l'instance sysDescr ci-dessus
serait référencé comme system.sysDescr.0.

Noms d'objet spécifiés avec un '.' sont toujours interprétés comme "pleinement qualifiés"
OID, répertoriant la séquence d'objets MIB à partir de la racine de l'arborescence MIB. De tels objets et
ceux qualifiés par un nom de module MIB explicite ne sont pas affectés par le -Ib, -ALLER ainsi que le -jeu
drapeaux.

Sinon, si aucune des options d'entrée ci-dessus n'est spécifiée, le comportement par défaut d'un
L'OID "relatif" consiste à essayer de l'interpréter comme un OID (implicitement) pleinement qualifié, puis
appliquer la recherche "accès aléatoire" (-ALLER), suivi de la correspondance de modèle "meilleure correspondance" (-Ib).

ENVIRONNEMENT VARIABLES

PREFIX Le préfixe standard pour les identificateurs d'objet (lors de l'utilisation d'une sortie de style UCD). Valeurs par défaut
vers .iso.org.dod.internet.mgmt.mib-2

MIBS La liste des MIB à charger. Par défaut, SNMPv2-TC:SNMPv2-MIB:IF-MIB:IP-MIB:TCP-
MIB:UDP-MIB:SNMP-VACM-MIB. Remplacé par le -m option.

MIBDIRS
La liste des répertoires dans lesquels rechercher des MIB. La valeur par défaut est DATADIR/snmp/mibs.
Remplacé par le -M option.

Utilisez pysnmpbulkwalk en ligne en utilisant les services onworks.net