git: 33e13e4c921b - releng/13.2 - FFS/UFS snapshots: improve documentation.

The branch releng/13.2 has been updated by gbe:

URL: https://cgit.FreeBSD.org/src/commit/?id=33e13e4c921be81280c33e9baa8a2c7699776538

commit 33e13e4c921be81280c33e9baa8a2c7699776538
Author:     Kirk McKusick <mckusick@FreeBSD.org>
AuthorDate: 2023-03-06 05:37:23 +0000
Commit:     Gordon Bergling <gbe@FreeBSD.org>
CommitDate: 2023-03-22 06:32:29 +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
    Approved by:    re (gjb)
    
    (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