From owner-freebsd-doc Wed Mar 6 15:30:13 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id B781537B419 for ; Wed, 6 Mar 2002 15:30:01 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g26NU1P62913; Wed, 6 Mar 2002 15:30:01 -0800 (PST) (envelope-from gnats) Received: from lists.blarg.net (lists.blarg.net [206.124.128.17]) by hub.freebsd.org (Postfix) with ESMTP id 46FF237B416 for ; Wed, 6 Mar 2002 15:29:41 -0800 (PST) Received: from thig.blarg.net (thig.blarg.net [206.124.128.18]) by lists.blarg.net (Postfix) with ESMTP id D8A38BD44 for ; Wed, 6 Mar 2002 15:29:40 -0800 (PST) Received: from localhost.localdomain ([206.124.139.115]) by thig.blarg.net (8.9.3/8.9.3) with ESMTP id PAA08357 for ; Wed, 6 Mar 2002 15:29:40 -0800 Received: (from jojo@localhost) by localhost.localdomain (8.11.6/8.11.3) id g26NWwY41957; Wed, 6 Mar 2002 15:32:58 -0800 (PST) (envelope-from swear@blarg.net) Message-Id: <496649gtlh.649@localhost.localdomain> Date: 06 Mar 2002 15:32:58 -0800 From: "Gary W. Swearingen" Reply-To: swear@blarg.net To: FreeBSD-gnats-submit@freebsd.org Subject: docs/35602: dump(8)/restore(8) pages don't explain "active file systems". 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: 35602 >Category: docs >Synopsis: dump(8)/restore(8) pages don't explain "active file systems". >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: Wed Mar 06 15:30:01 PST 2002 >Closed-Date: >Last-Modified: >Originator: Gary W. Swearingen >Release: FreeBSD 4.5-STABLE i386 >Organization: none >Environment: n/a ================ >Description: The two man pages use "active file system" as if it has a particular meaning but the term is nowhere described, leaving the user wondering and/or adding to freebsd-questions. ALSO: The dump(8) map page should also explain the implications of using it on an active FS (an implied suggestion in the Tower of Hanoi paragraph), maybe in the form of a WARNING, or BUG. ================ >How-To-Repeat: n/a ================ >Fix: FreeBSD needs a "jargon" doc somewhere (man page, section of man pages, section of Handbook, article, ...). For now, add descriptions to these man pages. I'm not sure what it means. Mike Meyer said "An active file system is being changed." and implied that even an writable FS can be inactive. (SoftUpdates with it's big delays comes to mind here.) Unmounted and read-only FSs are always inactive. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message