SOCKET_GETADDRINFO
Section: User Contributed Perl Documentation (1p)
Updated: 2022-10-13
Index
Return to Main Contents
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
OUTPUT FORMAT
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>
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- OUTPUT FORMAT
-
- NOTE
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 09:52:26 GMT, April 28, 2024