makerumpmanpages.sh revision 1.4 
1#!/bin/sh
2#
3#	$NetBSD: makerumpmanpages.sh,v 1.4 2008/10/16 10:30:17 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 (starting from 10% and depending
64on the workload and file system in question), there is no difference
65to using in-kernel code.
66.Pp
67It is recommended that untrusted file system images be mounted with
68.Nm
69instead of
70.Xr mount_xxxfsxxx 8 .
71Corrupt file system images commonly cause the file system
72to crash the entire kernel, but with
73.Nm
74only the userspace server process will dump core.
75.Pp
76Please see
77.Xr mount_xxxfsxxx 8
78for a full description of the available command line options.
79.Sh SEE ALSO
80.Xr p2k 3 ,
81.Xr puffs 3 ,
82.Xr rump 3 ,
83.Xr mount_xxxfsxxx 8
84.Sh HISTORY
85The
86.Nm
87utility first appeared in
88.Nx 5.0 .
89.Sh BUGS
90.Nm
91cannot be used via
92.Xr mount 8 .
93Instead,
94.Nm
95must be run directly.'
96
97# generate the manual pages
98#
99for x in rump_*
100do
101	fs=${x#rump_}
102
103	# syspuffs is special, it has a handwritten manpage
104	if [ "$fs" = "syspuffs" ]
105	then
106		continue
107	fi
108
109	fsc=`echo $fs | tr '[:lower:]' '[:upper:]'`
110	echo ${MANTMPL} | sed "s/xxxfsxxx/$fs/g;s/XXXFSXXX/$fsc/g" > \
111	    rump_${fs}/rump_${fs}.8
112done
113