---
name: "dt-getaddr"
section: "1"
platform: "linux"
package: "dnssec-tools"
version: "2.2.3-16"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/dt-getaddr"
---

# dt-getaddr(1)

command-line test program for the val\_getaddrinfo() function

## NAME

dt-getaddr - command-line test program for the val\_getaddrinfo() function

## SYNOPSIS

```
    dt-getaddr [options] <hostname|IPv4 address|IPv6 address>
```

## DESCRIPTION

This utility is a command-line wrapper around the *val\_getaddrinfo()* function.  It invokes the *val\_getaddrinfo()* operation for the given command-line arguments and displays the return code from the function and the contents of the *addrinfo* structure.

The exit status for this program is 1 if the answer received is trusted, 2 if  the answer received is validated, and -1 for an error. If no validation is performed, or the result is neither trusted nor validated, a value of 0 is returned. The trusted and validated status values are obtained using the *val\_istrusted()* and *val\_isvalidated()* functions from *[libval(3)](/libval/3.md)*.

## OPTIONS

- \-c, --canonname

  Use the AI\_CANONNAME flag in *val\_getaddrinfo()*.

- \-s, --service=*PORT\|SERVICE*

  Use the specified transport-layer port or service name.

- \-o, --output=\<debug-level\>:\<dest-type\>\[:\<dest-options\>\]

  \<debug-level\> is 1-7, corresponding to syslog levels ALERT-DEBUG \<dest-type\> is one of file, net, syslog, stderr, stdout \<dest-options\> depends on \<dest-type\>\
       file:\<file-name\>   (opened in append mode)\
       net\[:\<host-name\>:\<host-port\>\] (127.0.0.1:1053\
       syslog\[:facility\] (0-23 (default 1 USER))

- \-h, --help

  Display the help and exit.

## PRE-REQUISITES

libval

## COPYRIGHT

Copyright 2005-2013 SPARTA, Inc.  All rights reserved. See the COPYING file included with the DNSSEC-Tools package for details.

## AUTHORS

Abhijit Hayatnagarkar, Suresh Krishnaswamy, Robert Story

## SEE ALSO

***val\_getaddrinfo*****(3)**

***libval*****(3)**

http://www.dnssec-tools.org