[Bug 266358] FFS/UFS snapshots: improve documentation for removal (deletion) and unlinking

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=266358

            Bug ID: 266358
           Summary: FFS/UFS snapshots: improve documentation for removal
                    (deletion) and unlinking
           Product: Documentation
           Version: Latest
          Hardware: Any
               URL: https://discord.com/channels/727023752348434432/760416
                    197803245591/1018429147741179946
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: grahamperrin@freebsd.org
                CC: doc@FreeBSD.org

Manual pages
============

Darius in #documentation in Discord observed that neither mksnap_ffs(8) nor
snapinfo(8) leads to information about deletion. 

<https://www.freebsd.org/cgi/man.cgi?query=mksnap_ffs&sektion=8&manpath=FreeBSD#SEE_ALSO>

<https://www.freebsd.org/cgi/man.cgi?query=snapinfo&sektion=8&manpath=FreeBSD#SEE_ALSO>

FreeBSD Handbook
================

From <https://docs.freebsd.org/en/books/handbook/disks/#snapshots>: 

> ... When a snapshot is no longer required, it can be removed using 
> rm(1). While snapshots may be removed in any order, all the used space 
> may not be acquired because another snapshot will possibly claim some of 
> the released blocks.
> 
> The un-alterable snapshot file flag is set by mksnap_ffs(8) after initial 
> creation of a snapshot file. unlink(1) makes an exception for snapshot 
> files since it allows them to be removed. ...

<https://www.freebsd.org/cgi/man.cgi?query=rm&sektion=1&manpath=FreeBSD>

> rm, unlink -- remove directory entries

-- 
You are receiving this mail because:
You are on the CC list for the bug.