mirror of
https://github.com/Stichting-MINIX-Research-Foundation/netbsd.git
synced 2025-08-17 10:02:46 -04:00
103 lines
2.7 KiB
Plaintext
103 lines
2.7 KiB
Plaintext
.\" Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
|
|
.\" Copyright (c) 1998,1999 by Internet Software Consortium
|
|
.\"
|
|
.\" Permission to use, copy, modify, and distribute this software for any
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
|
.\" copyright notice and this permission notice appear in all copies.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
|
|
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR
|
|
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
|
|
.\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
.\"
|
|
.\" Id: getnameinfo.man3,v 1.3 2009/02/21 01:31:39 jreed Exp
|
|
.\"
|
|
.Dd January 11, 1999
|
|
.Dt GETNAMEINFO 3
|
|
.Sh NAME
|
|
.Nm getnameinfo
|
|
.Nd address-to-name translation in protocol-independent manner
|
|
.Sh SYNOPSIS
|
|
.Fd #include <sys/socket.h>
|
|
.Fd #include <netdb.h>
|
|
.Ft int
|
|
.Fn getnameinfo "const struct sockaddr *sa" "socklen_t salen" \
|
|
"char *host" "size_t hostlen" "char *serv" "size_t servlen" "int flags"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Fn getnameinfo
|
|
function is defined for protocol-independent address-to-nodename translation.
|
|
It performs functionality of
|
|
.Xr gethostbyaddr 3
|
|
and
|
|
.Xr getservbyport 3
|
|
in more sophisticated manner.
|
|
.Pp
|
|
The
|
|
.Fa sa
|
|
arguement is a pointer to a generic socket address structure of size
|
|
.Fa salen .
|
|
The arguements
|
|
.Fa host
|
|
and
|
|
.Fa serv
|
|
are pointers to buffers to hold the return values.
|
|
Their sizes are specified by
|
|
.Fa hostlen
|
|
and
|
|
.Fa servlen
|
|
repectively.
|
|
Either
|
|
.Fa host
|
|
or
|
|
.Fa serv
|
|
may be
|
|
.Dv NULL
|
|
if the hostname or service name is not required.
|
|
.Pp
|
|
The
|
|
.Fa flags
|
|
arguement modifies the behaviour of
|
|
.Fn getnameinfo
|
|
as follows:
|
|
.Pp
|
|
If
|
|
.Dv NI_NOFQDN
|
|
is set only the unqualified hostname is returned for local fully
|
|
qualified names.
|
|
.Pp
|
|
If
|
|
.Dv NI_NUMERICHOST
|
|
is set then the numeric form of the hostname is returned.
|
|
.Pp
|
|
If
|
|
.Dv NI_NAMEREQD
|
|
is set, then a error is returned if the hostname cannot be looked up.
|
|
.Pp
|
|
If
|
|
.Dv NI_NUMERICSERV
|
|
is set then the service is returned in numeric form.
|
|
.Pp
|
|
If
|
|
.Dv NI_DGRAM
|
|
is set then the service is UDP based rather than TCP based.
|
|
.Sh SEE ALSO
|
|
.Xr getaddrinfo 3 ,
|
|
.Xr gethostbyaddr 3 ,
|
|
.Xr getservbyport 3 ,
|
|
.Xr hosts 5 ,
|
|
.Xr services 5 ,
|
|
.Xr hostname 7 ,
|
|
.Pp
|
|
R. Gilligan, S. Thomson, J. Bound, and W. Stevens,
|
|
``Basic Socket Interface Extensions for IPv6,'' RFC2133, April 1997.
|
|
.Sh STANDARDS
|
|
The
|
|
.Fn getaddrinfo
|
|
function is defined IEEE POSIX 1003.1g draft specification,
|
|
and documented in ``Basic Socket Interface Extensions for IPv6''
|
|
(RFC2133).
|