1GETNAMEINFO(3)         FreeBSD Library Functions Manual         GETNAMEINFO(3)
2
3NNAAMMEE
4     ggeettnnaammeeiinnffoo -- address-to-name translation in protocol-independent manner
5
6SSYYNNOOPPSSIISS
7     ##iinncclluuddee <<ssyyss//ssoocckkeett..hh>>
8     ##iinncclluuddee <<nneettddbb..hh>>
9
10     _i_n_t
11     ggeettnnaammeeiinnffoo(_c_o_n_s_t _s_t_r_u_c_t _s_o_c_k_a_d_d_r _*_s_a, _s_o_c_k_l_e_n___t _s_a_l_e_n, _c_h_a_r _*_h_o_s_t,
12         _s_i_z_e___t _h_o_s_t_l_e_n, _c_h_a_r _*_s_e_r_v, _s_i_z_e___t _s_e_r_v_l_e_n, _i_n_t _f_l_a_g_s);
13
14DDEESSCCRRIIPPTTIIOONN
15     The ggeettnnaammeeiinnffoo() function is defined for protocol-independent address-
16     to-nodename translation.  It performs functionality of gethostbyaddr(3)
17     and getservbyport(3) in more sophisticated manner.
18
19     The _s_a arguement is a pointer to a generic socket address structure of
20     size _s_a_l_e_n.  The arguements _h_o_s_t and _s_e_r_v are pointers to buffers to hold
21     the return values.  Their sizes are specified by _h_o_s_t_l_e_n and _s_e_r_v_l_e_n
22     repectively.  Either _h_o_s_t or _s_e_r_v may be NULL if the hostname  or service
23     name is not required.
24
25     The _f_l_a_g_s arguement modifies the behaviour of ggeettnnaammeeiinnffoo() as follows:
26
27     If NI_NOFQDN is set only the unqualified hostname is returned for local
28     fully qualified names.
29
30     If NI_NUMERICHOST is set then the numeric form of the hostname is
31     returned.
32
33     If NI_NAMEREQD is set, then a error is returned if the hostname cannot be
34     looked up.
35
36     If NI_NUMERICSERV is set then the service is returned in numeric form.
37
38     If NI_DGRAM is set then the service is UDP based rather than TCP based.
39
40SSEEEE AALLSSOO
41     getaddrinfo(3), gethostbyaddr(3), getservbyport(3), hosts(5),
42     services(5), hostname(7),
43
44     R. Gilligan, S.  Thomson, J. Bound, and W. Stevens, ``Basic Socket Inter-
45     face Extensions for IPv6,'' RFC2133, April 1997.
46
47SSTTAANNDDAARRDDSS
48     The ggeettaaddddrriinnffoo() function is defined IEEE POSIX 1003.1g draft specifica-
49     tion, and documented in ``Basic Socket Interface Extensions for IPv6''
50     (RFC2133).
51
52                               January 11, 1999
53