From nobody Sun Mar 26 04:47:05 2023 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Pkk211j7Nz41FN6 for ; Sun, 26 Mar 2023 04:47:05 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Pkk206qScz3jht for ; Sun, 26 Mar 2023 04:47:04 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1679806025; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=k+/tDnTalKgya8TnRwa0ICk/PIF6vDxNT1KLq+JaHwI=; b=HckOAAs0gaCOtGHxU//IbWcG5oX7ZMKIEZKmILcI/norrzTLZzfDGHmWAFrxyeokJlwhJy pbQXcBGsi0ZLJ20+7FN4nygWVn3C1j9keea3m7T/3UlsAp7myrH8fV0u5hbiLjmZSqXAfv NWZpFU9K6kUwZc3wtBs3gArCz+Ud3qiq9DIjrtjhOcJbXdh9HPpX8NSdXJSpxZ+hR8iz9D IgV55jD1s2Rft+7/QlZMZ+Us4u553UYNp4Fv3mliI/dK860fkj0R54sXL1OYR5sMDds3JQ gIyE58AuvtfIYL23vnVvSHAkAZVan7Ljj0lKeHczwmqOgAAcUehHbgWBMmTcpA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1679806025; a=rsa-sha256; cv=none; b=bc0+Q+VbVS6H315hnUW+BIDdRAe8Xxm5ym+Hxx9xcHZqiv0FVBckHbiHhVanP6q664pujK ACCAoqSWDL0yMZuFApojZw2d2m+i2x1phBjh7yiMZHodzIs/FZvxwP8S/A5Gj44y/hIC6r zvt9itenD89pj/Tpv3ldQDnpHV8uaC8e/CnBWeOpk1g84Wt8+gxAwODgcweOkqxKCf4Lay L4G2VqpWwY/UzTaMMU6HRAdKA93+geAU1bg0F2ZyE1o3Wc29FYoCR1Pt1kxMM50Sh6Nahh LvmksimlwLyqjjHDm/eCQDBtqhYmxfpizra8pg4TEhpDuBduQfyFC+nIqDR3Kw== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Pkk205nGRzS48 for ; Sun, 26 Mar 2023 04:47:04 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 32Q4l4XW012757 for ; Sun, 26 Mar 2023 04:47:04 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 32Q4l4l7012756 for doc@FreeBSD.org; Sun, 26 Mar 2023 04:47:04 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 266358] FFS/UFS snapshots: improve documentation for removal (deletion) and unlinking Date: Sun, 26 Mar 2023 04:47:05 +0000 X-Bugzilla-Reason: CC X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: grahamperrin@freebsd.org X-Bugzilla-Status: Open X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: carlavilla@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_status resolution Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 X-ThisMailContainsUnwantedMimeParts: N https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D266358 Graham Perrin changed: What |Removed |Added ---------------------------------------------------------------------------- Status|Closed |Open Resolution|FIXED |--- --- Comment #19 from Graham Perrin --- mksnap_ffs(8) in 13.2-RC4 has a three-paragraph description, and the second example is 'Delete a snapshot:'. mksnap_ffs(8) in CURRENT built a few hours ago has a two-paragraph descript= ion, and only one example:=20 ---- root@mowa219-gjp4-8570p-freebsd:~ # man -P more mksnap_ffs MKSNAP_FFS(8) FreeBSD System Manager's Manual MKSNAP_FFS= (8) NAME mksnap_ffs =E2=80=93 take a file system snapshot SYNOPSIS mksnap_ffs snapshot_name DESCRIPTION The mksnap_ffs utility creates a snapshot named snapshot_name. The group ownership of the file is set to =E2=80=9Coperator=E2=80=9D; = the owner of the file remains =E2=80=9Croot=E2=80=9D. The mode of the snapshot is set = to be readable by the owner or members of the =E2=80=9Coperator=E2=80=9D group. EXAMPLES Create a snapshot of /usr/home file system and mount the snapshot elsewhere: mksnap_ffs /usr/home/snapshot mdconfig -a -t vnode -o readonly -f /usr/home/snapshot mount -o ro /dev/md0 /mnt/ SEE ALSO chmod(2), chown(8), mdconfig(8), mount(8) HISTORY The mksnap_ffs utility first appeared in FreeBSD 5.1. CAVEATS The disk full situation is not handled gracefully and may lead to a system panic when no free blocks are found. Every filesystem can have only up to 20 active snapshots. When this limit is reached, attempting to create more snapshots fails with ENOSP= C, and mksnap_ffs reports that it is =E2=80=9Cout of space=E2=80=9D. FreeBSD 14.0-CURRENT October 3, 2016 FreeBSD 14.0-CURR= ENT root@mowa219-gjp4-8570p-freebsd:~ # uname -aKU FreeBSD mowa219-gjp4-8570p-freebsd 14.0-CURRENT FreeBSD 14.0-CURRENT #36 main-n261767-508aee968143: Sat Mar 25 23:33:05 GMT 2023=20=20=20=20 grahamperrin@mowa219-gjp4-8570p-freebsd:/usr/obj/usr/src/amd64.amd64/sys/GE= NERIC-NODEBUG amd64 1400084 1400084 root@mowa219-gjp4-8570p-freebsd:~ # --=20 You are receiving this mail because: You are on the CC list for the bug.=