diff --git a/language-snippets.ent b/language-snippets.ent index 848b8fa2b..2cfb925b2 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,5 +1,5 @@ - + @@ -1209,6 +1209,22 @@ de la codificación de caracteres interna.'> '> + + A partir de PHP 8.0.0, se lanza un ValueError si + encoding es una codificación no válida. + Anteriormente a PHP 8.0.0, se emitía un E_WARNING en su lugar. +'> + + + 8.0.0 + + Ahora se lanza un ValueError si + encoding es una codificación no válida. + Anteriormente, se emitía un E_WARNING + y se devolvía &false;. + +'> + Una de las constantes MCRYPT_ciphername, o el nombre del algoritmo como cadena.'> @@ -2086,6 +2102,42 @@ que PGSQL_BOTH devolverá ambos índices numéricos y asoci '> + + + + 8.1.0 + + El protocolo de autenticación ahora acepta "SHA256" + y "SHA512" cuando la biblioteca Net-SNMP lo admite. + +'> + + + 8.6.0 + + El protocolo de privacidad ahora acepta "AES192", + "AES192C", "AES256" y + "AES256C" cuando la biblioteca Net-SNMP lo admite. + +'> + +El nombre de seguridad, generalmente algún tipo de nombre de usuario.'> + +El nivel de seguridad: "noAuthNoPriv", +"authNoPriv" o "authPriv".'> + +El protocolo de autenticación: "MD5", "SHA", +"SHA256" o "SHA512".'> + +La frase secreta de autenticación.'> + +El protocolo de privacidad: "DES" o "AES", +aceptado también como "AES128". "AES192", "AES192C", +"AES256" y "AES256C" se aceptan cuando los admite la +biblioteca Net-SNMP.'> + +La frase secreta de privacidad.'> + diff --git a/reference/snmp/functions/snmp3-get.xml b/reference/snmp/functions/snmp3-get.xml index edb7a46e6..ba4cf3969 100644 --- a/reference/snmp/functions/snmp3-get.xml +++ b/reference/snmp/functions/snmp3-get.xml @@ -1,5 +1,5 @@ - + @@ -43,50 +43,37 @@ security_name - - El nombre de la seguridad, habitualmente, el nombre de usuario. - + &snmp.parameter.security-name; security_level - - El nivel de seguridad (noAuthNoPriv|authNoPriv|authPriv). - + &snmp.parameter.security-level; auth_protocol - - El protocolo de autenticación (MD5 o SHA) - + &snmp.parameter.auth-protocol; auth_passphrase - - La frase secreta de autenticación. - + &snmp.parameter.auth-passphrase; privacy_protocol - - El protocolo de autenticación ("MD5", "SHA", - "SHA256" o "SHA512"). - + &snmp.parameter.privacy-protocol; privacy_passphrase - - La frase secreta privada. - + &snmp.parameter.privacy-passphrase; @@ -135,6 +122,7 @@ + &snmp.changelog.privacy-protocol-aes; 8.5.0 @@ -144,14 +132,7 @@ timeout o reintentos son menores a -1 o demasiado grandes. - - 8.1.0 - - El parámetro auth_protocol acepta ahora - "SHA256" y "SHA512" - cuando es soportado por libnetsnmp. - - + &snmp.changelog.auth-protocol-sha2; diff --git a/reference/snmp/functions/snmp3-getnext.xml b/reference/snmp/functions/snmp3-getnext.xml index 41ad18c31..9f497366c 100644 --- a/reference/snmp/functions/snmp3-getnext.xml +++ b/reference/snmp/functions/snmp3-getnext.xml @@ -1,10 +1,10 @@ - + snmp3_getnext - Recupera el objeto SNMP que sigue inmediatamente al objeto proporcionado + Recupera el objeto SNMP que sigue al identificador de objeto proporcionado @@ -24,8 +24,8 @@ La función snmp3_getnext se utiliza para leer - el valor de un objeto SNMP que sigue inmediatamente - al especificado por el identificador object_id. + el valor del objeto SNMP que sigue al + object_id especificado. @@ -44,50 +44,37 @@ security_name - - El nombre de la seguridad, habitualmente, el nombre de usuario. - + &snmp.parameter.security-name; security_level - - El grado de seguridad (noAuthNoPriv|authNoPriv|authPriv). - + &snmp.parameter.security-level; auth_protocol - - El protocolo de autenticación (MD5 o SHA). - + &snmp.parameter.auth-protocol; auth_passphrase - - La frase secreta de autenticación. - + &snmp.parameter.auth-passphrase; privacy_protocol - - El protocolo de autenticación ("MD5", "SHA", - "SHA256" o "SHA512"). - + &snmp.parameter.privacy-protocol; privacy_passphrase - - La frase secreta privada. - + &snmp.parameter.privacy-passphrase; @@ -110,7 +97,7 @@ retries - 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. @@ -120,10 +107,8 @@ &reftitle.returnvalues; - Devuelve el valor del objeto SNMP 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 SNMP en caso de éxito o &false; en caso de error. + En caso de error, se muestra un mensaje E_WARNING. @@ -138,14 +123,8 @@ - - 8.1.0 - - El parámetro auth_protocol acepta ahora - "SHA256" y "SHA512" - cuando es soportado por libnetsnmp. - - + &snmp.changelog.privacy-protocol-aes; + &snmp.changelog.auth-protocol-sha2; @@ -154,11 +133,11 @@ &reftitle.examples; - Ejemplo con <function>snmp3_getnext</function> + Uso de <function>snmp3_getnext</function> ]]> diff --git a/reference/snmp/functions/snmp3-real-walk.xml b/reference/snmp/functions/snmp3-real-walk.xml index ba5140130..505989079 100644 --- a/reference/snmp/functions/snmp3-real-walk.xml +++ b/reference/snmp/functions/snmp3-real-walk.xml @@ -1,10 +1,10 @@ - + snmp3_real_walk - Devuelve todos los objetos incluyendo los identificadores de sus respectivos objetos + Devuelve todos los objetos incluyendo los identificadores de sus respectivos objetos @@ -23,7 +23,10 @@ intretries-1 - La función snmp3_real_walk se utiliza para recorrer un número de objetos SNMP comenzando por el objeto cuyo identificador es object_id y devuelve no solo sus valores, sino también los identificadores de los objetos asociados. + La función snmp3_real_walk se utiliza para recorrer un + número de objetos SNMP comenzando por + object_id y devuelve no solo sus valores, sino también + los identificadores de los objetos asociados. @@ -31,7 +34,9 @@ &reftitle.parameters; - hostname + + hostname + El nombre del host del agente SNMP (servidor). @@ -39,55 +44,57 @@ - security_name + + security_name + - - El nombre de seguridad, generalmente el nombre de usuario. - + &snmp.parameter.security-name; - security_level + + security_level + - - El nivel de seguridad (noAuthNoPriv|authNoPriv|authPriv). - + &snmp.parameter.security-level; - auth_protocol + + auth_protocol + - - El protocolo de autenticación (MD5 o SHA). - + &snmp.parameter.auth-protocol; - auth_passphrase + + auth_passphrase + - - La frase secreta de autenticación. - + &snmp.parameter.auth-passphrase; - privacy_protocol + + privacy_protocol + - - El protocolo de privacidad ("MD5", "SHA", "SHA256" o "SHA512"). - + &snmp.parameter.privacy-protocol; - privacy_passphrase + + privacy_passphrase + - - La frase secreta privada. - + &snmp.parameter.privacy-passphrase; - object_id + + object_id + El identificador del objeto SNMP. @@ -95,7 +102,9 @@ - timeout + + timeout + El número de microsegundos antes del primer tiempo límite. @@ -103,7 +112,9 @@ - retries + + retries + El número de intentos en caso de que ocurra un tiempo límite. @@ -116,7 +127,9 @@ &reftitle.returnvalues; - Devuelve un array asociativo de identificadores de objetos SNMP junto con sus valores en caso de éxito, o &false; si ocurre un error. En caso de error, se emite una alerta de nivel E_WARNING. + Devuelve un array asociativo de identificadores de objetos + SNMP junto con sus valores en caso de éxito, o &false; si + ocurre un error. En caso de error, se emite una alerta de nivel E_WARNING. @@ -131,12 +144,8 @@ - - 8.1.0 - - El parámetro auth_protocol acepta ahora "SHA256" y "SHA512" cuando es soportado por libnetsnmp. - - + &snmp.changelog.privacy-protocol-aes; + &snmp.changelog.auth-protocol-sha2; @@ -145,7 +154,9 @@ &reftitle.examples; - Ejemplo con <function>snmp3_real_walk</function> + Ejemplo con + <function>snmp3_real_walk</function> + - + @@ -25,13 +25,13 @@ intretries-1 - snmp3_set se utiliza para definir el - valor de un objeto SNMP especificado por - el parámetro object_id. + snmp3_set se utiliza para definir el valor de un objeto + SNMP especificado por el parámetro object_id. - Aunque el nivel de seguridad no utilice autenticación - o protocolo privado por contraseña, se deben especificar valores válidos. + Los argumentos de autenticación y de privacidad siempre se deben pasar, pero + sus valores se ignoran cuando security_level no los + utiliza. @@ -50,49 +50,37 @@ security_name - - El nombre de seguridad, generalmente, el nombre de usuario. - + &snmp.parameter.security-name; security_level - - El nivel de seguridad (noAuthNoPriv|authNoPriv|authPriv). - + &snmp.parameter.security-level; auth_protocol - - El protocolo de autenticación (MD5 o SHA). - + &snmp.parameter.auth-protocol; auth_passphrase - - La frase secreta para la autenticación. - + &snmp.parameter.auth-passphrase; privacy_protocol - - El protocolo privado (DES o AES). - + &snmp.parameter.privacy-protocol; privacy_passphrase - - La frase secreta privada. - + &snmp.parameter.privacy-passphrase; @@ -124,7 +112,7 @@ timeout - El número de milisegundos antes del primer tiempo límite. + El número de microsegundos antes del primer tiempo límite. @@ -145,8 +133,8 @@ &return.success; - Si el host SNMP rechaza el tipo de datos, se muestra una alerta de tipo - E_WARNING como "Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length." + Si el host SNMP rechaza el tipo de datos, se muestra un mensaje E_WARNING como + "Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length." Si se especifica un OID desconocido o inválido, la alerta será probablemente "Could not add variable". @@ -163,6 +151,7 @@ + &snmp.changelog.privacy-protocol-aes; 8.5.0 @@ -172,6 +161,7 @@ timeout o reintentos son menores a -1 o demasiado grandes. + &snmp.changelog.auth-protocol-sha2; @@ -179,30 +169,31 @@ &reftitle.examples; - - Ejemplo con <function>snmp3_set</function> - + + Ejemplo con <function>snmp3_set</function> + ]]> - - - - Ejemplo con <function>snmp3_set</function> para configurar el identificador del objeto <acronym>SNMP</acronym> BITS - + + + + Ejemplo con <function>snmp3_set</function> para definir un identificador de objeto <acronym>SNMP</acronym> BITS + ]]> - - + + + + @@ -23,13 +23,14 @@ intretries-1 - La función snmp3_walk se utiliza para leer - todos los valores desde un agente SNMP especificado - por el parámetro host. + La función snmp3_walk se utiliza para leer todos los + valores de un agente SNMP especificado por el parámetro + hostname. - Aunque el nivel de seguridad no utilice un protocolo - de autenticación, se deben especificar valores válidos. + Los argumentos de autenticación y de privacidad siempre deben ser pasados, + pero sus valores son ignorados cuando security_level + no los utiliza. @@ -47,64 +48,52 @@ security_name - - El nombre de la seguridad, habitualmente, el nombre del usuario. - + &snmp.parameter.security-name; security_level - - El nivel de seguridad (noAuthNoPriv|authNoPriv|authPriv). - + &snmp.parameter.security-level; auth_protocol - - El protocolo de autenticación ("MD5", "SHA", - "SHA256" o "SHA512"). - + &snmp.parameter.auth-protocol; auth_passphrase - - La frase secreta de autenticación. - + &snmp.parameter.auth-passphrase; privacy_protocol - - El protocolo privado (DES o AES). - + &snmp.parameter.privacy-protocol; privacy_passphrase - - La frase secreta privada. - + &snmp.parameter.privacy-passphrase; object_id - Si vale &null;, object_id será la raíz - del árbol de objetos SNMP y todos los - objetos subyacentes se devuelven en forma de array. + Si es una cadena vacía, object_id se toma como + .1.3.6.1.2.1, la raíz del árbol de objetos + SNMP, y todos los objetos bajo ese árbol se devuelven + en forma de array. - Si object_id está especificado, - todos los objetos SNMP bajo el objeto - object_id serán devueltos. + Si object_id está especificado, se devuelven todos + los objetos SNMP situados bajo ese + object_id. @@ -130,12 +119,13 @@ &reftitle.returnvalues; - Devuelve un array de valores de objetos SNMP - comenzando desde el objeto object_id - como raíz, o &false; si ocurre un error. + Devuelve un array de valores de objetos SNMP comenzando + desde el objeto object_id como raíz, o &false; si + ocurre un error. + &reftitle.changelog; @@ -147,14 +137,8 @@ - - 8.1.0 - - El parámetro auth_protocol acepta ahora - "SHA256" y "SHA512" - cuando es soportado por libnetsnmp. - - + &snmp.changelog.privacy-protocol-aes; + &snmp.changelog.auth-protocol-sha2; @@ -175,8 +159,8 @@ var_export($ret); La llamada a la función anterior devolverá todos los objetos - SNMP desde el agente - SNMP ejecutándose en localhost: + SNMP desde el agente SNMP + ejecutándose en localhost: 'STRING: lo', diff --git a/reference/snmp/snmp/construct.xml b/reference/snmp/snmp/construct.xml index 689ec1f10..ebef83518 100644 --- a/reference/snmp/snmp/construct.xml +++ b/reference/snmp/snmp/construct.xml @@ -1,5 +1,5 @@ - + @@ -42,12 +42,12 @@ El agente SNMP. El parámetro hostname - puede ser prefijado con el puerto del agente opcional SNMP - después de una coma. Las direcciones IPV6 deben estar rodeadas de corchetes ([]) - si se utilizan puertos adicionales. Si FQDN se utiliza para el parámetro + puede ir seguido del puerto opcional del agente SNMP + después de dos puntos. Las direcciones IPv6 deben ir entre corchetes + si se utilizan con un puerto. Si se utiliza un FQDN para hostname, será resuelto por la extensión PHP SNMP, - y no por el motor Net-SNMP. El uso de direcciones IPV6 - al utilizar FQDN puede ser forzado rodeando FQDN con corchetes. + y no por el motor Net-SNMP. El uso de direcciones IPv6 + al indicar un FQDN puede forzarse encerrando el FQDN entre corchetes. A continuación se muestran algunos ejemplos: @@ -58,8 +58,8 @@ IPv6 con puerto específico[::1]:1161 FQDN con puerto por defectohost.domain FQDN con puerto específicohost.domain:1161 - FQDN con puerto por defecto, forzando el uso de direcciones IPV6[host.domain] - FQDN con puerto específico, forzando el uso de direcciones IPV6[host.domain]:1161 + FQDN con puerto por defecto, forzando el uso de direcciones IPv6[host.domain] + FQDN con puerto específico, forzando el uso de direcciones IPv6[host.domain]:1161 @@ -70,9 +70,10 @@ community - Especifica el nivel de seguridad para la version dada. - El objetivo de la cadena de acceso community es específico - a la versión de SNMP: + La cadena de comunidad o, para SNMP::VERSION_3, el + nombre de seguridad. El objetivo de la cadena de acceso + community es específico de la versión de + SNMP: @@ -100,10 +101,7 @@ SNMP::VERSION_3 - Nombre de seguridad SNMPv3, puede ser uno de los siguientes: - noAuthNoPriv, - authNoPriv (se requiere una contraseña de autenticación y un protocolo de autenticación), o - authPriv (se requiere una contraseña y un protocolo de autenticación, así como una contraseña y un protocolo de confidencialidad) + &snmp.parameter.security-name; @@ -137,9 +135,9 @@ &reftitle.errors; - SNMP::__construct lanza una excepción cuando - los parámetros son incorrectos o la versión del protocolo SNMP - es desconocida. + SNMP::__construct lanza una excepción cuando el + número o los tipos de los parámetros son incorrectos, o cuando se especifica + una versión desconocida del protocolo SNMP. @@ -151,7 +149,7 @@ get("sysDescr.0"); echo "$sysdescr\n"; diff --git a/reference/snmp/snmp/setsecurity.xml b/reference/snmp/snmp/setsecurity.xml index 84effc585..6af76daec 100644 --- a/reference/snmp/snmp/setsecurity.xml +++ b/reference/snmp/snmp/setsecurity.xml @@ -1,5 +1,5 @@ - + @@ -21,7 +21,7 @@ stringcontextEngineId"" - Configura los parámetros de seguridad de las sesiones del protocolo SNMPv3. + setSecurity configura los parámetros de sesión relacionados con la seguridad utilizados en la versión 3 del protocolo SNMP @@ -31,41 +31,31 @@ securityLevel - - el nivel de seguridad (noAuthNoPriv|authNoPriv|authPriv) - + &snmp.parameter.security-level; authProtocol - - el protocolo de autenticación (MD5 o SHA) - + &snmp.parameter.auth-protocol; authPassphrase - - la frase de paso para la autenticación - + &snmp.parameter.auth-passphrase; privacyProtocol - - el protocolo privado (DES o AES) - + &snmp.parameter.privacy-protocol; privacyPassphrase - - la frase de paso para el protocolo privado - + &snmp.parameter.privacy-passphrase; @@ -80,7 +70,7 @@ contextEngineId - el contexto EngineID + el EngineID del contexto @@ -94,6 +84,24 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &snmp.changelog.privacy-protocol-aes; + &snmp.changelog.auth-protocol-sha2; + + + + + &reftitle.examples; @@ -103,7 +111,7 @@ setSecurity('authPriv', 'MD5', $auth_pass, 'AES', $priv_pass, '', 'aeeeff'); ?> ]]>