Date: Mon, 22 Jul 2002 00:36:03 +0200 (CEST) From: Martin Heinen <martin@sumuk.de> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/40862: [PATCH] corrections for snapshot section Message-ID: <200207212236.g6LMa3oY073358@Kain.sumuk.de>
next in thread | raw e-mail | index | archive | help
>Number: 40862
>Category: docs
>Synopsis: [PATCH] corrections for snapshot section
>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 Jul 21 15:40:01 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator: Martin Heinen
>Release: FreeBSD 4.6-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD Kain.sumuk.de 4.6-PRERELEASE FreeBSD 4.6-PRERELEASE #0: Sun May 12 20:01:38 CEST 2002 toor@Kain.sumuk.de:/usr/obj/usr/src/sys/KAIN i386
>Description:
Linked to the 'Soft Updates' section of the handbook,
removed unclear sentence dealing with mount -u,
added an example showing how to create snapshots,
root -> <username>root</username>,
schg -> <option>schg</option>,
dumpdates -> <filename>dumpdates</filename>.
BTW, the section explaining how to run fsck on snapshots states
that this does the same as a background fsck. This doesn't make
sense to me, could we remove that sentence or clarify it?
>How-To-Repeat:
Read the section on snapshots in the handbook.
>Fix:
Index: chapter.sgml
===================================================================
RCS file: /u/cvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v
retrieving revision 1.90
diff -u -r1.90 chapter.sgml
--- chapter.sgml 15 Jul 2002 20:37:51 -0000 1.90
+++ chapter.sgml 21 Jul 2002 21:54:32 -0000
@@ -437,12 +437,11 @@
<secondary>Snapshots</secondary>
</indexterm>
- <para>FreeBSD 5.0 offers a new feature in conjunction with the
- <option>softupdates</option> option. File system snapshots.</para>
+ <para>FreeBSD 5.0 offers a new feature in conjunction with
+ <link linkend="soft-updates">Soft Updates</link>: File system snapshots.</para>
<para>Snapshots allow a user to create an image of specified file
- systems and treat this image as a file. The -u (or update) flag
- in &man.mount.8; is required with this option.
+ systems and treat this image as a file.
Snapshot files must be created in the file system that the
action is performed on, and a user may create no more than 20
snapshots per file system. Active snapshots are recorded
@@ -453,12 +452,19 @@
however all the used space may not be acquired as another snapshot will
possibly claim some of the blocks that were released.</para>
- <para>During initial creation, the schg flag (see &man.chflags.1; manual page)
- is set on to ensure that not even root can write to the snapshot.
+ <para>During initial creation, the <option>schg</option> flag (see &man.chflags.1; manual page)
+ is set on to ensure that not even <username>root</username> can write to the snapshot.
The &man.unlink.1; command makes an exception for snapshot files,
however, in which it allows them to be removed even
- though they have the schg flag set, so it is not necessary to
- clear the schg flag before removing a snapshot file.</para>
+ though they have the <option>schg</option> flag set, so it is not necessary to
+ clear the <option>schg</option> flag before removing a snapshot file.</para>
+
+ <para>Snapshots are created with the &man.mount.8; command. To place
+ a snapshot of <filename>/var</filename> in the file
+ <filename>/var/snapshot/snap</filename> use the following
+ command:</para>
+
+<screen>&prompt.root; <userinput>mount -u -o snapshot /var/snapshot/snap /var</userinput></screen>
<para>Once a snapshot has been created, there are several interesting
things that an administrator can do with them:</para>
@@ -483,7 +489,7 @@
file system as the timestamp of the snapshot.</para>
<warning><para>As of this writing &man.dump.8; has not yet
- been changed to set the dumpdates file correctly, so
+ been changed to set the <filename>dumpdates</filename> file correctly, so
do not use this feature in production until that fix
is made.</para></warning>
</listitem>
>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?200207212236.g6LMa3oY073358>