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

snmp: fix XML by converting para to simpara tags via script

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-26 15:35:54 +00:00
parent 36fffe8bee
commit 640d9c0222
38 changed files with 557 additions and 552 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
reference/snmp/book.xml
View File

@@ -1,26 +1,26 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 2f493dfdc26fe0736d693ceba7986af511729dbb Maintainer: leonardolara Status: ready --><!-- CREDITS: thiago,fernandowobeto,leonardolara -->
<book xml:id="book.snmp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: thiago,fernandowobeto,leonardolara -->
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.snmp">
<?phpdoc extension-membership="bundledexternal" ?>
<title>SNMP</title>
<!-- {{{ preface -->
<preface xml:id="intro.snmp">
&reftitle.intro;
<para>
<simpara>
A extensão SNMP provê um kit de ferramentas muito simples e fácil de usar para
controlar dispositivos remotos através do Simple Network Management Protocol.
</para>
<para>
</simpara>
<simpara>
Como é um encapsulador da biblioteca básica Net-SNMP,
todos os conceitos básicos são os mesmos e as funções PHP alteram
seus comportamentos dependendo dos arquivos de configuração Net-SNMP e das variáveis de ambiente.
</para>
<para>
</simpara>
<simpara>
Mais informações sobre o Net-SNMP podem ser encontradas em
<link xlink:href="&url.net-snmp;">&url.net-snmp;</link>
</para>
</simpara>
</preface>
<!-- }}} -->
@@ -31,7 +31,6 @@
&reference.snmp.snmp;
&reference.snmp.snmpexception;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -52,4 +51,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

10
reference/snmp/configure.xml
View File

@@ -1,16 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ce9a6b3a30732d94862f8e1f40bba41c3688b955 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<section xml:id="snmp.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.installation">
&reftitle.install;
<para>
<simpara>
A distribuição do Windows do <link xlink:href="&url.net-snmp;">Net-SNMP</link> contém arquivos de suporte para SNMP no
diretório <filename class="directory">mibs</filename>. Este diretório
deve ser adicionado às variáveis ​​de ambiente do Windows, como <envar>MIBDIRS</envar>, com o
valor sendo o caminho completo para o diretório <filename class="directory">mibs</filename>:
por exemplo, <filename class="directory">c:\usr\mibs</filename>.
</para>
</simpara>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-get-quick-print">
<refnamediv>
@@ -14,10 +14,10 @@
<type>bool</type><methodname>snmp_get_quick_print</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Retorna o valor atual armazenado na Biblioteca NET-SNMP para quick_print.
quick_print é desativado por padrão.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,9 +27,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna &true; se quick_print estiver ativado, &false; caso contrário.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp-get-valueretrieval">
<refnamediv>
@@ -25,11 +25,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Combinação OR de constantes (<constant>SNMP_VALUE_LIBRARY</constant> ou
<constant>SNMP_VALUE_PLAIN</constant>) com
possível conjunto SNMP_VALUE_OBJECT.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-read-mib">
<refnamediv>
@@ -15,15 +15,15 @@
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Esta função é usada para carregar MIBs adicionais, por exemplo, específicos do fornecedor, para que
OIDs legíveis por humanos, como <literal>VENDOR-MIB::foo.1</literal>, em vez de OIDs numéricos propensos a erros,
possam ser usados.
</para>
<para>
</simpara>
<simpara>
A ordem em que os MIBs são carregados importa, pois a biblioteca Net-SNMP
subjacente imprimirá avisos se os objetos referenciados não puderem ser resolvidos.
</para>
</simpara>
</refsect1>
@@ -32,16 +32,16 @@
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem><para>O nome do arquivo do <acronym>MIB</acronym>.</para></listitem>
<listitem><simpara>O nome do arquivo do <acronym>MIB</acronym>.</simpara></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -59,7 +59,7 @@
]]>
</programlisting>
</example>
<para>
<simpara>
O exemplo acima é inventado, mas os resultados seriam assim:
<![CDATA[
Array
@@ -71,7 +71,7 @@ Array
[FOO-BAR-MIB::someTable.0] => Gauge32: 6
)
]]>
</para>
</simpara>
</refsect1>
</refentry>

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-set-enum-print">
<refnamediv>
@@ -14,10 +14,10 @@
<type>true</type><methodname>snmp_set_enum_print</methodname>
<methodparam><type>bool</type><parameter>enable</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Esta função alterna se snmpwalk/snmpget etc. devem procurar automaticamente valores de enumeração
na MIB e retorná-los junto com sua string legível.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,9 +26,9 @@
<varlistentry>
<term><parameter>enable</parameter></term>
<listitem>
<para>
<simpara>
Como o valor é interpretado como booleano pela biblioteca Net-SNMP, ele só pode ser "0" ou "1".
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -36,9 +36,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.true.always;
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -73,13 +73,13 @@
]]>
</programlisting>
</example>
<para>
<simpara>
O exemplo acima retornaria
<![CDATA[
INTEGER: up(1)
INTEGER: 1
]]>
</para>
</simpara>
</refsect1>
</refentry>

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-set-oid-numeric-print">
<refnamediv>
@@ -9,9 +9,9 @@
<refsect1 role="description">
&reftitle.description;
<para>
<simpara>
&info.function.alias; <function>snmp_set_oid_output_format</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-set-oid-output-format">
<refnamediv>
@@ -14,10 +14,10 @@
<type>true</type><methodname>snmp_set_oid_output_format</methodname>
<methodparam><type>int</type><parameter>format</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>snmp_set_oid_output_format</function> define o formato de saída
como completo ou numérico.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -46,9 +46,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.true.always;
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -90,7 +90,7 @@
]]>
</programlisting>
<para>
<simpara>
O exemplo acima resultaria em:
<![CDATA[
Array
@@ -106,7 +106,7 @@
[.iso.org.dod.internet.mgmt.mib-2.system.sysObjectID.0] => OID: .iso.org.dod.internet.private.enterprises.netSnmp.netSnmpEnumerations.netSnmpAgentOIDs.linux
)
]]>
</para>
</simpara>
</example>
</refsect1>

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-set-quick-print">
<refnamediv>
@@ -14,7 +14,7 @@
<methodparam><type>bool</type><parameter>enable</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Define o valor de <parameter>enable</parameter> na biblioteca NET-<acronym>SNMP</acronym>. Quando este parâmetro
estiver definido (1), a biblioteca <acronym>SNMP</acronym> retornará valores de 'impressão rápida'. Isso
significa que apenas o valor será impresso. Quando <parameter>enable</parameter> não estiver
@@ -22,15 +22,15 @@
incluindo o tipo do valor (por exemplo, Endereço IP ou OID). Além disso,
se quick_print não estiver habilitado, a biblioteca imprime valores hexadecimais adicionais
para todas as strings de três caracteres ou menos.
</para>
<para>
</simpara>
<simpara>
Por padrão, a biblioteca NET-<acronym>SNMP</acronym> retorna valores detalhados; quick_print é
usado para retornar apenas o valor.
</para>
<para>
</simpara>
<simpara>
Atualmente, as strings ainda são retornadas com aspas extras. Isso será
corrigido em uma versão posterior.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,8 +39,8 @@
<varlistentry>
<term><parameter>enable</parameter></term>
<listitem>
<para>
</para>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -48,9 +48,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.true.always;
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -72,10 +72,10 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<simpara>
A configuração quick_print é frequentemente usada ao usar as informações retornadas
em vez de exibi-las.
</para>
</simpara>
<example>
<title>Usando <function>snmp_set_quick_print</function></title>
<programlisting role="php">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmp-set-valueretrieval">
<refnamediv>
@@ -56,9 +56,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.true.always;
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp2-get">
<refnamediv>
@@ -17,11 +17,11 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmp2_get</function> é usada para ler o
valor de um objeto <acronym>SNMP</acronym> especificado pelo
<parameter>object_id</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,41 +30,41 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O agente <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
<simpara>
A comunidade de leitura.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
O objeto <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -72,9 +72,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna o valor do objeto <acronym>SNMP</acronym> em caso de sucesso ou &false; em caso de erro.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp2-getnext">
<refnamediv>
@@ -17,11 +17,11 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmp2_get_next</function> é usada para ler o
valor do objeto <acronym>SNMP</acronym> que segue o
<parameter>object_id</parameter> especificado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,41 +30,41 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O nome do host do agente <acronym>SNMP</acronym> (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
<simpara>
A comunidade de leitura.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
O ID do objeto <acronym>SNMP</acronym> que precede o desejado.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -73,10 +73,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna o valor do objeto <acronym>SNMP</acronym> em caso de sucesso ou &false; em caso de erro.
Em caso de erro, uma mensagem E_WARNING é exibida.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp2-real-walk">
<refnamediv>
@@ -17,11 +17,11 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmp2_real_walk</function> é usada para percorrer uma série
de objetos <acronym>SNMP</acronym> a partir de <parameter>object_id</parameter>
e retornar não apenas seus valores, mas também seus IDs de objeto.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,41 +30,41 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O nome do host do agente <acronym>SNMP</acronym> (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
<simpara>
A comunidade de leitura.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
O ID do objeto <acronym>SNMP</acronym> que precede o desejado.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -73,10 +73,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna um array associativo dos IDs de objetos <acronym>SNMP</acronym> e seus valores em caso de sucesso ou &false; em caso de erro.
Em caso de erro, uma mensagem E_WARNING é exibida.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -91,7 +91,7 @@
]]>
</programlisting>
<para>
<simpara>
O resultado do exemplo acima será algo como:
<![CDATA[
Array
@@ -103,7 +103,7 @@
[IF-MIB::ifName.5] => STRING: sixxs
)
]]>
</para>
</simpara>
</example>
</refsect1>

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp2-set">
<refnamediv>
@@ -19,10 +19,10 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>snmp2_set</function> é usado para definir o valor de um objeto <acronym>SNMP</acronym>
especificado pelo <parameter>object_id</parameter>.
</para>
</simpara>
</refsect1>
@@ -32,25 +32,25 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O nome do host do agente <acronym>SNMP</acronym> (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
<simpara>
A comunidade de escrita.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
O ID do objeto <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -65,25 +65,25 @@
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
<simpara>
O novo valor.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -91,13 +91,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
<para>
</simpara>
<simpara>
Se o host SNMP rejeitar o tipo de dado, uma mensagem E_WARNING como "Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length." será exibida.
Se um OID desconhecido ou inválido for especificado, o aviso provavelmente será "Could not add variable".
</para>
</simpara>
</refsect1>

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp2-walk">
<refnamediv>
@@ -17,10 +17,10 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmp2_walk</function> é usada para ler todos os valores de
um agente <acronym>SNMP</acronym> especificado pelo <parameter>hostname</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -29,47 +29,47 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O agente SNMP (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
<simpara>
A comunidade de leitura.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
Se &null;, <parameter>object_id</parameter> for considerado a raiz da
árvore de objetos <acronym>SNMP</acronym> e todos os objetos sob essa árvore serão retornados como
um array.
</para>
<para>
</simpara>
<simpara>
Se <parameter>object_id</parameter> for especificado, todos os objetos <acronym>SNMP</acronym>
abaixo desse <parameter>object_id</parameter> serão retornados.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -77,10 +77,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna um array de valores de objetos <acronym>SNMP</acronym> começando pelo
<parameter>object_id</parameter> como raiz ou &false; em caso de erro.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -100,11 +100,11 @@ foreach ($a as $val) {
]]>
</programlisting>
</example>
<para>
<simpara>
A chamada de função acima retornaria todos os objetos
<acronym>SNMP</acronym> do agente <acronym>SNMP</acronym> em execução no host local. É possível percorrer os valores
com um loop.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp3-get">
<refnamediv>
@@ -22,11 +22,11 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmp3_get</function> é usada para ler o
valor de um objeto <acronym>SNMP</acronym> especificado pelo
<parameter>object_id</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -35,82 +35,82 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O nome do host do agente <acronym>SNMP</acronym> (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>security_name</parameter></term>
<listitem>
<para>
<simpara>
O nome de segurança, geralmente algum tipo de nome de usuário
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>security_level</parameter></term>
<listitem>
<para>
<simpara>
O nível de segurança (noAuthNoPriv|authNoPriv|authPriv)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_protocol</parameter></term>
<listitem>
<para>
<simpara>
O protocolo de autenticação (<literal>"MD5"</literal>, <literal>"SHA"</literal>,
<literal>"SHA256"</literal> ou <literal>"SHA512"</literal>)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_passphrase</parameter></term>
<listitem>
<para>
<simpara>
A senha de autenticação
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_protocol</parameter></term>
<listitem>
<para>
<simpara>
O protocolo de privacidade (DES ou AES)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_passphrase</parameter></term>
<listitem>
<para>
<simpara>
A senha de privacidade
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
O ID do objeto <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -118,9 +118,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna o valor do objeto <acronym>SNMP</acronym> em caso de sucesso ou &false; em caso de erro.
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp3-getnext">
<refnamediv>
@@ -22,11 +22,11 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmp3_getnext</function> é usada para ler o
valor do objeto <acronym>SNMP</acronym> que segue o
<parameter>object_id</parameter> especificado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -35,83 +35,83 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O nome do host do
agente <acronym>SNMP</acronym> (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>security_name</parameter></term>
<listitem>
<para>
<simpara>
O nome de segurança, geralmente algum tipo de nome de usuário
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>security_level</parameter></term>
<listitem>
<para>
<simpara>
O nível de segurança (noAuthNoPriv|authNoPriv|authPriv)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_protocol</parameter></term>
<listitem>
<para>
<simpara>
O protocolo de autenticação (<literal>"MD5"</literal>, <literal>"SHA"</literal>,
<literal>"SHA256"</literal> ou <literal>"SHA512"</literal>)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_passphrase</parameter></term>
<listitem>
<para>
<simpara>
A senha de autenticação
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_protocol</parameter></term>
<listitem>
<para>
<simpara>
O protocolo de privacidade (DES ou AES)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_passphrase</parameter></term>
<listitem>
<para>
<simpara>
A senha de privacidade
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
O ID do objeto <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -119,10 +119,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna o valor do objeto <acronym>SNMP</acronym> em caso de sucesso ou &false; em caso de erro.
Em caso de erro, uma mensagem E_WARNING é exibida.
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp3-real-walk">
<refnamediv>
@@ -22,14 +22,14 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função
<function>snmp3_real_walk</function> é usada para percorrer uma série de
objetos
<acronym>SNMP</acronym> a partir de
<parameter>object_id</parameter>
e retornar não apenas seus valores, mas também seus IDs de objeto.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -40,10 +40,10 @@
<parameter>hostname</parameter>
</term>
<listitem>
<para>
<simpara>
O nome do host do
agente <acronym>SNMP</acronym> (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -51,9 +51,9 @@
<parameter>security_name</parameter>
</term>
<listitem>
<para>
<simpara>
O nome de segurança, geralmente algum tipo de nome de usuário
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -61,9 +61,9 @@
<parameter>security_level</parameter>
</term>
<listitem>
<para>
<simpara>
O nível de segurança (noAuthNoPriv|authNoPriv|authPriv)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -71,9 +71,9 @@
<parameter>auth_protocol</parameter>
</term>
<listitem>
<para>
<simpara>
O protocolo de autenticação (MD5 ou SHA)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -81,9 +81,9 @@
<parameter>auth_passphrase</parameter>
</term>
<listitem>
<para>
<simpara>
A senha de autenticação
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -91,10 +91,10 @@
<parameter>privacy_protocol</parameter>
</term>
<listitem>
<para>
<simpara>
O protocolo de autenticação (<literal>"MD5"</literal>, <literal>"SHA"</literal>,
<literal>"SHA256"</literal> ou <literal>"SHA512"</literal>)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -102,9 +102,9 @@
<parameter>privacy_passphrase</parameter>
</term>
<listitem>
<para>
<simpara>
A senha de privacidade
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -112,9 +112,9 @@
<parameter>object_id</parameter>
</term>
<listitem>
<para>
<simpara>
O ID do objeto <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -122,9 +122,9 @@
<parameter>timeout</parameter>
</term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -132,9 +132,9 @@
<parameter>retries</parameter>
</term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -142,11 +142,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna um array associativo dos IDs de objetos
<acronym>SNMP</acronym> e seus valores em caso de sucesso ou &false; em caso de erro.
Em caso de erro, uma mensagem E_WARNING é exibida.
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -186,7 +186,7 @@
]]>
</programlisting>
<para>
<simpara>
O resultado do exemplo acima será algo como:
<![CDATA[
array (
@@ -197,7 +197,7 @@ array (
'IF-MIB::ifName.5' => 'STRING: sixxs',
)
]]>
</para>
</simpara>
</example>
</refsect1>

65
reference/snmp/functions/snmp3-set.xml
View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="function.snmp3-set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp3-set">
<refnamediv>
<refname>snmp3_set</refname>
<refpurpose>Define o valor de um objeto SNMP</refpurpose>
@@ -23,13 +24,13 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>snmp3_set</function> é usado para definir o valor de um objeto <acronym>SNMP</acronym>
especificado pelo <parameter>object_id</parameter>.
</para>
<para>
</simpara>
<simpara>
Mesmo que o nível de segurança não use um protocolo/senha auth ou priv, valores válidos devem ser especificados.
</para>
</simpara>
</refsect1>
@@ -39,65 +40,65 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O nome do hosto do agente SNMP (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>security_name</parameter></term>
<listitem>
<para>
<simpara>
O nome de segurança, geralmente algum tipo de nome de usuário
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>security_level</parameter></term>
<listitem>
<para>
<simpara>
O nível de segurança (noAuthNoPriv|authNoPriv|authPriv)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_protocol</parameter></term>
<listitem>
<para>
<simpara>
O protocolo de autenticação (MD5 ou SHA)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_passphrase</parameter></term>
<listitem>
<para>
<simpara>
A senha de autenticação
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_protocol</parameter></term>
<listitem>
<para>
<simpara>
O protocolo de privacidade (DES ou AES)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_passphrase</parameter></term>
<listitem>
<para>
<simpara>
A senha de privacidade
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
O ID do objeto <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -112,25 +113,25 @@
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
<simpara>
O novo valor.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -138,13 +139,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
<para>
</simpara>
<simpara>
Se o host SNMP rejeitar o tipo de dado, uma mensagem E_WARNING como "Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length." será exibida.
Se um OID desconhecido ou inválido for especificado, o aviso provavelmente será "Could not add variable".
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp3-walk">
<refnamediv>
@@ -22,13 +22,13 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmp3_walk</function> é usada para ler todos os valores de
um agente <acronym>SNMP</acronym> especificado pelo <parameter>hostname</parameter>.
</para>
<para>
</simpara>
<simpara>
Mesmo que o nível de segurança não use um protocolo/senha auth ou priv, valores válidos devem ser especificados.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,88 +37,88 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O nome do host do agente SNMP (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>security_name</parameter></term>
<listitem>
<para>
<simpara>
O nome de segurança, geralmente algum tipo de nome de usuário
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>security_level</parameter></term>
<listitem>
<para>
<simpara>
O nível de segurança (noAuthNoPriv|authNoPriv|authPriv)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_protocol</parameter></term>
<listitem>
<para>
<simpara>
O protocolo de autenticação (<literal>"MD5"</literal>, <literal>"SHA"</literal>,
<literal>"SHA256"</literal> ou <literal>"SHA512"</literal>)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_passphrase</parameter></term>
<listitem>
<para>
<simpara>
A senha de autenticação
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_protocol</parameter></term>
<listitem>
<para>
<simpara>
O protocolo de privacidade (DES ou AES)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_passphrase</parameter></term>
<listitem>
<para>
<simpara>
A senha de privacidade
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
Se &null;, <parameter>object_id</parameter> for considerado a raiz da
árvore de objetos <acronym>SNMP</acronym> e todos os objetos sob essa árvore serão retornados como
um array.
</para>
<para>
</simpara>
<simpara>
Se <parameter>object_id</parameter> for especificado, todos os objetos <acronym>SNMP</acronym>
abaixo desse <parameter>object_id</parameter> serão retornados.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -126,10 +126,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna um array de valores de objetos <acronym>SNMP</acronym> começando pelo
<parameter>object_id</parameter> como raiz ou &false; em caso de erro.
</para>
</simpara>
</refsect1>
@@ -169,7 +169,7 @@ var_export($ret);
]]>
</programlisting>
</example>
<para>
<simpara>
A chamada de função acima retornaria todos os objetos <acronym>SNMP</acronym> do agente
<acronym>SNMP</acronym> em execução no host local:
<![CDATA[
@@ -181,7 +181,7 @@ array (
4 => 'STRING: sixxs',
)
]]>
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmpget">
<refnamediv>
@@ -17,11 +17,11 @@
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmpget</function> é usada para ler o
valor de um objeto <acronym>SNMP</acronym> especificado pelo
<parameter>object_id</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,41 +30,41 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O agente <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
<simpara>
A comunidade de leitura.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
O objeto <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -72,9 +72,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna o valor do objeto <acronym>SNMP</acronym> em caso de sucesso ou &false; em caso de erro.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmpgetnext">
<refnamediv>
@@ -19,11 +19,11 @@
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmpgetnext</function> é usada para ler o
valor do objeto <acronym>SNMP</acronym> que segue o
<parameter>object_id</parameter> especificado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,33 +31,33 @@
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem><para>O nome do host do agente <acronym>SNMP</acronym> (servidor).</para></listitem>
<listitem><simpara>O nome do host do agente <acronym>SNMP</acronym> (servidor).</simpara></listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem><para>A comunidade de leitura.</para></listitem>
<listitem><simpara>A comunidade de leitura.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem><para>O ID do objeto <acronym>SNMP</acronym> que precede o desejado.</para></listitem>
<listitem><simpara>O ID do objeto <acronym>SNMP</acronym> que precede o desejado.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem><para>O número de microssegundos até o primeiro tempo limite.</para></listitem>
<listitem><simpara>O número de microssegundos até o primeiro tempo limite.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem><para>O número de tentativas caso ocorram tempos limite.</para></listitem>
<listitem><simpara>O número de tentativas caso ocorram tempos limite.</simpara></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna o valor do objeto <acronym>SNMP</acronym> em caso de sucesso ou &false; em caso de erro.
Em caso de erro, uma mensagem E_WARNING é exibida.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmprealwalk">
<refnamediv>
@@ -18,11 +18,11 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmprealwalk</function> é usada para percorrer uma série
de objetos <acronym>SNMP</acronym> a partir de <parameter>object_id</parameter>
e retornar não apenas seus valores, mas também seus IDs de objeto.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,33 +30,33 @@
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem><para>O nome do host do agente <acronym>SNMP</acronym> (servidor).</para></listitem>
<listitem><simpara>O nome do host do agente <acronym>SNMP</acronym> (servidor).</simpara></listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem><para>A comunidade de leitura.</para></listitem>
<listitem><simpara>A comunidade de leitura.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem><para>O ID do objeto <acronym>SNMP</acronym> que precede o desejado.</para></listitem>
<listitem><simpara>O ID do objeto <acronym>SNMP</acronym> que precede o desejado.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem><para>O número de microssegundos até o primeiro tempo limite.</para></listitem>
<listitem><simpara>O número de microssegundos até o primeiro tempo limite.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem><para>O número de tentativas caso ocorram tempos limite.</para></listitem>
<listitem><simpara>O número de tentativas caso ocorram tempos limite.</simpara></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna um array associativo dos IDs de objetos <acronym>SNMP</acronym> e seus valores em caso de sucesso ou &false; em caso de erro.
Em caso de erro, uma mensagem E_WARNING é exibida.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -71,7 +71,7 @@
]]>
</programlisting>
<para>
<simpara>
O resultado do exemplo acima será algo como:
<![CDATA[
Array
@@ -83,7 +83,7 @@
[IF-MIB::ifName.5] => STRING: sixxs
)
]]>
</para>
</simpara>
</example>
</refsect1>

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmpset">
<refnamediv>
@@ -20,10 +20,10 @@
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>snmpset</function> é usado para definir o valor de um objeto <acronym>SNMP</acronym>
especificado pelo <parameter>object_id</parameter>.
</para>
</simpara>
</refsect1>
@@ -33,25 +33,25 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O nome do host do agente <acronym>SNMP</acronym> (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
<simpara>
A comunidade de escrita.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
O ID do objeto <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -66,25 +66,25 @@
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
<simpara>
O novo valor.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -92,13 +92,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
<para>
</simpara>
<simpara>
Se o host SNMP rejeitar o tipo de dado, uma mensagem E_WARNING como "Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length." será exibida.
Se um OID desconhecido ou inválido for especificado, o aviso provavelmente será "Could not add variable".
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmpwalk">
<refnamediv>
@@ -17,10 +17,10 @@
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmpwalk</function> é usada para ler todos os valores de
um agente <acronym>SNMP</acronym> especificado pelo <parameter>hostname</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -29,45 +29,45 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O agente SNMP (servidor).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
<simpara>
A comunidade de leitura.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
Se &null;, <parameter>object_id</parameter> for considerado a raiz da
árvore de objetos <acronym>SNMP</acronym> e todos os objetos sob essa árvore serão retornados como
um array.
</para>
<para>
</simpara>
<simpara>
Se <parameter>object_id</parameter> for especificado, todos os objetos <acronym>SNMP</acronym>
abaixo desse <parameter>object_id</parameter> serão retornados.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>O número de tentativas caso ocorram tempos limite.</para>
<simpara>O número de tentativas caso ocorram tempos limite.</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -75,10 +75,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna um array de valores de objetos <acronym>SNMP</acronym> começando pelo
<parameter>object_id</parameter> como raiz ou &false; em caso de erro.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -98,11 +98,11 @@ foreach ($a as $val) {
]]>
</programlisting>
</example>
<para>
<simpara>
A chamada de função acima retornaria todos os objetos <acronym>SNMP</acronym> do
agente <acronym>SNMP</acronym> em execução no host local. É possível percorrer os valores
com um loop.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.snmpwalkoid">
<refnamediv>
@@ -18,18 +18,18 @@
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>snmpwalkoid</function> é usada para ler todos os IDs de objetos
e seus respectivos valores de um agente SNMP especificado por
<parameter>hostname</parameter>.
</para>
</simpara>
<para>
<simpara>
A existência de <function>snmpwalkoid</function> e
<function>snmpwalk</function> tem razões históricas. Ambas
as funções são fornecidas para compatibilidade com versões anteriores.
Em vez disso, use <function>snmprealwalk</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,47 +38,47 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
O agente SNMP.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
<simpara>
A comunidade de leitura.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>object_id</parameter></term>
<listitem>
<para>
<simpara>
Se &null;, <parameter>object_id</parameter> for considerado a raiz da
árvore de objetos SNMP e todos os objetos sob essa árvore serão retornados como
um array.
</para>
<para>
</simpara>
<simpara>
Se <parameter>object_id</parameter> for especificado, todos os objetos SNMP
abaixo desse <parameter>object_id</parameter> serão retornados.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso ocorram tempos limite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -86,11 +86,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna um array associativo com IDs de objetos e seus respectivos
valores de objeto, começando pelo <parameter>object_id</parameter>
como raiz ou &false; em caso de erro.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -108,11 +108,11 @@ for (reset($a); $i = key($a); next($a)) {
]]>
</programlisting>
</example>
<para>
<simpara>
A chamada de função acima retornaria todos os objetos SNMP do
agente SNMP em execução no host local. É possível percorrer os valores
com um loop.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

16
reference/snmp/setup.xml
View File

@@ -1,22 +1,22 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: fernandowobeto Status: ready --><!-- CREDITS: thiago,fernandowobeto -->
<chapter xml:id="snmp.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: fernandowobeto Status: ready -->
<!-- CREDITS: thiago,fernandowobeto -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.setup">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="snmp.requirements">
&reftitle.required;
<para>
<simpara>
A instalação do pacote <link xlink:href="&url.net-snmp;">Net-SNMP</link> é
requerida para para utilizar as funções <acronym>SNMP</acronym>. As funções
SNMPv3 só estarão disponíveis quando o pacote <link xlink:href="&url.openssl;">OpenSSL</link>
também estiver instalado
</para>
<para>
</simpara>
<simpara>
Net-SNMP versão 5.3+ é necessária para Unix
e o Net-SNMP 5.4+ para Windows.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -25,7 +25,6 @@
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -46,4 +45,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

71
reference/snmp/snmp.xml
View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<reference xml:id="class.snmp" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.snmp" role="class">
<title>A classe SNMP</title>
<titleabbrev>SNMP</titleabbrev>
@@ -9,9 +10,9 @@
<!-- {{{ SNMP intro -->
<section xml:id="snmp.intro">
&reftitle.intro;
<para>
<simpara>
Representa uma sessão <acronym>SNMP</acronym>.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -158,13 +159,13 @@
<varlistentry xml:id="snmp.props.max-oids">
<term><varname>max_oids</varname></term>
<listitem>
<para>OID máximo por solicitação GET/SET/GETBULK</para>
<simpara>OID máximo por solicitação GET/SET/GETBULK</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.props.valueretrieval">
<term><varname>valueretrieval</varname></term>
<listitem>
<para>Controla o método como os valores SNMP serão retornados</para>
<simpara>Controla o método como os valores SNMP serão retornados</simpara>
<informaltable>
<tgroup cols="2">
<tbody>
@@ -187,8 +188,8 @@
<varlistentry xml:id="snmp.props.quick-print">
<term><varname>quick_print</varname></term>
<listitem>
<para>Valor de <parameter>quick_print</parameter> na biblioteca NET-<acronym>SNMP</acronym></para>
<para>
<simpara>Valor de <parameter>quick_print</parameter> na biblioteca NET-<acronym>SNMP</acronym></simpara>
<simpara>
Define o valor de <parameter>quick_print</parameter> na biblioteca NET-<acronym>SNMP</acronym>. Quando este parâmetro
estiver definido (1), a biblioteca <acronym>SNMP</acronym> retornará valores de 'impressão rápida'. Isso
significa que apenas o valor será impresso. Quando <parameter>quick_print</parameter> não estiver
@@ -196,23 +197,23 @@
incluindo o tipo do valor (por exemplo, Endereço IP ou OID). Além disso,
se quick_print não estiver habilitado, a biblioteca imprime valores hexadecimais adicionais
para todas as strings de três caracteres ou menos.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.props.enum-print">
<term><varname>enum_print</varname></term>
<listitem>
<para>Controla a maneira como os valores de enumeração são impressos</para>
<para>
<simpara>Controla a maneira como os valores de enumeração são impressos</simpara>
<simpara>
Os parâmetros alternam se as funções walk/get etc. devem procurar automaticamente valores de enumeração
no MIB e retorná-los junto com sua string legível.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.props.oid-output-format">
<term><varname>oid_output_format</varname></term>
<listitem>
<para>Controla o formato de saída OID</para>
<simpara>Controla o formato de saída OID</simpara>
<table>
<title>Representação do OID .1.3.6.1.2.1.1.3.0 para vários valores de
<varname>oid_output_format</varname></title>
@@ -232,8 +233,8 @@
<varlistentry xml:id="snmp.props.oid-increasing-check">
<term><varname>oid_increasing_check</varname></term>
<listitem>
<para>Controla a desativação da verificação para aumentar o OID enquanto caminha pela árvore OID</para>
<para>
<simpara>Controla a desativação da verificação para aumentar o OID enquanto caminha pela árvore OID</simpara>
<simpara>
Alguns agentes <acronym>SNMP</acronym> são conhecidos por retornar OIDs fora
de ordem, mas conseguem completar a caminhada mesmo assim. Outros agentes retornam OIDs
que estão fora de ordem e podem fazer com que <methodname>SNMP::walk</methodname>
@@ -243,24 +244,24 @@
sobre a presença de OIDs não crescentes.
Defina <varname>oid_increasing_check</varname> como &false; para desabilitar esta
verificação.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.props.exceptions-enabled">
<term><varname>exceptions_enabled</varname></term>
<listitem>
<para>
<simpara>
Controla quais falhas gerarão uma exceção SNMPException em vez de
avisos. Use constantes <constant>SNMP::ERRNO_<replaceable>*</replaceable></constant> com OR binário.
Por padrão, todas as exceções SNMP são desabilitadas.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.props.info">
<term><varname>info</varname></term>
<listitem>
<para>Propriedade somente leitura com configuração de agente remoto: nome do host,
porta, tempo limite padrão, contagem de tentativas padrão</para>
<simpara>Propriedade somente leitura com configuração de agente remoto: nome do host,
porta, tempo limite padrão, contagem de tentativas padrão</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -277,70 +278,70 @@
<varlistentry xml:id="snmp.constants.errno-noerror">
<term><constant>SNMP::ERRNO_NOERROR</constant></term>
<listitem>
<para>Não ocorreu nenhum erro específico de <acronym>SNMP</acronym>.</para>
<simpara>Não ocorreu nenhum erro específico de <acronym>SNMP</acronym>.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.constants.errno-generic">
<term><constant>SNMP::ERRNO_GENERIC</constant></term>
<listitem>
<para>Ocorreu um erro genérico <acronym>SNMP</acronym>.</para>
<simpara>Ocorreu um erro genérico <acronym>SNMP</acronym>.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.constants.errno-timeout">
<term><constant>SNMP::ERRNO_TIMEOUT</constant></term>
<listitem>
<para>A solicitação ao agente <acronym>SNMP</acronym> atingiu o tempo limite.</para>
<simpara>A solicitação ao agente <acronym>SNMP</acronym> atingiu o tempo limite.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.constants.errno-error-in-reply">
<term><constant>SNMP::ERRNO_ERROR_IN_REPLY</constant></term>
<listitem>
<para>O agente <acronym>SNMP</acronym> retornou um erro na resposta.</para>
<simpara>O agente <acronym>SNMP</acronym> retornou um erro na resposta.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.constants.errno-oid-not-increasing">
<term><constant>SNMP::ERRNO_OID_NOT_INCREASING</constant></term>
<listitem>
<para>
<simpara>
O agente <acronym>SNMP</acronym> enfrentou um ciclo de OID reportando
OID não crescente durante a execução do comando (BULK)WALK.
Isso indica um agente <acronym>SNMP</acronym> remoto falso.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.constants.errno-oid-parsing-error">
<term><constant>SNMP::ERRNO_OID_PARSING_ERROR</constant></term>
<listitem>
<para>
<simpara>
A biblioteca falhou ao analisar o OID (e/ou tipo para o comando SET).
Nenhuma consulta foi realizada.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.constants.errno-multiple-set-queries">
<term><constant>SNMP::ERRNO_MULTIPLE_SET_QUERIES</constant></term>
<listitem>
<para>
<simpara>
A biblioteca utilizará múltiplas consultas para a operação SET solicitada.
Isso significa que a operação será realizada de forma não transacional
e o segundo bloco ou os blocos subsequentes poderão falhar caso ocorra uma falha de
tipo ou valor.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.constants.errno-any">
<term><constant>SNMP::ERRNO_ANY</constant></term>
<listitem>
<para>
<simpara>
Todos os códigos SNMP::ERRNO_* são combinados com OR binário.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -353,21 +354,21 @@
<varlistentry xml:id="snmp.constants.version-1">
<term><constant>SNMP::VERSION_1</constant></term>
<listitem>
<para/>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.constants.version-2c">
<term><constant>SNMP::VERSION_2C</constant>, <constant>SNMP::VERSION_2c</constant></term>
<listitem>
<para/>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="snmp.constants.version-3">
<term><constant>SNMP::VERSION_3</constant></term>
<listitem>
<para/>
<simpara/>
</listitem>
</varlistentry>

17
reference/snmp/snmp/close.xml
View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 888d70d7d21713f7f52d497e627543dfb41fc103 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="snmp.close" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.close">
<refnamediv>
<refname>SNMP::close</refname>
<refpurpose>Fecha a sessão <acronym>SNMP</acronym></refpurpose>
@@ -13,9 +14,9 @@
<modifier>public</modifier> <type>bool</type><methodname>SNMP::close</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Libera objeto de sessão <acronym>SNMP</acronym> alocado anteriormente.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,17 +26,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example xml:id="snmp.close.example.basic">
<title>Exemplo de <methodname>SNMP::close</methodname></title>
<para>
</para>
<simpara>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

29
reference/snmp/snmp/construct.xml
View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5c58d39a0bb5b81bff6618a1c6e27d8fb9622f29 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="snmp.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.construct">
<refnamediv>
<refname>SNMP::__construct</refname>
<refpurpose>Cria uma instância SNMP representando a sessão para o agente <acronym>SNMP</acronym> remoto</refpurpose>
@@ -17,9 +18,9 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>retries</parameter><initializer>-1</initializer></methodparam>
</constructorsynopsis>
<para>
<simpara>
Cria uma instância SNMP representando a sessão para o agente <acronym>SNMP</acronym> remoto.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,12 +29,12 @@
<varlistentry>
<term><parameter>version</parameter></term>
<listitem>
<para>
<simpara>
Versão de protocolo <acronym>SNMP</acronym>:
<constant>SNMP::VERSION_1</constant>,
<constant>SNMP::VERSION_2C</constant>,
<constant>SNMP::VERSION_3</constant>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -67,11 +68,11 @@
<varlistentry>
<term><parameter>community</parameter></term>
<listitem>
<para>
<simpara>
Especifica o nível de segurança para a versão informada no parâmetro <parameter>version</parameter>.
A finalidade da string de acesso <parameter>community</parameter> é
específica da versão <acronym>SNMP</acronym>:
</para>
</simpara>
<informaltable>
<tgroup cols="2">
<tbody>
@@ -117,17 +118,17 @@
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
O número de microssegundos até o primeiro tempo limite.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retries</parameter></term>
<listitem>
<para>
<simpara>
O número de tentativas caso o tempo limite seja atingido.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -135,11 +136,11 @@
<refsect1 role="errors">
&reftitle.errors;
<para>
<simpara>
<methodname>SNMP::__construct</methodname> lança uma exceção quando
a contagem de parâmetros ou os tipos estiverem incorretos ou desconhecidos ou
a versão do protocolo <acronym>SNMP</acronym> especificada for desconhecida.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.get">
<refnamediv>
@@ -15,40 +15,40 @@
<methodparam><type class="union"><type>array</type><type>string</type></type><parameter>objectId</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>preserveKeys</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Busca um objeto <acronym>SNMP</acronym> especificado em
<parameter>objectId</parameter> usando uma consulta GET.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<simpara>
Se <parameter>objectId</parameter> for uma string, então <methodname>SNMP::get</methodname>
retornará o objeto <acronym>SNMP</acronym> como string. Se
<parameter>objectId</parameter> for um array, todos os objetos <acronym>SNMP</acronym>
solicitados serão retornados como um array associativo dos IDs dos objetos <acronym>SNMP</acronym> e seus
valores.
</para>
</simpara>
<variablelist>
<varlistentry>
<term><parameter>objectId</parameter></term>
<listitem>
<para>
<simpara>
O objeto <acronym>SNMP</acronym> (OID) ou objetos
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>preserveKeys</parameter></term>
<listitem>
<para>
<simpara>
Quando <parameter>objectId</parameter> é um array e
<parameter>preserveKeys</parameter> definido como &true; as chaves nos resultados
serão obtidas exatamente como em <parameter>objectId</parameter>,
caso contrário, a propriedade <varname>SNMP::oid_output_format</varname> é usada para determinar
o formato das chaves.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -56,10 +56,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna objetos <acronym>SNMP</acronym> solicitados como string ou array
dependendo do tipo <parameter>objectId</parameter> ou &false; em caso de erro.
</para>
</simpara>
</refsect1>
&snmp.methods.exceptions_enable.refsect;
@@ -68,11 +68,11 @@
&reftitle.examples;
<example xml:id="snmp.get.example.singleoid">
<title>Objeto <acronym>SNMP</acronym> único</title>
<para>
<simpara>
Um único objeto <acronym>SNMP</acronym> pode ser solicitado de duas maneiras: como
string (valor de retorno da string resultante) ou como um array de elemento único (com
array associativo como saída).
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

17
reference/snmp/snmp/geterrno.xml
View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 888d70d7d21713f7f52d497e627543dfb41fc103 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="snmp.geterrno" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.geterrno">
<refnamediv>
<refname>SNMP::getErrno</refname>
<refpurpose>Obtém o último código de erro</refpurpose>
@@ -13,9 +14,9 @@
<modifier>public</modifier> <type>int</type><methodname>SNMP::getErrno</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Retorna o código de erro da última solicitação SNMP.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,17 +26,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna um dos valores de código de erro SNMP descritos na seção sobre as constantes.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example xml:id="snmp.geterrno.example.basic">
<title>Exemplo de <methodname>SNMP::getErrno</methodname></title>
<para>
</para>
<simpara>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

17
reference/snmp/snmp/geterror.xml
View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 888d70d7d21713f7f52d497e627543dfb41fc103 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="snmp.geterror" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.geterror">
<refnamediv>
<refname>SNMP::getError</refname>
<refpurpose>Obtém a última mensagem de erro</refpurpose>
@@ -13,9 +14,9 @@
<modifier>public</modifier> <type>string</type><methodname>SNMP::getError</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Retorna string com erro da última solicitação SNMP.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,17 +26,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
String descrevendo o erro da última solicitação SNMP.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example xml:id="snmp.geterror.example.basic">
<title>Exemplo de <methodname>SNMP::getError</methodname></title>
<para>
</para>
<simpara>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.getnext">
<refnamediv>
@@ -16,27 +16,27 @@
<modifier>public</modifier> <type>mixed</type><methodname>SNMP::getnext</methodname>
<methodparam><type class="union"><type>array</type><type>string</type></type><parameter>objectId</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Busca um objeto <acronym>SNMP</acronym> que segue o <parameter>objectId</parameter> especificado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<simpara>
Se <parameter>objectId</parameter> for uma string, então <methodname>SNMP::getnext</methodname>
retornará o objeto <acronym>SNMP</acronym> como string. Se
<parameter>objectId</parameter> for um array, todos os objetos <acronym>SNMP</acronym>
solicitados serão retornados como um array associativo dos IDs dos objetos <acronym>SNMP</acronym> e seus
valores.
</para>
</simpara>
<variablelist>
<varlistentry>
<term><parameter>objectId</parameter></term>
<listitem>
<para>
<simpara>
O objeto <acronym>SNMP</acronym> (OID) ou objetos
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -44,10 +44,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna objetos <acronym>SNMP</acronym> solicitados como string ou array
dependendo do tipo <parameter>objectId</parameter> ou &false; em caso de erro.
</para>
</simpara>
</refsect1>
&snmp.methods.exceptions_enable.refsect;
@@ -56,11 +56,11 @@
&reftitle.examples;
<example xml:id="snmp.getnext.example.singleoid">
<title>Single <acronym>SNMP</acronym> object</title>
<para>
<simpara>
Um único objeto <acronym>SNMP</acronym> pode ser solicitado de duas maneiras: como
string (valor de retorno da string resultante) ou como um array de elemento único (com
array associativo como saída).
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

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

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 017ddc051b8136cc9116b57ce51f655fe681bb82 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.set">
<refnamediv>
@@ -16,16 +16,16 @@
<methodparam><type class="union"><type>array</type><type>string</type></type><parameter>type</parameter></methodparam>
<methodparam><type class="union"><type>array</type><type>string</type></type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Solicita ao agente <acronym>SNMP</acronym> remoto que defina o valor de
um ou mais objetos SNMP especificados pelo <parameter>objectId</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<para>
<simpara>
Se <parameter>objectId</parameter> for <type>string</type>, tanto
<parameter>type</parameter> quanto <parameter>value</parameter> também devem ser
<type>string</type>. Se <parameter>objectId</parameter> for <type>array</type>,
@@ -35,21 +35,21 @@
<parameter>objectId</parameter>-<parameter>value</parameter>) ou
um array de tamanho igual com valor por OID. Quando qualquer outra combinação de parâmetros for
usada, várias mensagens E_WARNING podem ser exibidas com descrição detalhada.
</para>
</simpara>
<varlistentry>
<term><parameter>objectId</parameter></term>
<listitem>
<para>
<simpara>
O ID do objeto SNMP
</para>
<para>
</simpara>
<simpara>
Quando a contagem de OIDs no array object_id for maior que
max_oids, o método de definição de propriedades do objeto precisará usar múltiplas consultas
para realizar as atualizações dos valores solicitados. Nesse caso, as verificações de tipo e valor
são feitas por bloco, de modo que a segunda ou as solicitações subsequentes podem falhar devido a
tipo ou valor incorreto para o OID solicitado. Para sinalizar isso, um aviso é
gerado quando a contagem de OIDs no array object_id for maior que max_oids.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -64,9 +64,9 @@
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
<simpara>
O novo valor.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -74,9 +74,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
&snmp.methods.exceptions_enable.refsect;

45
reference/snmp/snmp/setsecurity.xml
View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 888d70d7d21713f7f52d497e627543dfb41fc103 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="snmp.setsecurity" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.setsecurity">
<refnamediv>
<refname>SNMP::setSecurity</refname>
<refpurpose>Configura parâmetros de sessão <acronym>SNMP</acronym>v3 relacionados à segurança</refpurpose>
@@ -19,9 +20,9 @@
<methodparam choice="opt"><type>string</type><parameter>contextName</parameter><initializer>""</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>contextEngineId</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Este método configura parâmetros de sessão relacionados à segurança usados ​​no protocolo <acronym>SNMP</acronym> versão 3.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,57 +31,57 @@
<varlistentry>
<term><parameter>securityLevel</parameter></term>
<listitem>
<para>
<simpara>
O nível de segurança (noAuthNoPriv|authNoPriv|authPriv)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>authProtocol</parameter></term>
<listitem>
<para>
<simpara>
O protocolo de autenticação (MD5 ou SHA)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>authPassphrase</parameter></term>
<listitem>
<para>
<simpara>
A senha de autenticação
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacyProtocol</parameter></term>
<listitem>
<para>
<simpara>
O protocolo de privacidade (DES ou AES)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacyPassphrase</parameter></term>
<listitem>
<para>
<simpara>
A senha de privacidade
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>contextName</parameter></term>
<listitem>
<para>
<simpara>
O nome do contexto
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>contextEngineId</parameter></term>
<listitem>
<para>
<simpara>
O ID do mecanismo do contexto
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -88,17 +89,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example xml:id="snmp.setsecurity.example.basic">
<title>Exemplo de <methodname>SNMP::setSecurity</methodname></title>
<para>
</para>
<simpara>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

33
reference/snmp/snmp/walk.xml
View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 888d70d7d21713f7f52d497e627543dfb41fc103 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="snmp.walk" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="snmp.walk">
<refnamediv>
<refname>SNMP::walk</refname>
<refpurpose>Busca subárvore de objetos <acronym>SNMP</acronym></refpurpose>
@@ -16,9 +17,9 @@
<methodparam choice="opt"><type>int</type><parameter>maxRepetitions</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>nonRepeaters</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<methodname>SNMP::walk</methodname> é usado para ler a subárvore <acronym>SNMP</acronym> com raiz no <parameter>objectId</parameter> especificado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,36 +28,36 @@
<varlistentry>
<term><parameter>objectId</parameter></term>
<listitem>
<para>
<simpara>
Raiz da subárvore a ser buscada
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>suffixAsKey</parameter></term>
<listitem>
<para>
<simpara>
Por padrão, a notação OID completa é usada para chaves no array de saída.
Se definido como &true;, o prefixo da subárvore será removido das chaves, deixando apenas o sufixo do object_id.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nonRepeaters</parameter></term>
<listitem>
<para>
<simpara>
Especifica o número de variáveis ​​fornecidas que não devem ser iteradas.
O padrão é usar este valor a partir do objeto <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>maxRepetitions</parameter></term>
<listitem>
<para>
<simpara>
Especifica o número máximo de iterações sobre as variáveis ​​repetidas.
O padrão é usar este valor a partir do objeto <acronym>SNMP</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -64,13 +65,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna um array associativo dos IDs de objetos <acronym>SNMP</acronym> e seus valores em caso de sucesso ou &false; em caso de erro.
Quando ocorre um erro <acronym>SNMP</acronym>, <methodname>SNMP::getErrno</methodname> e
<methodname>SNMP::getError</methodname> podem ser usados ​​para recuperar o número do erro
(específico para a extensão SNMP, consulte as constantes de classe) e a mensagem de erro
respectivamente.
</para>
</simpara>
</refsect1>
&snmp.methods.exceptions_enable.refsect;
@@ -106,10 +107,10 @@ Array
</example>
<example xml:id="snmp.walk.example.suffix-as-key">
<title>Exemplo de <parameter>suffixAsKey</parameter></title>
<para>
<simpara>
<parameter>suffixAsKey</parameter> pode ser usado ao mesclar várias subárvores <acronym>SNMP</acronym> em uma.
Este exemplo mapeia nomes de interface para seus tipos.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

13
reference/snmp/snmpexception.xml
View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<reference xml:id="class.snmpexception" role="exception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: leonardolara Status: ready -->
<!-- CREDITS: leonardolara -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.snmpexception" role="exception">
<title>A classe SNMPException</title>
<titleabbrev>SNMPException</titleabbrev>
@@ -9,12 +10,12 @@
<!-- {{{ SNMPException intro -->
<section xml:id="snmpexception.intro">
&reftitle.intro;
<para>
<simpara>
Representa um erro gerado pelo SNMP. Não se deve lançar uma
<classname>SNMPException</classname> no próprio código.
Consulte <link linkend="language.exceptions">Exceções</link> para obter mais
informações sobre exceções em PHP.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -56,9 +57,9 @@
<varlistentry xml:id="snmpexception.props.code"><!-- {{{ -->
<term><varname>code</varname></term>
<listitem>
<para>
<simpara>
Código de erro da biblioteca <literal>SNMP</literal>. Use <function>Exception::getCode</function> para acessá-lo.
</para>
</simpara>
</listitem>
</varlistentry><!-- }}} -->
</variablelist>