Package: debhelper
Version: 5.0.7
Severity: normal
On a couple of manpages Upsteam uses a non-ascii character which lintian
moans about like so:
"warning: can't find numbered character"
It would be nice to have a feature to convert or kill esoteric
characters (usually put in man pages to show off) like the section
symbol: §
I'll attach one upsteam man page which lintian moans about at line 75.
-- System Information:
Debian Release: testing/unstable
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.8-2-386
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Versions of packages debhelper depends on:
ii binutils 2.16.1cvs20051117-1 The GNU assembler, linker and bina
ii coreutils [fileutils 5.93-5 The GNU core utilities
ii debconf-utils 1.4.59 debconf utilities
ii dpkg-dev 1.13.11 package building tools for Debian
ii file 4.15-2 Determines file type using "magic"
ii fileutils 5.93-5 The GNU file management utilities
ii html2text 1.3.2a-3 An advanced HTML to text converter
ii perl 5.8.7-8 Larry Wall's Practical Extraction
ii po-debconf 0.9.0 manage translated Debconf template
debhelper recommends no packages.
-- no debconf information
.\" Do *not* edit this file; it was automatically generated by ej2man
.\" Look for a name.ej file with the same name as this filename
.\"
.\" Process this file with the following
.\" nroff -man -Tutf8 maradns.8 | tr '\020' ' '
.\"
.\" Last updated Fri Nov 18 20:40:11 2005
.\"
.TH csv1 5 "January 2002" MARADNS "MaraDNS reference"
.\" We don't want hyphenation (it's too ugly)
.\" We also disable justification when using nroff
.\" Due to the way the -mandoc macro works, this needs to be placed
.\" after the .TH heading
.hy 0
.if n .na
.\"
.SH "NAME"
csv1 - Format of the csv1 zone file that MaraDNS uses
.SH "SPECIAL CHARACTERS"
.TP 3
|
This delimits fields
.TP 3
#
This signifies a comment. Lines starting with this are
ignored, otherwise it has no significance
.TP 3
%
This, in domain names, signifies that the rest of the domain
name should be the name of this zone
.TP 3
*
This is translated to mean "any host name that otherwise
does not resolve". It must be at the beginning of a
domain name.
.TP 3
\\
This is used an an escape character, either to escape
octal values such as \'\\045\' for %, or to escape the \'%\'
character so it has no special meaning, or to escape the
backslash character.
.PP
.SH "NOTES ON PROCESSING"
All domain-name labels are converted to their lower-case equivalents
before
processing is done. This is because domain-name literals in the
database
with one or more upper-case letters in them are case-sensitive. This is
my way to resolve RFC1035 schizophrenic desire to both allow binary
domain
labels, and its desire to be case-insensitive.
The file must first have a SOA record, followed by one or more NS
records,
followed by other records. The initial NS and SOA records must be RR
for
this zone. NS records after any non-NS record must be part of
another zone. The resolution algorithm will not break if non-CNAME
records
share records with a CNAME record, but this is not a good idea to do.
.SH "RR FORMAT"
A domain name is a one-letter designation of its type, followed by the
domain name separated by dots, ending with either a % or a trailing
dot.
If the domain name does not end with a % or trailing dot, an error is
returned.
.SH "SUPPORTED RR TYPES"
MaraDNS currently supports the following types of resource records
(RRs):
.br
.ta +5 +7 +7
Letter Type RFC1035 §3.2.2 value
.br
A A 1
.br
N NS 2
.br
C CNAME 5
.br
S SOA 6
.br
P PTR 12
.br
@ MX 15
.br
T TXT 16
.br
U any determined in third field of line
.br
.SH "FORMAT OF SUPPORTED RR TYPES"
Here are the formats, shown by letter name:
.nf
A: Has three fields
field one: the domain name
field two: the ttl for the name in seconds
field three: the ip address, in dotted decimal notation
Example:
Ahost.example.com.|7200|10.1.2.3
.fi
A records are described with grueling detail in RFC1035. In short, an
A record is an IP address for a given host name.
.nf
N: Has three fields
field one: the domain name of the record
field two: the ttl for the name in seconds
field three: the domain name this NS points to.
Example:
Nexample.com.|86400|ns.example.com.
.fi
NS (N here) records are described in RFC1035
.nf
C: Has three fields
field one: the domain name of the record
field two: the ttl for the name in seconds
field three: the domain this CNAME record points to
Example:
Calias.example.org.|3200|realname.example.org.
.fi
CNAME (which C is short for) records are described in RFC1035
.nf
S: Has nine fields
field one: the domain name of the record.
field two: the TTL of the record
field three: the origin of the domain. In other words, the name of the
primary name server for the domain.
field four: the email address for this domain (in the RFC822, not
BIND format)
field five: the serial for the domain
field six: the refresh (how often to see updates) for the domain
field seven: the retry (how often to try when down) for the domain
field eight: the expire (how long before the slave gives up) for the
domain
field nine: the minimum (and default) TTL for the domain
Example:
Sexample.net.|86400|example.net.|[EMAIL PROTECTED]|19771108|7200|3600|604800|1800
.fi
SOA (S here) records are described in RFC1035
.nf
P: has three fields
field one: the IP we wish to point to (in in-addr.arpa form)
field two: the ttl for the name in seconds
field three: the FQDN for the IP in question
Example:
P3.2.1.10.in-addr.arpa.|86400|ns.example.com.
.fi
PTR (P here) records, which are used for reverse
DNS lookups, are described in RFC1035. Note that
one needs control of the appropriate in-addr.arpa
subdomain to make PTR records visible on the
internet at large.
.nf
@: has four fields
field one: The host that people send email to
field two: the ttl for this record
field three: The preference for this MX host
field four: The name of this MX host
Example:
@example.com.|86400|10|mail.example.com.
.fi
MX (@ here) records are described in RFC1035
.nf
T: has three fields
field one: The host someone wants to get additional information about
field two: the ttl for this record
field three: The desired text. Any data becomes the record up until a
new line is reached. The new line is not part of the TXT
record
Example:
Texample.com.|86400|Example.com: Buy example products online
.fi
TXT (T here) records are described in RFC1035
.nf
U: has four fields
field one: The host someone wants a data type normally unsupported by
MaraDNS for
field two: the ttl for this record
field three: The numeric code for this data type (33 for SRV, etc.)
field four: The raw binary data for this data type
Example:
Uexample.com.|3600|40|\\010\\001\\002Kitchen sink data
.fi
The above example is a "Kitchen Sink" RR (see
draft-ietf-dnsind-kitchen-sink-02.txt) with a "meaning" of 8, a
"coding"
of 1, a "subcoding" of 2, and a data string of "Kitchen sink data".
Since this particular data type is not formallized in a RFC at this
time,
the most appropriate method of storing this data is by using the
catch-all
"unsupported" syntax.
.SH "EXAMPLE CSV1 ZONE FILE"
.nf
# Zone file for example.com (example file)
# The SOA record must be first, followed by all authoritative NS
# records for this zone.
Sexample.com.|86400|example.com.|[EMAIL PROTECTED]|19771108|7200|3600|604800|1800
Nexample.com.|86400|ns1.example.com.
Nexample.com.|86400|ns2.example.com.
# Some 'IN A' records
Aexample.com.|86400|10.1.2.3
Amx.example.com.|86400|10.1.2.4
Ans1.example.com.|86400|10.0.0.1
Ans2.example.com.|86400|192.168.0.1
# An 'IN MX' record
@example.com.|86400|10|mx.example.com.
# An 'IN CNAME' record
Cwww.example.com.|86400|example.com.
# An 'IN TXT' record
Texample.com.|86400|Example.com: Buy examples of products online!
# An 'A' record showing the use of percent as a shortcut for the name
# of this zone (in this case, 'example.com.')
Aftp.%|3600|10.7.8.9
# A 'TXT' record showing the use of the backslash which allows any
# octal code in the record
Tpercent.%|7200|Get 50\045 off all \%items\% at example.com!
# A 'PTR' record which, while marked as unauthoritative, allows this
# program to work with the obsolete tool nslookup when bound on IP 127.0.0.3
# NOTE: This record is not part of the example.com domain, and,
# therefore, can not be transferred with the getzone client
# Also, PTR records will not be visible unless one has control of the
# appropriate in-addr.arpa domain (or the in-addr.arpa. domain has CNAME
# records that point to host names one controls)
P3.0.0.127.in-addr.arpa.|1234|nslookup.bug.workaround.
.fi
.SH "LEGAL DISCLAIMER"
THIS SOFTWARE IS PROVIDED BY THE AUTHORS \'\'AS IS\'\' AND ANY EXPRESS
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.SH "AUTHOR"
Sam Trenholme
http://www.samiam.org/
