Provided by: manpages-pl-dev_0.5-1_all 
NAZWA
gethostbyname, gethostbyaddr, sethostent, endhostent, herror, hstrerror - zwróć wpis sieciowy komputera
SKŁADNIA
#include <netdb.h>
extern int h_errno;
struct hostent *gethostbyname(const char *nazwa);
#include <sys/socket.h> /* dla AF_INET */
struct hostent *gethostbyaddr(const char *adres,
int dlug, int typ);
void sethostent(int stayopen);
void endhostent(void);
void herror(const char *s);
const char *hstrerror(int err);
/* rozszerzenia GNU */
struct hostent *gethostbyname2(const char *nazwa, int af);
int gethostbyname_r (const char *nazwa,
struct hostent *ret, char *buf, size_t buflen,
struct hostent **result, int *h_errnop);
int gethostbyname2_r (const char *nazwa, int af,
struct hostent *ret, char *buf, size_t buflen,
struct hostent **result, int *h_errnop);
OPIS
Uwaga! To tłumaczenie może być nieaktualne!
Funkcja gethostbyname() dla danego komputera nazwa zwraca strukturę typu hostent. Nazwa jest tutaj albo
nazwą komputera, albo adresem IPv4 w standardowej notacji z kropkami, albo adresem IPv6 w notacji ze
średnikami (i być może kropkami). (Proszę przeczytać RFC 1984, aby uzyskać opis adresów IPv6). Jeżeli
nazwa jest adresem Ipv4 lub IPv6, to gethostbyname() nie wykonuje żadnych sprawdzeń i po prostu kopiuje
nazwę do pola h_name oraz jej odpowiednik struct in_addr do pola h_addr_list[0] zwracanej struktury
hostent. Jeżeli nazwa nie kończy się kropką oraz ustawiono zmienną środowiskową HOSTALIASES, to
wyszukiwanie nazwy zacznie się od pliku z aliasami, wskazywanego przez HOSTALIASES. (format tego pliku
opisany jest w hostname(7)). Bieżąca domenta i jej domeny nadrzędne są przeszukiwane, chyba że nazwa
kończy się kropką.
Funkcja gethostbyaddr() zwraca strukturę typu hostent dla zadanego adresu adres o długości dlug i typie
adresu typ. Obecnie jedynym poprawnym typem adresu jest AF_INET.
Funkcja sethostent() określa, jeżeli stayopen jest prawdziwe (1), że do odpytywania serwera nazw będzie
użyte połączenie TCP i to połączenie będzie otwarte podczas kolejnych zapytań. W przeciwnym wypadku
serwer nazw będzie odpytywany przy użyciu datagramów UDP.
Funkcja endhostent() kończy połączenie TCP odpytywania serwera nazw.
(Przestarzała) funkcja herror() wypisuje na standardowe wyjście błędów komunikat błędu przypisany do
bieżącej wartości zmiennej h_errno.
(Przestarzała) funkcja hstrerror() dla przekazanego numeru błędu (zazwyczaj h_errno) zwraca odpowiadający
mu komunikat błędu.
Funkcje gethostbyname() i gethostbyaddr() używają do odpytywania serwera kombinacji któregokolwiek bądź
wszystkich serwerów nazw named(8), wydzielonych linii z /etc/hosts, oraz Systemu Informacji Sieciowej
(Network Information Service - NIS lub YP), w zależności od zawartości linii order w pliku
/etc/host.conf. (Proszę przeczytać resolv+(8)). Domyślnie najpierw odpytywane są serwery named(8), a
następnie przeglądany jest /etc/hosts.
Struktura hostent zdefiniowana w <netdb.h> następująco:
struct hostent {
char *h_name; /* oficjalna nazwa komputera */
char **h_aliases; /* lista aliasów */
int h_addrtype; /* typ adresu komputera */
int h_length; /* długość adresu */
char **h_addr_list; /* lista adresów */
}
#define h_addr h_addr_list[0] /* dla zachowania zgodności */
/* z wcześniejszymi wersjami */
Struktra hostent składa się z:
h_name Oficjalna nazwa komputera.
h_aliases
Zakończona zerem tablica alternatywnych nazw komputera.
h_addrtype
Typ adresu; obecnie zawsze jest to AF_INET.
h_length
Długość adresu w bajtach.
h_addr_list
Zakończona zerem tablica adresów sieciowych komputera w sieciowym porządku bajtów (network byte
order).
h_addr Pierwszy adres z h_addr_list - dla zachowania zgodności ze wcześniejszymi wersjami
WARTOŚĆ ZWRACANA
Funkcje gethostbyname() i gethostbyaddr() zwracają strukturę hostent lub wskaźnik NULL w przypadku błędu.
W razie błędu, zmienna h_errno przechowuje numer błędu.
BŁĘDY
Zmienna h_errno może przyjmować następujące wartości:
HOST_NOT_FOUND
Podany komputer jest nieznany.
NO_ADDRESS lub NO_DATA
Żądana nazwa jest poprawna, ale nie ma adresu IP.
NO_RECOVERY
Wystąpił trwały błąd serwera nazw.
TRY_AGAIN
Autorytatywny serwer nazw zwrócił tymczasowy błąd. Proszę spróbować ponownie później.
PLIKI
/etc/host.conf
plik konfiguracyjny resolver configuration file
/etc/hosts
plik bazy danych komputerów
ZGODNE Z
BSD 4.3.
UWAGI
Standard SUS-v2 jest błędny i określa parametr len funkcji gethostbyaddr() jako mający typ size_t. (No
nie jest właściwe, ponieważ musi to być typ int, którym size_t nie jest. POSIX 1003.1-2001 używa
socklen_t, co jest OK)
Funkcje gethostbyname() i gethostbyaddr() mogą zwracać wskaźniki do danych statycznych, które mogą być
nadpisane przez kolejne wywołania. Kopiowanie struct hostent nie wystarcza, ponieważ zawiera ona
wskaźniki - wymagane jest skopiowanie wszystkiego.
Glibc2 ma także funkcję gethostbyname2(), która działa jak gethostbyname(), ale pozwala określić rodzinę
adresów, do której musi należeć zadany adres.
Glibc2 ma także wielowątkowe wersje gethostbyname_r() i gethostbyname2_r(). Zwracają one 0 w przypadku
powodzenia i niezero w razie błędu. Wynik funkcji jest przechowywany w strukturze o adresie ret. Po
wywołaniu funkcji *result będzie NULL w razie błędu albo wskaźnikiem do wyniku, gdy funkcja zakończy się
powodzeniem. Pomocnicze dane są przechowywane w buforze buf o długości buflen. (Jeżeli bufor jest za
mały, to funkcje te zwrócą ERANGE.) Globalna zmienna h_errno nie jest modyfikowana, ale numer błędu jest
przekazywany w zmiennej, której adres został podany w h_errnop.
POSIX 1003.1-2001 traktuje gethostbyaddr() i gethostbyname() jako spuściznę i wprowadza
struct hostent *getipnodebyaddr (const void *restrict addr,
socklen_t len, int type, int *restrict error_num);
struct hostent *getipnodebyname (const char *name,
int type, int flags, int *error_num);
ZOBACZ TAKŻE
resolver(3), hosts(5), hostname(7), resolv+(8), named(8)
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 gethostbyname
Prosimy o pomoc w aktualizacji stron man - więcej informacji można znaleźć pod adresem
http://sourceforge.net/projects/manpages-pl/.
BSD 2000-08-12 GETHOSTBYNAME(3)