os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add class="directory" to <filename> elements that need it.

Browse source 
Reviewed by:	manolis, rene, trhodes
This commit is contained in:
Giorgos Keramidas 2009-05-06 13:34:56 +00:00
parent 63947bee93
commit 923fda1d51
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=34219
1 changed files with 34 additions and 34 deletions

68
en_US.ISO8859-1/books/handbook/config/chapter.sgml
View file

@ -53,7 +53,7 @@
</listitem>
<listitem>
<para>The basics of <filename>rc.conf</filename> configuration and
<filename>/usr/local/etc/rc.d</filename> startup systems.</para>
<filename class="directory">/usr/local/etc/rc.d</filename> startup systems.</para>
</listitem>
<listitem>
<para>How to configure and test a network card.</para>
@ -63,7 +63,7 @@
</listitem>
<listitem>
<para>How to use the various configuration files in
<filename>/etc</filename>.</para>
<filename class="directory">/etc</filename>.</para>
</listitem>
<listitem>
<para>How to tune &os; using <command>sysctl</command>
@ -97,13 +97,13 @@
<indexterm><primary>partition layout</primary></indexterm>
<indexterm>
<primary><filename>/etc</filename></primary>
<primary><filename class="directory">/etc</filename></primary>
</indexterm>
<indexterm>
<primary><filename>/var</filename></primary>
<primary><filename class="directory">/var</filename></primary>
</indexterm>
<indexterm>
<primary><filename>/usr</filename></primary>
<primary><filename class="directory">/usr</filename></primary>
</indexterm>
<sect3>
@ -115,32 +115,32 @@
tracks to the inner.
Thus smaller and heavier-accessed file systems
should be closer to the outside of the drive, while
larger partitions like <filename>/usr</filename> should be placed
larger partitions like <filename class="directory">/usr</filename> should be placed
toward the inner parts of the disk. It is a good idea to create
partitions in an order similar to: root, swap,
<filename>/var</filename>, <filename>/usr</filename>.</para>
<filename class="directory">/var</filename>, <filename class="directory">/usr</filename>.</para>
<para>The size of the <filename>/var</filename> partition
<para>The size of the <filename class="directory">/var</filename> partition
reflects the intended machine usage.
The <filename>/var</filename> file system is used to hold
The <filename class="directory">/var</filename> file system is used to hold
mailboxes, log files, and printer spools. Mailboxes and log
files can grow to unexpected sizes depending
on how many users exist and how long log
files are kept. Most users will rarely need more than about a
gigabyte of free disk space in <filename>/var</filename>.</para>
gigabyte of free disk space in <filename class="directory">/var</filename>.</para>
<note>
<para>There are a few times that a lot of disk space is required
in <filename>/var/tmp</filename>. When new software is installed
in <filename class="directory">/var/tmp</filename>. When new software is installed
with &man.pkg.add.1; the packaging tools extract a temporary copy
of the packages under <filename>/var/tmp</filename>. Large
of the packages under <filename class="directory">/var/tmp</filename>. Large
software packages, like <application>Firefox</application>,
or <application>OpenOffice</application> may be tricky to install
if there is not enough disk space
under <filename>/var/tmp</filename>.</para>
under <filename class="directory">/var/tmp</filename>.</para>
</note>
<para>The <filename>/usr</filename> partition holds many
<para>The <filename class="directory">/usr</filename> partition holds many
of the files required to support the system, including the &man.ports.7;
collection (recommended) and the source code (optional). Both the
ports and the sources of the base system are optional at install
@ -154,8 +154,8 @@
<note><para>Some users have found that &man.sysinstall.8;'s
<literal>Auto-defaults</literal> partition sizer will
sometimes select smaller than adequate <filename>/var</filename>
and <filename>/</filename> partitions. Partition wisely and
sometimes select smaller than adequate <filename class="directory">/var</filename>
and <filename class="directory">/</filename> partitions. Partition wisely and
generously.</para></note>
</sect3>
@ -200,10 +200,10 @@
First, each partition has different operational
characteristics and separating them allows the file system to
tune accordingly. For example, the root
and <filename>/usr</filename> partitions are read-mostly, without
and <filename class="directory">/usr</filename> partitions are read-mostly, without
much writing. While a lot of reading and writing could
occur in <filename>/var</filename> and
<filename>/var/tmp</filename>.</para>
occur in <filename class="directory">/var</filename> and
<filename class="directory">/var/tmp</filename>.</para>
<para>By properly partitioning a system, fragmentation
introduced in the smaller write heavy partitions
@ -216,7 +216,7 @@
performance in the larger partitions may be needed,
shifting them more toward the edge of the disk will not
lead to a significant performance improvement over moving
<filename>/var</filename> to the edge.
<filename class="directory">/var</filename> to the edge.
Finally, there are safety concerns. A smaller, neater root
partition which is mostly read-only has a greater
chance of surviving a bad crash.</para>
@ -244,7 +244,7 @@
<filename>rc.conf</filename> file to
override the default settings from
<filename>/etc/defaults/rc.conf</filename>. The defaults file
should not be copied verbatim to <filename>/etc</filename> - it
should not be copied verbatim to <filename class="directory">/etc</filename> - it
contains default values, not examples. All system-specific
changes should be made in the <filename>rc.conf</filename>
file itself.</para>
@ -297,7 +297,7 @@
<indexterm><primary>/usr/local/etc</primary></indexterm>
<para>Typically, these files are installed in
<filename>/usr/local/etc</filename>. In the case where an
<filename class="directory">/usr/local/etc</filename>. In the case where an
application has a large number of configuration files, a
subdirectory will be created to hold them.</para>
@ -309,7 +309,7 @@
copying the <filename>.default</filename> files.</para>
<para>For example, consider the contents of the directory
<filename>/usr/local/etc/apache</filename>:</para>
<filename class="directory">/usr/local/etc/apache</filename>:</para>
<literallayout class="monospaced">-rw-r--r-- 1 root wheel 2184 May 20 1998 access.conf
-rw-r--r-- 1 root wheel 2184 May 20 1998 access.conf.default
@ -527,7 +527,7 @@ run_rc_command "$1"</programlisting>
<para>One of the most useful utilities in &os; is &man.cron.8;. The
<command>cron</command> utility runs in the background and constantly
checks the <filename>/etc/crontab</filename> file. The <command>cron</command>
utility also checks the <filename>/var/cron/tabs</filename> directory, in
utility also checks the <filename class="directory">/var/cron/tabs</filename> directory, in
search of new <filename>crontab</filename> files. These
<filename>crontab</filename> files store information about specific
functions which <command>cron</command> is supposed to perform at
@ -702,7 +702,7 @@ HOME=/var/log
<para>In 2002 &os; integrated the NetBSD
<filename>rc.d</filename> system for system initialization.
Users should notice the files listed in the
<filename>/etc/rc.d</filename> directory. Many of these files
<filename class="directory">/etc/rc.d</filename> directory. Many of these files
are for basic services which can be controlled with the
<option>start</option>, <option>stop</option>,
and <option>restart</option> options.
@ -1418,7 +1418,7 @@ ifconfig_fxp0_alias7="inet 202.0.75.20 netmask 255.255.255.255"</programlisting>
<title>Configuration Files</title>
<sect2>
<title><filename>/etc</filename> Layout</title>
<title><filename class="directory">/etc</filename> Layout</title>
<para>There are a number of directories in which configuration
information is kept. These include:</para>
@ -1429,42 +1429,42 @@ ifconfig_fxp0_alias7="inet 202.0.75.20 netmask 255.255.255.255"</programlisting>
<tbody>
<row>
<entry><filename>/etc</filename></entry>
<entry><filename class="directory">/etc</filename></entry>
<entry>Generic system configuration information; data here is
system-specific.</entry>
</row>
<row>
<entry><filename>/etc/defaults</filename></entry>
<entry><filename class="directory">/etc/defaults</filename></entry>
<entry>Default versions of system configuration files.</entry>
</row>
<row>
<entry><filename>/etc/mail</filename></entry>
<entry><filename class="directory">/etc/mail</filename></entry>
<entry>Extra &man.sendmail.8; configuration, other
MTA configuration files.
</entry>
</row>
<row>
<entry><filename>/etc/ppp</filename></entry>
<entry><filename class="directory">/etc/ppp</filename></entry>
<entry>Configuration for both user- and kernel-ppp programs.
</entry>
</row>
<row>
<entry><filename>/etc/namedb</filename></entry>
<entry><filename class="directory">/etc/namedb</filename></entry>
<entry>Default location for &man.named.8; data. Normally
<filename>named.conf</filename> and zone files are stored
here.</entry>
</row>
<row>
<entry><filename>/usr/local/etc</filename></entry>
<entry><filename class="directory">/usr/local/etc</filename></entry>
<entry>Configuration files for installed applications.
May contain per-application subdirectories.</entry>
</row>
<row>
<entry><filename>/usr/local/etc/rc.d</filename></entry>
<entry><filename class="directory">/usr/local/etc/rc.d</filename></entry>
<entry>Start/stop scripts for installed applications.</entry>
</row>
<row>
<entry><filename>/var/db</filename></entry>
<entry><filename class="directory">/var/db</filename></entry>
<entry>Automatically generated system-specific database files,
such as the package database, the locate database, and so
on</entry>