Date: Tue, 5 Feb 2002 13:39:29 -0500 (EST) From: Tom Rhodes <darklogik@pittgoth.com> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/34644: [PATCH] Handbook chapter(s) Message-ID: <200202051839.g15IdTS02296@pittgoth.com>
next in thread | raw e-mail | index | archive | help
>Number: 34644
>Category: docs
>Synopsis: [PATCH] Handbook chapter(s)
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Tue Feb 05 10:40:01 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:
>Release: FreeBSD 4.5 i386
>Organization:
>Environment:
System: FreeBSD localhost 4.5
>Description:
Cleaning out the pr-database, many prs and patches have
become obsolete due to to changes before/after their submission. This
pr, other than fixing up a quick spell check, also closes several of these
prs. Including:
pr: 33042
pr: 34622
pr: 34587
pr: 34578
pr: 34344
pr: 33937
and obsoletes pr: 17916 which is a kernel config chapter rewrite, I am currently
reviewing this pr along with pr: 33354 pr: 34074 and pr: 34524
>How-To-Repeat:
Read the handbook, view the doc pr database, and wish someone
would clean it up
>Fix:
Apply the following patch to the handbook directory (used diff -ru)
diff -ru handbook.old/advanced-networking/chapter.sgml handbook/advanced-networking/chapter.sgml
--- handbook.old/advanced-networking/chapter.sgml Tue Feb 5 11:17:58 2002
+++ handbook/advanced-networking/chapter.sgml Tue Feb 5 11:52:44 2002
@@ -4473,7 +4473,10 @@
<para>
It is a good idea to subscribe to <ulink
url="http://www.cert.org/">CERT</ulink>; and
- <ulink url="../handbook/eresources.html#ERESOURCES-MAIL">freebsd-announce</ulink>
+ <ulink url="../handbook/eresources.html#ERESOURCES-MAIL">freebsd-security</ulink>
+ of if you are an extremely busy administrator or use, you may wish
+ to check out the
+ <ulink url="../handbook/eresources.html#ERESOURCES-EMAIL">freebsd-announce</ulink>
to stay up to date with the current Internet and FreeBSD security
issues.
</para>
diff -ru handbook.old/config/chapter.sgml handbook/config/chapter.sgml
--- handbook.old/config/chapter.sgml Tue Feb 5 11:17:57 2002
+++ handbook/config/chapter.sgml Tue Feb 5 12:13:26 2002
@@ -1156,44 +1156,51 @@
<filename>/usr/swap0</filename>. You can use any name you
want, of course.</para>
- <para>First, be certain that your kernel configuration includes
- the vnode driver. It is not in recent versions of
- GENERIC.</para>
-
- <programlisting>pseudo-device vn 1 #Vnode driver (turns a file into a device)</programlisting>
+ <example>
+ <title>Creating a Swapfile</title>
<orderedlist>
+ <listitem>
+ <para>Be certain that your kernel configuration includes
+ the vnode driver. It is <emphasis>not</emphasis> in recent versions of
+ <filename>GENERIC</filename>.</para>
+
+ <programlisting>pseudo-device vn 1 #Vnode driver (turns a file into a device)</programlisting>
+ </listitem>
+
<listitem>
- <para>create a vn-device</para>
+ <para>create a vn-device:</para>
<screen>&prompt.root; <userinput>cd /dev</userinput> &prompt.root; <userinput>sh MAKEDEV vn0</userinput></screen>
</listitem>
<listitem>
- <para>create a swapfile (<filename>/usr/swap0</filename>)</para>
+ <para>create a swapfile (<filename>/usr/swap0</filename>):</para>
<screen>&prompt.root; <userinput>dd if=/dev/zero of=/usr/swap0 bs=1024k count=64</userinput></screen>
</listitem>
<listitem>
- <para>set proper permissions on (<filename>/usr/swap0</filename>)</para>
+ <para>set proper permissions on (<filename>/usr/swap0</filename>):</para>
<screen>&prompt.root; <userinput>chmod 0600 /usr/swap0</userinput></screen>
</listitem>
<listitem>
- <para>enable the swap file in <filename>/etc/rc.conf</filename></para>
+ <para>enable the swap file in <filename>/etc/rc.conf</filename>:</para>
<programlisting>swapfile="/usr/swap0" # Set to name of swapfile if aux swapfile desired.</programlisting>
</listitem>
<listitem>
- <para>reboot the machine</para>
- </listitem>
- </orderedlist>
- <para>To enable the swap file immediately, type</para>
+ <para>Reboot the machine or to enable the swap file immediately,
+ type:</para>
+
+ <screen>&prompt.root; <userinput>vnconfig -e /dev/vn0b /usr/swap0 swap</userinput></screen>
+ </listitem>
+ </orderedlist>
- <screen>&prompt.root; <userinput>vnconfig -e /dev/vn0b /usr/swap0 swap</userinput></screen>
+ </example>
</sect2>
</sect1>
</chapter>
diff -ru handbook.old/cutting-edge/chapter.sgml handbook/cutting-edge/chapter.sgml
--- handbook.old/cutting-edge/chapter.sgml Tue Feb 5 11:17:58 2002
+++ handbook/cutting-edge/chapter.sgml Tue Feb 5 12:23:31 2002
@@ -758,6 +758,19 @@
<para>This checks the filesystems, remounts <filename>/</filename>
read/write, mounts all the other UFS filesystems referenced in
<filename>/etc/fstab</filename> and then turns swapping on.</para>
+
+
+ <note>
+ <para>If your CMOS clock is set to local time and not to GMT,
+ you may also need to run the following command:</para>
+<screen>&prompt.root; <userinput>adjkerntz -i</userinput></screen>
+
+ <para>This will make sure that your local timezone settings
+ get set up correctly - without this, you may later run into some
+ problems.
+ </para>
+ </note>
+
</sect2>
<sect2>
@@ -1009,7 +1022,8 @@
<maketarget>installworld</maketarget> to install the new system
binaries.</para>
- <para>Run</para>
+ <para>Be sure that you are in the <filename>/usr/src</filename>
+ directory, if not, &man.cd.1; there now and run:</para>
<screen>&prompt.root; <userinput>make installworld</userinput></screen>
diff -ru handbook.old/install/chapter.sgml handbook/install/chapter.sgml
--- handbook.old/install/chapter.sgml Tue Feb 5 11:17:59 2002
+++ handbook/install/chapter.sgml Tue Feb 5 11:24:26 2002
@@ -2190,10 +2190,10 @@
<entry><filename>/</filename></entry>
- <entry>64MB</entry>
+ <entry>100MB</entry>
<entry>This is the root file system. Every other filesystem
- will be mounted somewhere under this one. 64MB is a
+ will be mounted somewhere under this one. 100MB is a
reasonable size for this filesystem. You will not be storing
too much data on it, as a regular FreeBSD install will put
about 40MB of data here. The remaining space is for temporary
@@ -4515,6 +4515,11 @@
has been issued and the message "Please press any key to reboot"
appears. If any key is pressed instead of turning off the power
switch, the system will reboot.</para>
+
+ <para>You could also use the <keycap>CTRL+ALT+DEL</keycap> key
+ combination to reboot the system, however this is not recommended
+ during normal operation.</para>
+
</sect2>
</sect1>
diff -ru handbook.old/kernelconfig/chapter.sgml handbook/kernelconfig/chapter.sgml
--- handbook.old/kernelconfig/chapter.sgml Tue Feb 5 11:18:00 2002
+++ handbook/kernelconfig/chapter.sgml Tue Feb 5 11:42:05 2002
@@ -616,7 +616,7 @@
<programlisting>options SOFTUPDATES #Enable FFS soft updates support</programlisting>
<para>This option enables soft updates in the kernel, this will help speed
- up write access on the disks. They enabled by default in the 4.X branch
+ up write access on the disks. They are enabled by default in the 4.X branch
but may not be turned on. Review the output from &man.mount.8; to see
if you have them enabled. If you do not see the soft-updates option then
you will need to activate it using the &man.tunefs.8; or &man.newfs.8;
@@ -1318,7 +1318,7 @@
counts down from 10. Hit any key except for the
<keycap>enter</keycap> key, type <command>unload</command>
and then type
- <command>boot<replaceable>kernel.old</replaceable></command>,
+ <command>boot <replaceable>kernel.old</replaceable></command>,
or the filename of any other kernel that will boot properly.
When reconfiguring a kernel, it is always a good idea to keep
a kernel that is known to work on hand.</para>
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200202051839.g15IdTS02296>