NetBSD Problem Report #46730

From mm_lists@pulsar-zone.net  Sat Jul 21 07:39:33 2012
Return-Path: <mm_lists@pulsar-zone.net>
Received: from mail.netbsd.org (mail.netbsd.org [149.20.53.66])
	by www.NetBSD.org (Postfix) with ESMTP id BC91663B85F
	for <gnats-bugs@gnats.NetBSD.org>; Sat, 21 Jul 2012 07:39:33 +0000 (UTC)
Message-Id: <201207210739.q6L7dT9Z021100@ginseng.pulsar-zone.net>
Date: Sat, 21 Jul 2012 03:39:29 -0400
From: Matthew Mondor <mm_lists@pulsar-zone.net>
To: gnats-bugs@gnats.NetBSD.org
Subject: Improve mount_nilfs.8 (-current, netbsd-6)

>Number:         46730
>Category:       bin
>Synopsis:       Improve mount_nilfs.8 (-current, netbsd-6)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pgoyette
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Jul 21 07:40:00 +0000 2012
>Closed-Date:    Wed Jun 01 11:57:32 +0000 2016
>Last-Modified:  Wed Jun 01 12:00:01 +0000 2016
>Originator:     Matthew Mondor
>Release:        NetBSD 6.0_BETA2, -current
>Organization:
>Environment:
System: NetBSD ninja.xisop 6.0_BETA2 NetBSD 6.0_BETA2 (GENERIC_MM) #18: Wed Jul 4 20:43:55 EDT 2012 root@ninja.xisop:/usr/obj/sys/arch/amd64/compile/GENERIC_MM amd64
Architecture: x86_64
Machine: amd64
>Description:

When someone asked about if writing to nilfs was like writing to null
(which might have been a joke considering the current implementation
only supports read-only operations, but who knows, considering its
name :), I wondered what it was about, as the manual page had very
little information, and I had to search the web to find out...

>How-To-Repeat:
>Fix:

Proposed diff attached for review


--MP_/ctRy/SOHwdLawmf/xIDz6L3
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename=nilfs-diff.txt

Index: sbin/mount_nilfs/mount_nilfs.8
===================================================================
RCS file: /data/rsync/netbsd-cvs/src/sbin/mount_nilfs/mount_nilfs.8,v
retrieving revision 1.2
diff -u -r1.2 mount_nilfs.8
--- sbin/mount_nilfs/mount_nilfs.8	18 Jul 2009 17:07:12 -0000	1.2
+++ sbin/mount_nilfs/mount_nilfs.8	21 Jul 2012 07:27:51 -0000
@@ -46,6 +46,11 @@
 .Ar special
 .Ar node
 .Sh DESCRIPTION
+NILFS is a log-structured file system designed to support fast
+writing, fast recovery times, live snapshots, concurrent read-only
+snapshot mounts, and live file system resizing.  Its inodes are
+managed using B-trees.
+.Pp
 The
 .Nm
 command attaches the NILFS file system residing on the specified
@@ -75,6 +80,21 @@
 .Xr fstab 5 ,
 .Xr mount 8 ,
 .Xr umount 8 ,
-.Xr vnconfig 8
-.Sh NOTES
-NILFS is a file system developped by NTT and is currently in version 2.
+.Xr vnconfig 8,
+.Xr mount_lfs 8
+.Sh HISTORY
+NILFS is a file system developped by NTT and released in 2005 for
+Linux.  Version 2 is available since 2009.
+This cleanroom implementation was written by Reinoud Zandijk for
+NetBSD in 2009, and has first been released as part of NetBSD 6.
+.Sh AUTHORS
+This implementation of NILFS was written by Reinoud Zandijk.
+.Sh CAVEATS
+This implementation currently only supports read-only operation.
+See
+.Xr mount_lfs 8
+for an older log-structured file system with write support.  Also see
+.Xr wapbl 4
+and
+.Xr mount 8
+for fast journal-based recovery using FFS.

--MP_/ctRy/SOHwdLawmf/xIDz6L3--

>Release-Note:

>Audit-Trail:

Responsible-Changed-From-To: bin-bug-people->pgoyette
Responsible-Changed-By: pgoyette@NetBSD.org
Responsible-Changed-When: Wed, 01 Jun 2016 11:57:32 +0000
Responsible-Changed-Why:
I picked it up


State-Changed-From-To: open->closed
State-Changed-By: pgoyette@NetBSD.org
State-Changed-When: Wed, 01 Jun 2016 11:57:32 +0000
State-Changed-Why:
Changes from PR have been committed.


From: "Paul Goyette" <pgoyette@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/46730 CVS commit: src/sbin/mount_nilfs
Date: Wed, 1 Jun 2016 11:56:50 +0000

 Module Name:	src
 Committed By:	pgoyette
 Date:		Wed Jun  1 11:56:49 UTC 2016

 Modified Files:
 	src/sbin/mount_nilfs: mount_nilfs.8

 Log Message:
 Improved documentation of mount_nilfs, from PR bin/46730


 To generate a diff of this commit:
 cvs rdiff -u -r1.2 -r1.3 src/sbin/mount_nilfs/mount_nilfs.8

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

>Unformatted:
 --MP_/ctRy/SOHwdLawmf/xIDz6L3
 Content-Type: text/plain; charset=US-ASCII
 Content-Transfer-Encoding: 7bit
 Content-Disposition: inline

NetBSD Home
NetBSD PR Database Search

(Contact us) $NetBSD: query-full-pr,v 1.39 2013/11/01 18:47:49 spz Exp $
$NetBSD: gnats_config.sh,v 1.8 2006/05/07 09:23:38 tsutsui Exp $
Copyright © 1994-2014 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.