makerumpmanpages.sh revision 1.2 
1#!/bin/sh
2#
3#	$NetBSD: makerumpmanpages.sh,v 1.2 2008/08/06 20:18:19 pooka Exp $
4#
5
6IFS=' '
7MANTMPL=".\\\"	\$NetBSD\$"'
8.\"
9.\"	WARNING: GENERATED FILE, DO NOT EDIT
10.\"	INSTEAD, EDIT makerumpmanpages.sh AND REGEN
11.\"
12.\" Copyright (c) 2008 Antti Kantee.  All rights reserved.
13.\"
14.\" Redistribution and use in source and binary forms, with or without
15.\" modification, are permitted provided that the following conditions
16.\" are met:
17.\" 1. Redistributions of source code must retain the above copyright
18.\"    notice, this list of conditions and the following disclaimer.
19.\" 2. Redistributions in binary form must reproduce the above copyright
20.\"    notice, this list of conditions and the following disclaimer in the
21.\"    documentation and/or other materials provided with the distribution.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS" AND
24.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
27.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33.\" SUCH DAMAGE.
34.\"
35.Dd August 6, 2008
36.Dt RUMP_XXXFSXXX 8
37.Os
38.Sh NAME
39.Nm rump_xxxfsxxx
40.Nd mount the xxxfsxxx file system using a userspace server
41.Sh SYNOPSIS
42.Cd "file-system PUFFS"
43.Pp
44.Nm
45.Op options
46.Ar special
47.Ar node
48.Sh DESCRIPTION
49The
50.Nm
51utility can be used to mount xxxfsxxx file systems.
52It uses
53.Xr rump 3
54and
55.Xr p2k 3
56to facilitate running the file system as a server in userspace.
57As opposed to
58.Xr mount_xxxfsxxx 8 ,
59.Nm
60does not use file system code within the kernel and therefore does
61not require kernel support except
62.Xr puffs 4 .
63Apart from a minor speed penalty (~10%), there is no difference to
64using the in-kernel code.
65.Pp
66It is recommended that untrusted file system images be mounted with
67.Nm
68instead of
69.Xr mount_xxxfsxxx 8 .
70Corrupt file system images commonly cause the file system
71to crash the entire kernel, but with
72.Nm
73only the userspace server process will dump core.
74.Pp
75Please see
76.Xr mount_xxxfsxxx 8
77for a full description of the available command line options.
78.Sh SEE ALSO
79.Xr p2k 3 ,
80.Xr puffs 3 ,
81.Xr rump 3 ,
82.Xr mount_xxxfsxxx 8
83.Sh HISTORY
84The
85.Nm
86utility first appeared in
87.Nx 5.0 .
88.Sh BUGS
89.Nm
90cannot be used via
91.Xr mount 8 .
92Instead,
93.Nm
94must be run directly.'
95
96# generate the manual pages
97#
98for x in rump_*
99do
100	fs=${x#rump_}
101
102	# syspuffs is special, it has a handwritten manpage
103	if [ "$fs" = "syspuffs" ]
104	then
105		continue
106	fi
107
108	fsc=`echo $fs | tr '[:lower:]' '[:upper:]'`
109	echo ${MANTMPL}�| sed "s/xxxfsxxx/$fs/g;s/XXXFSXXX/$fsc/g" > \
110	    rump_${fs}/rump_${fs}.8
111done
112