dwww Home | Manual pages | Find package

SOCKET_GETADDRINFO(1p)User Contributed Perl DocumentatioSOCKET_GETADDRINFO(1p)

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>

perl v5.34.0                      2022-10-13            SOCKET_GETADDRINFO(1p)

Generated by dwww version 1.15 on Fri Jun 28 22:43:48 CEST 2024.