diff --git a/man/kdig.1.in b/man/kdig.1.in index 75e273e3f3aace4869c29dac533a4b59b7b9cd89..0904c238f9fbfef7b88550cd37c79a01a7dfe64d 100644 --- a/man/kdig.1.in +++ b/man/kdig.1.in @@ -23,8 +23,8 @@ which must precede \fIquery\fR specification. Is a domain name that is to be looked up. .TP .I 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 +Is a domain name or an IPv4 or IPv6 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 \fB/etc/resolv.conf\fR are used. .TP If no arguments are provided, \fBkdig\fR sends \fINS\fR query for the root zone. @@ -38,7 +38,8 @@ Use IPv6 protocol only. .TP .BI \-b \ address Set the source IP address of the query to \fIaddress\fR. The address -can be specified using [address]:port notation. +must be a valid address for local interface or :: or 0.0.0.0. +Optional port can be specified using [address]:port notation. .TP .BI \-c \ class Set query class (e.g. \fICH\fR, \fICLASS4\fR). An explicit variant of @@ -72,7 +73,8 @@ An explicit variant of \fItype\fR specification. The default type is \fIA\fR. Print program version. .TP .BI \-x \ address -Send \fIPTR\fR query for IPv4 or IPv6 \fIaddress\fR. +Send reverse (\fIPTR\fR) query for IPv4 or IPv6 \fIaddress\fR. Correct name, +class and type is set automatically. .TP .B \-y \fR[\fIalgo:\fR]\fIkeyname:key\fR Use TSIG key with a name \fIkeyname\fR to authenticate the request. The \fIalgo\fR @@ -80,7 +82,7 @@ part specifies the algorithm (the default is hmac\-md5) and \fIkey\fR specifies the shared secret encoded in Base64. .TP .BR + [ no ] multiline -Wrap long records to more lines. +Wrap long records to more lines and improve human readability. .TP .BR + [ no ] short Show record data only. @@ -150,18 +152,19 @@ Show TTL value. .TP .BI +time= T Set wait for reply interval in seconds (default is 5 seconds). +This timeout applies to each query try. .TP .BI +retries= N -Set number of retries (default is 2). This doesn't apply to AXFR or IXFR. +Set number (>=0) of UDP retries (default is 2). This doesn't apply to AXFR/IXFR. .TP .BI +bufsize= B Set EDNS buffer size in bytes (default is 512 bytes). .TP .BR + [ no ] tcp -Use TCP protocol. +Use TCP protocol (default is UDP for standard query and TCP for AXFR/IXFR). .TP .BR + [ no ] fail -Stop if SERVFAIL. +Stop quering next nameserver if SERVFAIL response is received. .TP .BR + [ no ] ignore Don't use TCP automatically if truncated reply is received. @@ -170,6 +173,32 @@ Don't use TCP automatically if truncated reply is received. Request nameserver identifier (NSID). .SH NOTE Options \fB\-k\fR and \fB\-y\fR cannot be used mutually. +.SS Missing features with regard to ISC dig +Options \fB\-f\fR and \fB\-m\fR and query options: +.br +.BR +split=\fIW\fR ,\ +tries=\fIT\fR ,\ +ndots=\fID\fR , +.br +.BR +domain=\fIsomename\fR , +trusted\-key=\fI####\fR , +.br +.BR + [ no ] vc ,\ + [ no ] search ,\ + [ no ] showsearch , +.br +.BR + [ no ] defname ,\ + [ no ] aaonly ,\ + [ no ] cmd , +.br +.BR + [ no ] identify ,\ + [ no ] comments ,\ + [ no ] rrcomments , +.br +.BR + [ no ] onesoa ,\ + [ no ] besteffort ,\ + [ no ] sigchase , +.br +.BR + [ no ] topdown ,\ + [ no ] nssearch ,\ + [ no ] trace. +.TP +Per-user file configuration via ${HOME}/.digrc. +.SS Differences with regard to ISC dig +Optional port specification has a form of [address]:port instead of address#port. +.TP +.BR + [ no ] ttl " instead of " + [ no ] ttlid +.TP +.BR +retries=T " instead of " +retry=T +.TP +Trailing information is formatted slightly different. .SH EXAMPLES .B Example 1. Get A record for example.com: .TP diff --git a/man/khost.1.in b/man/khost.1.in index ca4a5756a5a76df4221e2481e11cecc3be999307..805d96c5093ebf6bc52712f32af8173bbb020b62 100644 --- a/man/khost.1.in +++ b/man/khost.1.in @@ -63,10 +63,20 @@ Set query type (e.g. \fINS\fR, \fIIXFR=12345\fR, \fITYPE65535\fR). The default is to send 3 queries (\fIA\fR, \fIAAAA\fR and \fIMX\fR). .TP .BI \-R \ retries -The number of UDP retries to query a nameserver. The default is \fI1\fR. +The number (>=0) of UDP retries to query a nameserver. The default is \fI1\fR. .TP .BI \-W \ wait -The time to wait for a reply in seconds. The default is \fI2\fR seconds. +The time to wait for a reply in seconds. This timeout applies to each query try. +The default is \fI2\fR seconds. +.SH NOTES +.SS Missing features with regard to ISC host +Options \fB\-C, \-i, \-l, \-m, \-N\fR. +.SS Differences with regard to ISC host +Option \fB\-d\fR is not equivalent to \fB-v\fR, but enables debug messages. +.TP +The number of retries can be set to zero. +.TP +Verbose mode has slightly different format (same as \fBkdig\fR). .SH EXAMPLES .B Example 1. Get A, AAAA and MX records for example.com: .TP diff --git a/src/utils/host/host_params.c b/src/utils/host/host_params.c index 0b328939c7b3d25154ef0e6a9446ca80ff3f8290..66fe67a9630e4401fa2718489125cf0dcdfd4e1f 100644 --- a/src/utils/host/host_params.c +++ b/src/utils/host/host_params.c @@ -179,7 +179,7 @@ static void host_help(void) " -d Allow debug messages.\n" " -h, --help Print help.\n" " -r Disable recursion.\n" - " -s Stop if servfail.\n" + " -s Stop if SERVFAIL.\n" " -T Use TCP procotol.\n" " -v Verbose output.\n" " -V, --version Print program version.\n"