=head1 NAME

vserver-build - build new vserver with vserver ... build

=head1 SYNOPSIS

vserver vserver-name build -m <method> [options] [cfg-options]
        [--] [method-args]

=head1 METHODS

Possible methods are:

B<legacy>    the "old" copy-all-from-host method, which requires the
          old legacy  vserver-legacy script;  with  this method
          the cfg-options will be ignored

B<copy>      the copy-all-from-host method which uses the recent
          configuration scheme

B<apt-rpm> ... -- -d <distribution>
          installs the base-packages of the given distribution with
          help of 'vapt-get'

B<yum>     ... -- -d <distribution>
          installs the base-packages of the given distribution with
          help of 'vyum'

B<rpm>     ... -- [-d <distribution>] 
               --empty | ([--force] [--nodeps] <manifest>)+
          installs lists of rpm-packages

B<skeleton> ... -- [<cmd> <args>*]
          installs a minimal skeleton filesystem, creates the
          configuration file and calls an optional command then

B<debootstrap> ... -- -d <distrib> [-m <mirror> ] [-- <debootstrap-opts>*]
          bootstraps the vserver with Debian's 'debootstrap' package

=head1 OPTIONS

B<--force>     remove/rename already existing vservers with the same name

B<--rootdir> <dir>
            vserver root directory [default: /vservers]

B<--pkgbase> <dir>
            package base directory [default: /vservers/.pkg]
      
=head1 CFG-OPTIONS

B<--context>   the static context of the vserver [default: none; a dynamic
            context will be assumed]

B<--confdir>   vserver-specific configuration directory
            [default: /etc/vservers/<vserver-name>]

B<--lockfile> <filename>
            lock file [default: /var/run/vservers/<vserver-name>]

B<--hostname> <hostname>

B<--netdev>   <device>

B<--netbcast> <broadcast>

B<--netmask> <netmask> | --netprefix <prefixlen>
            sets the default netmask (a.b.c.d quadruple) or prefixlen
            (length of the interface)

B<--interface> [<name-suffix>=][<device>:]<ip>[/<mask|prefixlen>]
            declares an network-interface; this option can be specified
            multiple times

B<--flags> <flags>+
            sets comma-separated list of flags; possible flags are
            lock:  Prevent the vserver from setting new security
                   context
            sched: Merge  scheduler priority  of all processes in the
                   vserver so that it acts a like a single
                   one (kernel 2.4 only).
            nproc: Limit the number of processes in the vserver
                   according to ulimit  (instead of a per user limit,
                   this becomes a per vserver limit)
            private: No other process can join this security context.
                   Even root

B<--initstyle> <style>
            configures the initstyle (e.g. minit,sysv,plain)


=head1 SEE ALSO

B<vserver>(8), B<vserver-copy>(8), B<vserver-stat>(8),
B<vtop>(8), B<vps>(8), B<vpstree>(8),
B<chcontext>(8), B<chbind>(8), B<reducecap>(8)

=head1 BUGS

Please report bugs to enrico.scholz@informatik.tu-chemnitz.de

=head1 AUTHORS

manual page written by Daniel Hermann <hermann@tkm.uni-karlsruhe.de>
using output of "vserver-build --help"