Module Name: src
Committed By: pooka
Date: Mon Dec 13 19:36:34 UTC 2010
Modified Files:
src/distrib/sets/lists/man: mi
src/usr.bin/rump_allserver: Makefile
Added Files:
src/usr.bin/rump_allserver: rump_allserver.1
Log Message:
manpage
To generate a diff of this commit:
cvs rdiff -u -r1.1266 -r1.1267 src/distrib/sets/lists/man/mi
cvs rdiff -u -r1.2 -r1.3 src/usr.bin/rump_allserver/Makefile
cvs rdiff -u -r0 -r1.1 src/usr.bin/rump_allserver/rump_allserver.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/distrib/sets/lists/man/mi
diff -u src/distrib/sets/lists/man/mi:1.1266 src/distrib/sets/lists/man/mi:1.1267
--- src/distrib/sets/lists/man/mi:1.1266 Mon Dec 13 06:30:44 2010
+++ src/distrib/sets/lists/man/mi Mon Dec 13 19:36:34 2010
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1266 2010/12/13 06:30:44 mrg Exp $
+# $NetBSD: mi,v 1.1267 2010/12/13 19:36:34 pooka Exp $
#
# Note: don't delete entries from here - mark them as "obsolete" instead.
#
@@ -445,6 +445,8 @@
./usr/share/man/cat1/rsh.0 man-netutil-catman .cat
./usr/share/man/cat1/rtld.0 man-shlib-catman .cat
./usr/share/man/cat1/rump.halt.0 man-netutil-catman .cat
+./usr/share/man/cat1/rump_allserver.0 man-netutil-catman .cat
+./usr/share/man/cat1/rump_server.0 man-netutil-catman .cat
./usr/share/man/cat1/rup.0 man-netutil-catman .cat
./usr/share/man/cat1/ruptime.0 man-netutil-catman .cat
./usr/share/man/cat1/rusers.0 man-netutil-catman .cat
@@ -3224,6 +3226,8 @@
./usr/share/man/html1/rsh.html man-netutil-htmlman html
./usr/share/man/html1/rtld.html man-shlib-htmlman html
./usr/share/man/html1/rump.halt.html man-netutil-htmlman html
+./usr/share/man/html1/rump_allserver.html man-netutil-htmlman html
+./usr/share/man/html1/rump_server.html man-netutil-htmlman html
./usr/share/man/html1/rup.html man-netutil-htmlman html
./usr/share/man/html1/ruptime.html man-netutil-htmlman html
./usr/share/man/html1/rusers.html man-netutil-htmlman html
@@ -5661,6 +5665,8 @@
./usr/share/man/man1/rsh.1 man-netutil-man .man
./usr/share/man/man1/rtld.1 man-shlib-man .man
./usr/share/man/man1/rump.halt.1 man-netutil-man .man
+./usr/share/man/man1/rump_allserver.1 man-netutil-man .man
+./usr/share/man/man1/rump_server.1 man-netutil-man .man
./usr/share/man/man1/rup.1 man-netutil-man .man
./usr/share/man/man1/ruptime.1 man-netutil-man .man
./usr/share/man/man1/rusers.1 man-netutil-man .man
Index: src/usr.bin/rump_allserver/Makefile
diff -u src/usr.bin/rump_allserver/Makefile:1.2 src/usr.bin/rump_allserver/Makefile:1.3
--- src/usr.bin/rump_allserver/Makefile:1.2 Sun Dec 5 20:12:55 2010
+++ src/usr.bin/rump_allserver/Makefile Mon Dec 13 19:36:34 2010
@@ -1,8 +1,8 @@
-# $NetBSD: Makefile,v 1.2 2010/12/05 20:12:55 pooka Exp $
+# $NetBSD: Makefile,v 1.3 2010/12/13 19:36:34 pooka Exp $
#
PROG= rump_allserver
-NOMAN= for now
+MLINKS+=rump_allserver.1 rump_server.1
RUMPTOP=${.CURDIR}/../../sys/rump
Added files:
Index: src/usr.bin/rump_allserver/rump_allserver.1
diff -u /dev/null src/usr.bin/rump_allserver/rump_allserver.1:1.1
--- /dev/null Mon Dec 13 19:36:34 2010
+++ src/usr.bin/rump_allserver/rump_allserver.1 Mon Dec 13 19:36:34 2010
@@ -0,0 +1,107 @@
+.\" $NetBSD: rump_allserver.1,v 1.1 2010/12/13 19:36:34 pooka Exp $
+.\"
+.\" Copyright (c) 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 December 13, 2010
+.Dt RUMP_SERVER 1
+.Os
+.Sh NAME
+.Nm rump_server ,
+.Nm rump_allserver
+.Nd rump kernel server
+.Sh SYNOPSIS
+.Nm
+.Op Fl s
+.Op Fl l Ar library
+.Op Fl m Ar module
+.Ar url
+.Sh DESCRIPTION
+The
+.Nm
+utility is used to provide a rump kernel service.
+Clients can use the system calls provided by
+.Nm
+via
+.Ar url .
+.Pp
+The difference between
+.Nm
+and
+.Nm rump_allserver
+is that
+.Nm
+offers only a minimalistic set of features,
+while
+.Nm rump_allserver
+provides all rump kernel components which were available when the
+system was built.
+At execution time it is possible to load components from the command
+line as described in the options section.
+.Bl -tag -width indent
+.It Fl l Ar library
+Call
+.Fn dlopen
+on library before initializing the rump kernel.
+In case
+.Ar library
+provides a kernel module, it will appear as a builtin module in the
+rump kernel.
+Any rump component present in
+.Ar library
+will also be initialized.
+.Pp
+The argument
+.Ar library
+can contain a full path or a filename, in which case the standard
+dynamic library search path will be used.
+Libraries are loaded in the order they are given.
+Dependencies are not autoloaded, and the order must be specified
+correctly.
+.It Fl m Ar module
+Load and link a kernel module after the rump kernel is initialized.
+For this to work, the rump kernel must include the vfs faction,
+since the module is loaded using kernel vfs code (see EXAMPLES).
+.It Fl s
+Do not detach from the terminal.
+By default,
+.Nm
+detaches from the terminal once the service is running on
+.Ar url .
+.El
+.Pp
+After use,
+.Nm
+can be made to exit using
+.Xr rump.halt .
+.Sh EXAMPLES
+Start a server and load the tmpfs file system module, and halt the
+server immediately afterwards:
+.Bd -literal -offset indent
+$ rump_server -lrumpvfs -m /modules/tmpfs.kmod unix://sock
+$ env RUMP_SERVER=unix://sock rump.halt
+.Ed
+.Sh SEE ALSO
+.Xr rump.halt 1 ,
+.Xr dlopen 3 ,
+.Xr rump 3
