diff --git a/reference/snmp/functions/snmpgetnext.xml b/reference/snmp/functions/snmpgetnext.xml new file mode 100644 index 000000000..013cb1c60 --- /dev/null +++ b/reference/snmp/functions/snmpgetnext.xml @@ -0,0 +1,105 @@ + + + + + + snmpgetnext + + Liest das SNMP-Objekt, das auf die angegebene Object ID (OID) folgt + + + + &reftitle.description; + + mixedsnmpgetnext + stringhostname + stringcommunity + arraystringobject_id + inttimeout-1 + intretries-1 + + + + Die Funktion snmpgetnext wird verwendet, um den + Wert des SNMP-Objekts zu lesen, das auf die angegebene + object_id folgt. + + + + + &reftitle.parameters; + + + hostname + Der Hostname des SNMP-Agenten (Servers). + + + community + Die Lese-Community. + + + object_id + Die Object ID (OID) des SNMP-Objekts, das dem gewünschten vorangeht. + + + timeout + Die Anzahl der Mikrosekunden bis zur ersten Zeitüberschreitung. + + + retries + Die Anzahl der Wiederholungsversuche, falls Zeitüberschreitungen auftreten. + + + + + + &reftitle.returnvalues; + + Gibt bei Erfolg den Wert des SNMP-Objekts zurück oder &false; im Fehlerfall. + Im Fehlerfall wird eine E_WARNING-Meldung ausgegeben. + + + + + &reftitle.examples; + + Verwendung von <function>snmpgetnext</function> + + +]]> + + + + + + &reftitle.seealso; + + snmpget + snmpwalk + + + + + diff --git a/reference/snmp/snmp/getnext.xml b/reference/snmp/snmp/getnext.xml new file mode 100644 index 000000000..ddfae91e4 --- /dev/null +++ b/reference/snmp/snmp/getnext.xml @@ -0,0 +1,139 @@ + + + + + + SNMP::getnext + Liest ein SNMP-Objekt, das + auf die angegebene Object ID (OID) folgt + + + + + &reftitle.description; + + + public mixedSNMP::getnext + arraystringobjectId + + + Liest ein SNMP-Objekt, das auf die angegebene objectId folgt. + + + + + &reftitle.parameters; + + Ist objectId eine Zeichenkette, so gibt SNMP::getnext + das SNMP-Objekt als Zeichenkette zurück. Ist + objectId ein Array, so werden alle angeforderten SNMP-Objekte + als assoziatives Array der Object IDs (OIDs) der SNMP-Objekte und ihrer + Werte zurückgegeben. + + + + objectId + + + Das SNMP-Objekt (OID) oder die Objekte + + + + + + + + &reftitle.returnvalues; + + Gibt die angeforderten SNMP-Objekte als Zeichenkette oder Array + zurück, abhängig vom Typ der objectId, oder &false; im Fehlerfall. + + + + &snmp.methods.exceptions_enable.refsect; + + + &reftitle.examples; + + Einzelnes <acronym>SNMP</acronym>-Objekt + + Ein einzelnes SNMP-Objekt kann auf zwei Arten angefordert werden: als + Zeichenkette, was einen Rückgabewert vom Typ Zeichenkette ergibt, oder als einelementiges Array + mit einem assoziativen Array als Ausgabe. + + +getnext("sysDescr.0"); + echo "$nsysdescr\n"; + $nsysdescr = $session->getnext(array("sysDescr.0")); + print_r($nsysdescr); +?> +]]> + + &example.outputs.similar; + + OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 +) +]]> + + + + Mehrere <acronym>SNMP</acronym>-Objekte + +getnext(array("sysDescr.0", "sysName.0")); + print_r($results); + $session->close(); +?> +]]> + + &example.outputs.similar; + + OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 + [SNMPv2-MIB::sysLocation.0] => STRING: Nowhere +) +]]> + + + + + + &reftitle.seealso; + + SNMP::getErrno + SNMP::getError + + + + + diff --git a/reference/snmp/snmp/walk.xml b/reference/snmp/snmp/walk.xml new file mode 100644 index 000000000..0b9fd2aa3 --- /dev/null +++ b/reference/snmp/snmp/walk.xml @@ -0,0 +1,192 @@ + + + + + + SNMP::walk + Liest einen SNMP-Objektteilbaum + + + + &reftitle.description; + + + public arrayfalseSNMP::walk + arraystringobjectId + boolsuffixAsKey&false; + intmaxRepetitions-1 + intnonRepeaters-1 + + + SNMP::walk wird verwendet, um den SNMP-Teilbaum zu lesen, dessen Wurzel die angegebene objectId ist. + + + + + &reftitle.parameters; + + + objectId + + + Wurzel des zu lesenden Teilbaums + + + + + suffixAsKey + + + Standardmäßig wird die vollständige OID-Notation für die Schlüssel im Ausgabe-Array verwendet. + Ist dieser Parameter auf &true; gesetzt, wird der Teilbaum-Präfix aus den Schlüsseln entfernt, sodass nur das Suffix der object_id übrig bleibt. + + + + + nonRepeaters + + + Dies gibt die Anzahl der übergebenen Variablen an, über die nicht iteriert werden soll. + Standardmäßig wird dieser Wert aus dem SNMP-Objekt verwendet. + + + + + maxRepetitions + + + Dies gibt die maximale Anzahl der Iterationen über die sich wiederholenden Variablen an. + Standardmäßig wird dieser Wert aus dem SNMP-Objekt verwendet. + + + + + + + + &reftitle.returnvalues; + + Gibt bei Erfolg ein assoziatives Array der Object IDs (OIDs) der SNMP-Objekte und ihrer Werte zurück oder &false; im Fehlerfall. + Tritt ein SNMP-Fehler auf, können SNMP::getErrno und + SNMP::getError verwendet werden, um die Fehlernummer + (spezifisch für die SNMP-Erweiterung, siehe die Klassenkonstanten) beziehungsweise die + Fehlermeldung abzurufen. + + + + &snmp.methods.exceptions_enable.refsect; + + + &reftitle.examples; + + Beispiel für <methodname>SNMP::walk</methodname> + +walk("."); + print_r($fulltree); + $session->close(); +?> +]]> + + &example.outputs.similar; + + STRING: Test server + [SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 + [DISMAN-EVENT-MIB::sysUpTimeInstance] => Timeticks: (1150681750) 133 days, 4:20:17.50 + [SNMPv2-MIB::sysContact.0] => STRING: Nobody + [SNMPv2-MIB::sysName.0] => STRING: server.localdomain + ... +) +]]> + + + + Beispiel für <parameter>suffixAsKey</parameter> + + suffixAsKey kann verwendet werden, wenn mehrere SNMP-Teilbäume zu einem zusammengeführt werden. + Dieses Beispiel ordnet Schnittstellennamen ihrem Typ zu. + + +valueretrieval = SNMP_VALUE_PLAIN; + $ifDescr = $session->walk(".1.3.6.1.2.1.2.2.1.2", TRUE); + $session->valueretrieval = SNMP_VALUE_LIBRARY; + $ifType = $session->walk(".1.3.6.1.2.1.2.2.1.3", TRUE); + print_r($ifDescr); + print_r($ifType); + $result = array(); + foreach($ifDescr as $i => $n) { + $result[$n] = $ifType[$i]; + } + print_r($result); +?> +]]> + + &example.outputs.similar; + + igb0 + [2] => igb1 + [3] => ipfw0 + [4] => lo0 + [5] => lagg0 +) +Array +( + [1] => INTEGER: ieee8023adLag(161) + [2] => INTEGER: ieee8023adLag(161) + [3] => INTEGER: ethernetCsmacd(6) + [4] => INTEGER: softwareLoopback(24) + [5] => INTEGER: ethernetCsmacd(6) +) +Array +( + [igb0] => INTEGER: ieee8023adLag(161) + [igb1] => INTEGER: ieee8023adLag(161) + [ipfw0] => INTEGER: ethernetCsmacd(6) + [lo0] => INTEGER: softwareLoopback(24) + [lagg0] => INTEGER: ethernetCsmacd(6) +) +]]> + + + + + + &reftitle.seealso; + + SNMP::getErrno + SNMP::getError + + + + +