[src/trunk]: src/usr.sbin/puffs regen

[pooka <pooka%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/258c25e522b1
branches:  trunk
changeset: 758932:258c25e522b1
user:      pooka <pooka%NetBSD.org@localhost>
date:      Sun Nov 21 19:32:16 2010 +0000

description:
regen

diffstat:

 usr.sbin/puffs/rump_au-naturel/rump_au-naturel.8 |  137 +++++++++++++++++++++++
 usr.sbin/puffs/rump_cd9660/rump_cd9660.8         |   49 +++++--
 usr.sbin/puffs/rump_efs/rump_efs.8               |   49 +++++--
 usr.sbin/puffs/rump_ext2fs/rump_ext2fs.8         |   49 +++++--
 usr.sbin/puffs/rump_fdesc/rump_fdesc.8           |   49 +++++--
 usr.sbin/puffs/rump_ffs/rump_ffs.8               |   49 +++++--
 usr.sbin/puffs/rump_hfs/rump_hfs.8               |   49 +++++--
 usr.sbin/puffs/rump_kernfs/rump_kernfs.8         |   49 +++++--
 usr.sbin/puffs/rump_lfs/rump_lfs.8               |   49 +++++--
 usr.sbin/puffs/rump_msdos/rump_msdos.8           |   49 +++++--
 usr.sbin/puffs/rump_nfs/rump_nfs.8               |   49 +++++--
 usr.sbin/puffs/rump_nqmfs/rump_nqmfs.8           |  137 +++++++++++++++++++++++
 usr.sbin/puffs/rump_ntfs/rump_ntfs.8             |   49 +++++--
 usr.sbin/puffs/rump_smbfs/rump_smbfs.8           |   49 +++++--
 usr.sbin/puffs/rump_sysvbfs/rump_sysvbfs.8       |   49 +++++--
 usr.sbin/puffs/rump_tmpfs/rump_tmpfs.8           |   49 +++++--
 usr.sbin/puffs/rump_udf/rump_udf.8               |   49 +++++--
 17 files changed, 769 insertions(+), 240 deletions(-)

diffs (truncated from 1602 to 300 lines):

diff -r a3c99151b875 -r 258c25e522b1 usr.sbin/puffs/rump_au-naturel/rump_au-naturel.8
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/usr.sbin/puffs/rump_au-naturel/rump_au-naturel.8  Sun Nov 21 19:32:16 2010 +0000
@@ -0,0 +1,137 @@
+.\"    $NetBSD: rump_au-naturel.8,v 1.1 2010/11/21 19:32:16 pooka Exp $
+.\"
+.\"    WARNING: GENERATED FILE, DO NOT EDIT
+.\"    INSTEAD, EDIT makerumpmanpages.sh AND REGEN
+.\"
+.\" Copyright (c) 2008-2010 Antti Kantee. All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS" AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.Dd November 21, 2010
+.Dt RUMP_AU-NATUREL 8
+.Os
+.Sh NAME
+.Nm rump_au-naturel
+.Nd mount the au-naturel file system using a userspace server
+.Sh SYNOPSIS
+.Cd "file-system PUFFS"
+.Cd "pseudo-device putter"
+.Pp
+.Nm
+.Op options
+.Ar image
+.Ar mountpoint
+.Sh DESCRIPTION
+.Em NOTE!
+This manual page has been generated from a common source shared between all
+.Xr rump 3
+file servers.
+Some parts of this manual page may not apply to this particular server.
+After reading this manual page, you may want to verify the details from
+.Xr mount_au-naturel 8 .
+.Pp
+The
+.Nm
+utility can be used to mount au-naturel file systems.
+It uses
+.Xr rump 3
+and
+.Xr p2k 3
+to facilitate running the file system as a server in userspace.
+As opposed to
+.Xr mount_au-naturel 8 ,
+.Nm
+does not use file system code within the kernel and therefore does
+not require kernel support except
+.Xr puffs 4 .
+Apart from a minor speed penalty there is no downside with respect to
+in-kernel code.
+.Pp
+.Nm
+does not require using
+.Xr vnconfig 8
+for mounts from regular files and the file path can be passed
+directly as the
+.Ar image
+parameter.
+In fact, the use of
+.Xr vnconfig 8
+is discouraged, since it is unable to properly deal with images on
+sparse files.
+.Pp
+In case the image contains multiple partitions, the desired partition
+must be indicated by appending the token
+.Dq %DISKLABEL:p%
+to the
+.Ar image
+path.
+The letter
+.Dq p
+specifies the partition as obtained via
+.Xr disklabel 8 .
+For example, to mount partition
+.Dq e
+from image
+.Pa /tmp/wd0.img ,
+use
+.Dq /tmp/wd0.img%DISKLABEL:e% .
+.Pp
+It is recommended that untrusted file system images be mounted with
+.Nm
+instead of
+.Xr mount_au-naturel 8 .
+Corrupt file system images commonly cause the file system
+to crash the entire kernel, but with
+.Nm
+only the userspace server process will dump core.
+.Pp
+To use
+.Nm
+via
+.Xr mount 8 ,
+the flags
+.Fl o Ar rump
+and
+.Fl t Ar au-naturel
+should be given.
+Similarly,
+.Nm
+is run instead of
+.Xr mount_au-naturel 8
+if
+.Dq rump
+is added to the options field of
+.Xr fstab 5 .
+.Pp
+Please see
+.Xr mount_au-naturel 8
+for a full description of the available command line options.
+.Sh SEE ALSO
+.Xr p2k 3 ,
+.Xr puffs 3 ,
+.Xr rump 3 ,
+.Xr mount_au-naturel 8
+.Sh HISTORY
+The
+.Nm
+utility first appeared in
+.Nx 5.0 .
diff -r a3c99151b875 -r 258c25e522b1 usr.sbin/puffs/rump_cd9660/rump_cd9660.8
--- a/usr.sbin/puffs/rump_cd9660/rump_cd9660.8  Sun Nov 21 19:29:01 2010 +0000
+++ b/usr.sbin/puffs/rump_cd9660/rump_cd9660.8  Sun Nov 21 19:32:16 2010 +0000
@@ -1,9 +1,9 @@
-.\"    $NetBSD: rump_cd9660.8,v 1.9 2010/03/31 14:49:46 pooka Exp $
+.\"    $NetBSD: rump_cd9660.8,v 1.10 2010/11/21 19:32:16 pooka Exp $
 .\"
 .\"    WARNING: GENERATED FILE, DO NOT EDIT
 .\"    INSTEAD, EDIT makerumpmanpages.sh AND REGEN
 .\"
-.\" Copyright (c) 2008 Antti Kantee. All rights reserved.
+.\" Copyright (c) 2008-2010 Antti Kantee. All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
@@ -26,7 +26,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd March 31, 2010
+.Dd November 21, 2010
 .Dt RUMP_CD9660 8
 .Os
 .Sh NAME
@@ -38,8 +38,8 @@
 .Pp
 .Nm
 .Op options
-.Ar special
-.Ar node
+.Ar image
+.Ar mountpoint
 .Sh DESCRIPTION
 .Em NOTE!
 This manual page has been generated from a common source shared between all
@@ -63,19 +63,37 @@
 does not use file system code within the kernel and therefore does
 not require kernel support except
 .Xr puffs 4 .
-Apart from a minor speed penalty (starting from 10% and depending
-on the workload and file system in question), there is no difference
-to using in-kernel code.
+Apart from a minor speed penalty there is no downside with respect to
+in-kernel code.
 .Pp
-In case mounting a file system image from a regular file,
 .Nm
-does not require the use of
+does not require using
+.Xr vnconfig 8
+for mounts from regular files and the file path can be passed
+directly as the
+.Ar image
+parameter.
+In fact, the use of
 .Xr vnconfig 8
-unlike kernel file systems.
-Instead, the image path can be directly passed as the special file path.
-The exception is if the image contains a disklabel.
-In this case vnconfig is required to resolve the start offset for the
-correct partition within the image.
+is discouraged, since it is unable to properly deal with images on
+sparse files.
+.Pp
+In case the image contains multiple partitions, the desired partition
+must be indicated by appending the token
+.Dq %DISKLABEL:p%
+to the
+.Ar image
+path.
+The letter
+.Dq p
+specifies the partition as obtained via
+.Xr disklabel 8 .
+For example, to mount partition
+.Dq e
+from image
+.Pa /tmp/wd0.img ,
+use
+.Dq /tmp/wd0.img%DISKLABEL:e% .
 .Pp
 It is recommended that untrusted file system images be mounted with
 .Nm
@@ -117,4 +135,3 @@
 .Nm
 utility first appeared in
 .Nx 5.0 .
-It is currently considered experimental.
diff -r a3c99151b875 -r 258c25e522b1 usr.sbin/puffs/rump_efs/rump_efs.8
--- a/usr.sbin/puffs/rump_efs/rump_efs.8        Sun Nov 21 19:29:01 2010 +0000
+++ b/usr.sbin/puffs/rump_efs/rump_efs.8        Sun Nov 21 19:32:16 2010 +0000
@@ -1,9 +1,9 @@
-.\"    $NetBSD: rump_efs.8,v 1.9 2010/03/31 14:49:46 pooka Exp $
+.\"    $NetBSD: rump_efs.8,v 1.10 2010/11/21 19:32:16 pooka Exp $
 .\"
 .\"    WARNING: GENERATED FILE, DO NOT EDIT
 .\"    INSTEAD, EDIT makerumpmanpages.sh AND REGEN
 .\"
-.\" Copyright (c) 2008 Antti Kantee. All rights reserved.
+.\" Copyright (c) 2008-2010 Antti Kantee. All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
@@ -26,7 +26,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd March 31, 2010
+.Dd November 21, 2010
 .Dt RUMP_EFS 8
 .Os
 .Sh NAME
@@ -38,8 +38,8 @@
 .Pp
 .Nm
 .Op options
-.Ar special
-.Ar node
+.Ar image
+.Ar mountpoint
 .Sh DESCRIPTION
 .Em NOTE!
 This manual page has been generated from a common source shared between all
@@ -63,19 +63,37 @@
 does not use file system code within the kernel and therefore does
 not require kernel support except
 .Xr puffs 4 .
-Apart from a minor speed penalty (starting from 10% and depending
-on the workload and file system in question), there is no difference
-to using in-kernel code.
+Apart from a minor speed penalty there is no downside with respect to
+in-kernel code.
 .Pp
-In case mounting a file system image from a regular file,
 .Nm
-does not require the use of
+does not require using
+.Xr vnconfig 8
+for mounts from regular files and the file path can be passed
+directly as the
+.Ar image
+parameter.
+In fact, the use of
 .Xr vnconfig 8
-unlike kernel file systems.
-Instead, the image path can be directly passed as the special file path.
-The exception is if the image contains a disklabel.
-In this case vnconfig is required to resolve the start offset for the
-correct partition within the image.
+is discouraged, since it is unable to properly deal with images on
+sparse files.
+.Pp
+In case the image contains multiple partitions, the desired partition
+must be indicated by appending the token
+.Dq %DISKLABEL:p%
+to the
+.Ar image
+path.
+The letter