Provided by: ubuntu-vm-builder_0.4_all bug

NAME
       ubuntu-vm-builder - build ubuntu based virtual machines


SYNOPSIS
       ubuntu-vm-builder <vm> <suite> [OPTIONS]...


DESCRIPTION
       This  manual  page documents the ubuntu-vm-builder command.  ubuntu-vm-
       builder is a program that builds virtual machines based on Ubuntu.


OPTIONS
       NOTE!!! There are many more options than  this.  See  ubuntu-vm-builder
       --help for more information

       --addpkg PKG
              Install PKG into the guest (can be specfied multiple times)

       -a, --arch ARCH
              Specify the target  architecture.   Valid  options:  i386  amd64
              (amd64  only  on  amd64  hosts).   Defaults  to  the same as the
              running system.

       -d, --dest
              Specify   the   destination   directory.     Default:    ubuntu-
              vm-$SUITE-$ARCH

       --domain DOMAIN
              Set  DOMAIN as the domain name of the guest. Default: The domain
              of the machine running this script.

       -h, --help
              Self-explanatory.

       --hostname NAME
              Set NAME as the hostname of the guest. Default: ubuntu

       --mem NN
              Assign NN megabytes of memory to the guest vm.  Default: 128

       --mirror URL
              Use       Ubuntu       mirror       at       URL.       Default:
              http://archive.ubuntu.com/ubuntu

       --removepkg PKG
              Remove PKG from the guest (can be specfied multiple times)

       -s, --suite SUITE
              Use  the  specified  Ubuntu suite. Valid options: hardy*, gutsy,
              feisty, dapper

       -t, --tmp TMPDIR
              Use TMPDIR as temporary working area for the  image  generation.
              Defaults to $TMPDIR if set, or /tmp if not.

       --vm VM
              Generate  image  for  specified  virtualisation software.  Valid
              choices are: vmw6 vmserver vbox qemu kvm*

       --user username
              Set the name of the user to be added. Default: ubuntu.

       --name fullname
              Set the full name of the user to be added. Default: Ubuntu.

       --pass password
              Set the password for the user. Default: ubuntu.

       --no-opt
              Do not build the /opt partition

       --part partfile
              Allows to specify a partition table in  partfile  each  line  of
              partfile should specify (root first):
                     mountpoint size
              where  size is in megabytes. You can have up to 4 virtual disks,
              a new disk starts on a line with ’---’.  ie :
                      root 1000
                      /opt 1000
                      swap 256
                      ---
                      /var 2000
                      /log 1500

       The following three options are not used if --part is specified:
              --rootsize size
               The size in MB of the root filesystem (default 1000)

              --optsize size
                     The size in MB of the /opt filesystem (default 4000)

              --swapsize size
                     The size in MB of the swap partition (default 1000)

       --kernel-flavour
              The kernel  image  flavour  to  install  (default:  virtual  for
              versions >= gutsy on i386, server otherwise)

       --components
              A  comma  seperaed  list  of  distro components to include (e.g.
              main,universe). This defaults to "main"

       --ssh-key
              Add the given ssh  public  key  file  (absolute  path)to  root’s
              authorized  keys  and  install openssh-server (WARNING: this has
              strong security implications)

       --exec script
              Run the given script file. You can use ’chroot  root  <cmd>’  to
              execute code in the guest.

       --libvirt <uri>
              Add resulting VM to the libvirt hypervisor at uri.

       --templates <dir>
              Specify  where  libvirt.tmpl  and  vmware.tmpl  are stored. Uses
              script directory by default.

       --ip address
              Ip address in dotted form (defaults to dhcp if not specified)

       Options below are discarded if --ip is not specified
              --mask value IP mask in dotted form (default: 255.255.255.0)

              --net value
                     IP net address (default: X.X.X.0)

              --bcast value
                     IP broadcast (default: X.X.X.255)

              --gw address
                     Gateway address (default: X.X.X.1)

              --dns address
                     Name server address (default: X.X.X.1)


AUTHOR
       ubuntu-vm-builder and  this  man  page  was  written  by  Soren  Hansen
       <soren@canonical.com> and is copyright 2007-2008 Canonical Ltd.

                                   Mar 2008               UBUNTU-VM-BUILDER(1)