Skip to content

[Sync-En] snmp: factor out the SNMPv3 security parameter descriptions #1176

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 1 commit into
base: master
Choose a base branch
from
Open

[Sync-En] snmp: factor out the SNMPv3 security parameter descriptions #1176

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 53 additions & 1 deletion language-snippets.ent
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9e5166dc6a5ff650b649298470d19eb7c3637a63 Maintainer: argosback Status: ready -->
<!-- EN-Revision: 1ab1069cdd60b4ec4c18c0832924e20109159902 Maintainer: argosback Status: ready -->

<!ENTITY installation.enabled.disable 'Esta extensión está activada por defecto. Puede ser desactivada utilizando la opción de configuración: '>

Expand Down Expand Up @@ -1209,6 +1209,22 @@ de la codificación de caracteres interna.</simpara>'>
</entry>
</row>'>

<!ENTITY mbstring.errors.encoding-invalid '<para xmlns="http://docbook.org/ns/docbook">
A partir de PHP 8.0.0, se lanza un <exceptionname>ValueError</exceptionname> si
<parameter>encoding</parameter> es una codificación no válida.
Anteriormente a PHP 8.0.0, se emitía un <constant>E_WARNING</constant> en su lugar.
</para>'>

<!ENTITY mbstring.changelog.encoding-invalid '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
Ahora se lanza un <exceptionname>ValueError</exceptionname> si
<parameter>encoding</parameter> es una codificación no válida.
Anteriormente, se emitía un <constant>E_WARNING</constant>
y se devolvía &false;.
</entry>
</row>'>

<!-- mcrypt notes -->

<!ENTITY mcrypt.parameter.cipher '<simpara xmlns="http://docbook.org/ns/docbook">Una de las constantes <constant>MCRYPT_ciphername</constant>, o el nombre del algoritmo como cadena.</simpara>'>
Expand Down Expand Up @@ -2086,6 +2102,42 @@ que <constant>PGSQL_BOTH</constant> devolverá ambos índices numéricos y asoci
</entry>
</row>'>

<!-- SNMP entities -->

<!ENTITY snmp.changelog.auth-protocol-sha2 '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
El protocolo de autenticación ahora acepta <literal>"SHA256"</literal>
y <literal>"SHA512"</literal> cuando la biblioteca Net-SNMP lo admite.
</entry>
</row>'>

<!ENTITY snmp.changelog.privacy-protocol-aes '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.6.0</entry>
<entry>
El protocolo de privacidad ahora acepta <literal>"AES192"</literal>,
<literal>"AES192C"</literal>, <literal>"AES256"</literal> y
<literal>"AES256C"</literal> cuando la biblioteca Net-SNMP lo admite.
</entry>
</row>'>

<!ENTITY snmp.parameter.security-name '<simpara xmlns="http://docbook.org/ns/docbook">El nombre de seguridad, generalmente algún tipo de nombre de usuario.</simpara>'>

<!ENTITY snmp.parameter.security-level '<simpara xmlns="http://docbook.org/ns/docbook">El nivel de seguridad: <literal>"noAuthNoPriv"</literal>,
<literal>"authNoPriv"</literal> o <literal>"authPriv"</literal>.</simpara>'>

<!ENTITY snmp.parameter.auth-protocol '<simpara xmlns="http://docbook.org/ns/docbook">El protocolo de autenticación: <literal>"MD5"</literal>, <literal>"SHA"</literal>,
<literal>"SHA256"</literal> o <literal>"SHA512"</literal>.</simpara>'>

<!ENTITY snmp.parameter.auth-passphrase '<simpara xmlns="http://docbook.org/ns/docbook">La frase secreta de autenticación.</simpara>'>

<!ENTITY snmp.parameter.privacy-protocol '<simpara xmlns="http://docbook.org/ns/docbook">El protocolo de privacidad: <literal>"DES"</literal> o <literal>"AES"</literal>,
aceptado también como <literal>"AES128"</literal>. <literal>"AES192"</literal>, <literal>"AES192C"</literal>,
<literal>"AES256"</literal> y <literal>"AES256C"</literal> se aceptan cuando los admite la
biblioteca Net-SNMP.</simpara>'>

<!ENTITY snmp.parameter.privacy-passphrase '<simpara xmlns="http://docbook.org/ns/docbook">La frase secreta de privacidad.</simpara>'>

<!-- Common pieces for reference part END -->


Expand Down
37 changes: 9 additions & 28 deletions reference/snmp/functions/snmp3-get.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd22c782164c9f8d79f5de8991876d1588a21015 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 1ab1069cdd60b4ec4c18c0832924e20109159902 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.snmp3-get">
<refnamediv>
Expand Down Expand Up @@ -43,50 +43,37 @@
<varlistentry>
<term><parameter>security_name</parameter></term>
<listitem>
<simpara>
El nombre de la seguridad, habitualmente, el nombre de usuario.
</simpara>
&snmp.parameter.security-name;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>security_level</parameter></term>
<listitem>
<simpara>
El nivel de seguridad (noAuthNoPriv|authNoPriv|authPriv).
</simpara>
&snmp.parameter.security-level;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_protocol</parameter></term>
<listitem>
<simpara>
El protocolo de autenticación (MD5 o SHA)
</simpara>
&snmp.parameter.auth-protocol;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_passphrase</parameter></term>
<listitem>
<simpara>
La frase secreta de autenticación.
</simpara>
&snmp.parameter.auth-passphrase;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_protocol</parameter></term>
<listitem>
<simpara>
El protocolo de autenticación (<literal>"MD5"</literal>, <literal>"SHA"</literal>,
<literal>"SHA256"</literal> o <literal>"SHA512"</literal>).
</simpara>
&snmp.parameter.privacy-protocol;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_passphrase</parameter></term>
<listitem>
<simpara>
La frase secreta privada.
</simpara>
&snmp.parameter.privacy-passphrase;
</listitem>
</varlistentry>
<varlistentry>
Expand Down Expand Up @@ -135,6 +122,7 @@
</row>
</thead>
<tbody>
&snmp.changelog.privacy-protocol-aes;
<row>
<entry>8.5.0</entry>
<entry>
Expand All @@ -144,14 +132,7 @@
timeout o reintentos son menores a -1 o demasiado grandes.
</entry>
</row>
<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>
&snmp.changelog.auth-protocol-sha2;
</tbody>
</tgroup>
</informaltable>
Expand Down
55 changes: 17 additions & 38 deletions reference/snmp/functions/snmp3-getnext.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 40906725410aac6fe8cac4913a557a1784bf04b9 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 1ab1069cdd60b4ec4c18c0832924e20109159902 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<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>
<refpurpose>Recupera el objeto <acronym>SNMP</acronym> que sigue al identificador de objeto proporcionado</refpurpose>
</refnamediv>

<refsect1 role="description">
Expand All @@ -24,8 +24,8 @@
</methodsynopsis>
<simpara>
La función <function>snmp3_getnext</function> se utiliza para leer
el valor de un objeto <acronym>SNMP</acronym> que sigue inmediatamente
al especificado por el identificador <parameter>object_id</parameter>.
el valor del objeto <acronym>SNMP</acronym> que sigue al
<parameter>object_id</parameter> especificado.
</simpara>
</refsect1>

Expand All @@ -44,50 +44,37 @@
<varlistentry>
<term><parameter>security_name</parameter></term>
<listitem>
<simpara>
El nombre de la seguridad, habitualmente, el nombre de usuario.
</simpara>
&snmp.parameter.security-name;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>security_level</parameter></term>
<listitem>
<simpara>
El grado de seguridad (noAuthNoPriv|authNoPriv|authPriv).
</simpara>
&snmp.parameter.security-level;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_protocol</parameter></term>
<listitem>
<simpara>
El protocolo de autenticación (MD5 o SHA).
</simpara>
&snmp.parameter.auth-protocol;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_passphrase</parameter></term>
<listitem>
<simpara>
La frase secreta de autenticación.
</simpara>
&snmp.parameter.auth-passphrase;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_protocol</parameter></term>
<listitem>
<simpara>
El protocolo de autenticación (<literal>"MD5"</literal>, <literal>"SHA"</literal>,
<literal>"SHA256"</literal> o <literal>"SHA512"</literal>).
</simpara>
&snmp.parameter.privacy-protocol;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>privacy_passphrase</parameter></term>
<listitem>
<simpara>
La frase secreta privada.
</simpara>
&snmp.parameter.privacy-passphrase;
</listitem>
</varlistentry>
<varlistentry>
Expand All @@ -110,7 +97,7 @@
<term><parameter>retries</parameter></term>
<listitem>
<simpara>
El número de intentos en caso de que ocurra un tiempo límite.
El número de reintentos en caso de que ocurran tiempos límite.
</simpara>
</listitem>
</varlistentry>
Expand All @@ -120,10 +107,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Devuelve el valor del objeto <acronym>SNMP</acronym> en caso
de éxito o &false; si ocurre un error.
En caso de error, se emitirá una alerta de tipo
E_WARNING.
Devuelve el valor del objeto <acronym>SNMP</acronym> en caso de éxito o &false; en caso de error.
En caso de error, se muestra un mensaje E_WARNING.
</simpara>
</refsect1>

Expand All @@ -138,14 +123,8 @@
</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>
&snmp.changelog.privacy-protocol-aes;
&snmp.changelog.auth-protocol-sha2;
</tbody>
</tgroup>
</informaltable>
Expand All @@ -154,11 +133,11 @@
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>snmp3_getnext</function></title>
<title>Uso de <function>snmp3_getnext</function></title>
<programlisting role="php">
<![CDATA[
<?php
$nameOfSecondInterface = snmp3_getnext('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName.1');
$nameOfSecondInterface = snmp3_getnext('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName.1');
?>
]]>
</programlisting>
Expand Down
Loading