Dit is de opdracht pysnmptranslate die kan worden uitgevoerd in de gratis hostingprovider van OnWorks met behulp van een van onze meerdere gratis online werkstations zoals Ubuntu Online, Fedora Online, Windows online emulator of MAC OS online emulator
PROGRAMMA:
NAAM
pysnmpcmd - opties en gedrag die de meeste PySNMP-opdrachtregelprogramma's gemeen hebben
KORTE INHOUD
pysnmpcmd [OPTIES] AGENT [PARAMETERS]
PRODUCTBESCHRIJVING
Deze handleiding beschrijft de algemene opties voor de PySNMP-commando's: pysnmpbulkwandeling,
pysnmpget, pysnmpset, pysnmptranslate, pysnmpwandeling. De opdrachtregeltoepassingen gebruiken de
SNMP-protocol om te communiceren met een SNMP-compatibele netwerkentiteit, een agent. Individueel
toepassingen nemen meestal (maar niet noodzakelijkerwijs) aanvullende parameters die worden gegeven
na de agentspecificatie. Deze parameters zijn gedocumenteerd in de handleidingpagina's voor
elke toepassing.
OPTIES
-a authentificatieprotocol
Stel het verificatieprotocol (MD5 of SHA) in dat wordt gebruikt voor geverifieerde SNMPv3
berichten.
-A authWachtwoord
Stel de authenticatiewachtwoordzin in die wordt gebruikt voor geverifieerde SNMPv3-berichten.
-c gemeenschap
Stel de communitystring in voor SNMPv1/v2c-transacties.
-d Dump (in hexadecimaal) de onbewerkte SNMP-pakketten die zijn verzonden en ontvangen.
-D TOKEN[,...]
Schakel de foutopsporingsuitvoer in voor het gegeven TOKEN(s). Proberen allen voor extreem uitgebreid
uitgang.
-e motorID
Stel de gezaghebbende (beveiligings) engine-ID in die wordt gebruikt voor SNMPv3 REQUEST-berichten. Het is
meestal niet nodig om dit te specificeren, omdat het meestal zal worden ontdekt
automatisch.
-E motorID
Stel de context engineID in die wordt gebruikt voor SNMPv3 REQUEST-berichten scopedPdu. Als niet
opgegeven, wordt dit standaard de gezaghebbende engineID.
-H, --help
Geef een kort gebruiksbericht weer en sluit af.
-H Geef een lijst met configuratiebestandsrichtlijnen weer die door de opdracht worden begrepen en vervolgens
Uitgang.
-I [hu]
Specificeert opties voor het parseren van invoer. Zien INVOER OPTIES hieronder.
-l secNiveau
Stel het beveiligingsniveau in dat wordt gebruikt voor SNMPv3-berichten (noAuthNoPriv|authNoPriv|authPriv).
Passende wachtwoordzinnen moeten worden verstrekt bij gebruik van een niveau hoger dan
noAuthNoPriv.
-m MIBLIST
Specificeert een door dubbele punten gescheiden lijst van MIB-modules (geen bestanden) die hiervoor moeten worden geladen
toepassing.
Het speciale trefwoord ALLE wordt gebruikt om alle MIB-modules in de MIB-directoryzoekopdracht te laden
lijst. Elk bestand waarvan de naam niet begint met "." wordt geparseerd alsof het een
MIB-bestand.
-M DIRLIJST
Specificeert een door dubbele punten gescheiden lijst van mappen waarin naar MIB's moet worden gezocht. Merk op dat MIB's
opgegeven met de optie -m wordt geladen vanuit een van de mappen die worden vermeld door
de optie -M (of equivalenten).
-n contextNaam
Stel de contextName in die wordt gebruikt voor SNMPv3-berichten. De standaard contextName is leeg
snaar "".
-O [abeEfnqQsStTuUvxX]
Specificeert afdrukopties voor uitvoer. Zien OUTPUT OPTIES hieronder.
-r pogingen
Specificeert het aantal nieuwe pogingen dat moet worden gebruikt in de verzoeken. De standaardwaarde is 5.
-t time-out
Specificeert de time-out in seconden tussen nieuwe pogingen. De standaardwaarde is 1.
-u secNaam
Stel de securityName in die wordt gebruikt voor geverifieerde SNMPv3-berichten.
-v 1 | 2c | 3
Specificeert de te gebruiken protocolversie: 1 (RFC's 1155-1157), 2c (RFC's 1901-1908), of
3 (RFC's 2571-2574). De standaard is meestal versie 3.
-V, --versie
Geef versie-informatie voor de toepassing weer en sluit af.
-x privProtocol
Stel het privacyprotocol (DES of AES) in dat wordt gebruikt voor versleutelde SNMPv3-berichten.
-X privWachtwoord
Stel de privacywachtwoordzin in die wordt gebruikt voor versleutelde SNMPv3-berichten.
-Z laarzen, tijd
Stel de engineBoots en engineTime in die worden gebruikt voor geverifieerde SNMPv3-berichten. Dit
initialiseert de lokale notie van de agents boots/time met een authenticated
waarde opgeslagen in het LCD-scherm. Het is meestal niet nodig om deze optie op te geven, zoals
deze waarden worden meestal automatisch ontdekt.
AGENT SPECIFICATIE
De snaar AGENT in de KORTE INHOUD hierboven specificeert de externe SNMP-entiteit waarmee
communiceren. Deze specificatie heeft de vorm:
[ :]
Op zijn eenvoudigst, de AGENT specificatie kan bestaan uit een hostnaam of een IPv4-adres in
de standaard "dotted quad" notatie. In dit geval wordt geprobeerd te communiceren via
UDP/IPv4 naar poort 161 van de opgegeven host. Anders de deel van de
specificatie wordt geparseerd volgens de volgende tabel:
formaat
udp-hostnaam[:poort] or IPv4-adres[:poort]
Let daar op tekenreeksen zijn niet hoofdlettergevoelig, zodat bijvoorbeeld "tcp"
en "TCP" zijn equivalent. Hier zijn enkele voorbeelden, samen met hun interpretatie:
hostnaam:161 query uitvoeren met behulp van UDP/IPv4-datagrammen naar hostname op poort 161.
De ":161" is hier overbodig, aangezien dat de standaard SNMP-poort is
in elk geval.
udp:hostnaam identiek aan de vorige specificatie. De "udp:" is overbodig
hier aangezien UDP/IPv4 het standaardtransport is.
OUTPUT OPTIES
Het formaat van de uitvoer van SNMP-opdrachten kan worden geregeld met behulp van verschillende parameters van
the -O vlag. De effecten van deze subopties kunnen worden gezien in vergelijking met de
volgende standaarduitvoer (tenzij anders aangegeven):
$ snmpget -c public -v 1 localhost sysUpTime.0
SNMPv2-MIB::sysUpTime.0 = Tijdstips: (14096763) 1 dag, 15:09:27.63
- Oa Geef tekenreekswaarden weer als ASCII-tekenreeksen (tenzij er een DISPLAY-HINT is gedefinieerd voor
het overeenkomstige MIB-object). Standaard probeert de bibliotheek dit te bepalen
of de waarde een afdrukbare of binaire tekenreeks is, en geeft deze dienovereenkomstig weer.
Deze optie heeft geen invloed op objecten die do hebben een weergavehint.
-Ob Geef tabelindexen numeriek weer in plaats van te proberen de instantie te interpreteren
sub-ID's als string- of OID-waarden:
$ snmpgetnext -c public -v 1 localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0."wes" = xxx
$ snmpgetnext -c openbaar -v 1 -Ob localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0.3.119.101.115 = xxx
-Oe Verwijdert de symbolische labels van opsommingswaarden:
$ snmpget -c public -v 1 localhost ipForwarding.0
IP-MIB::ipForwarding.0 = INTEGER: expeditie(1)
$ snmpget -c publiek -v 1 -Oe localhost ipForwarding.0
IP-MIB::ipForwarding.0 = INTEGER: 1
-OE Wijzigt indexstrings om de aanhalingstekens te escapen:
$ snmpgetnext -c public -v 1 localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0."wes" = xxx
$ snmpgetnext -c openbaar -v 1 -OE localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0.\"wes\" = xxx
Hierdoor kan de uitvoer opnieuw worden gebruikt in shell-commando's.
-Van Neem de volledige lijst met MIB-objecten op bij het weergeven van een OID:
.iso.org.dod.internet.mgmt.mib-2.system.sysUpTime.0 =
Tijdstippen: (14096763) 1 dag, 15:09:27.63
-Op Geeft de OID numeriek weer:
.1.3.6.1.2.1.1.3.0 = Tijdstippen: (14096763) 1 dag, 15:09:27.63
-Ok Verwijdert het gelijkteken en type-informatie bij het weergeven van varbind-waarden:
SNMPv2-MIB::sysUpTime.0 1:15:09:27.63
-OK Verwijdert de type-informatie bij het weergeven van varbind-waarden:
SNMPv2-MIB::sysUpTime.0 = 1:15:09:27.63
-Jij Geef de MIB-objectnaam weer (plus eventuele instanties of andere sub-ID's):
sysUpTime.0 = Tijdstippen: (14096763) 1 dag, 15:09:27.63
-BOT Geef de naam van de MIB weer, evenals de objectnaam:
SNMPv2-MIB::sysUpTime.0 = Tijdstips: (14096763) 1 dag, 15:09:27.63
Dit is het standaard OID-uitvoerformaat.
-Ot Geef TimeTicks-waarden weer als onbewerkte getallen:
SNMPv2-MIB::sysUpTime.0 = 14096763
-OT Als waarden worden afgedrukt als Hex-tekenreeksen, geef dan ook een afdrukbare versie weer.
-U Geef de OID weer in de traditionele UCD-stijl (geërfd van de originele CMU
code). Dat betekent het verwijderen van een reeks "standaard" prefixen uit de OID, en
de resterende lijst met MIB-objectnamen weergeven (plus eventuele andere sub-ID's):
system.sysUpTime.0 = Tijdstippen: (14096763) 1 dag, 15:09:27.63
-OU Druk het achtervoegsel UNITS niet af aan het einde van de waarde.
-Ov Geef alleen de varbind-waarde weer, niet de OID:
$ snmpget -c publiek -v 1 -Oe localhost ipForwarding.0
GEHEEL GETAL: expeditie(1)
-Os Geef tekenreekswaarden weer als Hex-tekenreeksen (tenzij er een DISPLAY-HINT is gedefinieerd voor
het overeenkomstige MIB-object). Standaard probeert de bibliotheek dit te bepalen
of de waarde een afdrukbare of binaire tekenreeks is, en geeft deze dienovereenkomstig weer.
Deze optie heeft geen invloed op objecten die do hebben een weergavehint.
-OS Geef tabelindexen weer in een meer "programma-achtige" uitvoer, waarmee een traditioneel wordt nagebootst
indexindeling in arraystijl:
$ 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 = INTEGER: 2
$ snmpgetnext -c openbaar -v 1 -OE localhost ipv6Routetabel
IPv6-MIB::ipv6RouteIfIndex[3ffe:100:ff00:0:0:0:0:0][64][1] = INTEGER: 2
De meeste van deze opties kunnen ook worden geconfigureerd via configuratietokens. Zie de
snmp.conf(5) handleiding voor details.
INVOER OPTIES
De interpretatie van invoerobjectnamen en de toe te kennen waarden kunnen worden gecontroleerd
met behulp van verschillende parameters van de -I vlag. Het standaardgedrag wordt beschreven op de
einde van dit gedeelte.
-Ib geeft aan dat de opgegeven naam moet worden beschouwd als een reguliere expressie om overeen te komen
(niet hoofdlettergevoelig) tegen objectnamen in de MIB-structuur. De "beste" match zal
worden gebruikt - berekend als degene die het dichtst bij het begin van de komt
knooppuntnaam en de hoogste in de boom. Bijvoorbeeld het MIB-object
vacmSecurityModel kan overeenkomen met de uitdrukking vacmsecuritymodel (volledige naam,
maar ander geval), of vacm.*model (regexp-patroon).
Let daar op '.' is een speciaal teken in reguliere expressiepatronen, dus de
expressie kan geen instantie-sub-ID's of meer dan één objectnaam specificeren. A
"best match"-expressie wordt alleen toegepast op enkele MIB-objectnamen. Voor
bijvoorbeeld de uitdrukking sys*contact.0 zou niet overeenkomen met de instantie sysContact.0
(hoewel sys*contact zou overeenkomen met sysContact). Evenzo specificeert u een MIB-module
naam lukt niet (dus SNMPv2-MIB::sys.*contact zou ook niet passen).
-Ik schakelt het gebruik van DISPLAY-HINT-informatie uit bij het toewijzen van waarden. Dit zou
vereist dan het verstrekken van de ruwe waarde:
snmpset ... HOST-BRONNEN-MIB::hrSystemData.0
x "07 D2 0C 0A 02 04 06 08"
in plaats van een geformatteerde versie:
snmpset ... HOST-BRONNEN-MIB::hrSystemDate.0
= 2002-12-10,2:4:6.8
-En schakelt het controleren van tabelindexen uit en de waarde die moet worden toegewezen aan de relevante
MIB-definities. Dit zal er (hopelijk) toe leiden dat de externe agent een melding maakt
ongeldig verzoek, in plaats van dit te controleren (en af te wijzen) voordat het naar de
agent op afstand.
Lokale controles zijn efficiënter (en de verstrekte diagnoses zijn meestal ook meer
precies), maar het uitschakelen van dit gedrag is vooral handig bij het testen van de
agent op afstand.
-GAAN maakt "willekeurige toegang" opzoeken van MIB-namen mogelijk. In plaats van een volledig OID-pad te bieden
naar het gewenste MIB-object (of dit object kwalificeren met een expliciete MIB-module
naam), wordt in de MIB-structuur gezocht naar de overeenkomende objectnaam. Dus
.iso.org.dod.internet.mib-2.system.sysDescr.0 (of SNMPv2-MIB::sysDescr.0) kan
gewoon gespecificeerd als sysDescr.0.
Waarschuwing:
Aangezien MIB-objectnamen niet wereldwijd uniek zijn, kan deze benadering een
ander MIB-object, afhankelijk van welke MIB-bestanden zijn geladen.
De MIB-MODULE::objectNaam syntaxis heeft het voordeel van een unieke identificatie van een
bepaald MIB-object, maar ook iets efficiënter (en automatisch
indien nodig het benodigde MIB-bestand laden).
-Is ACHTERVOEGSEL
voegt het opgegeven achtervoegsel toe aan elke tekstuele OID die op de opdrachtregel wordt gegeven. Dit kan
worden gebruikt om meerdere objecten uit dezelfde rij van een tabel op te halen, door een
gemeenschappelijke indexwaarde.
-ES VOORVOEGSEL
voegt het opgegeven voorvoegsel toe aan elke tekstuele OID die op de opdrachtregel wordt gegeven. Dit kan
worden gebruikt om een expliciete MIB-modulenaam op te geven voor alle objecten die worden opgehaald (of
voor ongeneeslijk luie typisten).
-Iu maakt de traditionele benadering in UCD-stijl mogelijk voor het interpreteren van invoer-OID's. Dit
gaat ervan uit dat OID's zijn geroot op het 'mib-2'-punt in de boom (tenzij ze beginnen
met een expliciete '.' of neem een MIB-modulenaam op). Dus de sysDescr-instantie hierboven
zou worden verwezen als system.sysDescr.0.
Objectnamen gespecificeerd met een '.' worden altijd geïnterpreteerd als "volledig gekwalificeerd"
OID's, met de volgorde van MIB-objecten vanaf de hoofdmap van de MIB-structuur. Dergelijke objecten en
degenen die worden gekwalificeerd door een expliciete MIB-modulenaam worden niet beïnvloed door de -Ib, -GAAN en -Iu
vlaggen.
Anders, als geen van de bovenstaande invoeropties is opgegeven, wordt het standaardgedrag voor a
"Relatieve" OID is om te proberen het te interpreteren als een (impliciet) volledig gekwalificeerde OID
toepassen "willekeurige toegang" lookup (-GAAN), gevolgd door "beste overeenkomst" patroonovereenkomst (-Ib).
MILIEU VARIABELEN
PREFIX Het standaardvoorvoegsel voor object-ID's (bij gebruik van uitvoer in UCD-stijl). Standaardinstellingen
naar .iso.org.dod.internet.mgmt.mib-2
MIBS De lijst met te laden MIB's. Standaard ingesteld op SNMPv2-TC:SNMPv2-MIB:IF-MIB:IP-MIB:TCP-
MIB:UDP-MIB:SNMP-VACM-MIB. Overschreven door de -m optie.
MIBDIRS
De lijst met mappen om te zoeken naar MIB's. Standaard ingesteld op DATADIR/snmp/mibs.
Overschreven door de -M optie.
Gebruik pysnmptranslate online met behulp van onworks.net-services
