Skip to content

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

Open
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-en/1164-snmpv3-security
Open

[Sync-En] snmp: factor out the SNMPv3 security parameter descriptions#1176
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-en/1164-snmpv3-security

Conversation

@lacatoire

@lacatoire lacatoire commented Aug 31, 2026

Copy link
Copy Markdown
Member

Mirrors php/doc-en#5228 (commit 1ab1069) for reference/snmp. The SNMPv3 security parameter descriptions were duplicated by hand across six pages and had drifted apart; they are now defined once in language-snippets.ent as snmp.parameter.* entities, translated into Spanish, and referenced by the pages.

This fixes real errors the Spanish pages carried, notably privacy_protocol described with the authentication protocols on four pages, and snmp3_set() documenting timeout in milliseconds instead of microseconds. language-snippets.ent also gains the two mbstring.*.encoding-invalid entities added upstream by an intermediate commit, without which its EN-Revision would be inaccurate.

Fixes: #1164

Mirrors php/doc-en#5228 (commit 1ab1069) for reference/snmp.

The SNMPv3 security parameter descriptions were duplicated by hand across
six pages and had drifted apart. They are now defined once in
language-snippets.ent as snmp.parameter.* entities, translated into
Spanish, and the pages reference them.

This fixes several errors the Spanish pages carried:

- snmp3_get(), snmp3_getnext(), snmp3_real_walk() and snmp3_walk()
  described privacy_protocol with the authentication protocols
  ("MD5", "SHA", "SHA256", "SHA512"), which it does not accept
- snmp3_set() documented timeout in milliseconds instead of microseconds
- SNMP::setSecurity() had no changelog section at all
- SNMP::__construct() described the community parameter in terms of the
  security level, and hostname as suffixed after a comma rather than a colon
- the examples used the SNMP_VERSION_* constants instead of SNMP::VERSION_*

The privacy protocol list is completed the same way as EN ("AES128" as an
alias of "AES", plus "AES192", "AES192C", "AES256" and "AES256C").

language-snippets.ent also gains mbstring.errors.encoding-invalid and
mbstring.changelog.encoding-invalid, added upstream by an intermediate
commit: without them the file would claim to mirror 1ab1069 while missing
part of it.

Fixes: php#1164
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Sync EN] Fix and factor out the SNMPv3 security parameter descriptions (#5228)

1 participant