man getipnodebyname (3): określenie nazw i adresów sieciowych hosta

Other Alias

getipnodebyaddr, freehostent

SKŁADNIA

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

struct hostent *getipnodebyname(const char *name,
int af, int flags,
int *error_num);

struct hostent *getipnodebyaddr(const void *addr,
size_t len, int af,
int *error_num);

void freehostent(struct hostent *ip);

OPIS

Uwaga! To tłumaczenie może być nieaktualne!

Te funkcje są przestarzałe. Zamiast nich należy używać getaddrinfo(3) i getnameinfo(3).

Funkcje getipnodebyname(3) i getipnodebyaddr(3) zwracają nazwy i adresy hosta sieciowego. Wynik jest wskaźnikiem do struktury o następującej postaci:

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

Funkcje te zastąpiły funkcje gethostbyname(3) i gethostbyaddr(3), które mogły udostępniać jedynie adresy należące do rodziny adresów sieciowych IPv4. Funkcje getipnodebyname(3) i getipnodebyaddr(3) mogą udostępniać adresy należące do wielu rodzin adresów sieciowych.

W odróżnieniu od funkcji gethostby, funkcje te zwracają wskaźniki do pamięci przydzielonej dynamicznie. Funkcja freehostent(3) służy do zwalniania przydzielonej dynamicznie pamięci, gdy wywołujący już nie potrzebuje struktury hostent.

parametry getipnodebyname

Funkcja getipnodebyname(3) wyszukuje adresy sieciowe hosta podanego w parametrze name. Parametr af może zawierać jedną z następujących wartości:

AF_INET: Parametr name wskazuje na adres IPv4 (w postaci czterech rozdzielonych kropkami liczb) lub na nazwę hosta sieci IPv4.
AF_INET6: Parametr name wskazuje na adres IPv6 (w postaci szesnastkowej) lub na nazwę hosta sieci IPv6.

Parametr flags zawiera dodatkowe opcje. Można podać więcej niż jedną opcję poprzez wykonanie na nich logicznego OR. flags powinno być ustawione na 0, gdy żadne opcje nie są potrzebne.

AI_V4MAPPED: Ten znacznik użyty łącznie z AF_INET6 określa, że zapytanie ma dotyczyć adresów IPv4, a nie IPv6; adresy IPv4 będą odwzorowane na adresy IPv6.
AI_ALL: Ten znacznik użyty łącznie z AI_V4MAPPED określa, że zapytanie ma dotyczyć zarówno adresów IPv4, jak i IPv6. Znalezione adresy IPv4 zostaną odwzorowane na adresy IPv6.
AI_ADDRCONFIG: Ten znacznik użyty łącznie z AF_INET6 oznacza, że dalsze zapytania dotyczące adresów IPv6 nie powinny być wykonywane, jeżeli system nie posiada adresu IPv6 przydzielonego do któregoś z interfejsów sieciowych oraz, że dalsze zapytania dotyczące adresów IPv4 nie powinny być wykonywane, jeżeli system nie posiada adresu IPv4 przydzielonego do któregoś z interfejsów sieciowych. Znacznik ten może zostać użyty samodzielnie lub łącznie ze znacznikiem AI_V4MAPPED.
AI_ALL: Ten znacznik jest równoważny (AI_ADDRCONFIG | AI_V4MAPPED).

parametry getipnodebyaddr

Funkcja getipnodebyaddr(3) poszukuje nazwy hista, którego adres sieciowy jest podany w parametrze addr. Parametr af może mieć jedną z następujących wartości:

AF_INET: Parametr addr wskazuje na strukturę struct in_addr; len musi mieć wówczas wartość sizeof(struct in_addr).
AF_INET6: Parametr addr wskazuje na strukturę struct in6_addr; len musi mieć wówczas wartość sizeof(struct in6_addr).

WARTOŚĆ ZWRACANA

Gdy wystąpi błąd, zwrócony zostanie wskaźnik NULL a error_num będzie zawierać kod błędu według następującej listy:

HOST_NOT_FOUND: Nie znaleziono nazwy lub adresu sieciowego hosta.
NO_ADDRESS: Serwer DNS rozpoznał adres sieciowy lub nazwę hosta, ale nie zwrócił odpowiedzi. Może się to zdarzyć, gdy host posiada jedynie adresy IPv4, a zapytanie dotyczyło jedynie informacji o IPv6, lub odwrotnie.
NO_RECOVERY: Serwer DNS zwrócił błąd trwały.
TRY_AGAIN: Serwer DNS zwrócił błąd tymczasowy. Może następnym razem bedzie więcej szczęścia.

W przypadku pomyślnego wyniku zapytania zwraca ny jest wskaźnik do struktury hostent zawierającej następujące pola:

h_name: Oficjalna nazwa tego hosta.
h_aliases: Tablica wskaźników do nieoficjalnych aliasów tego samego hosta. Tablica jest zakończona wskaźnikiem NULL.
h_addrtype: Kopia parametru af funkcji getipnodebyname(3) lub getipnodebyaddr(3). h_addrtype będzie równe AF_INET, gdy parametr af był równy AF_INET. h_addrtype będzie równe AF_INET6, gdy parametr af był równy AF_INET6.
h_length: Będzie równe sizeof(struct in_addr), gdy h_addrtype jest równe AF_INET a sizeof(struct in6_addr), gdy h_addrtype jest równe AF_INET6.
h_addr_list: Tablica zawierająca jeden lub więcej wskaźników do struktur adresów sieciowych danego hosta. Tablica jest zakończona wskaźnikiem NULL.

UWAGI

Funkcje te były obecne w glibc 2.1.91-95, ale zostały ponownie usunięte. Wspierają je niektóre systemy uniksopodobne, lecz wszystkie traktują te funkcje jako niezalecane.

ZGODNE Z

RFC 2553.

INFORMACJE O TŁUMACZENIU

Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może nie być aktualne. W razie zauważenia różnic między powyższym opisem a rzeczywistym zachowaniem opisywanego programu lub funkcji, prosimy o zapoznanie się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:

: man --locale=C 3 getipnodebyname

Prosimy o pomoc w aktualizacji stron man - więcej informacji można znaleźć pod adresem http://sourceforge.net/projects/manpages-pl/.