diff options
author | Ondřej Surý <ondrej@sury.org> | 2013-06-28 10:46:30 +0200 |
---|---|---|
committer | Ondřej Surý <ondrej@sury.org> | 2013-06-28 12:59:09 +0200 |
commit | 419a329df811fba66ea8afbfcf493e28f4305d7a (patch) | |
tree | 03fc60815a90a60a10d6b3f7f51d255cd144ad7f | |
parent | 76fa5071b6213d93fe5d16fd3a935e4b6667bb0b (diff) | |
download | knot-419a329df811fba66ea8afbfcf493e28f4305d7a.tar.gz |
Add patch to move manpage to correct location
-rw-r--r-- | debian/patches/fix_manpages_sections.patch | 888 | ||||
-rw-r--r-- | debian/patches/series | 1 |
2 files changed, 889 insertions, 0 deletions
diff --git a/debian/patches/fix_manpages_sections.patch b/debian/patches/fix_manpages_sections.patch new file mode 100644 index 0000000..da59486 --- /dev/null +++ b/debian/patches/fix_manpages_sections.patch @@ -0,0 +1,888 @@ +--- /dev/null ++++ knot/man/kdig.1 +@@ -0,0 +1,195 @@ ++.TH "kdig" "8" "April 2013" "CZ.NIC Labs" "Knot DNS, version 1.3.0-rc3" ++.SH NAME ++.B kdig ++\- Advanced DNS lookup utility (libknot equivalent of ISC dig) ++.SH SYNOPSIS ++.B kdig ++[\fIcommon-settings\fR] [\fIquery\fR [\fIsettings\fR]]... ++.TP 5 ++.B kdig ++\fB-h\fR ++.SH DESCRIPTION ++This utility sends one or more DNS \fIqueries\fR to a nameserver. Each query can ++have individual \fIsettings\fR, or it can be specified globally via \fIcommon-settings\fR, ++which must precede \fIquery\fR specification. ++.TP 4 ++\fIquery ++\fIname\fR | \fB-q\fR \fIname\fR | \fB-x\fR \fIaddress\fR ++.TP ++\fIcommon-settings, settings ++[\fIclass\fR] [\fItype\fR] [\fB@\fIserver\fR]... [\fIoptions\fR] ++.TP ++\fIname\fR ++Is a domain name that is to be looked up. ++.TP ++\fIserver\fR ++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 \fB/etc/resolv.conf\fR are used. ++.TP ++If no arguments are provided, \fBkdig\fR sends \fINS\fR query for root zone. ++.SH OPTIONS ++.TP 4 ++.BI -4 ++Use IPv4 protocol only. ++.TP ++.BI -6 ++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. ++.TP ++.BI -c \ class ++Set query class (e.g. \fICH\fR, \fICLASS4\fR). ++An explicit variant of \fIclass\fR specification. ++The default class is \fIIN\fR. ++.TP ++.BI -d ++Enable debug messages if any. ++.TP ++\fB\-h\fR, \fB\-\-help\fR ++Print short help. ++.TP ++.BI -k \ keyfile ++Use TSIG or SIG\-0 key stored in a file \fIkeyfile\fR to authenticate the request. ++Supported file format is the same as generated by ISC \fBdnssec\-keygen\fR. ++The key comprises of public (.key extension) and private part (.private extension). ++Either of these file names or a name without the extension can be specified as \fIkeyfile\fR ++parameter. ++.TP ++.BI -p \ port ++Set nameserver port number or service name to send a query to. ++The default port is \fI53\fR. ++.TP ++.BI -q \ name ++Set query name. An explicit variant of \fIname\fR specification. ++.TP ++.BI -t \ type ++Set query type (e.g. \fINS\fR, \fIIXFR=12345\fR, \fITYPE65535\fR). ++An explicit variant of \fItype\fR specification. The default type is \fIA\fR. ++.TP ++\fB\-v\fR, \fB\-\-version\fR ++Print program version. ++.TP ++.BI -x \ address ++Send \fIPTR\fR query for IPv4 or IPv6 \fIaddress\fR. ++.TP ++.BI -y \ \fR[\fIalgo:\fR]\fIkeyname:key\fR ++Use TSIG key with a name \fIkeyname\fR to authenticate the request. The \fIalgo\fR ++part specifies the algorithm (the default is hmac\-md5) and \fIkey\fR specifies ++the shared secret encoded in Base64. ++.TP ++\fB+\fR[\fBno\fR]\fBmultiline\fR ++Wrap long records to more lines. ++.TP ++\fB+\fR[\fBno\fR]\fBshort\fR ++Show record data only. ++.TP ++\fB+\fR[\fBno\fR]\fBaaflag\fR ++Set AA flag. ++.TP ++\fB+\fR[\fBno\fR]\fBtcflag\fR ++Set TC flag. ++.TP ++\fB+\fR[\fBno\fR]\fBrdflag\fR ++Set RD flag. ++.TP ++\fB+\fR[\fBno\fR]\fBrecurse\fR ++Same as +\fR[\fBno\fR]\fBrdflag\fR ++.TP ++\fB+\fR[\fBno\fR]\fBrec\fR ++Same as +\fR[\fBno\fR]\fBrdflag\fR ++.TP ++\fB+\fR[\fBno\fR]\fBraflag\fR ++Set RA flag. ++.TP ++\fB+\fR[\fBno\fR]\fBzflag\fR ++Set zero flag bit. ++.TP ++\fB+\fR[\fBno\fR]\fBadflag\fR ++Set AD flag. ++.TP ++\fB+\fR[\fBno\fR]\fBcdflag\fR ++Set CD flag. ++.TP ++\fB+\fR[\fBno\fR]\fBdnssec\fR ++Set DO flag. ++.TP ++\fB+\fR[\fBno\fR]\fBall\fR ++Show all packet sections. ++.TP ++\fB+\fR[\fBno\fR]\fBqr\fR ++Show query packet. ++.TP ++\fB+\fR[\fBno\fR]\fBheader\fR ++Show packet header. ++.TP ++\fB+\fR[\fBno\fR]\fBedns\fR ++Show EDNS pseudosectio. ++.TP ++\fB+\fR[\fBno\fR]\fBquestion\fR ++Show question section. ++.TP ++\fB+\fR[\fBno\fR]\fBanswer\fR ++Show answer section. ++.TP ++\fB+\fR[\fBno\fR]\fBauthority\fR ++Show authority section. ++.TP ++\fB+\fR[\fBno\fR]\fBadditional\fR ++Show additional section. ++.TP ++\fB+\fR[\fBno\fR]\fBstats\fR ++Show trailing packet statistics. ++.TP ++\fB+\fR[\fBno\fR]\fBcl\fR ++Show DNS class. ++.TP ++\fB+\fR[\fBno\fR]\fBttl\fR ++Show TTL value. ++.TP ++\fB+time=\fIT\fR ++Set wait for reply interval in seconds (default is 5 seconds). ++.TP ++\fB+retries=\fIN\fR ++Set number of retries (default is 2). This doesn't apply to AXFR or IXFR. ++.TP ++\fB+bufsize=\fIB\fR ++Set EDNS buffer size in bytes (default is 512 bytes). ++.TP ++\fB+\fR[\fBno\fR]\fBtcp\fR ++Use TCP protocol. ++.TP ++\fB+\fR[\fBno\fR]\fBfail\fR ++Stop if SERVFAIL. ++.TP ++\fB+\fR[\fBno\fR]\fBignore\fR ++Don't use TCP automatically if truncated reply is received. ++.TP ++\fB+\fR[\fBno\fR]\fBnsid\fR ++Request nameserver identifier (NSID). ++.SH NOTE ++Options \fB-k\fR and \fB-y\fR cannot be used mutually. ++.SH EXAMPLES ++.B Example 1. Get A record for example.com: ++.TP ++# kdig example.com A ++.TP ++.B Example 2. Perform AXFR for zone example.com from the server 192.0.2.1: ++.TP ++# kdig example.com -t AXFR @192.0.2.1 ++.TP 12 ++.B Example 3. Send one A query for example.com from 192.0.2.1 and one reverse \ ++lookup for address 2001:DB8::1 from 192.0.2.2. Both using TCP protocol: ++.TP ++# kdig +tcp example.com -t A @192.0.2.1 -x 2001:DB8::1 @192.0.2.2 ++.SH FILES ++.BI /etc/resolv.conf ++.SH AUTHOR ++Daniel Salzman (\fBhttp://knot-dns.cz\fR) ++.TP ++Please send any bugs or comments to \fBknot-dns@labs.nic.cz\fR ++.SH SEE ALSO ++.BI khost\fR(8), ++.BI knsupdate\fR(8). +--- knot.orig/man/kdig.8 ++++ /dev/null +@@ -1,195 +0,0 @@ +-.TH "kdig" "8" "April 2013" "CZ.NIC Labs" "Knot DNS, version 1.3.0-rc3" +-.SH NAME +-.B kdig +-\- Advanced DNS lookup utility (libknot equivalent of ISC dig) +-.SH SYNOPSIS +-.B kdig +-[\fIcommon-settings\fR] [\fIquery\fR [\fIsettings\fR]]... +-.TP 5 +-.B kdig +-\fB-h\fR +-.SH DESCRIPTION +-This utility sends one or more DNS \fIqueries\fR to a nameserver. Each query can +-have individual \fIsettings\fR, or it can be specified globally via \fIcommon-settings\fR, +-which must precede \fIquery\fR specification. +-.TP 4 +-\fIquery +-\fIname\fR | \fB-q\fR \fIname\fR | \fB-x\fR \fIaddress\fR +-.TP +-\fIcommon-settings, settings +-[\fIclass\fR] [\fItype\fR] [\fB@\fIserver\fR]... [\fIoptions\fR] +-.TP +-\fIname\fR +-Is a domain name that is to be looked up. +-.TP +-\fIserver\fR +-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 \fB/etc/resolv.conf\fR are used. +-.TP +-If no arguments are provided, \fBkdig\fR sends \fINS\fR query for root zone. +-.SH OPTIONS +-.TP 4 +-.BI -4 +-Use IPv4 protocol only. +-.TP +-.BI -6 +-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. +-.TP +-.BI -c \ class +-Set query class (e.g. \fICH\fR, \fICLASS4\fR). +-An explicit variant of \fIclass\fR specification. +-The default class is \fIIN\fR. +-.TP +-.BI -d +-Enable debug messages if any. +-.TP +-\fB\-h\fR, \fB\-\-help\fR +-Print short help. +-.TP +-.BI -k \ keyfile +-Use TSIG or SIG\-0 key stored in a file \fIkeyfile\fR to authenticate the request. +-Supported file format is the same as generated by ISC \fBdnssec\-keygen\fR. +-The key comprises of public (.key extension) and private part (.private extension). +-Either of these file names or a name without the extension can be specified as \fIkeyfile\fR +-parameter. +-.TP +-.BI -p \ port +-Set nameserver port number or service name to send a query to. +-The default port is \fI53\fR. +-.TP +-.BI -q \ name +-Set query name. An explicit variant of \fIname\fR specification. +-.TP +-.BI -t \ type +-Set query type (e.g. \fINS\fR, \fIIXFR=12345\fR, \fITYPE65535\fR). +-An explicit variant of \fItype\fR specification. The default type is \fIA\fR. +-.TP +-\fB\-v\fR, \fB\-\-version\fR +-Print program version. +-.TP +-.BI -x \ address +-Send \fIPTR\fR query for IPv4 or IPv6 \fIaddress\fR. +-.TP +-.BI -y \ \fR[\fIalgo:\fR]\fIkeyname:key\fR +-Use TSIG key with a name \fIkeyname\fR to authenticate the request. The \fIalgo\fR +-part specifies the algorithm (the default is hmac\-md5) and \fIkey\fR specifies +-the shared secret encoded in Base64. +-.TP +-\fB+\fR[\fBno\fR]\fBmultiline\fR +-Wrap long records to more lines. +-.TP +-\fB+\fR[\fBno\fR]\fBshort\fR +-Show record data only. +-.TP +-\fB+\fR[\fBno\fR]\fBaaflag\fR +-Set AA flag. +-.TP +-\fB+\fR[\fBno\fR]\fBtcflag\fR +-Set TC flag. +-.TP +-\fB+\fR[\fBno\fR]\fBrdflag\fR +-Set RD flag. +-.TP +-\fB+\fR[\fBno\fR]\fBrecurse\fR +-Same as +\fR[\fBno\fR]\fBrdflag\fR +-.TP +-\fB+\fR[\fBno\fR]\fBrec\fR +-Same as +\fR[\fBno\fR]\fBrdflag\fR +-.TP +-\fB+\fR[\fBno\fR]\fBraflag\fR +-Set RA flag. +-.TP +-\fB+\fR[\fBno\fR]\fBzflag\fR +-Set zero flag bit. +-.TP +-\fB+\fR[\fBno\fR]\fBadflag\fR +-Set AD flag. +-.TP +-\fB+\fR[\fBno\fR]\fBcdflag\fR +-Set CD flag. +-.TP +-\fB+\fR[\fBno\fR]\fBdnssec\fR +-Set DO flag. +-.TP +-\fB+\fR[\fBno\fR]\fBall\fR +-Show all packet sections. +-.TP +-\fB+\fR[\fBno\fR]\fBqr\fR +-Show query packet. +-.TP +-\fB+\fR[\fBno\fR]\fBheader\fR +-Show packet header. +-.TP +-\fB+\fR[\fBno\fR]\fBedns\fR +-Show EDNS pseudosectio. +-.TP +-\fB+\fR[\fBno\fR]\fBquestion\fR +-Show question section. +-.TP +-\fB+\fR[\fBno\fR]\fBanswer\fR +-Show answer section. +-.TP +-\fB+\fR[\fBno\fR]\fBauthority\fR +-Show authority section. +-.TP +-\fB+\fR[\fBno\fR]\fBadditional\fR +-Show additional section. +-.TP +-\fB+\fR[\fBno\fR]\fBstats\fR +-Show trailing packet statistics. +-.TP +-\fB+\fR[\fBno\fR]\fBcl\fR +-Show DNS class. +-.TP +-\fB+\fR[\fBno\fR]\fBttl\fR +-Show TTL value. +-.TP +-\fB+time=\fIT\fR +-Set wait for reply interval in seconds (default is 5 seconds). +-.TP +-\fB+retries=\fIN\fR +-Set number of retries (default is 2). This doesn't apply to AXFR or IXFR. +-.TP +-\fB+bufsize=\fIB\fR +-Set EDNS buffer size in bytes (default is 512 bytes). +-.TP +-\fB+\fR[\fBno\fR]\fBtcp\fR +-Use TCP protocol. +-.TP +-\fB+\fR[\fBno\fR]\fBfail\fR +-Stop if SERVFAIL. +-.TP +-\fB+\fR[\fBno\fR]\fBignore\fR +-Don't use TCP automatically if truncated reply is received. +-.TP +-\fB+\fR[\fBno\fR]\fBnsid\fR +-Request nameserver identifier (NSID). +-.SH NOTE +-Options \fB-k\fR and \fB-y\fR cannot be used mutually. +-.SH EXAMPLES +-.B Example 1. Get A record for example.com: +-.TP +-# kdig example.com A +-.TP +-.B Example 2. Perform AXFR for zone example.com from the server 192.0.2.1: +-.TP +-# kdig example.com -t AXFR @192.0.2.1 +-.TP 12 +-.B Example 3. Send one A query for example.com from 192.0.2.1 and one reverse \ +-lookup for address 2001:DB8::1 from 192.0.2.2. Both using TCP protocol: +-.TP +-# kdig +tcp example.com -t A @192.0.2.1 -x 2001:DB8::1 @192.0.2.2 +-.SH FILES +-.BI /etc/resolv.conf +-.SH AUTHOR +-Daniel Salzman (\fBhttp://knot-dns.cz\fR) +-.TP +-Please send any bugs or comments to \fBknot-dns@labs.nic.cz\fR +-.SH SEE ALSO +-.BI khost\fR(8), +-.BI knsupdate\fR(8). +--- /dev/null ++++ knot/man/khost.1 +@@ -0,0 +1,89 @@ ++.TH "khost" "8" "April 2013" "CZ.NIC Labs" "Knot DNS, version 1.3.0-rc3" ++.SH NAME ++.B khost ++\- Simple DNS lookup utility (libknot equivalent of ISC host) ++.SH SYNOPSIS ++.B khost ++[\fIoptions\fR] \fIname\fR [\fIserver\fR] ++.SH DESCRIPTION ++This utility sends a DNS query for the \fIname\fR to the \fIserver\fR and prints ++a reply in more user-readable form. For more advanced DNS queries use \fBkdig\fR instead. ++.TP 4 ++\fI name\fR ++Is a domain name that is to be looked up. ++If the \fIname\fR is IPv4 or IPv6 address the \fIPTR\fR query type is used. ++.TP ++\fI server\fR ++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 \fB/etc/resolv.conf\fR are used. ++.TP ++If no arguments are provided, \fBkhost\fR prints short help. ++.SH OPTIONS ++.TP 4 ++.BI -4 ++Use IPv4 protocol only. ++.TP ++.BI -6 ++Use IPv6 protocol only. ++.TP ++.BI -a ++Send ANY query with verbose mode. ++.TP ++.BI -d ++Enable debug messages if any. ++.TP ++\fB\-h\fR, \fB\-\-help\fR ++Print help. ++.TP ++.BI -r ++Disable recursion. ++.TP ++.BI -s ++Stop quering next nameserver if SERVFAIL response is received. ++.TP ++.BI -T ++Use TCP protocol. ++.TP ++.BI -v ++Enable verbose output. ++.TP ++\fB\-V\fR, \fB\-\-version\fR ++Print program version. ++.TP ++.BI -w ++Wait forever for the reply. ++.TP ++.BI -c \ class ++Set query class (e.g. \fICH\fR, \fICLASS4\fR). The default class is \fIIN\fR. ++.TP ++.BI -t \ type ++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. ++.TP ++.BI -W \ wait ++The time to wait for a reply in seconds. The default is \fI2\fR seconds. ++.SH EXAMPLES ++.B Example 1. Get A, AAAA and MX records for example.com: ++.TP ++# khost example.com ++.TP ++.B Example 2. Get reverse record for address 192.0.2.1: ++.TP ++# khost 192.0.2.1 ++.TP ++.B Example 3. Perform verbose zone transfer for zone example.com: ++.TP ++# khost -t AXFR -v example.com ++.SH FILES ++.BI /etc/resolv.conf ++.SH AUTHOR ++Daniel Salzman (\fBhttp://knot-dns.cz\fR) ++.TP ++Please send any bugs or comments to \fBknot-dns@labs.nic.cz\fR ++.SH SEE ALSO ++.BI kdig\fR(8), ++.BI knsupdate\fR(8). +--- knot.orig/man/khost.8 ++++ /dev/null +@@ -1,89 +0,0 @@ +-.TH "khost" "8" "April 2013" "CZ.NIC Labs" "Knot DNS, version 1.3.0-rc3" +-.SH NAME +-.B khost +-\- Simple DNS lookup utility (libknot equivalent of ISC host) +-.SH SYNOPSIS +-.B khost +-[\fIoptions\fR] \fIname\fR [\fIserver\fR] +-.SH DESCRIPTION +-This utility sends a DNS query for the \fIname\fR to the \fIserver\fR and prints +-a reply in more user-readable form. For more advanced DNS queries use \fBkdig\fR instead. +-.TP 4 +-\fI name\fR +-Is a domain name that is to be looked up. +-If the \fIname\fR is IPv4 or IPv6 address the \fIPTR\fR query type is used. +-.TP +-\fI server\fR +-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 \fB/etc/resolv.conf\fR are used. +-.TP +-If no arguments are provided, \fBkhost\fR prints short help. +-.SH OPTIONS +-.TP 4 +-.BI -4 +-Use IPv4 protocol only. +-.TP +-.BI -6 +-Use IPv6 protocol only. +-.TP +-.BI -a +-Send ANY query with verbose mode. +-.TP +-.BI -d +-Enable debug messages if any. +-.TP +-\fB\-h\fR, \fB\-\-help\fR +-Print help. +-.TP +-.BI -r +-Disable recursion. +-.TP +-.BI -s +-Stop quering next nameserver if SERVFAIL response is received. +-.TP +-.BI -T +-Use TCP protocol. +-.TP +-.BI -v +-Enable verbose output. +-.TP +-\fB\-V\fR, \fB\-\-version\fR +-Print program version. +-.TP +-.BI -w +-Wait forever for the reply. +-.TP +-.BI -c \ class +-Set query class (e.g. \fICH\fR, \fICLASS4\fR). The default class is \fIIN\fR. +-.TP +-.BI -t \ type +-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. +-.TP +-.BI -W \ wait +-The time to wait for a reply in seconds. The default is \fI2\fR seconds. +-.SH EXAMPLES +-.B Example 1. Get A, AAAA and MX records for example.com: +-.TP +-# khost example.com +-.TP +-.B Example 2. Get reverse record for address 192.0.2.1: +-.TP +-# khost 192.0.2.1 +-.TP +-.B Example 3. Perform verbose zone transfer for zone example.com: +-.TP +-# khost -t AXFR -v example.com +-.SH FILES +-.BI /etc/resolv.conf +-.SH AUTHOR +-Daniel Salzman (\fBhttp://knot-dns.cz\fR) +-.TP +-Please send any bugs or comments to \fBknot-dns@labs.nic.cz\fR +-.SH SEE ALSO +-.BI kdig\fR(8), +-.BI knsupdate\fR(8). +--- /dev/null ++++ knot/man/knsupdate.1 +@@ -0,0 +1,147 @@ ++.TH "knsupdate" "8" "April 2013" "CZ.NIC Labs" "Knot DNS, version 1.3.0-rc3" ++.SH NAME ++.TP 10 ++.B knsupdate ++\- Dynamic DNS update utility (libknot equivalent of ISC nsupdate) ++.SH SYNOPSIS ++.B knsupdate ++[\fIoptions\fR] [\fIfilename\fR] ++ ++.SH DESCRIPTION ++ ++The utility sends Dynamic DNS update message to DNS server. Update content is ++read from a file (if the parameter \fIfilename\fR is given) or from standard ++input. The format of the update is described in \fBINPUT FORMAT\fR section. ++ ++.SH OPTIONS ++.TP 4 ++.BI -d ++Enable debugging messages. ++.TP ++.BI -v ++Use TCP protocol instead of the default UDP. ++.TP ++.BI -p \ port ++Set the port to use when connecting to server and the port was not explicitly ++specified in the update. The default is 53. ++.TP ++.BI -t \ timeout ++The timeout of the update request in seconds. The default is 12. If set to ++zero, the timeout is infinite. ++.TP ++.BI -r \ retries ++The number of retries for UDP requests. The default is 3. Partial timeout for ++each try is computed from total timeout (option \fB-t\fR). ++.TP ++.BI -k \ keyfile ++Use TSIG or SIG\-0 key stored in file to authenticate the request. The tool ++supports keys generated by ISC \fBdnssec\-keygen\fR. The key comprises of ++public (.key extension) and private part (.private extension). Either of these ++file names or a name without the extension can be specified as \fIkeyfile\fR ++parameter. ++ ++.TP ++.BI -y \ \fR[\fIhmac:\fR]\fIname:key ++Use TSIG key to authenticate the request. The \fIhmac\fR part specifies the ++algorithm (the default is hmac\-md5), \fIname\fR specifies the key name, and ++\fIkey\fR specifies the shared secret encoded in Base64. ++ ++.TP ++\fB\-\-help\fR ++Print help. ++ ++.TP ++\fB\-\-version\fR ++Print program version. ++ ++.TP ++Options \fB-k\fR and \fB-y\fR cannot be used mutually. ++ ++.SH INPUT FORMAT ++ ++The input format is textual and is made up of commands. Every command is placed ++on a separate line of the input. Lines starting with a semicolon are comments ++and are not processed. ++ ++List of commands format and their description: ++ ++.TP ++\fBserver\fR \fIname\fR [\fIport\fR] ++ ++Specifies a receiving server of the dynamic update message. Parameter \fIname\fR ++can be either a host name or an IP address. If the \fIport\fR is not specified, ++default port is used. The default port value can be controlled using program ++option \fB-p\fR. ++ ++.TP ++\fBzone\fR \fIname\fR ++ ++Specifies that all updates are done within a zone named \fIname\fR. If not used, ++the default zone is the root zone. ++ ++.TP ++\fBorigin\fR \fIname\fR ++ ++Specifies fully qualified domain name suffix which is appended to ++non-fqd owners in update commands. The default origin is the root zone. ++ ++.TP ++\fBclass\fR \fIname\fR ++ ++Sets \fIname\fR as a default class for all updates. If not used, the default ++class is IN. ++ ++.TP ++\fBttl\fR \fIvalue\fR ++ ++Sets \fIvalue\fR as a default TTL (time to live) in seconds. If not used, the ++default value is zero. ++ ++.TP ++\fBkey\fB \fIname\fR \fIkey\fR ++ ++Specifies TSIG key to authenticate the request. This command has the same ++semantics as the program option \fB\-y\fR, except that the MAC algorithm ++cannot be set. ++ ++.TP ++[\fBupdate\fR] \fBadd\fR \fIname\fR \fIttl\fR [\fIclass\fR] \fItype\fR \fIdata\fR ++ ++Adds a request to add a new resource record into the zone. Please note that if the ++\fIname\fR is not fully qualified domain name, current \fIorigin\fR name is appended to it. ++ ++.TP ++[\fBupdate\fR] \fBdel\fR[\fBete\fR] \fIname\fR [\fIttl\fR] [\fIclass\fR] [\fItype\fR] [\fIdata\fR] ++ ++Adds a request to remove all (or matching \fIclass\fR, \fItype\fR, \fIdata\fR) ++resource records from the zone. There is the same requirement for the ++\fIname\fR parameter as in the \fBupdate add\fR command. The \fIttl\fR item is ignored. ++ ++.TP ++\fBshow\fR ++ ++Displays current content of the update message. ++ ++.TP ++\fBsend\fR ++ ++Sends the current update message and cleans the list of updates. ++ ++.TP ++\fBanswer\fR ++ ++Displays the last answer from the server. ++ ++.TP ++\fBdebug\fR ++ ++Enable debugging. This command has the same meaning as program option \fB\-d\fR. ++ ++.SH BUGS ++ ++Please note that there are slight differences from ISC nsupdate and some ++features are not supported. Any bugs, comments, or feature requests can be sent ++to \fBknot-dns@labs.nic.cz\fR. ++.SH SEE ALSO ++.BI khost\fR(8), ++.BI kdig\fR(8). +--- knot.orig/man/knsupdate.8 ++++ /dev/null +@@ -1,147 +0,0 @@ +-.TH "knsupdate" "8" "April 2013" "CZ.NIC Labs" "Knot DNS, version 1.3.0-rc3" +-.SH NAME +-.TP 10 +-.B knsupdate +-\- Dynamic DNS update utility (libknot equivalent of ISC nsupdate) +-.SH SYNOPSIS +-.B knsupdate +-[\fIoptions\fR] [\fIfilename\fR] +- +-.SH DESCRIPTION +- +-The utility sends Dynamic DNS update message to DNS server. Update content is +-read from a file (if the parameter \fIfilename\fR is given) or from standard +-input. The format of the update is described in \fBINPUT FORMAT\fR section. +- +-.SH OPTIONS +-.TP 4 +-.BI -d +-Enable debugging messages. +-.TP +-.BI -v +-Use TCP protocol instead of the default UDP. +-.TP +-.BI -p \ port +-Set the port to use when connecting to server and the port was not explicitly +-specified in the update. The default is 53. +-.TP +-.BI -t \ timeout +-The timeout of the update request in seconds. The default is 12. If set to +-zero, the timeout is infinite. +-.TP +-.BI -r \ retries +-The number of retries for UDP requests. The default is 3. Partial timeout for +-each try is computed from total timeout (option \fB-t\fR). +-.TP +-.BI -k \ keyfile +-Use TSIG or SIG\-0 key stored in file to authenticate the request. The tool +-supports keys generated by ISC \fBdnssec\-keygen\fR. The key comprises of +-public (.key extension) and private part (.private extension). Either of these +-file names or a name without the extension can be specified as \fIkeyfile\fR +-parameter. +- +-.TP +-.BI -y \ \fR[\fIhmac:\fR]\fIname:key +-Use TSIG key to authenticate the request. The \fIhmac\fR part specifies the +-algorithm (the default is hmac\-md5), \fIname\fR specifies the key name, and +-\fIkey\fR specifies the shared secret encoded in Base64. +- +-.TP +-\fB\-\-help\fR +-Print help. +- +-.TP +-\fB\-\-version\fR +-Print program version. +- +-.TP +-Options \fB-k\fR and \fB-y\fR cannot be used mutually. +- +-.SH INPUT FORMAT +- +-The input format is textual and is made up of commands. Every command is placed +-on a separate line of the input. Lines starting with a semicolon are comments +-and are not processed. +- +-List of commands format and their description: +- +-.TP +-\fBserver\fR \fIname\fR [\fIport\fR] +- +-Specifies a receiving server of the dynamic update message. Parameter \fIname\fR +-can be either a host name or an IP address. If the \fIport\fR is not specified, +-default port is used. The default port value can be controlled using program +-option \fB-p\fR. +- +-.TP +-\fBzone\fR \fIname\fR +- +-Specifies that all updates are done within a zone named \fIname\fR. If not used, +-the default zone is the root zone. +- +-.TP +-\fBorigin\fR \fIname\fR +- +-Specifies fully qualified domain name suffix which is appended to +-non-fqd owners in update commands. The default origin is the root zone. +- +-.TP +-\fBclass\fR \fIname\fR +- +-Sets \fIname\fR as a default class for all updates. If not used, the default +-class is IN. +- +-.TP +-\fBttl\fR \fIvalue\fR +- +-Sets \fIvalue\fR as a default TTL (time to live) in seconds. If not used, the +-default value is zero. +- +-.TP +-\fBkey\fB \fIname\fR \fIkey\fR +- +-Specifies TSIG key to authenticate the request. This command has the same +-semantics as the program option \fB\-y\fR, except that the MAC algorithm +-cannot be set. +- +-.TP +-[\fBupdate\fR] \fBadd\fR \fIname\fR \fIttl\fR [\fIclass\fR] \fItype\fR \fIdata\fR +- +-Adds a request to add a new resource record into the zone. Please note that if the +-\fIname\fR is not fully qualified domain name, current \fIorigin\fR name is appended to it. +- +-.TP +-[\fBupdate\fR] \fBdel\fR[\fBete\fR] \fIname\fR [\fIttl\fR] [\fIclass\fR] [\fItype\fR] [\fIdata\fR] +- +-Adds a request to remove all (or matching \fIclass\fR, \fItype\fR, \fIdata\fR) +-resource records from the zone. There is the same requirement for the +-\fIname\fR parameter as in the \fBupdate add\fR command. The \fIttl\fR item is ignored. +- +-.TP +-\fBshow\fR +- +-Displays current content of the update message. +- +-.TP +-\fBsend\fR +- +-Sends the current update message and cleans the list of updates. +- +-.TP +-\fBanswer\fR +- +-Displays the last answer from the server. +- +-.TP +-\fBdebug\fR +- +-Enable debugging. This command has the same meaning as program option \fB\-d\fR. +- +-.SH BUGS +- +-Please note that there are slight differences from ISC nsupdate and some +-features are not supported. Any bugs, comments, or feature requests can be sent +-to \fBknot-dns@labs.nic.cz\fR. +-.SH SEE ALSO +-.BI khost\fR(8), +-.BI kdig\fR(8). +--- knot.orig/man/Makefile.am ++++ knot/man/Makefile.am +@@ -1,4 +1,4 @@ +-MANPAGES = knot.conf.5 knotc.8 knotd.8 kdig.8 khost.8 knsupdate.8 ++MANPAGES = knot.conf.5 knotc.8 knotd.8 kdig.1 khost.1 knsupdate.1 + + .5in.5: + $(SED) 's;\@VERSION\@;@VERSION@;g' $< > $@ diff --git a/debian/patches/series b/debian/patches/series index 7a1d34a..e9b56cb 100644 --- a/debian/patches/series +++ b/debian/patches/series @@ -1,2 +1,3 @@ run-as-knot.knot.patch DESTDIR_is_your_friend.patch +fix_manpages_sections.patch |