php/archived-doc-es
1
0
Fork 0
mirror of https://github.com/php/doc-es.git synced 2026-03-23 23:12:09 +01:00
Code Issues Packages Projects Releases Wiki Activity

snmp: fix XML to remove useless wrapping para tags via script

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-26 15:35:40 +00:00
parent f05bfd7d2f
commit 993ecaf52a
26 changed files with 722 additions and 849 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
reference/snmp/functions/snmp-get-quick-print.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9f7b578adf85bcbc94397c11a7a813d1d3d0cc56 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp-get-quick-print" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-get-quick-print">
<refnamediv>
<refname>snmp_get_quick_print</refname>
<refpurpose>
@@ -36,32 +36,27 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp_get_quick_print</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp_get_quick_print</function></title>
<programlisting role="php">
<![CDATA[
<?php
$quickprint = snmp_get_quick_print();
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp_set_quick_print</function> para una descripción completa
sobre lo que hace quick_print.</member>
</simplelist>
</para>
<simplelist>
<member><function>snmp_set_quick_print</function> para una descripción completa
sobre lo que hace quick_print.</member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

32
reference/snmp/functions/snmp-get-valueretrieval.xml
View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 64bab6321fe7aec300303dcedfddfcb31fb053c2 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp-get-valueretrieval" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp-get-valueretrieval">
<refnamediv>
<refname>snmp_get_valueretrieval</refname>
<refpurpose>
@@ -35,10 +34,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp_get_valueretrieval</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp_get_valueretrieval</function></title>
<programlisting role="php">
<![CDATA[
<?php
$ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
@@ -49,25 +47,21 @@
}
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member>
<function>snmp_set_valueretrieval</function>
</member>
<member><xref linkend="snmp.constants" /></member>
</simplelist>
</para>
<simplelist>
<member>
<function>snmp_set_valueretrieval</function>
</member>
<member><xref linkend="snmp.constants"/></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

31
reference/snmp/functions/snmp-read-mib.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 73fae4ee51b644b72028e610abefefced57c18ad Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp-read-mib" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-read-mib">
<refnamediv>
<refname>snmp_read_mib</refname>
<refpurpose>
@@ -30,14 +30,12 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem><para>El nombre del fichero <acronym>MIB</acronym>.</para></listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem><para>El nombre del fichero <acronym>MIB</acronym>.</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -49,10 +47,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp_read_mib</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp_read_mib</function></title>
<programlisting role="php">
<![CDATA[
<?php
print_r( snmprealwalk('localhost', 'public', '.1.3.6.1.2.1.2.3.4.5') );
@@ -61,9 +58,8 @@
print_r( snmprealwalk('localhost', 'public', 'FOO-BAR-MIB::someTable') );
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
<para>
El ejemplo a continuación mostrará algo como:
<![CDATA[
@@ -80,7 +76,6 @@ Array
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

44
reference/snmp/functions/snmp-set-enum-print.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2ca090342977839edca2f7f4e52305a1b5da6095 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp-set-enum-print" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-set-enum-print">
<refnamediv>
<refname>snmp_set_enum_print</refname>
<refpurpose>
@@ -46,29 +46,26 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&return.type.true;
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&return.type.true;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp_set_enum_print</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp_set_enum_print</function></title>
<programlisting role="php">
<![CDATA[
<?php
snmp_set_enum_print(0);
@@ -77,9 +74,8 @@
echo snmpget('localhost', 'public', 'IF-MIB::ifOperStatus.3') . "\n";
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
<para>
El ejemplo anterior mostrará:
<![CDATA[

13
reference/snmp/functions/snmp-set-oid-numeric-print.xml
View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 00b214a0c59b1ace0dc975c66ac77ad57d1f01f9 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp-set-oid-numeric-print" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-set-oid-numeric-print">
<refnamediv>
<refname>snmp_set_oid_numeric_print</refname>
<refpurpose>&Alias; <function>snmp_set_oid_output_format</function></refpurpose>
@@ -18,11 +17,9 @@
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp_set_oid_output_format</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmp_set_oid_output_format</function></member>
</simplelist>
</refsect1>
</refentry>

92
reference/snmp/functions/snmp-set-oid-output-format.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2ca090342977839edca2f7f4e52305a1b5da6095 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp-set-oid-output-format" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-set-oid-output-format">
<refnamediv>
<refname>snmp_set_oid_output_format</refname>
<refpurpose>Define el formato de salida OID</refpurpose>
@@ -21,28 +21,26 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<table>
<title>Representación OID .1.3.6.1.2.1.1.3.0 para varios valores de <parameter>format</parameter></title>
<tgroup cols="2">
<tbody>
<row><entry><constant>SNMP_OID_OUTPUT_FULL</constant></entry><entry>.iso.org.dod.internet.mgmt.mib-2.system.sysUpTime.sysUpTimeInstance</entry></row>
<row><entry><constant>SNMP_OID_OUTPUT_NUMERIC</constant></entry><entry>.1.3.6.1.2.1.1.3.0</entry> </row>
<row><entry><constant>SNMP_OID_OUTPUT_MODULE</constant></entry><entry>DISMAN-EVENT-MIB::sysUpTimeInstance</entry></row>
<row><entry><constant>SNMP_OID_OUTPUT_SUFFIX</constant></entry><entry>sysUpTimeInstance</entry></row>
<row><entry><constant>SNMP_OID_OUTPUT_UCD</constant></entry><entry>system.sysUpTime.sysUpTimeInstance</entry></row>
<row><entry><constant>SNMP_OID_OUTPUT_NONE</constant></entry><entry>Undefined</entry></row>
</tbody>
</tgroup>
</table>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<table>
<title>Representación OID .1.3.6.1.2.1.1.3.0 para varios valores de <parameter>format</parameter></title>
<tgroup cols="2">
<tbody>
<row><entry><constant>SNMP_OID_OUTPUT_FULL</constant></entry><entry>.iso.org.dod.internet.mgmt.mib-2.system.sysUpTime.sysUpTimeInstance</entry></row>
<row><entry><constant>SNMP_OID_OUTPUT_NUMERIC</constant></entry><entry>.1.3.6.1.2.1.1.3.0</entry> </row>
<row><entry><constant>SNMP_OID_OUTPUT_MODULE</constant></entry><entry>DISMAN-EVENT-MIB::sysUpTimeInstance</entry></row>
<row><entry><constant>SNMP_OID_OUTPUT_SUFFIX</constant></entry><entry>sysUpTimeInstance</entry></row>
<row><entry><constant>SNMP_OID_OUTPUT_UCD</constant></entry><entry>system.sysUpTime.sysUpTimeInstance</entry></row>
<row><entry><constant>SNMP_OID_OUTPUT_NONE</constant></entry><entry>Undefined</entry></row>
</tbody>
</tgroup>
</table>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -54,29 +52,26 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&return.type.true;
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&return.type.true;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmprealwalk</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmprealwalk</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -92,10 +87,10 @@
print_r( snmprealwalk('localhost', 'public', 'RFC1213-MIB::sysObjectID') );
?>
]]>
</programlisting>
</programlisting>
<para>
El ejemplo anterior mostrará:
<para>
El ejemplo anterior mostrará:
<![CDATA[
Array
(
@@ -110,9 +105,8 @@
[.iso.org.dod.internet.mgmt.mib-2.system.sysObjectID.0] => OID: .iso.org.dod.internet.private.enterprises.netSnmp.netSnmpEnumerations.netSnmpAgentOIDs.linux
)
]]>
</para>
</example>
</para>
</para>
</example>
</refsect1>
</refentry>

78
reference/snmp/functions/snmp-set-quick-print.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2ca090342977839edca2f7f4e52305a1b5da6095 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp-set-quick-print" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-set-quick-print">
<refnamediv>
<refname>snmp_set_quick_print</refname>
<refpurpose>Escribe el valor actual de la opción <parameter>enable</parameter> de la biblioteca NET-<acronym>SNMP</acronym></refpurpose>
@@ -36,17 +36,15 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>enable</parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>enable</parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -58,21 +56,19 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&return.type.true;
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&return.type.true;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
@@ -81,10 +77,9 @@
Modificar <parameter>enable</parameter> es más frecuente
cuando se utilizan los valores devueltos que cuando se muestran.
</para>
<para>
<example>
<title>Ejemplo con <function>snmp_set_quick_print</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp_set_quick_print</function></title>
<programlisting role="php">
<![CDATA[
<?php
snmp_set_quick_print(0);
@@ -95,25 +90,22 @@ $a = snmpget("127.0.0.1", "public", ".1.3.6.1.2.1.2.2.1.9.1");
echo "$a\n";
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
'Timeticks: (0) 0:00:00.00'
'0:00:00.00'
]]>
</screen>
</example>
</para>
</screen>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp_get_quick_print</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmp_get_quick_print</function></member>
</simplelist>
</refsect1>
</refentry>

144
reference/snmp/functions/snmp-set-valueretrieval.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2ca090342977839edca2f7f4e52305a1b5da6095 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp-set-valueretrieval" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-set-valueretrieval">
<refnamediv>
<refname>snmp_set_valueretrieval</refname>
<refpurpose>
@@ -18,50 +18,48 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term>
<parameter>method</parameter>
</term>
<listitem>
<table>
<title>types</title>
<tgroup cols="2">
<tbody>
<row>
<entry>SNMP_VALUE_LIBRARY</entry>
<entry>
Los valores devueltos serán aquellos devueltos por la biblioteca
Net-SNMP.
</entry>
</row>
<row>
<entry>SNMP_VALUE_PLAIN</entry>
<entry>
Los valores devueltos serán brutos, sin la información
del tipo SNMP.
</entry>
</row>
<row>
<entry>SNMP_VALUE_OBJECT</entry>
<entry>
Los valores devueltos serán objetos con las propiedades
<literal>value</literal> y <literal>type</literal>, donde la segunda es una de las constantes
<constant>SNMP_OCTET_STR</constant>, <constant>SNMP_COUNTER</constant> etc.
La forma en que la <literal>value</literal> es devuelta se basa
en el uso de la constante
<constant>SNMP_VALUE_LIBRARY</constant> o de
la constante <constant>SNMP_VALUE_PLAIN</constant>.
</entry>
</row>
</tbody>
</tgroup>
</table>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term>
<parameter>method</parameter>
</term>
<listitem>
<table>
<title>types</title>
<tgroup cols="2">
<tbody>
<row>
<entry>SNMP_VALUE_LIBRARY</entry>
<entry>
Los valores devueltos serán aquellos devueltos por la biblioteca
Net-SNMP.
</entry>
</row>
<row>
<entry>SNMP_VALUE_PLAIN</entry>
<entry>
Los valores devueltos serán brutos, sin la información
del tipo SNMP.
</entry>
</row>
<row>
<entry>SNMP_VALUE_OBJECT</entry>
<entry>
Los valores devueltos serán objetos con las propiedades
<literal>value</literal> y <literal>type</literal>, donde la segunda es una de las constantes
<constant>SNMP_OCTET_STR</constant>, <constant>SNMP_COUNTER</constant> etc.
La forma en que la <literal>value</literal> es devuelta se basa
en el uso de la constante
<constant>SNMP_VALUE_LIBRARY</constant> o de
la constante <constant>SNMP_VALUE_PLAIN</constant>.
</entry>
</row>
</tbody>
</tgroup>
</table>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -73,29 +71,26 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&return.type.true;
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&return.type.true;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp_set_valueretrieval</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp_set_valueretrieval</function></title>
<programlisting role="php">
<![CDATA[
<?php
snmp_set_valueretrieval(SNMP_VALUE_LIBRARY);
@@ -132,21 +127,18 @@
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member>
<function>snmp_get_valueretrieval</function>
</member>
<member><xref linkend="snmp.constants"/></member>
</simplelist>
</para>
<simplelist>
<member>
<function>snmp_get_valueretrieval</function>
</member>
<member><xref linkend="snmp.constants"/></member>
</simplelist>
</refsect1>
</refentry>

24
reference/snmp/functions/snmp2-get.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp2-get" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp2-get">
<refnamediv>
<refname>snmp2_get</refname>
<refpurpose>Recupera un objeto <acronym>SNMP</acronym></refpurpose>
@@ -80,27 +80,23 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp2_get</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp2_get</function></title>
<programlisting role="php">
<![CDATA[
<?php
$syscontact = snmp2_get("127.0.0.1", "public", "system.SysContact.0");
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp2_set</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmp2_set</function></member>
</simplelist>
</refsect1>
</refentry>

26
reference/snmp/functions/snmp2-getnext.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 73fae4ee51b644b72028e610abefefced57c18ad Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp2-getnext" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp2-getnext">
<refnamediv>
<refname>snmp2_getnext</refname>
<refpurpose>Recupera el objeto <acronym>SNMP</acronym> que sigue inmediatamente
@@ -84,28 +84,24 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp2_get_next</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp2_get_next</function></title>
<programlisting role="php">
<![CDATA[
<?php
$nameOfSecondInterface = snmp2_get_next('localhost', 'public', 'IF-MIB::ifName.1');
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp2_get</function></member>
<member><function>snmp2_walk</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmp2_get</function></member>
<member><function>snmp2_walk</function></member>
</simplelist>
</refsect1>
</refentry>

30
reference/snmp/functions/snmp2-real-walk.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp2-real-walk" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp2-real-walk">
<refnamediv>
<refname>snmp2_real_walk</refname>
<refpurpose>Devuelve todos los objetos incluyendo los identificadores de sus respectivos objetos</refpurpose>
@@ -86,19 +86,18 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp2_real_walk</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp2_real_walk</function></title>
<programlisting role="php">
<![CDATA[
<?php
print_r(snmp2_real_walk("localhost", "public", "IF-MIB::ifName"));
?>
]]>
</programlisting>
</programlisting>
<para>
El ejemplo anterior mostrará algo como:
<para>
El ejemplo anterior mostrará algo como:
<![CDATA[
Array
(
@@ -109,18 +108,15 @@
[IF-MIB::ifName.5] => STRING: sixxs
)
]]>
</para>
</example>
</para>
</para>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp2_walk</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmp2_walk</function></member>
</simplelist>
</refsect1>
</refentry>

12
reference/snmp/functions/snmp2-set.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp2-set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp2-set">
<refnamediv>
<refname>snmp2_set</refname>
<refpurpose>Define el valor de un objeto <acronym>SNMP</acronym></refpurpose>
@@ -131,11 +131,9 @@
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp2_get</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmp2_get</function></member>
</simplelist>
</refsect1>
</refentry>

24
reference/snmp/functions/snmp2-walk.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp2-walk" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp2-walk">
<refnamediv>
<refname>snmp2_walk</refname>
<refpurpose>Recupera todos los objetos <acronym>SNMP</acronym> desde un agente</refpurpose>
@@ -89,10 +89,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp2_walk</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp2_walk</function></title>
<programlisting role="php">
<![CDATA[
<?php
$a = snmp2_walk("127.0.0.1", "public", "");
@@ -103,9 +102,8 @@ foreach ($a as $val) {
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
<para>
La función anterior debería devolver todos los objetos
<acronym>SNMP</acronym> desde el agente <acronym>SNMP</acronym>
@@ -116,11 +114,9 @@ foreach ($a as $val) {
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp2_real_walk</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmp2_real_walk</function></member>
</simplelist>
</refsect1>
</refentry>

66
reference/snmp/functions/snmp3-get.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1051736a4ca76eb71c5c651e8c78ac808e8edc02 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp3-get" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp3-get">
<refnamediv>
<refname>snmp3_get</refname>
<refpurpose>Recupera un objeto <acronym>SNMP</acronym></refpurpose>
@@ -126,53 +126,47 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
El parámetro <parameter>auth_protocol</parameter> acepta ahora
<literal>"SHA256"</literal> y <literal>"SHA512"</literal>
cuando es soportado por libnetsnmp.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
El parámetro <parameter>auth_protocol</parameter> acepta ahora
<literal>"SHA256"</literal> y <literal>"SHA512"</literal>
cuando es soportado por libnetsnmp.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp3_get</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp3_get</function></title>
<programlisting role="php">
<![CDATA[
<?php
$nameOfSecondInterface = snmp3_get('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName.2');
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp3_set</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmp3_set</function></member>
</simplelist>
</refsect1>
</refentry>

68
reference/snmp/functions/snmp3-getnext.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1051736a4ca76eb71c5c651e8c78ac808e8edc02 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp3-getnext" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp3-getnext">
<refnamediv>
<refname>snmp3_getnext</refname>
<refpurpose>Recupera el objeto <acronym>SNMP</acronym> que sigue inmediatamente al objeto proporcionado</refpurpose>
@@ -129,54 +129,48 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
El parámetro <parameter>auth_protocol</parameter> acepta ahora
<literal>"SHA256"</literal> y <literal>"SHA512"</literal>
cuando es soportado por libnetsnmp.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
El parámetro <parameter>auth_protocol</parameter> acepta ahora
<literal>"SHA256"</literal> y <literal>"SHA512"</literal>
cuando es soportado por libnetsnmp.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp3_getnext</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp3_getnext</function></title>
<programlisting role="php">
<![CDATA[
<?php
$nameOfSecondInterface = snmp3_getnext('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName.1');
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp3_get</function></member>
<member><function>snmp3_walk</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmp3_get</function></member>
<member><function>snmp3_walk</function></member>
</simplelist>
</refsect1>
</refentry>

72
reference/snmp/functions/snmp3-real-walk.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1051736a4ca76eb71c5c651e8c78ac808e8edc02 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp3-real-walk" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp3-real-walk">
<refnamediv>
<refname>snmp3_real_walk</refname>
<refpurpose> Devuelve todos los objetos incluyendo los identificadores de sus respectivos objetos</refpurpose>
@@ -122,43 +122,40 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
El parámetro <parameter>auth_protocol</parameter> acepta ahora <literal>"SHA256"</literal> y <literal>"SHA512"</literal> cuando es soportado por libnetsnmp.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
El parámetro <parameter>auth_protocol</parameter> acepta ahora <literal>"SHA256"</literal> y <literal>"SHA512"</literal> cuando es soportado por libnetsnmp.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp3_real_walk</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp3_real_walk</function></title>
<programlisting role="php">
<![CDATA[
<?php
var_export(snmp3_real_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName'));
?>
]]>
</programlisting>
</programlisting>
<para>
El ejemplo anterior mostrará algo como:
<para>
El ejemplo anterior mostrará algo como:
<![CDATA[
array (
'IF-MIB::ifName.1' => 'STRING: lo',
@@ -168,20 +165,17 @@ array (
'IF-MIB::ifName.5' => 'STRING: sixxs',
)
]]>
</para>
</example>
</para>
</para>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member>
<function>snmpwalk</function>
</member>
</simplelist>
</para>
<simplelist>
<member>
<function>snmpwalk</function>
</member>
</simplelist>
</refsect1>
</refentry>

66
reference/snmp/functions/snmp3-walk.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1051736a4ca76eb71c5c651e8c78ac808e8edc02 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmp3-walk" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp3-walk">
<refnamediv>
<refname>snmp3_walk</refname>
<refpurpose>Recupera todos los objetos <acronym>SNMP</acronym> desde un agente</refpurpose>
@@ -138,45 +138,41 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
El parámetro <parameter>auth_protocol</parameter> acepta ahora
<literal>"SHA256"</literal> y <literal>"SHA512"</literal>
cuando es soportado por libnetsnmp.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
El parámetro <parameter>auth_protocol</parameter> acepta ahora
<literal>"SHA256"</literal> y <literal>"SHA512"</literal>
cuando es soportado por libnetsnmp.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmp3_walk</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmp3_walk</function></title>
<programlisting role="php">
<![CDATA[
<?php
$ret = snmp3_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName');
var_export($ret);
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
<para>
La llamada a la función anterior devolverá todos los objetos
<acronym>SNMP</acronym> desde el agente
@@ -195,11 +191,9 @@ array (
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmp3_real_walk</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmp3_real_walk</function></member>
</simplelist>
</refsect1>
</refentry>

110
reference/snmp/functions/snmpget.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmpget" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmpget">
<refnamediv>
<refname>snmpget</refname>
<refpurpose>Recibe un objeto <acronym>SNMP</acronym></refpurpose>
@@ -25,50 +25,48 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
El agente <acronym>SNMP</acronym>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
La comunidad de lectura.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
El objeto <acronym>SNMP</acronym>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
El número de microsegundos desde el primer timeout.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
El número de intentos cuando ocurre el tiempo límite máximo de espera.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
El agente <acronym>SNMP</acronym>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
La comunidad de lectura.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
El objeto <acronym>SNMP</acronym>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
El número de microsegundos desde el primer timeout.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
El número de intentos cuando ocurre el tiempo límite máximo de espera.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -80,27 +78,23 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmpget</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmpget</function></title>
<programlisting role="php">
<![CDATA[
<?php
$syscontact = snmpget("127.0.0.1", "public", "system.SysContact.0");
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmpset</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmpset</function></member>
</simplelist>
</refsect1>
</refentry>

72
reference/snmp/functions/snmpgetnext.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 73fae4ee51b644b72028e610abefefced57c18ad Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmpgetnext" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmpgetnext">
<refnamediv>
<refname>snmpgetnext</refname>
<refpurpose>Recupera un objeto <acronym>SNMP</acronym> que sigue inmediatamente
@@ -28,30 +28,28 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem><para>El nombre del host del agente <acronym>SNMP</acronym> (servidor).</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem><para>La comunidad de lectura.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem><para>El identificador del objeto <acronym>SNMP</acronym> que precede al deseado.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem><para>El número de microsegundos antes del primer tiempo límite.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem><para>El número de intentos en caso de que ocurra un tiempo límite.</para></listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem><para>El nombre del host del agente <acronym>SNMP</acronym> (servidor).</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem><para>La comunidad de lectura.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem><para>El identificador del objeto <acronym>SNMP</acronym> que precede al deseado.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem><para>El número de microsegundos antes del primer tiempo límite.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem><para>El número de intentos en caso de que ocurra un tiempo límite.</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -66,28 +64,24 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmpgetnext</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmpgetnext</function></title>
<programlisting role="php">
<![CDATA[
<?php
$nameOfSecondInterface = snmpgetnext('localhost', 'public', 'IF-MIB::ifName.1');
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmpget</function></member>
<member><function>snmpwalk</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmpget</function></member>
<member><function>snmpwalk</function></member>
</simplelist>
</refsect1>
</refentry>

78
reference/snmp/functions/snmprealwalk.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmprealwalk" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmprealwalk">
<refnamediv>
<refname>snmprealwalk</refname>
<refpurpose>Devuelve todos los objetos, incluyendo los identificadores respectivos incluidos en el objeto</refpurpose>
@@ -26,31 +26,29 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem><para>El nombre del host del agente <acronym>SNMP</acronym> (servidor).</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem><para>La comunidad de lectura.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem><para>El identificador del objeto <acronym>SNMP</acronym>
que precede al deseado.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem><para>El número de microsegundos antes del primer tiempo límite.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem><para>El número de intentos en caso de que ocurra el tiempo límite.</para></listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem><para>El nombre del host del agente <acronym>SNMP</acronym> (servidor).</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem><para>La comunidad de lectura.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem><para>El identificador del objeto <acronym>SNMP</acronym>
que precede al deseado.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem><para>El número de microsegundos antes del primer tiempo límite.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem><para>El número de intentos en caso de que ocurra el tiempo límite.</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -66,19 +64,18 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmprealwalk</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmprealwalk</function></title>
<programlisting role="php">
<![CDATA[
<?php
print_r(snmprealwalk("localhost", "public", "IF-MIB::ifName"));
?>
]]>
</programlisting>
</programlisting>
<para>
El código anterior producirá una salida similar a:
<para>
El código anterior producirá una salida similar a:
<![CDATA[
Array
(
@@ -89,18 +86,15 @@
[IF-MIB::ifName.5] => STRING: sixxs
)
]]>
</para>
</example>
</para>
</para>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmpwalk</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmpwalk</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

132
reference/snmp/functions/snmpset.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmpset" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmpset">
<refnamediv>
<refname>snmpset</refname>
<refpurpose>Define el valor de un objeto <acronym>SNMP</acronym></refpurpose>
@@ -29,67 +29,65 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
El nombre de host del agente <acronym>SNMP</acronym> (servidor).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
La comunidad de lectura.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
El identificador del objeto <acronym>SNMP</acronym>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>type</parameter></term>
<listitem>
&snmp.set.type.values;
&snmp.set.type.values.asn.mapping;
&snmp.set.type.values.equal.note;
&snmp.set.type.values.bitset.note;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
El nuevo valor.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
El número de microsegundos desde el primer timeout.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
El número de intentos antes de alcanzar el tiempo máximo de espera.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
El nombre de host del agente <acronym>SNMP</acronym> (servidor).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
La comunidad de lectura.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
El identificador del objeto <acronym>SNMP</acronym>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>type</parameter></term>
<listitem>
&snmp.set.type.values;
&snmp.set.type.values.asn.mapping;
&snmp.set.type.values.equal.note;
&snmp.set.type.values.bitset.note;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
El nuevo valor.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
El número de microsegundos desde el primer timeout.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
El número de intentos antes de alcanzar el tiempo máximo de espera.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -134,11 +132,9 @@
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmpget</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmpget</function></member>
</simplelist>
</refsect1>
</refentry>

120
reference/snmp/functions/snmpwalk.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmpwalk" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmpwalk">
<refnamediv>
<refname>snmpwalk</refname>
<refpurpose>Recibe todos los objetos <acronym>SNMP</acronym> de un agente</refpurpose>
@@ -25,55 +25,53 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
El agente SNMP (servidor).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
La comunidad de lectura.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
Si &null;, <parameter>object_id</parameter> se toma como raíz de los
objetos <acronym>SNMP</acronym> y todos los objetos de este árbol se devuelven en forma de array.
</para>
<para>
Si <parameter>object_id</parameter> está especificado, todos los objetos <acronym>SNMP</acronym>
que siguen a este <parameter>object_id</parameter> se devuelven.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
El número de microsegundos desde el primer timeout.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
El número de intentos en caso de que ocurra el tiempo límite.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
El agente SNMP (servidor).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
La comunidad de lectura.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
Si &null;, <parameter>object_id</parameter> se toma como raíz de los
objetos <acronym>SNMP</acronym> y todos los objetos de este árbol se devuelven en forma de array.
</para>
<para>
Si <parameter>object_id</parameter> está especificado, todos los objetos <acronym>SNMP</acronym>
que siguen a este <parameter>object_id</parameter> se devuelven.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
El número de microsegundos desde el primer timeout.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
El número de intentos en caso de que ocurra el tiempo límite.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -86,10 +84,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmpwalk</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmpwalk</function></title>
<programlisting role="php">
<![CDATA[
<?php
$a = snmpwalk("127.0.0.1", "public", "");
@@ -100,9 +97,8 @@ foreach ($a as $val) {
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
<para>
La llamada a la función anterior devolverá todos los objetos <acronym>SNMP</acronym>
desde el agente <acronym>SNMP</acronym> ejecutado en el host local. Se recorren los valores
@@ -112,11 +108,9 @@ foreach ($a as $val) {
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmprealwalk</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmprealwalk</function></member>
</simplelist>
</refsect1>
</refentry>

122
reference/snmp/functions/snmpwalkoid.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.snmpwalkoid" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmpwalkoid">
<refnamediv>
<refname>snmpwalkoid</refname>
<refpurpose>Solicitud de información de árbol sobre una entidad de la red</refpurpose>
@@ -33,56 +33,54 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
El agente SNMP.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
La comunidad de lectura.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
Si &null;, <parameter>object_id</parameter> se toma como raíz de los
objetos SNMP y todos los objetos de este árbol se devuelven en forma de array.
</para>
<para>
Si <parameter>object_id</parameter> se especifica, todos los objetos SNMP
siguientes a este <parameter>object_id</parameter> se devuelven.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
El número de microsegundos desde el primer timeout.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
El número de intentos en caso de que ocurra el tiempo límite
máximo.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
El agente SNMP.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
La comunidad de lectura.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
Si &null;, <parameter>object_id</parameter> se toma como raíz de los
objetos SNMP y todos los objetos de este árbol se devuelven en forma de array.
</para>
<para>
Si <parameter>object_id</parameter> se especifica, todos los objetos SNMP
siguientes a este <parameter>object_id</parameter> se devuelven.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
El número de microsegundos desde el primer timeout.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
El número de intentos en caso de que ocurra el tiempo límite
máximo.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -96,10 +94,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>snmpwalkoid</function></title>
<programlisting role="php">
<example>
<title>Ejemplo con <function>snmpwalkoid</function></title>
<programlisting role="php">
<![CDATA[
<?php
$a = snmpwalkoid("127.0.0.1", "public", "");
@@ -108,9 +105,8 @@ for (reset($a); $i = key($a); next($a)) {
}
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
<para>
La llamada a la función anterior devolverá todos los objetos SNMP
desde el agente SNMP ejecutado en el host local. Se recorren los valores
@@ -120,11 +116,9 @@ for (reset($a); $i = key($a); next($a)) {
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>snmpwalk</function></member>
</simplelist>
</para>
<simplelist>
<member><function>snmpwalk</function></member>
</simplelist>
</refsect1>
</refentry>

50
reference/snmp/snmp/get.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 888d70d7d21713f7f52d497e627543dfb41fc103 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="snmp.get" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.get">
<refnamediv>
<refname>SNMP::get</refname>
<refpurpose>Recupera un objeto <acronym>SNMP</acronym></refpurpose>
@@ -30,30 +30,28 @@
serán devueltos en forma de array asociativo de identificadores de objetos
<acronym>SNMP</acronym> y sus valores.
</para>
<para>
<variablelist>
<varlistentry>
<term><parameter>objectId</parameter></term>
<listitem>
<para>
El o los objetos <acronym>SNMP</acronym> (OID)
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>preserve_keys</parameter></term>
<listitem>
<para>
Cuando <parameter>objectId</parameter> es un array, y el parámetro
<parameter>preserve_keys</parameter> está definido a &true;, las claves en el resultado
serán tomadas exactamente del objeto <parameter>objectId</parameter>, de lo contrario,
la propiedad <varname>SNMP::oid_output_format</varname> será utilizada para determinar
el formato de las claves.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>objectId</parameter></term>
<listitem>
<para>
El o los objetos <acronym>SNMP</acronym> (OID)
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>preserve_keys</parameter></term>
<listitem>
<para>
Cuando <parameter>objectId</parameter> es un array, y el parámetro
<parameter>preserve_keys</parameter> está definido a &true;, las claves en el resultado
serán tomadas exactamente del objeto <parameter>objectId</parameter>, de lo contrario,
la propiedad <varname>SNMP::oid_output_format</varname> será utilizada para determinar
el formato de las claves.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">

26
reference/snmp/snmp/getnext.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 888d70d7d21713f7f52d497e627543dfb41fc103 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="snmp.getnext" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.getnext">
<refnamediv>
<refname>SNMP::getnext</refname>
<refpurpose>Recupera un objeto <acronym>SNMP</acronym> que sigue al identificador de objeto proporcionado</refpurpose>
@@ -31,18 +31,16 @@
un array asociativo de identificadores de objetos
<acronym>SNMP</acronym> así como sus valores.
</para>
<para>
<variablelist>
<varlistentry>
<term><parameter>objectId</parameter></term>
<listitem>
<para>
El o los objetos <acronym>SNMP</acronym> (OID).
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>objectId</parameter></term>
<listitem>
<para>
El o los objetos <acronym>SNMP</acronym> (OID).
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">

12
reference/snmp/snmp/set.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 888d70d7d21713f7f52d497e627543dfb41fc103 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="snmp.set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.set">
<refnamediv>
<refname>SNMP::set</refname>
<refpurpose>Define el valor de un objeto SNMP</refpurpose>
@@ -129,11 +129,9 @@
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>SNMP::get</methodname></member>
</simplelist>
</para>
<simplelist>
<member><methodname>SNMP::get</methodname></member>
</simplelist>
</refsect1>
</refentry>