1GETADDRINFO(1) User Contributed Perl Documentation GETADDRINFO(1)
2
3
4
6 "getaddrinfo" - command-line tool to "getaddrinfo(3)" resolver
7
9 getaddrinfo [options...] host service
10
12 This tool provides a convenient command-line wrapper around the
13 getaddrinfo(3) resolver function. It will perform a single lookup and
14 print the returned results in a human-readable form. This is mainly
15 useful when debugging address resolution problems, because it allows
16 inspection of the getaddrinfo(3) behaviour itself, outside of any real
17 program that is trying to use it.
18
20 --host, -H HOST
21 Hostname to resolve. If not supplied, will use the first
22 positional argument
23
24 --service, -S SERVICE
25 Service name or port number to resolve. If not supplied, will
26 use the second positional argument.
27
28 -4 Restrict to just "AF_INET" (IPv4) results
29
30 -6 Restrict to just "AF_INET6" (IPv6) results
31
32 --stream
33 Restrict to just "SOCK_STREAM" results
34
35 --dgram Restrict to just "SOCK_DGRAM" results
36
37 --proto PROTO
38 Restrict to just results of the given IP protocol
39
40 --passive
41 Set the "AI_PASSIVE" hint; results will used to bind() and
42 listen() rather than connect()
43
44 --canonical
45 Retrive the canonical name for the requested host
46
47 --help Display a help summary and exit
48
50 Each line of output will be given in a form that indicates the four
51 result fields of "ai_family", "ai_socktype", "ai_protocol" and
52 "ai_addr". The first three are printed in the form of a socket(2) call,
53 either symbolically or numerically, and the latter is printed as a
54 plain string following it. For example
55
56 socket(AF_INET , SOCK_STREAM, IPPROTO_TCP) + '127.0.0.1:80'
57
59 Paul Evans <leonerd@leonerd.org.uk>
60
61
62
63perl v5.38.0 2023-07-21 GETADDRINFO(1)