getservent_r(3)            Library Functions Manual            getservent_r(3)

NUME
       getservent_r, getservbyname_r, getservbyport_r - ob<?>ine intrarea
       serviciului (reentrant)

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <netdb.h>

       int getservent_r(struct servent *restrict result_buf,
                        char buf[restrict .buflen], size_t buflen,
                        struct servent **restrict result);
       int getservbyname_r(const char *restrict name,
                        const char *restrict proto,
                        struct servent *restrict result_buf,
                        char buf[restrict .buflen], size_t buflen,
                        struct servent **restrict result);
       int getservbyport_r(int port,
                        const char *restrict proto,
                        struct servent *restrict result_buf,
                        char buf[restrict .buflen], size_t buflen,
                        struct servent **restrict result);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       getservent_r(), getservbyname_r(), getservbyport_r():
           Incepand cu glibc 2.19:
               _DEFAULT_SOURCE
           glibc 2.19 <?>i versiunile anterioare:
               _BSD_SOURCE || _SVID_SOURCE

DESCRIERE
       Func<?>iile getservent_r(), getservbyname_r() <?>i getservbyport_r()
       sunt echivalentele reentrante ale func<?>iilor getservent(3),
       getservbyname(3) <?>i getservbyport(3). Ele difera prin modul in care
       este returnata structura servent, precum <?>i prin semnatura de apelare
       a func<?>iei <?>i valoarea de returnare. Aceasta pagina de manual
       descrie doar diferen<?>ele fa<?>a de func<?>iile ne reentrante.

       In loc sa returneze un indicator la o structura servent alocata static
       ca rezultat al func<?>iei, aceste func<?>ii copiaza structura in
       loca<?>ia indicata de result_buf.

       Matricea buf este utilizata pentru a stoca campurile de <?>iruri de
       caractere indicate de structura servent returnata; (func<?>iile
       nereturnante aloca aceste <?>iruri de caractere in memoria statica).
       Dimensiunea acestei matrice este specificata in buflen. Daca buf este
       prea mica, apelul e<?>ueaza cu eroarea ERANGE, iar apelantul trebuie sa
       incerce din nou cu o memorie tampon mai mare; (un buffer cu o lungime
       de 1024 octe<?>i ar trebui sa fie suficient pentru majoritatea
       aplica<?>iilor).

       Daca apelul func<?>iei ob<?>ine cu succes o eviden<?>a a serviciului,
       atunci *result este stabilit la result_buf; in caz contrar, *result
       este stabilit la NULL.

VALOAREA RETURNATA
       In caz de succes, aceste func<?>ii returneaza 0. In caz de eroare,
       acestea returneaza unul dintre numerele pozitive de eroare enumerate in
       sec<?>iunea ERORI-IE<?>IRE.

       In caz de eroare, inregistrare nedescoperita (getservbyname_r(),
       getservbyport_r()) sau sfar<?>it de intrare (getservent_r()), result
       este stabilit la NULL.

ERORI-IE<?>IRE
       ENOENT (getservent_r()) Nu mai exista inregistrari in baza de date.

       ERANGE buf este prea mic. Incerca<?>i din nou cu o memorie tampon mai
              mare (<?>i cu buflen marit).

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +-------------------------------+---------------------+----------------+
       |Interfa<?>a                    | Atribut             | Valoare        |
       +-------------------------------+---------------------+----------------+
       |getservent_r(),                | Siguran<?>a firelor | MT-Safe locale |
       |getservbyname_r(),             |                     |                |
       |getservbyport_r()              |                     |                |
       +-------------------------------+---------------------+----------------+
VERSIUNI
       Func<?>ii cu nume similare exista <?>i pe alte sisteme, de<?>i, de
       obicei, cu semnaturi de apelare diferite.

STANDARDE
       GNU.

EXEMPLE
       Programul de mai jos utilizeaza getservbyport_r() pentru a prelua
       inregistrarea serviciului pentru portul <?>i protocolul men<?>ionate in
       primul sau argument de linie de comanda. In cazul in care se furnizeaza
       un al treilea argument de linie de comanda (numar intreg), acesta este
       utilizat ca valoare ini<?>iala pentru buflen; daca getservbyport_r()
       e<?>ueaza cu eroarea ERANGE, programul incearca din nou cu dimensiuni
       mai mari ale memoriei tampon. Urmatoarea sesiune shell prezinta cateva
       exemple de execu<?>ie:

           $ ./a.out 7 tcp 1
           ERANGE! Se reincearca cu o memorie tampon mai mare
           getservbyport_r() returned: 0 (success)  (buflen=87)
           s_name=echo; s_proto=tcp; s_port=7; aliases=
           $ ./a.out 77777 tcp
           getservbyport_r() returned: 0 (success)  (buflen=1024)
           Apel e<?>uat/inregistrarea nu a fost gasita

   Sursa programului
       #define _GNU_SOURCE
       #include <ctype.h>
       #include <errno.h>
       #include <netdb.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <string.h>

       #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]\n", 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 depa<?>ita (%d)\n", 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 reincearca cu o memorie tampon mai mare\n");
                   erange_cnt++;

                   /* Incrementam cate un octet pe rand ca sa vedem exact
                      ce dimensiune a fost necesara pentru memoria tampon. */

                   buflen++;

                   if (buflen > MAX_BUF) {
                       printf("Limita memoriei tampon a fost depa<?>ita (%d)\n", MAX_BUF);
                       exit(EXIT_FAILURE);
                   }
               }
           } while (s == ERANGE);

           printf("getservbyport_r() returned: %s  (buflen=%d)\n",
                  (s == 0) ? "0 (success)" : (s == ENOENT) ? "ENOENT" :
                  strerror(s), buflen);

           if (s != 0 || result == NULL) {
               printf("Apel e<?>uat/inregistrarea nu a fost gasita\n");
               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("\n");

           exit(EXIT_SUCCESS);
       }

CONSULTA<?>I <?>I
       getservent(3), services(5)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023               getservent_r(3)