From swear@blarg.net  Wed Mar  6 15:29:41 2002
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id 46FF237B416
	for <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: dump(8)/restore(8) pages don't explain "active file systems".
X-GNATS-Notify:

>Number:         35602
>Category:       docs
>Synopsis:       dump(8)/restore(8) pages don't explain "active file systems".
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    kensmith
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Mar 06 15:30:01 PST 2002
>Closed-Date:    Wed Nov 05 14:22:03 PST 2003
>Last-Modified:  Wed Nov 05 14:22:03 PST 2003
>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:
Responsible-Changed-From-To: freebsd-doc->kensmith 
Responsible-Changed-By: kensmith 
Responsible-Changed-When: Fri Oct 24 12:39:12 PDT 2003 
Responsible-Changed-Why:  

Sorry for the delay.  I'll try to take care of this. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=35602 
State-Changed-From-To: open->closed 
State-Changed-By: kensmith 
State-Changed-When: Wed Nov 5 14:20:43 PST 2003 
State-Changed-Why:  

Added an explanation of "active file system" (in this context, it gets 
used in several different ways). 


http://www.freebsd.org/cgi/query-pr.cgi?pr=35602 
>Unformatted:
