getaddrinfo(1) manual page

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 example, "inet" corresponds with AF_INET.

-N

Treat the service as numeric and do not attempt service name resolution, 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.

“	I'm not interested in developing a powerful brain. All I'm after is just a mediocre brain, something like the President of the American Telephone and Telegraph Company.	”
— Alan Turing

Manual Pages — GETADDRINFO

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

EXIT STATUS

EXAMPLES

SEE ALSO

HISTORY

-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 example, "inet" corresponds with `AF_INET`.
-N
	Treat the service as numeric and do not attempt service name resolution, 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`.