getipnodebyname(3)         Library Functions Manual         getipnodebyname(3)

NUME
       nodebyname, getipnodebyaddr, freehostent - ob<?>ine nume de gazda <?>i
       adrese de re<?>ea

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <sys/types.h>
       #include <sys/socket.h>
       #include <netdb.h>

       [[deprecia]t] struct hostent *getipnodebyname(const char *name, int af,
                                                   int flags, int *error_num);
       [[depreciat]] struct hostent *getipnodebyaddr(const void addr[.len],
                                                   size_t len, int af,
                                                   int *error_num);
       [[depreciat]] void freehostent(struct hostent *ip);

DESCRIERE
       Aceste func<?>ii sunt depreciate (<?>i nu sunt disponibile in glibc).
       Utiliza<?>i in schimb getaddrinfo(3) <?>i getnameinfo(3).

       Func<?>iile getipnodebyname() <?>i getipnodebyaddr() returneaza numele
       <?>i adresele unei gazde de re<?>ea. Aceste func<?>ii returneaza un
       indicator la urmatoarea structura:

           struct hostent {
               char  *h_name;
               char **h_aliases;
               int    h_addrtype;
               int    h_length;
               char **h_addr_list;
           };

       Aceste func<?>ii inlocuiesc func<?>iile gethostbyname(3) <?>i
       gethostbyaddr(3), care puteau accesa numai familia de adrese de re<?>ea
       IPv4. Func<?>iile getipnodebyname() <?>i getipnodebyaddr() pot accesa
       mai multe familii de adrese de re<?>ea.

       Spre deosebire de func<?>iile gethostby, aceste func<?>ii returneaza
       indicatori catre memoria alocata dinamic. Func<?>ia freehostent() este
       utilizata pentru a elibera memoria alocata dinamic dupa ce apelantul nu
       mai are nevoie de structura hostent.

   argumente getipnodebyname()
       Func<?>ia getipnodebyname() cauta adresele de re<?>ea pentru gazda
       specificata de argumentul name.  Argumentul af specifica una dintre
       urmatoarele valori:

       AF_INET
              Argumentul name indica o adresa IPv4 cu patru grupe separate
              prin puncte sau un nume al unei gazde de re<?>ea IPv4.

       AF_INET6
              Argumentul name indica o adresa IPv6 in hexazecimal sau un nume
              al unei gazde de re<?>ea IPv6.

       Argumentul flags specifica op<?>iuni suplimentare. Se pot specifica mai
       multe op<?>iuni prin combinarea lor in mod binar OR- impreuna. flags
       trebuie sa fie stabilit la 0 daca nu se dore<?>te nicio op<?>iune.

       AI_V4MAPPED
              Acest fanion este utilizat impreuna cu AF_INET6 pentru a
              solicita o interogare pentru adrese IPv4 in loc de adrese IPv6;
              adresele IPv4 vor fi convertite in adrese IPv6.

       AI_ALL Acest fanion este utilizat impreuna cu AI_V4MAPPED pentru a
              solicita o interogare atat pentru adresele IPv4, cat <?>i pentru
              cele IPv6. Orice adresa IPv4 gasita va fi convertita intr-o
              adresa IPv6.

       AI_ADDRCONFIG
              Acest fanion este utilizat impreuna cu AF_INET6 pentru a
              solicita in continuare ca interogarile pentru adrese IPv6 sa nu
              fie efectuate decat daca sistemul are cel pu<?>in o adresa IPv6
              atribuita unei interfe<?>e de re<?>ea <?>i ca interogarile
              pentru adrese IPv4 sa nu fie efectuate decat daca sistemul are
              cel pu<?>in o adresa IPv4 atribuita unei interfe<?>e de re<?>ea.
              Acest fanion poate fi utilizat singur sau impreuna cu fanionul
              AI_V4MAPPED.

       AI_DEFAULT
              Acest fanion este echivalent cu (AI_ADDRCONFIG | AI_V4MAPPED).

   argumente getipnodebyaddr()
       Func<?>ia getipnodebyaddr() cauta numele gazdei a carei adresa de
       re<?>ea este specificata de argumentul addr.  Argumentul af specifica
       una dintre urmatoarele valori:

       AF_INET
              Argumentul addr indica o structura struct in_addr, iar len
              trebuie sa fie stabilit la sizeof(struct in_addr).

       AF_INET6
              Argumentul addr indica o structura struct in6_addr, iar len
              trebuie sa fie stabilit la sizeof(struct in6_addr).

VALOAREA RETURNATA
       Se returneaza NULL daca s-a produs o eroare, iar error_num va con<?>ine
       un cod de eroare din urmatoarea lista:

       HOST_NOT_FOUND
              Numele de gazda sau adresa de re<?>ea nu au fost gasite.

       NO_ADDRESS
              Serverul de nume de domeniu a recunoscut adresa sau numele
              re<?>elei, dar nu a primit niciun raspuns. Acest lucru se poate
              intampla in cazul in care gazda re<?>elei are numai adrese IPv4
              <?>i a fost facuta o cerere pentru informa<?>ii numai pentru
              IPv6 sau invers.

       NO_RECOVERY
              Serverul de nume de domeniu a returnat un raspuns de e<?>ec
              permanent.

       TRY_AGAIN
              Serverul de nume de domeniu a returnat un raspuns de e<?>ec
              temporar. S-ar putea sa ave<?>i mai mult noroc data viitoare.

       O interogare reu<?>ita returneaza un indicator catre o structura
       hostent care con<?>ine urmatoarele campuri:

       h_name Acesta este numele oficial al acestei gazde de re<?>ea.

       h_aliases
              Aceasta este o matrice de indicatoare catre nume alias
              neoficiale pentru aceea<?>i gazda. Matricea se termina cu un
              indicator nul.

       h_addrtype
              Aceasta este o copie a argumentului af pentru getipnodebyname()
              sau getipnodebyaddr(). h_addrtype va fi intotdeauna AF_INET daca
              argumentul af a fost AF_INET. h_addrtype va fi intotdeauna
              AF_INET6 daca argumentul af a fost AF_INET6.

       h_length
              Acest camp va fi stabilit la sizeof(struct in_addr) daca
              h_addrtype este AF_INET <?>i la sizeof(struct in6_addr) daca
              h_addrtype este AF_INET6.

       h_addr_list
              Aceasta este o matrice de unul sau mai mul<?>i indicatori la
              structurile de adrese de re<?>ea pentru gazda re<?>elei.
              Matricea se termina cu un indicator nul.

STANDARDE
       Niciunul.

ISTORIC
       RFC 2553.

       Prezente in glibc 2.1.91-95, dar au fost eliminate din nou.  Mai multe
       sisteme de tip UNIX le accepta, dar toate le numesc depreciate.

CONSULTA<?>I <?>I
       getaddrinfo(3), getnameinfo(3), inet_ntop(3), inet_pton(3)

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.9.1   2 mai 2024                getipnodebyname(3)