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

Add markup around a few filenames and literal text.

Browse source 
Fix the markup choice in a few instances.

Cuddle up the ending </programlisting> with the previous line.

Turn $FreeBSD$ in to $FreeBSD&dollar; to prevent expansion.

Add Emacs local variables section.
This commit is contained in:
Nik Clayton 2001-07-16 20:49:02 +00:00
parent b72caddbbc
commit 65d647eb30
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=9934
1 changed files with 49 additions and 43 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v 1.2 2001/07/14 01:09:40 chern Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v 1.3 2001/07/16 20:35:38 nik Exp $
-->
<chapter id="config-tuning">
@ -394,7 +394,7 @@ exit 0
<title>Configuration Files</title>
<sect2>
<title>/etc Layout</title>
<title><filename>/etc</filename> Layout</title>
<para>There are a number of directories in which configuration
information is kept. These include:</para>
@ -402,42 +402,42 @@ exit 0
<tgroup cols="2">
<tbody>
<row>
<entry>/etc</entry>
<entry><filename>/etc</filename></entry>
<entry>Generic system configuration information; data here is
system-specific.</entry>
</row>
<row>
<entry>/etc/defaults</entry>
<entry><filename>/etc/defaults</filename></entry>
<entry>Default versions of system configuration files.</entry>
</row>
<row>
<entry>/etc/mail</entry>
<entry><filename>/etc/mail</filename></entry>
<entry>Extra sendmail configuration, other MTA configuration
files.
</entry>
</row>
<row>
<entry>/etc/ppp</entry>
<entry><filename>/etc/ppp</filename></entry>
<entry>Configuration for both user- and kernel-ppp programs.
</entry>
</row>
<row>
<entry>/etc/namedb</entry>
<entry><filename>/etc/namedb</filename></entry>
<entry>Default location for bind(8) data. Normally the
boot file is located here, and contains a directive to
refer to other data in /var/db.</entry>
</row>
<row>
<entry>/usr/local/etc</entry>
<entry><filename>/usr/local/etc</filename></entry>
<entry>Configuration files for installed applications.
May contain per-application subdirectories.</entry>
</row>
<row>
<entry>/usr/local/etc/rc.d</entry>
<entry><filename>/usr/local/etc/rc.d</filename></entry>
<entry>Start/stop scripts for installed applications.</entry>
</row>
<row>
<entry>/var/db</entry>
<entry><filename>/var/db</filename></entry>
<entry>Persistent system-specific data files, eg. bind(8) zone
files, database files, and so on.</entry>
</row>
@ -467,18 +467,18 @@ exit 0
<tgroup cols="2">
<tbody>
<row>
<entry>nameserver</entry>
<entry><literal>nameserver</literal></entry>
<entry>The IP address of a nameserver the resolver
should query. The servers are queried in the order
listed with a maximum of three.</entry>
</row>
<row>
<entry>search</entry>
<entry><literal>search</literal></entry>
<entry>Search list hostname lookup. This is normally
determined by the domain of the local hostname.</entry>
</row>
<row>
<entry>domain</entry>
<entry><literal>domain</literal></entry>
<entry>The local domain name.</entry>
</row>
</tbody>
@ -489,8 +489,7 @@ exit 0
<programlisting>search foobar.com
nameserver 147.11.1.11
nameserver 147.11.100.30
</programlisting>
nameserver 147.11.100.30</programlisting>
<para>&man.dhclient.8; usually rewrites
<filename>resolv.conf</filename> with information received from the
@ -498,7 +497,7 @@ nameserver 147.11.100.30
</sect3>
<sect3>
<title>/etc/hosts</title>
<title><filename>/etc/hosts</filename></title>
<indexterm><primary>hosts</primary></indexterm>
@ -511,7 +510,7 @@ nameserver 147.11.100.30
a local record of Internet names, reducing the need to query
externally for commonly accessed names.</para>
<programlisting># $FreeBSD: doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v 1.2 2001/07/14 01:09:40 chern Exp $
<programlisting># &dollar;FreeBSD$
#
# Host Database
# This file should contain the addresses and aliases
@ -540,17 +539,16 @@ nameserver 147.11.100.30
# to invent your own network numbers but instead get one from your
# network provider (if any) or from the Internet Registry (ftp to
# rs.internic.net, directory `/templates').
#
</programlisting>
#</programlisting>
<para><filename>/etc/hosts</filename> takes on the simple format of:</para>
<programlisting>[Internet address] [offical hostname] [alias1] [alias2] ...
</programlisting>
<para><filename>/etc/hosts</filename> takes on the simple format
of:</para>
<programlisting>[Internet address] [offical hostname] [alias1] [alias2] ...</programlisting>
<para>For example:</para>
<programlisting>10.0.0.1 myRealHostname.foobar.com myRealHostname foobar1 foobar2
</programlisting>
<programlisting>10.0.0.1 myRealHostname.foobar.com myRealHostname foobar1 foobar2</programlisting>
<para>Consult &man.hosts.5; for more information.</para>
</sect3>
@ -562,7 +560,7 @@ nameserver 147.11.100.30
<indexterm><primary>log files</primary></indexterm>
<sect3>
<title>syslog.conf</title>
<title><filename>syslog.conf</filename></title>
<indexterm><primary>syslog.conf</primary></indexterm>
@ -570,7 +568,7 @@ nameserver 147.11.100.30
for the &man.syslogd.8; program. It indicates which types
of syslog messages are logged to particular log files.</para>
<programlisting># $FreeBSD: doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v 1.2 2001/07/14 01:09:40 chern Exp $
<programlisting># $FreeBSD&dollar;
#
# Spaces ARE valid field separators in this file. However,
# other *nix-like systems still insist on using tabs as field
@ -600,15 +598,14 @@ cron.* /var/log/cron
!startslip
*.* /var/log/slip.log
!ppp
*.* /var/log/ppp.log
</programlisting>
*.* /var/log/ppp.log</programlisting>
<para>Consult the &man.syslog.conf.5; manpage for more
information.</para>
</sect3>
<sect3>
<title>newsyslog.conf</title>
<title><filename>newsyslog.conf</filename></title>
<indexterm><primary>newsyslog.conf</primary></indexterm>
@ -630,7 +627,7 @@ cron.* /var/log/cron
certain periodic time/date.</para>
<programlisting># configuration file for newsyslog
# $FreeBSD: doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v 1.2 2001/07/14 01:09:40 chern Exp $
# $FreeBSD&dollar;
#
# logfilename [owner:group] mode count size when [ZB] [/pid_file] [sig_num]
/var/log/cron 600 3 100 * Z
@ -648,8 +645,7 @@ cron.* /var/log/cron
/var/log/daily.log 640 7 * @T00 Z
/var/log/weekly.log 640 5 1 $W6D0 Z
/var/log/monthly.log 640 12 * $M1D0 Z
/var/log/console.log 640 5 100 * Z
</programlisting>
/var/log/console.log 640 5 100 * Z</programlisting>
<para>Consult the &man.newsyslog.8; manpage for more
information.</para>
@ -657,7 +653,7 @@ cron.* /var/log/cron
</sect2>
<sect2>
<title>sysctl.conf</title>
<title><filename>sysctl.conf</filename></title>
<indexterm><primary>sysctl.conf</primary></indexterm>
<indexterm><primary>sysctl</primary></indexterm>
@ -673,9 +669,7 @@ cron.* /var/log/cron
<programlisting>kern.logsigexit=0 # Do not log fatal signal exits (e.g. sig 11)
compat.linux.osname=FreeBSD
compat.linux.osrelease=4.3-STABLE
</programlisting>
compat.linux.osrelease=4.3-STABLE</programlisting>
</sect2>
</sect1>
@ -696,19 +690,20 @@ compat.linux.osrelease=4.3-STABLE
modify system settings.</para>
<para>To view all readable variables:</para>
<programlisting>&prompt.user; <userinput>sysctl -a</userinput>
</programlisting>
<screen>&prompt.user; <userinput>sysctl -a</userinput></screen>
<para>To read a particular variable, for example,
<literal>kern.maxproc</literal>:</para>
<programlisting>&prompt.user; <userinput>sysctl kern.maxproc</userinput>
kern.maxproc: 1044</programlisting>
<screen>&prompt.user; <userinput>sysctl kern.maxproc</userinput>
kern.maxproc: 1044</screen>
<para>To set a particular variable, use the <literal>=</literal>
option:</para>
<programlisting>&prompt.root; <userinput>sysctl kern.maxfiles=5000</userinput>
kern.maxfiles: 2088 -> 5000</programlisting>
<screen>&prompt.root; <userinput>sysctl kern.maxfiles=5000</userinput>
kern.maxfiles: 2088 -> 5000</screen>
<para>Settings of sysctl variables are usually either strings, numbers,
or booleans. A boolean being 1 for yes or a 0 for no.</para>
@ -719,6 +714,7 @@ kern.maxfiles: 2088 -> 5000</programlisting>
<sect2>
<title>Sysctl Variables</title>
<sect3>
<title>vfs.vmiodirenable</title>
@ -803,7 +799,6 @@ kern.maxfiles: 2088 -> 5000</programlisting>
update of it, e.g. make installworld, can run it out of space and
cause the update to fail.</para>
</sect2>
</sect1>
<sect1 id="configtuning-kernel-limits">
@ -839,3 +834,14 @@ kern.maxfiles: 2088 -> 5000</programlisting>
</sect2>
</sect1>
</chapter>
<!--
Local Variables:
mode: sgml
sgml-declaration: "../chapter.decl"
sgml-indent-data: t
sgml-omittag: nil
sgml-always-quote-attributes: t
sgml-parent-document: ("../book.sgml" "part" "chapter")
End:
-->