.\" -*- 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 "24 décembre 2024" "Pages du manuel de Linux 6.12" .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 .P \fBint getnetent_r(struct netent *restrict \fP\fIresult_buf\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict .\fP\fIsize\fP\fB], size_t \fP\fIsize\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\fIsize\fP\fB], size_t \fP\fIsize\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\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP \fB struct netent **restrict \fP\fIresult\fP\fB,\fP \fB int *restrict \fP\fIh_errnop\fP\fB);\fP .P .fi .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7)) : .RE .P \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. .P 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. .P .\" I can find no information on the required/recommended buffer size; .\" the nonreentrant functions use a 1024 byte buffer -- mtk. The \fIbuf\fP array is used to store the string fields pointed to by the returned \fInetent\fP structure. (The nonreentrant functions allocate these strings in static storage.) The size of this array is specified in \fIsize\fP. If \fIbuf\fP is too small, the call fails with the error \fBERANGE\fP, and the caller must try again with a larger buffer. (A buffer of size 1024 bytes should be sufficient for most applications.) .P 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. .P .\" 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. .P 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 is too small. Try again with a larger buffer (and increased \fIsize\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 .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 .