FreeBSD Bugzilla – Attachment 18351 Details for
Bug 33017
Updates to config section of Handbook + plus whitespace patch
Home
|
New
|
Browse
|
Search
|
[?]
|
Reports
|
Help
|
New Account
|
Log In
Remember
[x]
|
Forgot Password
Login:
[x]
[patch]
file.diff
file.diff (text/plain), 17.10 KB, created by
setantae
on 2001-12-19 21:40:00 UTC
(
hide
)
Description:
file.diff
Filename:
MIME Type:
Creator:
setantae
Created:
2001-12-19 21:40:00 UTC
Size:
17.10 KB
patch
obsolete
>*** doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml.old Wed Dec 19 21:09:48 2001 >--- doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml Wed Dec 19 21:20:03 2001 >*************** >*** 42,49 **** > administrative configuration of FreeBSD systems.</para> > > <para>This chapter will also describe some of the parameters that >! can be set to tune a FreeBSD system for optimum >! performance.</para> > > <para>After reading this chapter, you will know:</para> > >--- 42,48 ---- > administrative configuration of FreeBSD systems.</para> > > <para>This chapter will also describe some of the parameters that >! can be set to tune a FreeBSD system for optimum performance.</para> > > <para>After reading this chapter, you will know:</para> > >*************** >*** 82,90 **** > </listitem> > <listitem> > <para>Be familiar with keeping FreeBSD sources up to date >! (<xref linkend="cutting-edge">), and >! the basics of kernel configuration/compilation >! (<xref linkend="kernelconfig">).</para> > </listitem> > </itemizedlist> > </sect1> >--- 81,88 ---- > </listitem> > <listitem> > <para>Be familiar with keeping FreeBSD sources up to date >! (<xref linkend="cutting-edge">), and the basics of kernel >! configuration/compilation (<xref linkend="kernelconfig">).</para> > </listitem> > </itemizedlist> > </sect1> >*************** >*** 116,124 **** > smaller, heavily-accessed filesystems, such as root and swap, > closer to the outside of the drive, while placing larger > partitions, such as <filename>/usr</filename>, towards the >! inner. To do so, it is >! a good idea to create partitions in a similar order: root, >! swap, <filename>/var</filename>, > <filename>/usr</filename>.</para> > > <para>The size of your <filename>/var</filename> partition >--- 114,121 ---- > smaller, heavily-accessed filesystems, such as root and swap, > closer to the outside of the drive, while placing larger > partitions, such as <filename>/usr</filename>, towards the >! inner. To do so, it is a good idea to create partitions in >! a similar order: root, swap, <filename>/var</filename>, > <filename>/usr</filename>.</para> > > <para>The size of your <filename>/var</filename> partition >*************** >*** 135,153 **** > > <para>The <filename>/usr</filename> partition holds the bulk > of the files required to support the system and a >! subdirectory within it called >! <filename>/usr/local</filename> holds the bulk of the files >! installed from the &man.ports.7; hierarchy. If you do not >! use ports all that much and do not intend to keep system >! source (<filename>/usr/src</filename>) on the machine, >! you can get away with a 1 >! gigabyte <filename>/usr</filename> partition. However, >! if you install a lot of >! ports (especially window managers and Linux binaries), we >! recommend at least a two gigabyte <filename>/usr</filename> >! and if you also >! intend to keep system source on the machine, we recommend a >! three gigabyte <filename>/usr</filename>. Do not > underestimate the amount of space you will need in this > partition, it can creep up and surprise you!</para> > >--- 132,147 ---- > > <para>The <filename>/usr</filename> partition holds the bulk > of the files required to support the system and a >! subdirectory within it called <filename>/usr/local</filename> >! holds the bulk of the files installed from the &man.ports.7; >! hierarchy. If you do not use ports all that much and do not >! intend to keep system source (<filename>/usr/src</filename>) >! on the machine, you can get away with a 1 gigabyte >! <filename>/usr</filename> partition. However, if you install >! a lot of ports (especially window managers and Linux binaries), >! we recommend at least a two gigabyte <filename>/usr</filename> >! and if you also intend to keep system source on the machine, >! we recommend a three gigabyte <filename>/usr</filename>. Do not > underestimate the amount of space you will need in this > partition, it can creep up and surprise you!</para> > >*************** >*** 157,166 **** > frustration.</para> > > <note><para>Some users who have used &man.sysinstall.8;'s >! <literal>Auto-defaults</literal> partition sizer have found >! either their root or <filename>/var</filename> partitions too >! small later on. Partition wisely and >! generously.</para></note> > > </sect3> > >--- 151,159 ---- > frustration.</para> > > <note><para>Some users who have used &man.sysinstall.8;'s >! <literal>Auto-defaults</literal> partition sizer have found >! either their root or <filename>/var</filename> partitions too >! small later on. Partition wisely and generously.</para></note> > > </sect3> > >*************** >*** 271,284 **** > > <itemizedlist> > <listitem><para>rc.conf:</para> >! <programlisting> . rc.conf.site >! hostname="node15.example.com" >! network_interfaces="fxp0 lo0" >! ifconfig_fxp0="inet 10.1.1.1"</programlisting></listitem> > <listitem><para>rc.conf.site:</para> >! <programlisting> defaultrouter="10.1.1.254" >! saver="daemon" >! blanktime="100"</programlisting></listitem> > </itemizedlist> > > <para>The <filename>rc.conf.site</filename> file can then be >--- 264,277 ---- > > <itemizedlist> > <listitem><para>rc.conf:</para> >! <programlisting>. rc.conf.site >! hostname="node15.example.com" >! network_interfaces="fxp0 lo0" >! ifconfig_fxp0="inet 10.1.1.1"</programlisting></listitem> > <listitem><para>rc.conf.site:</para> >! <programlisting>defaultrouter="10.1.1.254" >! saver="daemon" >! blanktime="100"</programlisting></listitem> > </itemizedlist> > > <para>The <filename>rc.conf.site</filename> file can then be >*************** >*** 288,295 **** > > <para>Upgrading the system using &man.sysinstall.8; > or <command>make world</command> will not overwrite the >! <filename>rc.conf</filename> >! file, so system configuration information will not be lost.</para> > > </sect1> > >--- 281,288 ---- > > <para>Upgrading the system using &man.sysinstall.8; > or <command>make world</command> will not overwrite the >! <filename>rc.conf</filename> file, so system configuration >! information will not be lost.</para> > > </sect1> > >*************** >*** 312,320 **** > <para>Normally, when a port or package is installed, sample > configuration files are also installed. These are usually > identified with a <quote>.default</quote> suffix. If there >! are no existing >! configuration files for the application, they will be created by >! copying the .default files.</para> > > <para>For example, consider the contents of the directory > <filename>/usr/local/etc/apache</filename>:</para> >--- 305,312 ---- > <para>Normally, when a port or package is installed, sample > configuration files are also installed. These are usually > identified with a <quote>.default</quote> suffix. If there >! are no existing configuration files for the application, >! they will be created by copying the .default files.</para> > > <para>For example, consider the contents of the directory > <filename>/usr/local/etc/apache</filename>:</para> >*************** >*** 352,364 **** > <filename>/usr/local/etc/rc.d</filename> which is invoked at > system startup with a <option>start</option> argument, and at > system shutdown with a <option>stop</option> argument. >! This is the recommended way for >! starting system-wide services that are to be run as >! <username>root</username>, or that > expect to be started as <username>root</username>. >! These scripts are registered as >! part of the installation of the package, and will be removed >! when the package is removed.</para> > > <para>A generic startup script in > <filename>/usr/local/etc/rc.d</filename> looks like:</para> >--- 344,354 ---- > <filename>/usr/local/etc/rc.d</filename> which is invoked at > system startup with a <option>start</option> argument, and at > system shutdown with a <option>stop</option> argument. >! This is the recommended way for starting system-wide services >! that are to be run as <username>root</username>, or that > expect to be started as <username>root</username>. >! These scripts are registered as part of the installation of the >! package, and will be removed when the package is removed.</para> > > <para>A generic startup script in > <filename>/usr/local/etc/rc.d</filename> looks like:</para> >*************** >*** 379,386 **** > ;; > esac > >! exit 0 >! </programlisting> > > <para>This script is called with <option>start</option> > at startup, and the <option>stop</option> at shutdown to allow >--- 369,375 ---- > ;; > esac > >! exit 0</programlisting> > > <para>This script is called with <option>start</option> > at startup, and the <option>stop</option> at shutdown to allow >*************** >*** 405,412 **** > <note><para>Do <emphasis>not</emphasis> place any commands in > <filename>/etc/rc.conf</filename>. To start daemons, or > run any commands at boot time, place a script in >! <filename>/usr/local/etc/rc.d</filename> instead.</para> >! </note> > > <para>It is also possible to use the &man.cron.8; daemon to start > system services. This approach has a number of advantages, not >--- 394,400 ---- > <note><para>Do <emphasis>not</emphasis> place any commands in > <filename>/etc/rc.conf</filename>. To start daemons, or > run any commands at boot time, place a script in >! <filename>/usr/local/etc/rc.d</filename> instead.</para></note> > > <para>It is also possible to use the &man.cron.8; daemon to start > system services. This approach has a number of advantages, not >*************** >*** 416,424 **** > > <para>This takes advantage of a feature of &man.cron.8;: the > time specification may be replaced by <literal>@reboot</literal>, >! which will >! cause the job to be run when &man.cron.8; is started shortly after >! system boot.</para> > </sect1> > > <sect1 id="configtuning-virtual-hosts"> >--- 404,411 ---- > > <para>This takes advantage of a feature of &man.cron.8;: the > time specification may be replaced by <literal>@reboot</literal>, >! which will cause the job to be run when &man.cron.8; is started >! shortly after system boot.</para> > </sect1> > > <sect1 id="configtuning-virtual-hosts"> >*************** >*** 434,441 **** > > <para>A given network interface has one <quote>real</quote> address, > and may have any number of <quote>alias</quote> addresses. >! These aliases are >! normally added by placing alias entries in > <filename>/etc/rc.conf</filename>.</para> > > <para>An alias entry for the interface <devicename>fxp0</devicename> >--- 421,427 ---- > > <para>A given network interface has one <quote>real</quote> address, > and may have any number of <quote>alias</quote> addresses. >! These aliases are normally added by placing alias entries in > <filename>/etc/rc.conf</filename>.</para> > > <para>An alias entry for the interface <devicename>fxp0</devicename> >*************** >*** 445,452 **** > > <para>Note that alias entries must start with alias0 and proceed > upwards in order, (for example, _alias1, _alias2, and so on). >! The configuration process will stop at the first missing number. >! </para> > > <para>The calculation of alias netmasks is important, but > fortunately quite simple. For a given interface, there must be >--- 431,437 ---- > > <para>Note that alias entries must start with alias0 and proceed > upwards in order, (for example, _alias1, _alias2, and so on). >! The configuration process will stop at the first missing number.</para> > > <para>The calculation of alias netmasks is important, but > fortunately quite simple. For a given interface, there must be >*************** >*** 464,478 **** > <para>The following entries configure the adapter correctly for > this arrangement:</para> > >! <programlisting> ifconfig_fxp0="inet 10.1.1.1 netmask 255.255.255.0" >! ifconfig_fxp0_alias0="inet 10.1.1.2 netmask 255.255.255.255" >! ifconfig_fxp0_alias1="inet 10.1.1.3 netmask 255.255.255.255" >! ifconfig_fxp0_alias2="inet 10.1.1.4 netmask 255.255.255.255" >! ifconfig_fxp0_alias3="inet 10.1.1.5 netmask 255.255.255.255" >! ifconfig_fxp0_alias4="inet 202.0.75.17 netmask 255.255.255.240" >! ifconfig_fxp0_alias5="inet 202.0.75.18 netmask 255.255.255.255" >! ifconfig_fxp0_alias6="inet 202.0.75.19 netmask 255.255.255.255" >! ifconfig_fxp0_alias7="inet 202.0.75.20 netmask 255.255.255.255"</programlisting> > > </sect1> > >--- 449,463 ---- > <para>The following entries configure the adapter correctly for > this arrangement:</para> > >! <programlisting>ifconfig_fxp0="inet 10.1.1.1 netmask 255.255.255.0" >! ifconfig_fxp0_alias0="inet 10.1.1.2 netmask 255.255.255.255" >! ifconfig_fxp0_alias1="inet 10.1.1.3 netmask 255.255.255.255" >! ifconfig_fxp0_alias2="inet 10.1.1.4 netmask 255.255.255.255" >! ifconfig_fxp0_alias3="inet 10.1.1.5 netmask 255.255.255.255" >! ifconfig_fxp0_alias4="inet 202.0.75.17 netmask 255.255.255.240" >! ifconfig_fxp0_alias5="inet 202.0.75.18 netmask 255.255.255.255" >! ifconfig_fxp0_alias6="inet 202.0.75.19 netmask 255.255.255.255" >! ifconfig_fxp0_alias7="inet 202.0.75.20 netmask 255.255.255.255"</programlisting> > > </sect1> > >*************** >*** 499,511 **** > <row> > <entry><filename>/etc/mail</filename></entry> > <entry>Extra &man.sendmail.8; configuration, other >! MTA configuration files. >! </entry> > </row> > <row> > <entry><filename>/etc/ppp</filename></entry> >! <entry>Configuration for both user- and kernel-ppp programs. >! </entry> > </row> > <row> > <entry><filename>/etc/namedb</filename></entry> >--- 484,494 ---- > <row> > <entry><filename>/etc/mail</filename></entry> > <entry>Extra &man.sendmail.8; configuration, other >! MTA configuration files.</entry> > </row> > <row> > <entry><filename>/etc/ppp</filename></entry> >! <entry>Configuration for both user- and kernel-ppp programs.</entry> > </row> > <row> > <entry><filename>/etc/namedb</filename></entry> >*************** >*** 752,760 **** > > <para><filename>sysctl.conf</filename> looks much like > <filename>rc.conf</filename>. Values are set in a >! <literal>variable=value</literal> >! form. The specified values are set after the system goes into >! multi-user mode. Not all variables are settable in this mode.</para> > > <para>A sample <filename>sysctl.conf</filename> turning off logging > of fatal signal exits and letting Linux programs know they are really >--- 735,743 ---- > > <para><filename>sysctl.conf</filename> looks much like > <filename>rc.conf</filename>. Values are set in a >! <literal>variable=value</literal> form. The specified values >! are set after the system goes into multi-user mode. Not all >! variables are settable in this mode.</para> > > <para>A sample <filename>sysctl.conf</filename> turning off logging > of fatal signal exits and letting Linux programs know they are really >*************** >*** 818,833 **** > </indexterm> > > <para>The <varname>vfs.vmiodirenable</varname> sysctl variable >! defaults to 1 (on) and may >! be set to 0 (off) or 1 (on). This parameter controls how >! directories are cached by the system. Most directories are >! small and use but a single fragment (typically 1K) in the >! filesystem and even less (typically 512 bytes) in the buffer >! cache. However, when operating in the default mode the buffer >! cache will only cache a fixed number of directories even if >! you have a huge amount of memory. Turning on this sysctl >! allows the buffer cache to use the VM Page Cache to cache the >! directories. The advantage is that all of memory is now > available for caching directories. The disadvantage is that > the minimum in-core memory used to cache a directory is the > physical page size (typically 4K) rather than 512 bytes. We >--- 801,815 ---- > </indexterm> > > <para>The <varname>vfs.vmiodirenable</varname> sysctl variable >! defaults to 1 (on) and may be set to 0 (off) or 1 (on). >! This parameter controls how directories are cached by the >! system. Most directories are small and use but a single fragment >! (typically 1K) in the filesystem and even less (typically 512 >! bytes) in the buffer cache. However, when operating in the >! default mode the buffer cache will only cache a fixed number of >! directories even if you have a huge amount of memory. Turning >! on this sysctl allows the buffer cache to use the VM Page Cache >! to cache the directories. The advantage is that all of memory is now > available for caching directories. The disadvantage is that > the minimum in-core memory used to cache a directory is the > physical page size (typically 4K) rather than 512 bytes. We
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Diff
View Attachment As Raw
Actions:
View
|
Diff
Attachments on
bug 33017
:
18350
| 18351