Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GETADDRINFO(1)		FreeBSD	General	Commands Manual		GETADDRINFO(1)

NAME
     getaddrinfo -- resolve names to socket addresses

SYNOPSIS
     getaddrinfo [-cNnP] [-f family] [-p protocol] [-s service[/protocol]]
		 [-t socktype] [hostname]

DESCRIPTION
     The getaddrinfo utility resolves host and service names to	socket
     addresses with getaddrinfo(3) and prints them to standard output in a
     user-friendly format.

     The output	is a sequence of lines with space-separated fields:

	   socket-type address-family protocol [af-specific data ...]

     For the ``inet'' and ``inet6'' address families, the af-specific data are
     the IP/IPv6 address and port number.

     Depending on the settings in nsswitch.conf(5), getaddrinfo	might query
     DNS for answers.  However,	it is not intended to be a general-purpose DNS
     query utility.  Use drill(1) for that.

     These options are available:

     -c	     Look up a canonical name as if with the AI_CANONNAME flag to
	     getaddrinfo(3) and	print it on the	first line before the socket
	     addresses.

     -f	family
	     Specify an	address	family.	 Address families are named like the
	     AF_... constants for address family numbers in the	<sys/socket.h>
	     header file but without the AF_ prefix and	lowercase.  For	exam-
	     ple, ``inet'' corresponds with AF_INET.

     -N	     Treat the service as numeric and do not attempt service name res-
	     olution, as if with the AI_NUMERICSERV flag to getaddrinfo(3).

     -n	     Treat the hostname	as a numeric address and do not	attempt	name
	     resolution, as if with the	AI_NUMERICHOST flag to getaddrinfo(3).

     -P	     Return socket addresses intended for use with bind(2), as if with
	     the AI_PASSIVE flag to getaddrinfo(3).  By	default, the socket
	     addresses are intended for	use with connect(2), sendto(2),	or
	     sendmsg(2).

     -p	protocol
	     Specify a protocol.  Protocols are	numeric	or symbolic as listed
	     in	protocols(5).

     -s	service[/protocol]
	     Specify a service to look up.  Services are symbolic or numeric
	     with an optional protocol suffix as listed	in services(5).	 If a
	     service is	not specified, a hostname is required.

     -t	socktype
	     Specify a socket type.  Socket types are named like the SOCK_...
	     constants for socket type numbers in the <sys/socket.h> header
	     file but without the SOCK_	prefix and lowercase.  For example,
	     ``dgram'' corresponds with	SOCK_DGRAM.

EXIT STATUS
     The getaddrinfo utility exits 0 on	success, and >0	if an error occurs.

EXAMPLES
     Look up ``www.NetBSD.org'':

	   $ getaddrinfo www.NetBSD.org
	   dgram inet6 udp 2001:4f8:3:7:2e0:81ff:fe52:9ab6 0
	   dgram inet udp 149.20.53.67 0
	   stream inet6	tcp 2001:4f8:3:7:2e0:81ff:fe52:9ab6 0
	   stream inet tcp 149.20.53.67	0

     The port number here is zero because no service was specified.

     Look up ``morden.NetBSD.org'' for stream sockets on port 80, and show the
     canonical name:

	   $ getaddrinfo -c -t stream -s 80 morden.NetBSD.org
	   canonname ftp.NetBSD.org
	   stream inet6	tcp 2001:470:1f05:3d::21 80
	   stream inet tcp 199.233.217.249 80

SEE ALSO
     drill(1), getent(1), getaddrinfo(3), getnameinfo(3), resolver(3),
     hosts(5), nsswitch.conf(5), protocols(5), resolv.conf(5), services(5)

HISTORY
     The getaddrinfo command first appeared in NetBSD 7.0, followed by
     FreeBSD 11.1 and FreeBSD 12.0.

FreeBSD	11.1			March 28, 2017			  FreeBSD 11.1

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | EXAMPLES | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getaddrinfo&sektion=1&manpath=FreeBSD+11.1-RELEASE+and+Ports>

home | help