Date: Sun, 27 Jan 2002 19:17:56 +0100 (CET) From: Martin Heinen <martin@sumuk.de> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/34344: [PATCH] Warp 'Creating a Swapfile' in <example> Message-ID: <200201271817.g0RIHu240014@sumuk.de>
next in thread | raw e-mail | index | archive | help
>Number: 34344
>Category: docs
>Synopsis: [PATCH] Warp 'Creating a Swapfile' in <example>
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sun Jan 27 10:20:01 PST 2002
>Closed-Date:
>Last-Modified:
>Originator: Martin Heinen
>Release: FreeBSD 4.4-STABLE i386
>Organization:
>Environment:
System: FreeBSD Moses.earth.sol 4.4-STABLE FreeBSD 4.4-STABLE #0: Sat Dec 22 07:35:30 CET 2001 toor@Moses.earth.sol:/usr/obj/usr/src/sys/MOSES i386
>Description:
The section 'Adding Swap Space' describes how to create
swapfiles. This seems to be very important information,
so I wrapped this into an <example>.
If the patch gets committed, I'll fix whitespace damage
done with another patch.
>How-To-Repeat:
Read the section on Adding Swap Space in Configuration and Tuning
>Fix:
Index: chapter.sgml
===================================================================
RCS file: /u/cvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v
retrieving revision 1.37
diff -u -r1.37 chapter.sgml
--- chapter.sgml 23 Jan 2002 11:59:32 -0000 1.37
+++ chapter.sgml 27 Jan 2002 17:54:40 -0000
@@ -1156,44 +1156,49 @@
<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>
+ <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>
-
- <para>To enable the swap file immediately, type</para>
-
- <screen>&prompt.root; <userinput>vnconfig -e /dev/vn0b /usr/swap0 swap</userinput></screen>
+ </example>
</sect2>
</sect1>
</chapter>
>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?200201271817.g0RIHu240014>