cl_snmp, Befehl

Zweck

Gibt SNMP-Anforderungen (Simple Network Management Protocol) an Agenten aus und verarbeitet SNMP-Antworten, die von Agenten zurückgegeben werden.

Syntax

cl_snmp [-com][-debug Ebene] [-Host TargetHost] [-Zeitlimit TimeoutValue] [-wiederholung RetryNumber] [-max MaxRepetitions] [-Datei ConfigurationFile] [-port PortNumber] [-verbose ] [-nicht NonRepeaters] Function [MIB-Variable][VariableType][Wert][...]

Beschreibung

Verwenden Sie den Befehl cl_snmp , um SNMP-Anforderungen an Agenten auszugeben und SNMP-Antworten zu verarbeiten, die von Agenten zurückgegeben werden. Der Befehl Virtual I/O ServerVirtual I/O Server cl_snmp kann für SNMPv1verwendet werden. SNMPv2c-und SNMPv3 -Anforderungen.

Flaggen

Flagname Beschreibung
-com Gibt den Community-Namen an, der für den Zugriff auf die angegebenen Variablen im SNMP-Zielagenten verwendet wird. Wenn Sie keinen Community-Namen angeben, wird standardmäßig der Name "public" verwendet. Community-Namen sind nicht erforderlich, wenn Sie das benutzerbasierte Sicherheitsmodell verwenden.
Hinweis Bei Community-Namen muss die Groß-/Kleinschreibung beachtet werden.
-debug Stufe Gibt eine Debugstufe während der Laufzeit an Der Standardwert ist 0. Je höher die Debugstufe ist, desto größer ist die Anzahl der angezeigten Nachrichten. Die Ebenen können zwischen 0 und 4 liegen.
-host TargetHost Gibt den Zielhost an, an den Sie eine Anforderung senden möchten. Dieses Ziel kann eine Internet Protocol -Adresse, ein Hostname oder ein winSNMP -Name in der Konfigurationsdatei clsnmp.conf sein. Wenn Sie keinen Host angeben, wird standardmäßig der lokale Host verwendet.
-timeout TimeoutValue Gibt die Zeit (in Sekunden) an, die der Befehl cl_snmp auf eine Antwort vom SNMP-Agenten wartet. Der Standardwert ist 3.
-retry RetryNumber Gibt an, wie oft der Befehl nach der Überschreitung des zulässigen Zeitlimits maximale wiederholt werden soll. Der Standardwert ist 2.
-max MaxRepetitions Gibt die Anzahl lexikografischer Nachfolger an, die für jedes Variablenbindungspaar nach den ersten -non Nachfolgern zurückgegeben werden sollen Der Parameter gilt nur für die getbulk -Anforderung. Dies wird ignoriert, wenn die Funktionsanforderung keine getbulk -Anforderung ist. Geben Sie beispielsweise ab dem Nachfolger -non number+ 1 -max number Nachfolger für jedes Variablenbindungspaar zurück. Der Standardwert ist 10.
-file ConfigurationFile Gibt den vollständigen Pfad und Dateinamen der Konfigurationsdatei an.
-port Portnummer Gibt die Nummer des Ports an, der auf Traps überwacht werden soll. Wenn keine Portnummer angegeben wird, ist die Trapfunktion cl_snmp am Standardport 162 empfangsbereit, dem Standardport für cl_snmp -Traps.
-verbose Gibt an, dass die Ausgabe einer Anforderung unter Verwendung einer ausführlichen Ausgabe angezeigt werden muss, z. B. unter Verwendung des Textnamens anstelle der MIB-Objekt-ID.
-non NonRepeaters Gibt die Anzahl der Variablenbindungspaare (Name/Wert) ab dem ersten an, für die nur ein einziger Nachfolger zurückgegeben wird. Dieser Parameter gilt nur für getbulk -Anforderungen. Dies wird ignoriert, wenn die Funktionsanforderung keine getbulk -Anforderung ist. Der Standardwert ist 0.
Funktion [MIB-Variable] [VariableType] [Wert] [...] Gibt die auszuführende SNMP-Funktion oder -Operation an. Dies ist eine der folgenden Funktionen:
  • abrufen
  • getnext
  • getbulk
  • einstellen
  • Walk-Operation
  • Fangzone
  • findname
MIB-Variable
Gibt das MIB-Objekt (MIB = Management Information Base) unter Verwendung seines Objektdeskriptors (Textname), der Objekt-ID in ASN.1 -Notation oder einer Kombination aus beidem an. Bei Verwendung mit der Funktion walk ist dies das MIB-Objektpräfix. Bei einem Präfix kann es sich um den führende Teil der vollständigen Objekt-ID handeln. Bei Verwendung mit dem Befehl findname wird diese Objekt-ID in der Notation ASN.1 angegeben.
Wert
Gibt den Wert an, der von der SET-Funktion festgelegt werden soll. Wenn Leerzeichen im Wert erforderlich sind, setzen Sie den Wert in Anführungszeichen. Wenn Sie eine Variable auf einen Wert setzen möchten, der ebenfalls ein Typ ist, müssen Sie den Typ angeben.
VariableType
Gibt den Typ des Werts an, der festgelegt wird Zum Ausführen einer SNMP-SET-Anforderung muss der SMI_type bekannt sein. Wenn kein Typ angegeben ist, durchsucht der Befehl cl_snmp zuerst die Datei /etc/mib.defs und anschließend die kompilierte MIB, um den Typ zu bestimmen. Wenn die Variable nicht gefunden wird, wird ein Fehler zurückgegeben. Wenn ein VariableType angegeben wird, hat der VariableType Vorrang vor allen Typen, die in der MIB zugeordnet werden können. Der VariableType und der Wert müssen kompatibel sein. Wenn Sie beispielsweise den Typ Zahl und den Wert fooangeben, wird ein Fehler zurückgegeben, da foo keine Zahl ist. Beim Variablentyp muss die Groß-/Kleinschreibung nicht beachtet werden. Gültige Variablentypen sind: (bitstring, counter, counter32, counter64, display oder displaystring, gauge, gauge32, integer, integer32, ipaddress, nsapaddress, null, objectidentifier oder OID, octetstring, opaque, opaqueascii, timeticks, uinteger)

Anfragentypen

Name des Anforderungstyps Beschreibung
findname Sendet eine Anforderung zum Suchen nach dem Textnamen für eine angegebene MIBVariable -Eingabe, deren interner ASN.1 -Wert am besten mit dem Eingabewert ASN.1 übereinstimmt. Bei der Suche wird zuerst die Datei /etc/mib.defs überprüft. Wenn kein übereinstimmender Textname gefunden wird, wird die Suche mit der kompilierten Management Information Base (MIB) fortgesetzt. Pro Aufruf von cl_snmp findname ist nur eine MIBVariable zulässig.
abrufen Sendet eine Anforderung an einen SNMP-Agenten für eine bestimmte MIB-Variable. Der Befehl cl_snmp wartet dann auf eine Antwort oder eine Zeitlimitüberschreitung.
getbulk Ruft den Wert der Variablen in der MIB-Struktur ab, der durch die Objekt-ID (OID) oder den MIB-Variablennamen angegeben wird Ein einzelner Befehl getbulk führt dieselbe Funktion wie eine Reihe von getnext -Befehlen aus, wobei weniger Daten zwischen dem Befehl cl_snmp und dem SNMP-Agenten ausgetauscht werden müssen.
getnext Sendet eine Anforderung für die nächste MIB-Variable, die der angegebenen MIB-Variablenlexikografisch folgt, an einen SNMP-Agenten. Der Befehl cl_snmp wartet dann auf eine Antwort oder eine Zeitlimitüberschreitung.
einstellen Sendet eine Anforderung zum Festlegen einer bestimmten MIBVariablean einen SNMP-Agenten. Der Befehl cl_snmp wartet dann auf eine Antwort oder eine Zeitlimitüberschreitung.
Fangzone Ist für SNMP-Traps empfangsbereit und zeigt Trapinformationen an, wenn sie auftreten. Verwendet den Standardport 162 oder die in der Option -port angegebene Portnummer. Die Funktion cl_snmp trap überwacht weiterhin Traps, bis der Prozess gestoppt oder abgebrochen wird.
Walk-Operation Setzt eine getnext -Anforderung für ein angegebenes Präfix ab und setzt anschließend die Ausgabe von getnext -Anforderungen fort, während Variablen vorhanden sind, die mit dem angegebenen Präfix übereinstimmen. Bei einem Präfix kann es sich um den führende Teil der vollständigen Objekt-ID handeln.

Exitstatus

Siehe Exit-Status für Virtual I/O Server -Befehle.

Beispiele

Führen Sie den folgenden Befehl aus, um eine SNMP-Anforderung auszugeben:
cl_snmp -host hostname get sysName.0

Zugehörige Informationen

Der Befehl snmp_info und der Befehl snmp_trap .