Unbreak build and whitespace clean-up.

This commit is contained in:
Hiroki Sato 2009-05-17 09:42:35 +00:00
parent 06864915c7
commit 79436d4ede
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=34283

View file

@ -3218,6 +3218,7 @@ dhcpd_ifaces="dc0"</programlisting>
<sect2>
<title>Starting BIND</title>
<indexterm>
<primary>BIND</primary>
<secondary>starting</secondary>
@ -3254,6 +3255,7 @@ dhcpd_ifaces="dc0"</programlisting>
<sect2>
<title>Configuration Files</title>
<indexterm>
<primary>BIND</primary>
<secondary>configuration files</secondary>
@ -3322,8 +3324,7 @@ options {
// the entries in /etc/resolv.conf, uncomment the following line and
// set named_auto_forward=yes in /etc/rc.conf. You can also enable
// named_auto_forward_only (the effect of which is described above).
// include "/etc/namedb/auto_forward.conf";
</programlisting>
// include "/etc/namedb/auto_forward.conf";</programlisting>
<para>Just as the comment says, to benefit from an uplink's
cache, <literal>forwarders</literal> can be enabled here.
@ -3607,7 +3608,7 @@ zone "1.168.192.in-addr.arpa" {
<primary>BIND</primary>
<secondary>zone files</secondary>
</indexterm>
<para>An example master zone file for <hostid
role="domainname">example.org</hostid> (existing within
<filename>/etc/namedb/master/example.org</filename>) is as
@ -3640,28 +3641,24 @@ mx IN A 192.168.1.4
mail IN A 192.168.1.5
; Aliases
www IN CNAME example.org.<programlisting>
www IN CNAME example.org.</programlisting>
<para>
Note that every hostname ending in a <quote>.</quote> is an
<para>Note that every hostname ending in a <quote>.</quote> is an
exact hostname, whereas everything without a trailing
<quote>.</quote> is relative to the origin. For example,
<literal>ns1</literal> is translated into
<literal>ns1.<replaceable>example.org.</replaceable></literal>
</para>
<literal>ns1.<replaceable>example.org.</replaceable></literal></para>
<para>The format of a zone file follows:</para>
<para>
The format of a zone file follows:
</para>
<programlisting>recordname IN recordtype value</programlisting>
<indexterm>
<primary>DNS</primary>
<secondary>records</secondary>
</indexterm>
<para>
The most commonly used DNS records:
</para>
<para>The most commonly used DNS records:</para>
<variablelist>
<varlistentry>
@ -3702,8 +3699,7 @@ www IN CNAME example.org.<programlisting>
</varlistentry>
</variablelist>
<programlisting>
example.org. IN SOA ns1.example.org. admin.example.org. (
<programlisting>example.org. IN SOA ns1.example.org. admin.example.org. (
2006051501 ; Serial
10800 ; Refresh after 3 hours
3600 ; Retry after 1 hour
@ -3714,23 +3710,28 @@ example.org. IN SOA ns1.example.org. admin.example.org. (
<varlistentry>
<term><hostid role="domainname">example.org.</hostid></term>
<listitem><para>the domain name, also the origin for this
zone file.</para></listitem>
<listitem>
<para>the domain name, also the origin for this
zone file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><hostid role="fqdn">ns1.example.org.</hostid></term>
<listitem><para>the primary/authoritative name server for this
zone.</para></listitem>
<listitem>
<para>the primary/authoritative name server for this
zone.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>admin.example.org.</literal></term>
<listitem><para>the responsible person for this zone,
<listitem>
<para>the responsible person for this zone,
email address with <quote>@</quote>
replaced. (<email>admin@example.org</email> becomes
replaced. (<email>admin@example.org</email> becomes
<literal>admin.example.org</literal>)</para>
</listitem>
</varlistentry>
@ -3738,91 +3739,75 @@ example.org. IN SOA ns1.example.org. admin.example.org. (
<varlistentry>
<term><literal>2006051501</literal></term>
<listitem><para>the serial number of the file. This
must be incremented each time the zone file is
modified. Nowadays, many admins prefer a
<literal>yyyymmddrr</literal> format for the serial
number. <literal>2006051501</literal> would mean
last modified 05/15/2006, the latter
<literal>01</literal> being the first time the zone
file has been modified this day. The serial number
is important as it alerts slave name servers for a
zone when it is updated.</para>
</listitem>
<listitem>
<para>the serial number of the file. This
must be incremented each time the zone file is
modified. Nowadays, many admins prefer a
<literal>yyyymmddrr</literal> format for the serial
number. <literal>2006051501</literal> would mean
last modified 05/15/2006, the latter
<literal>01</literal> being the first time the zone
file has been modified this day. The serial number
is important as it alerts slave name servers for a
zone when it is updated.</para>
</listitem>
</varlistentry>
</variablelist>
<programlisting>
IN NS ns1.example.org.</programlisting>
<programlisting> IN NS ns1.example.org.</programlisting>
<para>
This is an NS entry. Every name server that is going to reply
authoritatively for the zone must have one of these entries.
</para>
<para>This is an NS entry. Every name server that is going to reply
authoritatively for the zone must have one of these entries.</para>
<programlisting>
localhost IN A 127.0.0.1
<programlisting>localhost IN A 127.0.0.1
ns1 IN A 192.168.1.2
ns2 IN A 192.168.1.3
mx IN A 192.168.1.4
mail IN A 192.168.1.5</programlisting>
<para>
The A record indicates machine names. As seen above,
<para>The A record indicates machine names. As seen above,
<hostid role="fqdn">ns1.example.org</hostid> would resolve
to <hostid role="ipaddr">192.168.1.2</hostid>.
</para>
to <hostid role="ipaddr">192.168.1.2</hostid>.</para>
<programlisting>
IN A 192.168.1.1</programlisting>
<programlisting> IN A 192.168.1.1</programlisting>
<para>This line assigns IP address
<hostid role="ipaddr">192.168.1.1</hostid> to the current origin,
in this case <hostid role="domainname">example.org</hostid>.</para>
<programlisting>
www IN CNAME @</programlisting>
<programlisting>www IN CNAME @</programlisting>
<para>
The canonical name record is usually used for giving aliases
<para>The canonical name record is usually used for giving aliases
to a machine. In the example, <hostid>www</hostid> is
aliased to the <quote>master</quote> machine whose name happens
to be the same as the domain name
<hostid role="domainname">example.org</hostid>
(<hostid role="ipaddr">192.168.1.1</hostid>).
CNAMEs can never be used together with another kind of record
for the same hostname.
</para>
for the same hostname.</para>
<indexterm>
<primary>MX record</primary>
</indexterm>
<programlisting>
IN MX 10 mail.example.org.</programlisting>
<programlisting> IN MX 10 mail.example.org.</programlisting>
<para>
The MX record indicates which mail
<para>The MX record indicates which mail
servers are responsible for handling incoming mail for the
zone. <hostid role="fqdn">mail.example.org</hostid> is the
hostname of the mail server, and 10 being the priority of
that mail server.
</para>
that mail server.</para>
<para>
One can have several mail servers, with priorities of 10,
<para>One can have several mail servers, with priorities of 10,
20 and so on. A mail server attempting to deliver to <hostid
role="domainname">example.org</hostid> would first try the
role="domainname">example.org</hostid> would first try the
highest priority MX (the record with the lowest priority
number), then the second highest, etc, until the mail can be
properly delivered.
</para>
properly delivered.</para>
<para>
For in-addr.arpa zone files (reverse DNS), the same format is
<para>For in-addr.arpa zone files (reverse DNS), the same format is
used, except with PTR entries instead of
A or CNAME.
</para>
A or CNAME.</para>
<programlisting>$TTL 3600
@ -3844,6 +3829,7 @@ www IN CNAME @</programlisting>
<para>This file gives the proper IP address to hostname
mappings of our above fictitious domain.</para>
<para>It is worth noting that all names on the right side
of a PTR record need to be fully qualified (i.e., end in
a <quote>.</quote>).</para>
@ -3991,7 +3977,7 @@ www IN CNAME @</programlisting>
<listitem>
<para>This specifies the default directory hierarchy for
the <application>Apache</application> installation. Binaries are stored in the
<filename class="directory">bin</filename> and
<filename class="directory">bin</filename> and
<filename class="directory">sbin</filename> subdirectories
of the server root, and configuration files are stored in
<filename class="directory">etc/apache</filename>.</para>
@ -4281,7 +4267,7 @@ DocumentRoot /www/someotherdomain.tld
from the ports system.</para>
<screen>&prompt.root; <userinput>cd /usr/ports/www/rubygem-rails; make all install clean</userinput></screen>
</sect3>
</sect3>
<sect3>
<title>mod_perl</title>
@ -5215,7 +5201,7 @@ syslogd_flags="-a logclient.example.com -vv"</programlisting>
<para>Similar to log servers, clients must also meet a few minimum
requirements:</para>
<itemizedlist>
<listitem>
<para>&man.syslogd.8; must be configured to send messages of