.\" -*- 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 getservent_r 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME getservent_r, getservbyname_r, getservbyport_r \- obține intrarea serviciului (reentrant) .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP .PP \fBint getservent_r(struct servent *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 servent **restrict \fP\fIresult\fP\fB);\fP \fBint getservbyname_r(const char *restrict \fP\fIname\fP\fB,\fP \fB const char *restrict \fP\fIproto\fP\fB,\fP \fB struct servent *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 servent **restrict \fP\fIresult\fP\fB);\fP \fBint getservbyport_r(int \fP\fIport\fP\fB,\fP \fB const char *restrict \fP\fIproto\fP\fB,\fP \fB struct servent *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 servent **restrict \fP\fIresult\fP\fB);\fP .PP .fi .RS -4 Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați \fBfeature_test_macros\fP(7)): .RE .PP \fBgetservent_r\fP(), \fBgetservbyname_r\fP(), \fBgetservbyport_r\fP(): .nf Începând cu glibc 2.19: _DEFAULT_SOURCE glibc 2.19 și versiunile anterioare: _BSD_SOURCE || _SVID_SOURCE .fi .SH DESCRIERE Funcțiile \fBgetservent_r\fP(), \fBgetservbyname_r\fP() și \fBgetservbyport_r\fP() sunt echivalentele reentrante ale funcțiilor \fBgetservent\fP(3), \fBgetservbyname\fP(3) și \fBgetservbyport\fP(3). Ele diferă prin modul în care este returnată structura \fIservent\fP, precum și prin semnătura de apelare a funcției și valoarea de returnare. Această pagină de manual descrie doar diferențele față de funcțiile ne reentrante. .PP În loc să returneze un indicator la o structură \fIservent\fP alocată static ca rezultat al funcției, aceste funcții copiază structura în locația indicată de \fIresult_buf\fP. .PP .\" I can find no information on the required/recommended buffer size; .\" the nonreentrant functions use a 1024 byte buffer -- mtk. Matricea \fIbuf\fP este utilizată pentru a stoca câmpurile de șiruri de caractere indicate de structura \fIservent\fP returnată; (funcțiile nereturnante alocă aceste șiruri de caractere în memoria statică). Dimensiunea acestei matrice este specificată în \fIbuflen\fP. Dacă \fIbuf\fP este prea mică, apelul eșuează cu eroarea \fBERANGE\fP, iar apelantul trebuie să încerce din nou cu o memorie tampon mai mare; (un buffer cu o lungime de 1024 octeți ar trebui să fie suficient pentru majoritatea aplicațiilor). .PP Dacă apelul funcției obține cu succes o evidență a serviciului, atunci \fI*result\fP este stabilit la \fIresult_buf\fP; în caz contrar, \fI*result\fP este stabilit la NULL. .SH "VALOAREA RETURNATĂ" În caz de succes, aceste funcții returnează 0. În caz de eroare, acestea returnează unul dintre numerele pozitive de eroare enumerate în secțiunea ERORI\-IEȘIRE. .PP În caz de eroare, înregistrare nedescoperită (\fBgetservbyname_r\fP(), \fBgetservbyport_r\fP()) sau sfârșit de intrare (\fBgetservent_r\fP()), \fIresult\fP este stabilit la NULL. .SH ERORI\-IEȘIRE .TP \fBENOENT\fP (\fBgetservent_r\fP()) Nu mai există înregistrări în baza de date. .TP \fBERANGE\fP \fIbuf\fP este prea mic. Încercați din nou cu o memorie tampon mai mare (și cu \fIbuflen\fP mărit). .SH ATRIBUTE Pentru o explicație a termenilor folosiți în această secțiune, a se vedea \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interfață Atribut Valoare T{ .na .nh \fBgetservent_r\fP(), \fBgetservbyname_r\fP(), \fBgetservbyport_r\fP() T} Siguranța firelor MT\-Safe locale .TE .sp 1 .SH VERSIUNI Funcții cu nume similare există și pe alte sisteme, deși, de obicei, cu semnături de apelare diferite. .SH STANDARDE GNU. .SH EXEMPLE Programul de mai jos utilizează \fBgetservbyport_r\fP() pentru a prelua înregistrarea serviciului pentru portul și protocolul menționate în primul său argument de linie de comandă. În cazul în care se furnizează un al treilea argument de linie de comandă (număr întreg), acesta este utilizat ca valoare inițială pentru \fIbuflen\fP; dacă \fBgetservbyport_r\fP() eșuează cu eroarea \fBERANGE\fP, programul încearcă din nou cu dimensiuni mai mari ale memoriei tampon. Următoarea sesiune shell prezintă câteva exemple de execuție: .PP .in +4n .EX $\fB ./a.out 7 tcp 1\fP ERANGE! Se reîncearcă cu o memorie tampon mai mare getservbyport_r() returned: 0 (success) (buflen=87) s_name=echo; s_proto=tcp; s_port=7; aliases= $\fB ./a.out 77777 tcp\fP getservbyport_r() returned: 0 (success) (buflen=1024) Apel eșuat/înregistrarea nu a fost găsită .EE .in .SS "Sursa programului" .\" SRC BEGIN (getservent_r.c) \& .EX #define _GNU_SOURCE #include #include #include #include #include #include \& #define MAX_BUF 10000 \& int main(int argc, char *argv[]) { int buflen, erange_cnt, port, s; struct servent result_buf; struct servent *result; char buf[MAX_BUF]; char *protop; \& if (argc < 3) { printf("Utilizare: %s port\-num proto\-name [buflen]\en", argv[0]); exit(EXIT_FAILURE); } \& port = htons(atoi(argv[1])); protop = (strcmp(argv[2], "null") == 0 || strcmp(argv[2], "NULL") == 0) ? NULL : argv[2]; \& buflen = 1024; if (argc > 3) buflen = atoi(argv[3]); \& if (buflen > MAX_BUF) { printf("Limita memoriei tampon a fost depășită (%d)\en", MAX_BUF); exit(EXIT_FAILURE); } \& erange_cnt = 0; do { s = getservbyport_r(port, protop, &result_buf, buf, buflen, &result); if (s == ERANGE) { if (erange_cnt == 0) printf("ERANGE! Se reîncearcă cu o memorie tampon mai mare\en"); erange_cnt++; \& /* Incrementăm câte un octet pe rând ca să vedem exact ce dimensiune a fost necesară pentru memoria tampon. */ \& buflen++; \& if (buflen > MAX_BUF) { printf("Limita memoriei tampon a fost depășită (%d)\en", MAX_BUF); exit(EXIT_FAILURE); } } } while (s == ERANGE); \& printf("getservbyport_r() returned: %s (buflen=%d)\en", (s == 0) ? "0 (success)" : (s == ENOENT) ? "ENOENT" : strerror(s), buflen); \& if (s != 0 || result == NULL) { printf("Apel eșuat/înregistrarea nu a fost găsită\en"); exit(EXIT_FAILURE); } \& printf("s_name=%s; s_proto=%s; s_port=%d; aliases=", result_buf.s_name, result_buf.s_proto, ntohs(result_buf.s_port)); for (char **p = result_buf.s_aliases; *p != NULL; p++) printf("%s ", *p); printf("\en"); \& exit(EXIT_SUCCESS); } .EE .\" SRC END .SH "CONSULTAȚI ȘI" \fBgetservent\fP(3), \fBservices\fP(5) .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .