cvs: phpdoc /de/functions snmp.xml

jan Sun Nov 25 15:46:02 2001 EDT Modified files: /phpdoc/de/functions snmp.xml Log: synced up to revision 1.18

Index: phpdoc/de/functions/snmp.xml diff -u phpdoc/de/functions/snmp.xml:1.8 phpdoc/de/functions/snmp.xml:1.9 --- phpdoc/de/functions/snmp.xml:1.8 Wed Nov 14 17:07:54 2001 +++ phpdoc/de/functions/snmp.xml Sun Nov 25 15:46:02 2001 @@ -5,8 +5,9 @@ <partintro> <simpara> - Um die SNMP Funktionen nutzen zu können muss das <ulink url="&url.ucd-snmp;">UCD SNMP</ulink> Paket installiert sein. - Unter Windows sind diese Funktionen nru unter NT verfügbar, nicht aber unter Win95/98 + Um die SNMP Funktionen unter Unix nutzen zu können muss das <ulink url="&url.ucd-snmp;">UCD SNMP</ulink> + Paket installiert sein. Unter Windows sind diese Funktionen nur unter NT verfügbar, nicht aber + unter Win95/98. </simpara> <simpara> @@ -14,12 +15,13 @@ Nache dem Konfigureieren UCD SNMP muss in der Datei config.h die Zeile mit NO_ZEROLENGTH_COMMUNITY auskommentiert werden. Die Zeile sollte danach so aussehen:</simpara> - <para> - <programlisting> + <para> + <programlisting role="c"> +<![CDATA[ #define NO_ZEROLENGTH_COMMUNITY 1 +]]> </programlisting> </para> - <simpara> Wenn seltsame "segmentation faults" in Verbindung mit SNMP Kommandos auftauchen, wurden die obigen Anweisungen nicht korrekt befolgt. @@ -57,7 +59,9 @@ <para> <informalexample> <programlisting role="php"> +<![CDATA[ $syscontact = snmpget("127.0.0.1", "public", "system.SysContact.0"); +]]> </programlisting> </informalexample> </para> @@ -68,7 +72,7 @@ <refentry id="function.snmpset"> <refnamediv> <refname>snmpset</refname> - <refpurpose>Set an SNMP object</refpurpose> + <refpurpose>Setzt ein SNMP Objekt</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -86,15 +90,18 @@ </funcsynopsis> <para> + Setzt den angegebenen SNMP Objekt Wert, gibt &true; bei Erfolg + und &false; bei einem Fehler zurück. Sets the specified SNMP object value, returning &true; on success - and &false; on error.</para> + </para> <para> - The <function>snmpset</function> function is used - to set the value of an SNMP object specified by the - <parameter>object_id</parameter>. SNMP agent is specified by the - <parameter>hostname</parameter> and the read community is specified - by the <parameter>community</parameter> parameter.</para> + Die Funktion <function>snmpset</function> wird benutzt, um den Wert + eines SNMP Objekts zu setzen, der mit <parameter>object_id</parameter> + angegeben wird. Der SNMP Agent wird bei <parameter>hostname</parameter> + angegeben und die Lese-"Community" mit dem <parameter>community</parameter> + Parameter. + </para> </refsect1> </refentry> @@ -102,10 +109,10 @@ <refentry id="function.snmpwalk"> <refnamediv> <refname>snmpwalk</refname> - <refpurpose>Fetch all the SNMP objects from an agent</refpurpose> + <refpurpose>Holt alle SNMP Objekte eines Agenten</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>array <function>snmpwalk</function></funcdef> @@ -120,36 +127,40 @@ </funcsynopsis> <para> - Returns an array of SNMP object values starting from the - <function>object_id</function> as root and &false; on error.</para> + Gibt einen Array von SNMP Objekten zurück, der mit der + <function>object_id</function> als Wurzel beginn, oder &false; + bei einem Fehler. + </para> <para> - <function>snmpwalk</function> function is used to read all the - values from an SNMP agent specified by the - <parameter>hostname</parameter>. <parameter>Community</parameter> - specifies the read community for that agent. A &null; - <parameter>object_id</parameter> is taken as the root of the SNMP - objects tree and all objects under that tree are returned as an - array. If <parameter>object_id</parameter> is specified, all the - SNMP objects below that <parameter>object_id</parameter> are - returned. + Die <function>snmpwalk</function> Funktion wird verwendet um alle Werte von + dem SNMP Agenten zu lesen, der bei <parameter>hostname</parameter> angegebn + wurde. Der <parameter>Community</parameter> Parameter bestimm die Lese-"Community" + für diesen Agenten. Ein &null; <parameter>object_id</parameter> wird als Wurzel des + SNMP Objektbaums verwendet und alle Objekts unter diesem Baum als ein Array + zurückgegeben. Wenn <parameter>object_id</parameter> angegeben wird, werden alle + SNMP Objekte unterhalb der <parameter>object_id</parameter> zurückgegeben. <informalexample> <programlisting role="php"> +<![CDATA[ $a = snmpwalk("127.0.0.1", "public", ""); +]]> </programlisting> </informalexample></para> <para> - Above function call would return all the SNMP objects from the - SNMP agent running on localhost. One can step through the values - with a loop + Der obige Funktionsaufruf gibt alle SNMP Objekte des Agenten, der auf + localhost läuft, zurück. Man kann mit einer Schleife alle Werte + durchlaufen. <informalexample> <programlisting role="php"> -for ($i=0; $i&lt;count($a); $i++) { +<![CDATA[ +for ($i=0; $i < count($a); $i++) { echo $a[$i]; } +]]> </programlisting> </informalexample></para> @@ -160,11 +171,11 @@ <refentry id="function.snmpwalkoid"> <refnamediv> <refname>snmpwalkoid</refname> - <refpurpose>Query for a tree of information about a network entity + <refpurpose>Abfrage über einen Baum einer Netzwerkeinheit. </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>array <function>snmpwalkoid</function></funcdef> @@ -179,45 +190,46 @@ </funcsynopsis> <para> - Returns an associative array with object ids and their respective - object value starting from the <parameter>object_id</parameter> - as root and &false; on error.</para> - - <para> - <function>snmpwalkoid</function> function is used to read all - object ids and their respective values from an SNMP agent - specified by the hostname. Community specifies the read - <parameter>community</parameter> for that agent. A &null; - <parameter>object_id</parameter> is taken as the root of the SNMP - objects tree and all objects under that tree are returned as an - array. If <parameter>object_id</parameter> is specified, all the - SNMP objects below that <parameter>object_id</parameter> are - returned.</para> - - <para> - The existence of <function>snmpwalkoid</function> and - <function>snmpwalk</function> has historical reasons. Both - functions are provided for backward compatibility. + Gibt ein assoziatives Array mit den Objekt Ids und den dazugehörigen + Objektwerten zurück, der mit der <parameter>object_id</parameter> als + Wurzel beginnt, oder &false; bei einem Fehler.</para> - <informalexample> + <para> + Die <function>snmpwalkoid</function> Funktion wird verwendet um alle Werte von + dem SNMP Agenten zu lesen, der bei <parameter>hostname</parameter> angegebn + wurde. Der <parameter>Community</parameter> Parameter bestimm die Lese-"Community" + für diesen Agenten. Ein &null; <parameter>object_id</parameter> wird als Wurzel des + SNMP Objektbaums verwendet und alle Objekts unter diesem Baum als ein Array + zurückgegeben. Wenn <parameter>object_id</parameter> angegeben wird, werden alle + SNMP Objekte unterhalb der <parameter>object_id</parameter> zurückgegeben.</para> + + <para> + Die Existenz von <function>snmpwalkoid</function> und + <function>snmpwalk</function> hat historische Gründe. Beide Funktionen gibt es + aus Kompatiblitätsgründen. + + <informalexample> <programlisting role="php"> +<![CDATA[ $a = snmpwalkoid("127.0.0.1", "public", ""); +]]> </programlisting> </informalexample></para> <para> - Above function call would return all the SNMP objects from the - SNMP agent running on localhost. One can step through the values - with a loop + Der obige Funktionsaufruf gibt alle SNMP Objekte des Agenten, der auf + localhost läuft, zurück. Man kann mit einer Schleife alle Werte + durchlaufen. <informalexample> <programlisting role="php"> -for (reset($a); $i = key($a); next($a)) { - echo "$i: $a[$i]&lt;br>\n"; +<![CDATA[ +for ($i=0; $i < count($a); $i++) { + echo $a[$i]; } +]]> </programlisting> </informalexample></para> - </refsect1> </refentry> @@ -225,7 +237,7 @@ <refentry id="function.snmp-get-quick-print"> <refnamediv> <refname>snmp_get_quick_print</refname> - <refpurpose>Fetch the current value of the UCD library's quick_print setting + <refpurpose>Holt den aktuellen Wert der quick_print Einstellung der UCD Bibliothek </refpurpose> </refnamediv> <refsect1> @@ -238,28 +250,29 @@ </funcsynopsis> <para> - Returns the current value stored in the UCD Library for quick_print. - quick_print is off by default. + Gibt den aktuellen Wert von quick_print der UCD Bibliothek zurück. + quick_print ist standartmäßig abgeschaltet. <informalexample> <programlisting role="php"> +<![CDATA[ $quickprint = snmp_get_quick_print(); +]]> </programlisting> </informalexample></para> <para> - Above function call would return <systemitem>&false;</systemitem> if - quick_print is on, and <systemitem>&true;</systemitem> if quick_print - is on.</para> + Der obige Funktionsaufruf gibt <systemitem>&false;</systemitem> zurück, wenn + quick_print ausgeschaltet ist und <systemitem>&true;</systemitem>, wenn quick_print + eingeschaltet ist.</para> <para> - <function>snmp_get_quick_print</function> is only available when using - the UCD SNMP library. This function is not available when using the - Windows SNMP library.</para> + Die <function>snmp_get_quick_print</function> Funktion ist nur bei Verwendung der + SNMP Bibliothek verfügbar, jedoch nicht bei Verwendung der Windows SNMP Bibliothek.</para> <para> - See: <function>snmp_set_quick_print</function> for a full description - of what quick_print does.</para> + Siehe: <function>snmp_set_quick_print</function> für eine Vollständie Beschreibung was + quick_print bewirkt..</para> </refsect1> </refentry> @@ -267,11 +280,11 @@ <refentry id="function.snmp-set-quick-print"> <refnamediv> <refname>snmp_set_quick_print</refname> - <refpurpose>Set the value of quick_print within the UCD SNMP library. + <refpurpose>Setzt den Wert von quick_print innerhalb der UCD SNMP Bibliothek. </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>void <function>snmp_set_quick_print</function></funcdef> @@ -280,45 +293,46 @@ </funcsynopsis> <para> - Sets the value of quick_print within the UCD SNMP library. When this - is set (1), the SNMP library will return 'quick printed' values. This - means that just the value will be printed. When quick_print is not - enabled (default) the UCD SNMP library prints extra information - including the type of the value (i.e. IpAddress or OID). Additionally, - if quick_print is not enabled, the library prints additional hex values - for all strings of three characters or less.</para> + Setzt den Wert von quick_print innerhalb der UCD SNMP Bibliothek. + Falls esgesetzt ist (1), wird die SNMP Bibliothek 'quick printed' Werte zurückgeben. + Das Bedeutet, dass nur der Wert ausgegeben wird. Wenn quick_print nicht aktiviert ist, + (Standarteinstellung) gibt die UCD SNMP Bibliothek extra Informationen aus, die den Typ + des Wertes (z.B. IpAddress oder OID) enhalten. Zusätzlich gibt die Bibliothek Hex-Werte + für alle Werte, die weniger als vier Zeichen haben, aus, wenn quick_print nicht aktiviert ist. + </para> <para> - Setting quick_print is often used when using the information returned - rather then displaying it. + quick_print wird oft verwendet um die Informationen, die zurückgegeben werden, weiterzuverwenden + anstatt sie auszugeben. <informalexample> <programlisting role="php"> +<![CDATA[ snmp_set_quick_print(0); $a = snmpget("127.0.0.1", "public", ".1.3.6.1.2.1.2.2.1.9.1"); -echo "$a&lt;BR>\n"; +echo "$a<BR>\n"; snmp_set_quick_print(1); $a = snmpget("127.0.0.1", "public", ".1.3.6.1.2.1.2.2.1.9.1"); -echo "$a&lt;BR>\n"; +echo "$a<BR>\n"; +]]> </programlisting> </informalexample></para> <para> - The first value printed might be: 'Timeticks: (0) 0:00:00.00', whereas - with quick_print enabled, just '0:00:00.00' would be printed.</para> + Der erste Wert, der ausgegeben wird, ist:: 'Timeticks: (0) 0:00:00.00', waehrend mit + aktiviertem quick_print, nur '0:00:00.00' ausgegeben wird.</para> <para> - By default the UCD SNMP library returns verbose values, quick_print is - used to return only the value.</para> + Standartmäßig gibt die UCD SNMP umfangreiche Werte zurück, quick_print wird + verwendet um nur die Werte zurückzugeben.</para> <para> - Currently strings are still returned with extra quotes, this will be - corrected in a later release.</para> + Momentan werden Strings noch mit extra Quotierungen zurückgegeben, dies wird in Zukunft + behoben werden.</para> <para> - <function>snmp_set_quick_print</function> is only available when using - the UCD SNMP library. This function is not available when using - the Windows SNMP library.</para> + Die <function>snmp_set_quick_print</function> Funktion ist nur bei Verwendung der + SNMP Bibliothek verfügbar, jedoch nicht bei Verwendung der Windows SNMP Bibliothek.</para> </refsect1> </refentry>