summaryrefslogtreecommitdiffstats
path: root/doc/man_khost.rst
blob: 9447856e80e5210735f571055b16467c79ba36b3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
.. highlight:: none

``khost`` – Simple DNS lookup utility
=====================================

Synopsis
--------

:program:`khost` [*options*] *name* [*server*]

Description
-----------

This utility sends a DNS query for the *name* to the *server* and prints a reply
in more user-readable form. For more advanced DNS queries use :doc:`kdig<man_kdig>`
instead.

Parameters
..........

*name*
  Is a domain name that is to be looked up. If the *name* is IPv4 or IPv6
  address the PTR query type is used.

*server*
  Is a name or an address of the nameserver to send a query to.  The address
  can be specified using [address]:port notation. If no server is specified,
  the servers from :file:`/etc/resolv.conf` are used.

If no arguments are provided, :program:`khost` prints a short help.

Options
.......

**-4**
  Use the IPv4 protocol only.

**-6**
  Use the IPv6 protocol only.

**-a**
  Send ANY query with verbose mode.

**-d**
  Enable debug messages.

**-h**, **--help**
  Print the program help.

**-r**
  Disable recursion.

**-T**
  Use the TCP protocol.

**-v**
  Enable verbose output.

**-V**, **--version**
  Print the program version. The option **-VV** makes the program
  print the compile time configuration summary.

**-w**
  Wait forever for the reply.

**-c** *class*
  Set the query class (e.g. CH, CLASS4). The default class is IN.

**-t** *type*
  Set the query type (e.g. NS, IXFR=12345, TYPE65535). The default is to send 3
  queries (A, AAAA and MX).

**-R** *retries*
  The number (>=0) of UDP retries to query a nameserver. The default is 1.

**-W** *wait*
  The time to wait for a reply in seconds. This timeout applies to each query
  try. The default is 2 seconds.

Exit values
-----------

Exit status of 0 means successful operation. Any other exit status indicates
an error.

Examples
--------

1. Get the A, AAAA and MX records for example.com::

     $ khost example.com

2. Get the reverse record for address 192.0.2.1::

     $ khost 192.0.2.1

3. Perform a verbose zone transfer for zone example.com::

     $ khost -t AXFR -v example.com

Files
-----

:file:`/etc/resolv.conf`

See Also
--------

:manpage:`kdig(1)`, :manpage:`knsupdate(1)`.