1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70
|
=head1 NAME
mic-image-convertor - Convert a virtual machine image to a live image
=head1 SYNOPSIS
mic-image-convertor [options]
=head1 DESCRIPTION
mic-image-convertor can convert a virtual machine image to a live image,
this is specially for developers, they will use VMWare player or KVM or VirtualBox
to run this image and do some changes in place, then they convert this changed image
to a live image to run in a real device.
mic-image-manager has a GUI tool for mic-image-convertor, you can use it if
you prefer to use GUI instead of command line.
=head1 General OPTIONS
B<--version> show version number and exit
B<-h, --help> show this help message and exit
B<-F SRCFORMAT, --source-format=SRCFORMAT> Source image format, possible values are: raw, vmdk or vdi (default: automatically detect image type).
B<-I SRCIMG, --source-image=SRCIMG> Source image which was created by mic-image-creator or an image file system.
B<-T DSTFORMAT, --target-format=DSTFORMAT> Target image format, possible values are: livecd and liveusb
B<-t TMPDIR, --tmpdir=TMPDIR> Temporary directory to use (default: /var/tmp)
B<-o OUTDIR, --outdir=OUTDIR> Output directory to use (default: current work dir)
B<-S SUFFIX, --suffix=SUFFIX> Image name suffix (default: date stamp)
=head1 OPTIONS For Live USB
B<-i, --interactive> Directly write into a USB disk.
B<--fstype=FSTYPE> File system type for live USB image, ext3 or vfat, the default is vfat.
B<--overlay-size-mb=OVERLAYSIZEMB> Overlay size in MB as unit, it means how size changes you can save in your live USB disk.
=head1 Debug OPTIONS
B<-d, --debug> Output debugging information
B<-v, --verbose> Output verbose progress information
B<--logfile=FILE> Save debug information to FILE
=head1 EXAMPLES
Convert a VMWare image to a live CD image:
mic-image-convertor -I your-vmware-image.vmdk -T liveusb
=head1 EXIT STATUS
mic-image-convertor returns a zero exist status if it succeeds, otherwise return non-zero and print error message.
=head1 AUTHOR
Yi Yang, Anas Nashif, Jianfeng Ding
=head1 SEE ALSO
mic-image-creator(1), mic-chroot(1), mic-image-writer(1),
mic-livecd-iso-to-disk(1), mic-image-manager(1)
|