File: mic-image-convertor.pod

package info (click to toggle)
mic2 0.24.12-1
  • links: PTS
  • area: main
  • in suites: wheezy
  • size: 1,140 kB
  • sloc: python: 11,220; sh: 1,367; makefile: 64
file content (70 lines) | stat: -rw-r--r-- 2,389 bytes parent folder | download | duplicates (2)
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)