NAZWA¶

SKŁADNIA¶

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

int getnameinfo(const struct sockaddr *addr, socklen_t addrlen,
                char *host, socklen_t hostlen,
                char *serv, socklen_t servlen, int flags);

Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

getnameinfo(): Od glibc 2.22: _POSIX_C_SOURCE >= 201112L Glibc 2.21 i wcześniejsze: _POSIX_C_SOURCE

OPIS¶

Argument sa jest wskaźnikiem do ogólnej struktury adresu gniazda (typu sockaddr_in lub sockaddr_in6) o rozmiarze addrlen, która przechowuje wejściowy adres IP i numer portu. Argumenty host i port są wskaźnikami do zaalokowanych przez program wywołujący tę funkcję buforów (odpowiednio o rozmiarach hostlen i servlen), w których getnameinfo() umieści zakończone NULL-em łańcuchy znaków zawierające odpowiednio nazwę komputera i nazwy usług.

Funkcja wywołująca może określić, że nazwa komputera (lub nazwa serwisu) nie jest potrzebna, przez przekazanie wartości NULL w argumencie host (lub serv) albo przez podanie 0 w parametrze hostlen (lub servlen). Jednakże co najmniej jeden z podanych parametrów (nazwa komputera lub nazwa serwisu) musi być ustawiony.

Argument flags zmienia zachowanie getnameinfo() w następujący sposób:

NI_NAMEREQD

Jeśli ustawiono, to w razie nieznalezienia nazwy komputera zwracany jest błąd.

NI_DGRAM

Jeżeli ustawiono, to serwis jest oparty raczej na datagramach (UDP) niż na strumieniach (TCP). Jest to wymagane dla kilku portów (512-514), które mają przypisane inne serwisy dla UDP niż dla TCP.

NI_NOFQDN

Jeżeli ustawiono, to zwracana jest tylko lokalna część nazwy komputera, a nie jego pełną domenowa nazwa sieciowa.

NI_NUMERICHOST

Jeśli ustawiono, to nazwa komputera jest zwracana w formie numerycznej. (Może się to również zdarzyć wtedy, gdy nie ustawiono tej flagi i nie można znaleźć nazwy komputera).

NI_NUMERICSERV

Jeśli ustawiono, to nazwa komputera jest zwracana w formie numerycznej. (Może się to również zdarzyć wtedy, gdy nie ustawiono tej flagi i nie można znaleźć nazwy komputera).

WARTOŚĆ ZWRACANA¶

EAI_AGAIN

Obecnie nie można znaleźć nazwy. Proszę spróbować później.

EAI_BADFLAGS

Argument flags ma niepoprawną wartość.

EAI_FAIL

Wystąpił błąd krytyczny.

EAI_FAMILY

Nieznana rodzina adresów lub długość adresu nie jest odpowiednia dla podanej rodziny.

EAI_MEMORY

Brak pamięci.

EAI_NONAME

Nie można rozwinąć nazwy dla podanych parametrów. Ustawiono NI_NAMEREQD, a nie można znaleźć nazwy komputera albo nie zażądano ani nazwy komputera, ani nazwy serwisu.

EAI_OVERFLOW

Bufor, na który wskazywał parametr host lub serv, był za mały.

EAI_SYSTEM

Wystąpił błąd systemowy. Numer błędu można znaleźć w zmiennej errno.

Funkcja gai_strerror(3) przekształca te kody błędów w komunikat zrozumiały dla człowieka, więc jest odpowiednia do raportowania błędów.

PLIKI¶

WERSJE¶

ATRYBUTY¶

ZGODNE Z¶

UWAGI¶

#define NI_MAXHOST      1025
#define NI_MAXSERV      32

Od glibc 2.8 powyższe definicje są dostępne, jeśli zdefiniowano odpowiednie makro, mianowicie: _GNU_SOURCE, _DEFAULT_SOURCE (od glibc 2.19) lub (w wersjach glibc do 2.19 włącznie) _BSD_SOURCE lub _SVID_SOURCE.

Pierwsza z nich jest stałą MAXDNAME zdefiniowaną w pliku nagłówkowym <arpa/nameser.h> z nowszych wersji BIND-a. Druga jest zgadywaniem opartym na liście serwisów w bieżącym RFC dotyczącym przypisanych numerów (Assigned Numbers RFC).

Przed glibc w wersji 2.2 argumenty hostlen i servlen były wprowadzane jako size_t.

PRZYKŁAD¶

struct sockaddr *addr;     /* wejście */
socklen_t addrlen;         /* wejście */
char hbuf[NI_MAXHOST], sbuf[NI_MAXSERV];
if (getnameinfo(addr, addrlen, hbuf, sizeof(hbuf), sbuf,
            sizeof(sbuf), NI_NUMERICHOST | NI_NUMERICSERV) == 0)
    printf("host=%s, serv=%s\n", hbuf, sbuf);

Następująca wersja sprawdza, czy adres gniazda ma odwrotne mapowanie adresu.

struct sockaddr *addr;     /* wejście */
socklen_t addrlen;         /* wejście */
char hbuf[NI_MAXHOST];
if (getnameinfo(addr, addrlen, hbuf, sizeof(hbuf),
            NULL, 0, NI_NAMEREQD))
    printf("nie można znaleźć nazwy komputera");
else
    printf("komputer=%s\n", hbuf);

Przykładowy program używający getnameinfo() można znaleźć w getaddrinfo(3).

ZOBACZ TAKŻE¶

R. Gilligan, S. Thomson, J. Bound i W. Stevens, Basic Socket Interface Extensions for IPv6, RFC 2553, marzec 1999.

Tatsuya Jinmei i Atsushi Onoe, An Extension of Format for IPv6 Scoped Addresses, szkic internetowy, prace trwają ftp://ftp.ietf.org/internet-drafts/draft-ietf-ipngwg-scopedaddr-format-02.txt.

Craig Metz, Protocol Independence Using the Sockets API, Proceedings of the freenix track: Coroczna techniczna konferencja USENIX 2000, czerwiec 2000 http://www.usenix.org/publications/library/proceedings/usenix2000/freenix/metzprotocol.html.

O STRONIE¶

TŁUMACZENIE¶

Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją 4.07 oryginału.