=head1 NAME

newvserver - Creates a new Debian vserver by calling vserver ... build

=head1 SYNOPSIS

newvserver --hostname x --domain y.z --ip 1.2.3.4/24 [OPTIONS]

=head1 DESCRIPTION

=head1 OPTIONS

Optional:
    -h, --help        this help
    -V, --version     copyright and version information
    --arch            set target architecture (eg. --arch "i386")
                      (autodetected on Debian host if dpkg available)
    --dist            defaults to "squeeze", passed to debootstrap.
    --context n       Set the context id to be used.
    --fakeinit        use "/sbin/init" to boot vserver
    --conffile        extra configuration file to load.
    --post-install-script
                      script to run after the installation finishes inside vserver.
    --post-install-host-script
                      script to run after the installation finishes outside vserver
		      and before post-install script.
    --interface       interface for IP addresses (default "eth0")
    --mirror          Debian HTTP/FTP mirror (including the /debian)
                      Default: http://ftp.uk.debian.org/debian
    --sshkeys         copy pub-keys to "/root/.ssh/authorized_keys"
    --pkgcache        Package caching.
    -v, --verbose     show extra output during setup
    --vsroot          location of "/vserver/" directory
Required:
    --hostname        hostname for new vserver (eg. "alpha")
    --domain          dns domain for new vserver (eg. "example.com")
    --ip              IPv4 address for new vserver
                      (syntax: --ip <ip>[/<netmask|prefixlength>])

=head1 CONFIG FILE

The following variables can be set in a configuration file. The configuration
file is a normal shell file and is sourced to get the configuration variables.

The file /etc/vservers/newvserver-vars is always sourced so this configuration
file only override that file.

# Default VROOTDIR
VROOTDIR="/etc/vservers/.defaults/vdirbase"

Packages to install in addition to the base defaults
MUST INCLUDE ALL DEPENDENCIES (seperated by "," commas)

INSTALL_PACKAGES="package1,package2"

Packages installed from within the vserver after it has
been setup (seperated by "," commas)
EXTRA_PACKAGES="package1,package2"

Packages to remove from the base defaults (seperated by "," commas)
REMOVE_PACKAGES="package1,package2"

Sysvinit services relating to hardware access to remove
REMOVE_LINKS="klogd hwclock.sh setserial urandom networking umountfs halt reboot"

Absolute path location of a script that you want to run after the
vserver installation.
POST_INSTALL_SCRIPT=""

Absolute path location of a script that you want to run after the
vserver installation but before the previous script and outside
vserver context. This can be used for example to copy
/etc/apt/sources.list from host.
POST_INSTALL_HOST_SCRIPT=""

Architecture: overide on non-Debian host such as Redhat
otherwise dpkg will detect whether we are i386/powerpc/sparc/etc
ARCH=""

Which Debian distribution (Warning. unstable and testing distributions change
frequently so you can not expect it to work out of the box).
DIST="squeeze"

Local or nearest location of a Debian mirror (must include the `/debian')
MIRROR="http://ftp.uk.debian.org/debian"

Debian-non-US mirror (must include the '/debian-non-US', only used for woody)
MIRROR_NON_US="http://non-us.debian.org/debian-non-US"

mirror for security updates
MIRROR_SECURITY="http://security.debian.org"

Default network interface for vservers:
INTERFACE="eth0"

Package caching:
PKGCACHE=1

The name of a debconf database to be read by debconf's file driver.
This can be used to store the answers for debconf questions during
install and thus allows for unattended installation.  See the
debconf.conf(5) manual page for the file format.
DEBCONF_FILE_DB=""

=head1 AUTHOR

Author of the manual page is Ola Lundqvist <ola@inguza.com>

=head1 SEE ALSO

util-vserver(1), dupvserver(1), stripserver(1)

=cut
