Date: Mon, 20 Mar 2023 05:22:32 GMT From: Kirk McKusick <mckusick@FreeBSD.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Subject: git: 24ed6ac44549 - stable/13 - FFS/UFS snapshots: improve documentation. Message-ID: <202303200522.32K5MWKR068833@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
The branch stable/13 has been updated by mckusick: URL: https://cgit.FreeBSD.org/src/commit/?id=24ed6ac445497ce2489c7be1723462030eef47d4 commit 24ed6ac445497ce2489c7be1723462030eef47d4 Author: Kirk McKusick <mckusick@FreeBSD.org> AuthorDate: 2023-03-06 05:37:23 +0000 Commit: Kirk McKusick <mckusick@FreeBSD.org> CommitDate: 2023-03-20 05:22:06 +0000 FFS/UFS snapshots: improve documentation. This update provides a more detailed description of FFS/UFS snapshots and adds links to useful man pages. Requested by: Graham Perrin Submitted by: darius-dons.net.au Reviewed by: Ravi Pokala PR: 266358 Differential Revision: https://reviews.freebsd.org/D38817 (cherry picked from commit 528d8e55c8d338e78fa4e6c9f182e8975f75199a) --- sbin/mksnap_ffs/mksnap_ffs.8 | 29 +++++++++++++++++++++++------ 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/sbin/mksnap_ffs/mksnap_ffs.8 b/sbin/mksnap_ffs/mksnap_ffs.8 index 201014522721..658502cffdcb 100644 --- a/sbin/mksnap_ffs/mksnap_ffs.8 +++ b/sbin/mksnap_ffs/mksnap_ffs.8 @@ -32,9 +32,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ -.\" -.Dd October 3, 2016 +.Dd March 5, 2023 .Dt MKSNAP_FFS 8 .Os .Sh NAME @@ -48,6 +46,18 @@ The .Nm utility creates a snapshot named .Ar snapshot_name . +This name is a path in the file system being snapshotted. +Typically this is under the +.Pa .snap +directory in the root of the file system, but it can +be anywhere. +Snapshots can be listed using the +.Xr snapinfo 8 +command. +.Pp +After a snapshot is taken it appears as a file. +The file is the size of the file system from which it was taken. +It can be moved, renamed or deleted (which removes the snapshot). .Pp The group ownership of the file is set to .Dq Li operator ; @@ -62,15 +72,22 @@ Create a snapshot of .Pa /usr/home file system and mount the snapshot elsewhere: .Bd -literal -offset indent -mksnap_ffs /usr/home/snapshot -mdconfig -a -t vnode -o readonly -f /usr/home/snapshot +mksnap_ffs /usr/home/.snap/snap1 +mdconfig -a -t vnode -o readonly -f /usr/home/.snap/snap1 mount -o ro /dev/md0 /mnt/ .Ed +.Pp +Delete a snapshot: +.Bd -literal -offset indent +rm /usr/home/.snap/snap1 +.Ed .Sh SEE ALSO +.Xr rm 1 , .Xr chmod 2 , .Xr chown 8 , .Xr mdconfig 8 , -.Xr mount 8 +.Xr mount 8 , +.Xr snapinfo 8 .Sh HISTORY The .Nm
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202303200522.32K5MWKR068833>