👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

NetBSD 6.1.5 - man page for rump_allserver (netbsd section 1)

RUMP_SERVER(1)			   BSD General Commands Manual			   RUMP_SERVER(1)

NAME
     rump_server, rump_allserver -- rump kernel server

SYNOPSIS
     rump_server [-s] [-c ncpu] [-d drivespec] [-l library] [-m module] url

DESCRIPTION
     The rump_server utility is used to provide a rump kernel service.	Clients can use the sys-
     tem calls provided by rump_server via url.

     The difference between rump_server and rump_allserver is that rump_server offers only a min-
     imalistic set of features, while rump_allserver provides all rump kernel components which
     were available when the system was built.	At execution time it is possible to load compo-
     nents from the command line as described in the options section.

     -c ncpu
	     Configure ncpu virtual CPUs on SMP-capable archs.	By default, the number of CPUs
	     equals the number of CPUs on the host.

     -d drivespec
	     The argument drivespec maps a host file in the rump fs namespace.	The string
	     drivespec must be of comma-separated ``name=value'' format and must contain the fol-
	     lowing tokens:

	     key	   Block device path in rump namespace.  This must be specified according
			   to the rules for a key in rump_etfs(3).

	     hostpath	   Host file used for storage.	If the file does not exist, it will be
			   created.

	     size	   Size of the mapping.  Similar to dd(1), this argument accepts a suffix
			   as the multiplier for the number.  The special value ``host'' indi-
			   cates that the current size of hostpath will be used.  In this case it
			   is assumed that hostpath exists and is a regular file.

	     OR

	     disklabel	   Use a disklabel partition identifier to specify the offset and size of
			   the mapping.  hostpath must contain an existing and valid disklabel
			   within the first 64k.

	     The following are optional:

	     offset	   Offset of the mapping.  The window into hostpath therefore is [offset,
			   offset+size].  In case this parameter is not given, the default value
			   0 is used.

	     type	   The type of file that key is exposed as within the rump kernel.  The
			   possibilities are ``blk'', ``chr'', and ``reg'' for block device,
			   character device and regular file, respectively.  The default is a
			   block device.

			   Note: the contents of block devices are cached in the rump kernel's
			   buffer cache.  To avoid cache incoherency, it is advisable not to
			   access a file through the host namespace while it is mapped as a block
			   device in a rump kernel.

	     In case hostpath does not exist, it will be created as a regular file with mode 0644
	     (plus any restrictions placed by umask).  In case hostpath is a regular file and is
	     not large enough to accommodate the specified size, it will be extended to the spec-
	     ified size.

     -l library
	     Call dlopen() on library before initializing the rump kernel.  In case library pro-
	     vides a kernel module, it will appear as a builtin module in the rump kernel.  Any
	     rump component present in library will also be initialized.

	     The argument library can contain a full path or a filename, in which case the stan-
	     dard 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.

     -m 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).

     -r total_ram
	     Sets the limit of kernel memory allocatable by the server to total_ram as opposed to
	     the default which allows the server to allocate as much memory as the host will give
	     it.  This parameter is especially useful for VFS servers, since by default the vir-
	     tual file system will attempt to consume as much memory as it can, and accessing
	     large files can cause an excessive amount of memory to be used as file system cache.

     -s      Do not detach from the terminal.  By default, rump_server detaches from the terminal
	     once the service is running on url.

     -v      Set bootverbose.

     After use, rump_server can be made to exit using rump.halt(1).

EXAMPLES
     Start a server and load the tmpfs file system module, and halt the server immediately after-
     wards:

	   $ rump_server -lrumpvfs -m /modules/tmpfs.kmod unix://sock
	   $ env RUMP_SERVER=unix://sock rump.halt

     Start a server with the one gigabyte host file dk.img mapped as the block device /dev/dk in
     the rump kernel.

	   $ rump_allserver -d key=/dev/dk,hostpath=dk.img,size=1g unix://sock

     Start a server which listens on INADDR_ANY port 3755

	   $ rump_server tcp://0:3755/

     Start a FFS server with a 16MB kernel memory limit.

	   $ rump_server -lrumpvfs -lrumpfs_ffs -r 16m unix:///tmp/ffs_server

SEE ALSO
     rump.halt(1), dlopen(3), rump(3), rump_sp(7)

BSD					February 21, 2011				      BSD


All times are GMT -4. The time now is 11:44 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password





Not a Forum Member?
Forgot Password?