.\" -*- coding: UTF-8 -*- .\" Copyright 2000 Sam Varshavchik .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References: RFC 2553 .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getipnodebyname 3 "30 martie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME nodebyname, getipnodebyaddr, freehostent \- obține nume de gazdă și adrese de rețea .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP \fB#include \fP \fB#include \fP .PP \fB[[deprecia]t] struct hostent *getipnodebyname(const char *\fP\fIname\fP\fB, int \fP\fIaf\fP\fB,\fP \fB int \fP\fIflags\fP\fB, int *\fP\fIerror_num\fP\fB);\fP \fB[[depreciat]] struct hostent *getipnodebyaddr(const void \fP\fIaddr\fP\fB[.\fP\fIlen\fP\fB],\fP \fB size_t \fP\fIlen\fP\fB, int \fP\fIaf\fP\fB,\fP \fB int *\fP\fIerror_num\fP\fB);\fP \fB[[depreciat]] void freehostent(struct hostent *\fP\fIip\fP\fB);\fP .fi .SH DESCRIERE Aceste funcții sunt depreciate (și nu sunt disponibile în glibc). Utilizați în schimb \fBgetaddrinfo\fP(3) și \fBgetnameinfo\fP(3). .PP Funcțiile \fBgetipnodebyname\fP() și \fBgetipnodebyaddr\fP() returnează numele și adresele unei gazde de rețea. Aceste funcții returnează un indicator la următoarea structură: .PP .in +4n .EX struct hostent { char *h_name; char **h_aliases; int h_addrtype; int h_length; char **h_addr_list; }; .EE .in .PP Aceste funcții înlocuiesc funcțiile \fBgethostbyname\fP(3) și \fBgethostbyaddr\fP(3), care puteau accesa numai familia de adrese de rețea IPv4. Funcțiile \fBgetipnodebyname\fP() și \fBgetipnodebyaddr\fP() pot accesa mai multe familii de adrese de rețea. .PP Spre deosebire de funcțiile \fBgethostby\fP, aceste funcții returnează indicatori către memoria alocată dinamic. Funcția \fBfreehostent\fP() este utilizată pentru a elibera memoria alocată dinamic după ce apelantul nu mai are nevoie de structura \fIhostent\fP. .SS "argumente getipnodebyname()" Funcția \fBgetipnodebyname\fP() caută adresele de rețea pentru gazda specificată de argumentul \fIname\fP. Argumentul \fIaf\fP specifică una dintre următoarele valori: .TP \fBAF_INET\fP Argumentul \fIname\fP indică o adresă IPv4 cu patru grupe separate prin puncte sau un nume al unei gazde de rețea IPv4. .TP \fBAF_INET6\fP Argumentul \fIname\fP indică o adresă IPv6 în hexazecimal sau un nume al unei gazde de rețea IPv6. .PP Argumentul \fIflags\fP specifică opțiuni suplimentare. Se pot specifica mai multe opțiuni prin combinarea lor în mod binar OR\- împreună. \fIflags\fP trebuie să fie stabilit la 0 dacă nu se dorește nicio opțiune. .TP \fBAI_V4MAPPED\fP Acest fanion este utilizat împreună cu \fBAF_INET6\fP pentru a solicita o interogare pentru adrese IPv4 în loc de adrese IPv6; adresele IPv4 vor fi convertite în adrese IPv6. .TP \fBAI_ALL\fP Acest fanion este utilizat împreună cu \fBAI_V4MAPPED\fP pentru a solicita o interogare atât pentru adresele IPv4, cât și pentru cele IPv6. Orice adresă IPv4 găsită va fi convertită într\-o adresă IPv6. .TP \fBAI_ADDRCONFIG\fP Acest fanion este utilizat împreună cu \fBAF_INET6\fP pentru a solicita în continuare ca interogările pentru adrese IPv6 să nu fie efectuate decât dacă sistemul are cel puțin o adresă IPv6 atribuită unei interfețe de rețea și ca interogările pentru adrese IPv4 să nu fie efectuate decât dacă sistemul are cel puțin o adresă IPv4 atribuită unei interfețe de rețea. Acest fanion poate fi utilizat singur sau împreună cu fanionul \fBAI_V4MAPPED\fP. .TP \fBAI_DEFAULT\fP Acest fanion este echivalent cu \fB(AI_ADDRCONFIG | AI_V4MAPPED)\fP. .SS "argumente getipnodebyaddr()" Funcția \fBgetipnodebyaddr\fP() caută numele gazdei a cărei adresă de rețea este specificată de argumentul \fIaddr\fP. Argumentul \fIaf\fP specifică una dintre următoarele valori: .TP \fBAF_INET\fP Argumentul \fIaddr\fP indică o structură \fIstruct in_addr\fP, iar \fIlen\fP trebuie să fie stabilit la \fIsizeof(struct in_addr)\fP. .TP \fBAF_INET6\fP Argumentul \fIaddr\fP indică o structură \fIstruct in6_addr\fP, iar \fIlen\fP trebuie să fie stabilit la \fIsizeof(struct in6_addr)\fP. .SH "VALOAREA RETURNATĂ" Se returnează NULL dacă s\-a produs o eroare, iar \fIerror_num\fP va conține un cod de eroare din următoarea listă: .TP \fBHOST_NOT_FOUND\fP Numele de gazdă sau adresa de rețea nu au fost găsite. .TP \fBNO_ADDRESS\fP Serverul de nume de domeniu a recunoscut adresa sau numele rețelei, dar nu a primit niciun răspuns. Acest lucru se poate întâmpla în cazul în care gazda rețelei are numai adrese IPv4 și a fost făcută o cerere pentru informații numai pentru IPv6 sau invers. .TP \fBNO_RECOVERY\fP Serverul de nume de domeniu a returnat un răspuns de eșec permanent. .TP \fBTRY_AGAIN\fP Serverul de nume de domeniu a returnat un răspuns de eșec temporar. S\-ar putea să aveți mai mult noroc data viitoare. .PP O interogare reușită returnează un indicator către o structură \fIhostent\fP care conține următoarele câmpuri: .TP \fIh_name\fP Acesta este numele oficial al acestei gazde de rețea. .TP \fIh_aliases\fP Aceasta este o matrice de indicatoare către nume alias neoficiale pentru aceeași gazdă. Matricea se termină cu un indicator nul. .TP \fIh_addrtype\fP Aceasta este o copie a argumentului \fIaf\fP pentru \fBgetipnodebyname\fP() sau \fBgetipnodebyaddr\fP(). \fIh_addrtype\fP va fi întotdeauna \fBAF_INET\fP dacă argumentul \fIaf\fP a fost \fBAF_INET\fP. \fIh_addrtype\fP va fi întotdeauna \fBAF_INET6\fP dacă argumentul \fIaf\fP a fost \fBAF_INET6\fP. .TP \fIh_length\fP Acest câmp va fi stabilit la \fIsizeof(struct in_addr)\fP dacă \fIh_addrtype\fP este \fBAF_INET\fP și la \fIsizeof(struct in6_addr)\fP dacă \fIh_addrtype\fP este \fBAF_INET6\fP. .TP \fIh_addr_list\fP Aceasta este o matrice de unul sau mai mulți indicatori la structurile de adrese de rețea pentru gazda rețelei. Matricea se termină cu un indicator nul. .SH STANDARDE Niciunul. .SH ISTORIC .\" Not in POSIX.1-2001. RFC\ 2553. .PP Prezente în glibc 2.1.91\-95, dar au fost eliminate din nou. Mai multe sisteme de tip UNIX le acceptă, dar toate le numesc depreciate. .SH "CONSULTAȚI ȘI" \fBgetaddrinfo\fP(3), \fBgetnameinfo\fP(3), \fBinet_ntop\fP(3), \fBinet_pton\fP(3) .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 .