NAME¶
"socket_getaddrinfo" - command-line tool to "
getaddrinfo(3)"
resolver
SYNOPSIS¶
socket_getaddrinfo [
options...]
host service
DESCRIPTION¶
This tool provides a convenient command-line wrapper around the
getaddrinfo(3)
resolver function. It will perform a single lookup and print the returned
results in a human-readable form. This is mainly useful when debugging address
resolution problems, because it allows inspection of the
getaddrinfo(3)
behaviour itself, outside of any real program that is trying to use it.
OPTIONS¶
- --host, -H HOST
- Hostname to resolve. If not supplied, will use the first positional
argument
- --service, -S SERVICE
- Service name or port number to resolve. If not supplied, will use the
second positional argument.
- -4
- Restrict to just "AF_INET" (IPv4) results
- -6
- Restrict to just "AF_INET6" (IPv6) results
- --stream
- Restrict to just "SOCK_STREAM" results
- --dgram
- Restrict to just "SOCK_DGRAM" results
- --proto PROTO
- Restrict to just results of the given IP protocol
- --passive
- Set the "AI_PASSIVE" hint; results will used to bind()
and listen() rather than connect()
- --canonical
- Retrive the canonical name for the requested host
- --help
- Display a help summary and exit
Each line of output will be given in a form that indicates the four result
fields of "ai_family", "ai_socktype",
"ai_protocol" and "ai_addr". The first three are printed
in the form of a
socket(2) call, either symbolically or numerically, and the
latter is printed as a plain string following it. For example
socket(AF_INET , SOCK_STREAM, IPPROTO_TCP) + '127.0.0.1:80'
NOTE¶
Upstream this script is known as "getaddrinfo", but was renamed on
Debian.
AUTHOR¶
Paul Evans <leonerd@leonerd.org.uk>