gethost(1)

1GETHOST(1)                       User Commands                      GETHOST(1)
2
3
4

NAME

6       gethost - command-line test program for the val_gethostbyname() (and
7       related) functions
8

SYNOPSIS

10          gethost [options] name
11

DESCRIPTION

13       This utility is a command-line wrapper around the val_gethostbyname()
14       (and related) functions.  It invokes the val_gethostbyname(), val_geth‐
15       ostbyname_r() and val_gethostbyname2() functions for the given command-
16       line arguments and displays the returned hostent, the validation status
17       value, and the value of the h_errno variable.
18
19       The exit status for this program is 1 if the answer received is
20       trusted, 2 if the answer received is validated, and -1 for an error.
21       The program returns 0 if no validation was performed or if the result
22       was neither trusted nor validated.  The trusted and validated status
23       values are obtained using the val_istrusted() and val_isvalidated()
24       functions from libval(3).
25

OPTIONS

27       -r, --reentrant
28           Use the re-entrant query interface.
29
30       -f, --family=[AF_INET⎪AF_INET6]
31           Use the specified address family for the query.
32
33       -o, --output=<debug-level>:<dest-type>[:<dest-options>]
34           <debug-level> is 1-7, corresponding to syslog levels ALERT-DEBUG
35           <dest-type> is one of file, net, syslog, stderr, stdout
36           <dest-options> depends on <dest-type>
37               file:<file-name>   (opened in append mode)
38               net[:<host-name>:<host-port>] (127.0.0.1:1053
39               syslog[:facility] (0-23 (default 1 USER))
40
41       -h, --help
42           Display the help and exit.
43

PRE-REQUISITES

45       libval
46

COPYRIGHT

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

AUTHORS

52       Abhijit Hayatnagarkar, Suresh Krishnaswamy, Robert Story
53