---
name: "socket_getaddrinfo"
section: "1p"
platform: "linux"
package: "libsocket-getaddrinfo-perl"
version: "0.22-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/socket_getaddrinfo"
---

# socket\_getaddrinfo(1p)

command-line tool to "getaddrinfo(3)" resolver

## NAME

"socket\_getaddrinfo" - command-line tool to "[getaddrinfo(3)](/getaddrinfo/3.md)" 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\>