From owner-freebsd-doc Sun Jul 21 15:40:11 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C430337B400 for ; Sun, 21 Jul 2002 15:40:03 -0700 (PDT) Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 14E1643E5E for ; Sun, 21 Jul 2002 15:40:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.4/8.12.4) with ESMTP id g6LMe2JU056828 for ; Sun, 21 Jul 2002 15:40:02 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.4/8.12.4/Submit) id g6LMe2CU056826; Sun, 21 Jul 2002 15:40:02 -0700 (PDT) Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2D04B37B405 for ; Sun, 21 Jul 2002 15:36:06 -0700 (PDT) Received: from Kain.sumuk.de (Kain.sumuk.de [213.221.86.114]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2EAD343E31 for ; Sun, 21 Jul 2002 15:36:05 -0700 (PDT) (envelope-from vincent@Kain.sumuk.de) Received: from Kain.sumuk.de (localhost [127.0.0.1]) by Kain.sumuk.de (8.12.3/8.12.3) with ESMTP id g6LMa3pE073359 for ; Mon, 22 Jul 2002 00:36:03 +0200 (CEST) (envelope-from vincent@Kain.sumuk.de) Received: (from vincent@localhost) by Kain.sumuk.de (8.12.3/8.12.3/Submit) id g6LMa3oY073358; Mon, 22 Jul 2002 00:36:03 +0200 (CEST) Message-Id: <200207212236.g6LMa3oY073358@Kain.sumuk.de> Date: Mon, 22 Jul 2002 00:36:03 +0200 (CEST) From: Martin Heinen Reply-To: Martin Heinen To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/40862: [PATCH] corrections for snapshot section Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >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 -> root, schg -> , dumpdates -> dumpdates. 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 @@ Snapshots - FreeBSD 5.0 offers a new feature in conjunction with the - option. File system snapshots. + FreeBSD 5.0 offers a new feature in conjunction with + Soft Updates: File system snapshots. 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. - 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. + During initial creation, the flag (see &man.chflags.1; manual page) + is set on to ensure that not even root 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. + though they have the flag set, so it is not necessary to + clear the flag before removing a snapshot file. + + Snapshots are created with the &man.mount.8; command. To place + a snapshot of /var in the file + /var/snapshot/snap use the following + command: + +&prompt.root; mount -u -o snapshot /var/snapshot/snap /var Once a snapshot has been created, there are several interesting things that an administrator can do with them: @@ -483,7 +489,7 @@ file system as the timestamp of the snapshot. As of this writing &man.dump.8; has not yet - been changed to set the dumpdates file correctly, so + been changed to set the dumpdates file correctly, so do not use this feature in production until that fix is made. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message