diff options
| -rwxr-xr-x | debvm-create | 10 | ||||
| -rwxr-xr-x | debvm-run | 14 |
2 files changed, 12 insertions, 12 deletions
diff --git a/debvm-create b/debvm-create index 58094cc..c6f4b5c 100755 --- a/debvm-create +++ b/debvm-create @@ -11,7 +11,7 @@ debvm-create - Create a VM image for various Debian releases and architectures =head1 SYNOPSIS -B<debvm-create> [B<-a> I<architecture>] [B<-h> I<hostname>] [B<-k> I<sshkey>] [B<-m> I<mirror>] [B<-o> I<output>] [B<-p> I<package>] [B<-r> I<release>] [B<-z> I<size_in_GB>] [B<--> I<mmdebstrap options>] +B<debvm-create> [B<-a> I<architecture>] [B<-h> I<hostname>] [B<-k> F<sshkey>] [B<-m> I<mirror>] [B<-o> F<output>] [B<-p> I<package>] [B<-r> I<release>] [B<-z> I<size_in_GB>] [B<--> I<mmdebstrap options>] =head1 DESCRIPTION @@ -37,7 +37,7 @@ A suitable kernel image is automatically selected and installed into the image. Set the hostname of the virtual machine. By default, the hostname is B<testvm>. -=item B<-k> I<sshkey>, B<--sshkey>=I<sshkey> +=item B<-k> F<sshkey>, B<--sshkey>=F<sshkey> Install the given ssh public key file into the virtual machine image for the root user. This option also causes the ssh server to be installed. @@ -47,12 +47,12 @@ To connect to the vm, pass a port number to B<debvm-run> with the B<-s> option. =item B<-m> I<mirror>, B<--mirror>=I<mirror> Specify the Debian mirror to be used for downloading packages and to be configured inside the virtual machine image. -By default, B<http://deb.debian.org/debian> is being used. +By default, L<http://deb.debian.org/debian> is being used. -=item B<-o> I<output>, B<--output>=I<output> +=item B<-o> F<output>, B<--output>=F<output> Specify the file name of the resulting virtual machine image. -By default, it is written to B<rootfs.ext4>. +By default, it is written to F<rootfs.ext4>. =item B<-p> I<package>, B<--package>=I<package> @@ -9,14 +9,14 @@ debvm-run - Run a VM image created by debvm-create =head1 SYNOPSIS -B<debvm-run> [B<-g>] [B<-i> I<image>] [B<-s> I<sshport>] [B<--> I<qemu options>] +B<debvm-run> [B<-g>] [B<-i> F<image>] [B<-s> I<sshport>] [B<--> I<qemu options>] =head1 DESCRIPTION B<debvm-run> is essentially a thin wrapper around B<qemu> for running a virtual machine image created by B<debvm-create> or something compatible. The virtual machine image is expected to be a raw ext4 image with file system label B<debvm>. -The architecture of the machine is detected from the contained B</bin/true>. -It must contain a symbolic link pointing to a kernel image at B</vmlinuz> or B</vmlinux> depending on the architecture and a symbolic link pointing to an initrd image at B</initrd.img>. +The architecture of the machine is detected from the contained F</bin/true>. +It must contain a symbolic link pointing to a kernel image at F</vmlinuz> or F</vmlinux> depending on the architecture and a symbolic link pointing to an initrd image at F</initrd.img>. Both are extracted and passed to B<qemu>. A net interface configured for user mode is added automatically. @@ -29,10 +29,10 @@ A net interface configured for user mode is added automatically. By default, the option B<-nographic> is passed to B<qemu> and one interacts with the serial console of the machine. This configuration is skipped in the presence of this option. -=item B<-i> I<image>, B<--image>=I<image> +=item B<-i> F<image>, B<--image>=F<image> This option specifies the location of the virtual machine image file. -By default B<rootfs.ext4> in the working directory is used. +By default F<rootfs.ext4> in the working directory is used. =item B<-s> I<sshport>, B<--sshport>=I<sshport> @@ -51,10 +51,10 @@ One possible use of this method is passing B<-snapshot> to avoid modifying the v =head1 EXAMPLES -Run a virtual machine stored in the image B<rootfs.ext4> (the default) with +Run a virtual machine stored in the image F<rootfs.ext4> (the default) with local port 8022 routed to port 22 of the virtual machine. The B<-snapshot> argument is passed to QEMU and prevents any permanent changes to -B<rootfs.ext4>, resulting in an ephemeral run. +F<rootfs.ext4>, resulting in an ephemeral run. debvm-run -s 8022 -i rootfs.ext4 -- -snapshot |