From 9a5a4abe608035d52f9ad7944381a776415c81fe Mon Sep 17 00:00:00 2001 From: David CARLIER Date: Wed, 20 Nov 2024 12:57:57 +0000 Subject: [PATCH] network sync with EN (#1775) --- reference/network/constants.xml | 942 +++++++++++++----- .../network/functions/dns-get-record.xml | 32 +- reference/network/functions/openlog.xml | 154 +-- reference/network/functions/syslog.xml | 61 +- 4 files changed, 727 insertions(+), 462 deletions(-) diff --git a/reference/network/constants.xml b/reference/network/constants.xml index ff2ef62ca4..c40bf58729 100644 --- a/reference/network/constants.xml +++ b/reference/network/constants.xml @@ -1,275 +1,687 @@ - + &reftitle.constants; &extension.constants.core; - - - Options de <function>openlog</function> - - - - Constante - Description - - - - - LOG_CONS - - S'il y a une erreur lors de l'envoi de données au système d'historique, - l'erreur sera écrite directement sur la console système. - - - - LOG_NDELAY - - Ouvre la connexion à l'historique immédiatement - - - - LOG_ODELAY - - (par défaut) retarde l'ouverture de la connexion jusqu'à ce que le premier - message soit archivé - - - - LOG_NOWAIT - - - - - LOG_PERROR - Affiche aussi le message sur la sortie standard - - - LOG_PID - Ajoute le PID dans chaque message - - - -
- - - Facilité de <function>syslog</function> - - - - Constante - Description - - - - - LOG_AUTH - - sécurité/autorisation message (utilisez LOG_AUTHPRIV à la place - sur les systèmes où cette constante n'est pas définie) - - - - LOG_AUTHPRIV - sécurité/autorisation message (privé) - - - LOG_CRON - démon de temps (cron et at) - - - LOG_DAEMON - autres démons systèmes - - - LOG_KERN - messages noyau - - - LOG_LOCAL0 - réservé à un usage local, non disponible sous Windows - - - LOG_LOCAL1 - réservé à un usage local, non disponible sous Windows - - - LOG_LOCAL2 - réservé à un usage local, non disponible sous Windows - - - LOG_LOCAL3 - réservé à un usage local, non disponible sous Windows - - - LOG_LOCAL4 - réservé à un usage local, non disponible sous Windows - - - LOG_LOCAL5 - réservé à un usage local, non disponible sous Windows - - - LOG_LOCAL6 - réservé à un usage local, non disponible sous Windows - - - LOG_LOCAL7 - réservé à un usage local, non disponible sous Windows - - - LOG_LPR - imprimante système - - - LOG_MAIL - système de mail - - - LOG_NEWS - système de news USENET - - - LOG_SYSLOG - messages générés en interne par le démon syslogd - - - LOG_USER - messages génériques utilisateurs - - - LOG_UUCP - système UUCP - - - -
- - Priorités de <function>syslog</function> (en ordre décroissant) - - - - Constante - Description - - - - - LOG_EMERG - Le système est inutilisable - - - LOG_ALERT - Une mesure doit être prise immédiatement - - - LOG_CRIT - Conditions critiques - - - LOG_ERR - Erreurs - - - LOG_WARNING - Alertes - - - LOG_NOTICE - Notes (normales mais significatives) - - - LOG_INFO - Message d'informations - - - LOG_DEBUG - Message de déboguage - - - -
- - Options <function>dns_get_record</function> - - - - Constante - Description - - - - - DNS_A - Adresse IPv4 - - - DNS_A6 - Défini dans le cadre des débuts de l'IPv6 mais rétrogradé à historique par la RFC 6563 - - - DNS_CAA - Certification Authority Authorization Resource (disponible à partir de PHP 7.0.16 et 7.1.2) - - - DNS_MX - Champs serveur Mail (MX) - - - DNS_CNAME - Champs alias (Nom canonique) (A) - - - DNS_NAPTR - Pointeur d'Autorité de Nom - - - DNS_NS - Champs de serveur autorité (NS) - - - DNS_PTR - Champs de pointeur (PTR) - - - DNS_HINFO - Champs d'informations d'hôte (HINFO) (voir la - Operating System Names - pour la signification de ces valeurs) - - - DNS_SOA - Champs de délégation d'autorité (SOA) - - - DNS_SRV - Localisateur de service - - - DNS_TXT - Texte - - - DNS_ANY - Tous les champs. Sur la plupart des systèmes, - cela retourne tous les champs, mais il ne faut pas - s'y fier. Utilisez DNS_ALL. - - - - DNS_AAAA - Adresse IPv6 - - - DNS_ALL - Sollicite itérativement le serveur pour chaque - type de champ. - - - -
+ + + <parameter>flags</parameter> disponibles pour + <function>openlog</function> + + + + + LOG_CONS + (int) + + + + Si une erreur se produit lors de l'envoi des données au journal système, + écrire directement sur la console système. + + + + + + + LOG_NDELAY + (int) + + + + Ouvrir immédiatement la connexion au journal. + + + + + + + LOG_ODELAY + (int) + + + + Retarder l'ouverture de la connexion jusqu'à l'enregistrement du premier message. + C'est le comportement par défaut. + + + + + + + LOG_NOWAIT + (int) + + + + + + + + + + LOG_PERROR + (int) + + + + Enregistrer également les messages dans STDERR. + + + + + + + LOG_PID + (int) + + + + Inclure l'ID de processus (PID) avec chaque message journal. + + + + + + + + <parameter>facility</parameter> disponibles pour + <function>openlog</function> + + + + + LOG_AUTH + (int) + + + + Pour les messages de sécurité ou d'autorisation. + + + + Utiliser LOG_AUTHPRIV à la place lorsque disponible. + + + + + + + + LOG_AUTHPRIV + (int) + + + + Pour les messages de sécurité ou d'autorisation privés. + + + + + + + LOG_CRON + (int) + + + + Pour les messages du démon de planification. + Par exemple, cron ou at. + + + + + + + LOG_DAEMON + (int) + + + + Pour les messages des démons système. + + + + + + + LOG_KERN + (int) + + + + Pour les messages du noyau. + + + + + + + LOG_LOCAL0 + (int) + + + + Réservé à un usage local. + + + + Non disponible sur Windows. + + + + + + + + LOG_LOCAL1 + (int) + + + + Réservé à un usage local. + + + + Non disponible sur Windows. + + + + + + + + LOG_LOCAL2 + (int) + + + + Réservé pour un usage local. + + + + Non disponible sur Windows. + + + + + + + + LOG_LOCAL3 + (int) + + + + Réservé pour un usage local. + + + + Non disponible sur Windows. + + + + + + + + LOG_LOCAL4 + (int) + + + + Réservé pour un usage local. + + + + Non disponible sur Windows. + + + + + + + + LOG_LOCAL5 + (int) + + + + Réservé pour un usage local. + + + + Non disponible sur Windows. + + + + + + + + LOG_LOCAL6 + (int) + + + + Réservé pour un usage local. + + + + Non disponible sur Windows. + + + + + + + + LOG_LOCAL7 + (int) + + + + Réservé pour un usage local. + + + + Non disponible sur Windows. + + + + + + + + LOG_LPR + (int) + + + + Pour les messages provenant du sous-système de l'imprimante en ligne. + + + + + + + LOG_MAIL + (int) + + + + Pour les messages provenant du sous-système de messagerie. + + + + + + + LOG_NEWS + (int) + + + + Pour les messages provenant du sous-système de nouvelles USENET. + + + + + + + LOG_SYSLOG + (int) + + + + Pour les messages générés en interne par syslogd. + + + + + + + LOG_USER + (int) + + + + Pour les messages génériques au niveau de l'utilisateur. + + + + + + + LOG_UUCP + (int) + + + + Pour les messages provenant du sous-système UUCP. + + + + + + + + Priorités disponibles pour + <function>syslog</function> + + + + Les constantes de priorité sont listées de l'urgence aux messages de débogage. + + + + + LOG_EMERG + (int) + + + + Urgence, le système est inutilisable. + Cela correspond à une condition de panique. + Habituellement diffusé à tous les processus. + + + + + + + LOG_ALERT + (int) + + + + Alerte, une action immédiate est requise. + Par exemple, une base de données système corrompue. + + + + + + + LOG_CRIT + (int) + + + + Critique, une action est requise. + Par exemple, une erreur matérielle. + + + + + + + LOG_ERR + (int) + + + + Messages d'erreur. + + + + + + + LOG_WARNING + (int) + + + + Messages d'avertissement. + + + + + + + LOG_NOTICE + (int) + + + + Messages de notification, correspondant à des conditions qui ne sont pas des erreurs, + mais qui peuvent nécessiter un traitement spécial. + + + + + + + LOG_INFO + (int) + + + + Messages informatifs. + + + + + + + LOG_DEBUG + (int) + + + + Messages de débogage contenant des informations généralement utiles uniquement lors + du débogage d'un programme. + + + + + + + + Types disponibles pour + <function>dns_get_record</function> + + + + + DNS_ANY + (int) + + + + Tout enregistrement de ressource. + Sur la plupart des systèmes, cela renvoie tous les enregistrements de ressources, + cependant, en raison des particularités des performances de + libresolv entre les plateformes, cela n'est pas garanti. + + + Le plus lent DNS_ALL collectera tous les enregistrements plus fiablement. + + + + + + + DNS_ALL + (int) + + + + Requête itérative du serveur de noms pour chaque type d'enregistrement disponible. + + + + + + + DNS_A + (int) + + + + Enregistrement d'adresse IPv4. + + + + + + + DNS_AAAA + (int) + + + + Ressource d'adresse IPv6. + + + + + + + DNS_A6 + (int) + + + + Défini dans les premières spécifications IPv6, mais rétrogradé en historique par + RFC 6563. + + + + + + + DNS_CAA + (int) + + + + Ressource d'autorisation d'autorité de certification. + Disponible à partir de PHP 7.0.16 et 7.1.2. + + + + Non disponible sous Windows. + + + + + + + + DNS_CNAME + (int) + + + + Ressource d'alias (Nom canonique). + + + + + + + DNS_HINFO + (int) + + + + Ressource d'information sur l'hôte. + Pour plus d'explications et de significations de ces valeurs, consultez la page de l'IANA sur + Noms des systèmes d'exploitation. + + + + + + + DNS_MX + (int) + + + + Ressource d'échangeur de courrier. + + + + + + + DNS_NAPTR + (int) + + + + Pointeur d'autorité de nom. + + + + + + + DNS_NS + (int) + + + + Ressource du serveur de noms autoritaire. + + + + + + + DNS_PTR + (int) + + + + Ressource de pointeur. + + + + + + + DNS_SOA + (int) + + + + Ressource de début d'autorité. + + + + + + + DNS_SRV + (int) + + + + Localisateur de service. + + + + + + + DNS_TXT + (int) + + + + Ressource de texte. + + + + + - + @@ -55,32 +55,10 @@ Par défaut, dns_get_record va rechercher toutes les - ressources associées à hostname. Pour limiter la - taille de la requête, le paramètre optionnel type - peut prendre l'une des valeurs constantes suivantes : - DNS_A, DNS_CNAME, - DNS_HINFO, DNS_CAA, - DNS_MX, DNS_NS, - DNS_PTR, DNS_SOA, - DNS_TXT, DNS_AAAA, - DNS_SRV, DNS_NAPTR, - DNS_A6, DNS_ALL - ou DNS_ANY. + ressources associées à hostname. + Pour limiter la requête, utilisez l'une des constantes + DNS_*. - - - À cause des performances excentriques de la bibliothèque libresolv, - suivant les plates-formes, DNS_ANY ne retournera - pas toujours tous les enregistrements, et l'option DNS_ALL, - bien que plus lente, le fera de manière plus sûre. - - - - - Windows : DNS_CAA n'est pas supporté. - Support pour DNS_A6 n'est pas implémenté. - - @@ -107,7 +85,7 @@ Le type sera interprété comme un ID de type DNS brut - (les constantes DNS_* ne peuvent pas être utilisé). + (les constantes DNS_* ne peuvent pas être utilisées). La valeur de retour contiendra une clé data, qui doit être manuellement analysé. diff --git a/reference/network/functions/openlog.xml b/reference/network/functions/openlog.xml index e720a30bf4..e31fa5eb04 100644 --- a/reference/network/functions/openlog.xml +++ b/reference/network/functions/openlog.xml @@ -1,6 +1,6 @@ - + @@ -45,54 +45,15 @@ flags - L'argument flags indique - les options de journalisation utilisées pour générer le message. - - Options pour la fonction <function>openlog</function> - - - - Constante - Description - - - - - LOG_CONS - - Si une erreur survient lors de l'envoi des données au gestionnaire - d'historique, écrire directement l'erreur sur la console. - - - - LOG_NDELAY - - Ouvre immédiatement une connexion au gestionnaire d'historique. - - - - LOG_ODELAY - - Retarde l'ouverture de la connexion jusqu'à ce que le - premier message soit enregistré (par défaut). - - - - LOG_PERROR - Envoie le message au gestionnaire standard. - - - LOG_PID - Inclut le PID à chaque message. - - - -
- Vous pouvez utiliser une ou plusieurs de ces options. Pour les - combiner, utiliser l'opérateur OR. Par exemple, - pour ouvrir immédiatement la connexion, écrire sur la console et - inclure le PID de chaque message, utilisez : - LOG_CONS | LOG_NDELAY | LOG_PID. + Masque de bits des constantes suivantes : + + LOG_CONS + LOG_NDELAY + LOG_ODELAY + LOG_NOWAIT + LOG_PERROR + LOG_PID + @@ -100,81 +61,30 @@ facility - L'argument facility sert à indiquer quel programme - enregistre ce message. Cela vous permet de spécifier - (sur la machine d'historique) comment traiter les messages venant - de plusieurs serveurs. - - Paramètre <parameter>facility</parameter> d'<function>openlog</function> - - - - Constante - Description - - - - - LOG_AUTH - - sécurité/messages d'autorisation (utilisez - LOG_AUTHPRIV, pour - remplacer cette constante sur les systèmes où elle est définie). - - - - LOG_AUTHPRIV - sécurité/messages d'autorisation (privé) - - - LOG_CRON - démon horloge (cron et at) - - - LOG_DAEMON - autres démons système - - - LOG_KERN - noyau (kernel) - - - LOG_LOCAL0 ... LOG_LOCAL7 - réservé pour utilisation locale. Inutilisable sous Windows - - - LOG_LPR - imprimante (line printer subsystem) - - - LOG_MAIL - messagerie mail - - - LOG_NEWS - USENET : groupes de news (newsgroup) - - - LOG_SYSLOG - messages générés en interne par syslogd - - - LOG_USER - messages utilisateurs génériques - - - LOG_UUCP - sous-système UUCP - - - -
+ L'argument facility est utilisé pour spécifier + le type de programme qui enregistre le message. + Cela permet au fichier de configuration de spécifier que les messages provenant de différentes + installations seront traités différemment. + Doit être l'une des constantes suivantes : + + LOG_AUTH + LOG_AUTHPRIV + LOG_CRON + LOG_DAEMON + LOG_KERN + LOG_LOCAL[0-7] + LOG_LPR + LOG_MAIL + LOG_NEWS + LOG_SYSLOG + LOG_USER + LOG_UUCP + - - LOG_USER est le seul type valide sous les environnements - Windows. - + + Ce paramètre est ignoré sur Windows. + diff --git a/reference/network/functions/syslog.xml b/reference/network/functions/syslog.xml index d13d892478..0bb671160a 100644 --- a/reference/network/functions/syslog.xml +++ b/reference/network/functions/syslog.xml @@ -1,6 +1,6 @@ - + @@ -39,53 +39,18 @@ priority - priority est une combinaison des valeurs - d'accès et de niveau. Les valeurs possibles sont : - - Priorités <function>syslog</function> (en ordre décroissant) - - - - Constante - Description - - - - - LOG_EMERG - système inutilisable - - - LOG_ALERT - une décision doit être prise immédiatement - - - LOG_CRIT - condition critique - - - LOG_ERR - condition d'erreur - - - LOG_WARNING - condition d'alerte - - - LOG_NOTICE - condition normale, mais significative - - - LOG_INFO - message d'information - - - LOG_DEBUG - message de déboguage - - - -
+ L'une des + + LOG_EMERG + LOG_ALERT + LOG_CRIT + LOG_ERR + LOG_WARNING + LOG_NOTICE + LOG_INFO + LOG_DEBUG + + constantes.