.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2008, Linux Foundation, written by Michael Kerrisk .\" .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getnetent_r 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" .SH NOM getnetent_r, getnetbyname_r, getnetbyaddr_r \- Lire les informations réseau (versions réentrantes) .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBint getnetent_r(struct netent *restrict \fP\fIresult_buf\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict .\fP\fIbuflen\fP\fB], size_t \fP\fIbuflen\fP\fB,\fP \fB struct netent **restrict \fP\fIresult\fP\fB,\fP \fB int *restrict \fP\fIh_errnop\fP\fB);\fP \fBint getnetbyname_r(const char *restrict \fP\fIname\fP\fB,\fP \fB struct netent *restrict \fP\fIresult_buf\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict .\fP\fIbuflen\fP\fB], size_t \fP\fIbuflen\fP\fB,\fP \fB struct netent **restrict \fP\fIresult\fP\fB,\fP \fB int *restrict \fP\fIh_errnop\fP\fB);\fP \fBint getnetbyaddr_r(uint32_t \fP\fInet\fP\fB, int \fP\fItype\fP\fB,\fP \fB struct netent *restrict \fP\fIresult_buf\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict .\fP\fIbuflen\fP\fB], size_t \fP\fIbuflen\fP\fB,\fP \fB struct netent **restrict \fP\fIresult\fP\fB,\fP \fB int *restrict \fP\fIh_errnop\fP\fB);\fP .PP .fi .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7))\ : .RE .PP \fBgetnetent_r\fP(), \fBgetnetbyname_r\fP(), \fBgetnetbyaddr_r\fP() : .nf Depuis la glibc 2.19 : _DEFAULT_SOURCE glibc 2.19 et antérieures : _BSD_SOURCE || _SVID_SOURCE .fi .SH DESCRIPTION Les fonctions \fBgetnetent_r\fP(), \fBgetnetbyname_r\fP(), et \fBgetnetbyaddr_r\fP() sont respectivement les versions réentrantes, de \fBgetnetent\fP(3), \fBgetnetbyname\fP(3), et \fBgetnetbyaddr\fP(3). Elles diffèrent dans le sens où la structure \fInetent\fP est renvoyée dans la signature de l'appel et dans la valeur de retour. .PP Au lieu de renvoyé un pointeur sur une structure \fInetent\fP statiquement allouée, ces fonctions copient la structure à l'adresse pointée par \fIresult_buf\fP. .PP .\" I can find no information on the required/recommended buffer size; .\" the nonreentrant functions use a 1024 byte buffer -- mtk. Le tableau \fIbuf\fP est utilisé pour sauvegarder les champs de la chaîne pointés par la structure \fInetent\fP renvoyée (les fonctions non réentrantes allouent ces chaînes de façon statique). La taille du tableau est indiquée avec \fIbuflen\fP. Si \fIbuf\fP est trop petit, l'appel échoue avec l'erreur \fBERANGE\fP, et l'appelant doit essayer de nouveau avec un tableau plus grand (un tableau de 1024 octets est en général suffisant). .PP Si la fonction obtient un enregistrement de réseau, alors \fI*result\fP pointe vers \fIresult_buf\fP sinon \fI*result\fP est défini à NULL. .PP .\" getnetent.3 doesn't document any use of h_errno, but nevertheless .\" the nonreentrant functions no seem to set h_errno. Le tampon pointé par \fIh_errnop\fP est utilisé pour renvoyé la valeur qui doit être sauvegardée dans la variable globale \fIh_errno\fP lors de l'utilisation des versions non réentrantes de ces fonctions. .SH "VALEUR RENVOYÉE" En cas de succès, ces fonctions renvoient zéro. En cas d'erreur, une valeur d'erreur positive listée dans ERREURS est renvoyée. .PP Dans le cas des erreurs, enregistrement non trouvé (\fBgetnetbyname_r\fP(), \fBgetnetbyaddr_r\fP()), ou fin de l'entrée (\fBgetnetent_r\fP()), \fIresult\fP est défini à NULL. .SH ERREURS .TP \fBENOENT\fP (\fBgetnetent_r\fP()) Plus d'enregistrement dans la base de données. .TP \fBERANGE\fP \fIbuf\fP est trop petit. Réessayer avec un tampon plus grand (et augmentez \fIbuflen\fP). .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Attribut Valeur T{ .na .nh \fBgetnetent_r\fP(), \fBgetnetbyname_r\fP(), \fBgetnetbyaddr_r\fP() T} Sécurité des threads MT\-Safe locale .TE .sp 1 .SH VERSIONS Des fonctions avec des noms similaires existent sur d'autres systèmes, bien qu’en général avec des signatures d'appel différentes. .SH STANDARDS GNU. .SH "VOIR AUSSI" \fBgetnetent\fP(3), \fBnetworks\fP(5) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier et David Prévot . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .