.TH MIC "1" "Jun 2011" "mic 0.24.12" "User Commands" .SH NAME mic \- MeeGo image command-line tool. .SH SYNOPSIS .B mic [\fIGLOBALOPTS\fR] \fISUBCOMMAND \fR[\fIOPTS\fR] [\fIARGS\fR...] .br .B mic \fIhelp SUBCOMMAND\fR .SH DESCRIPTION MeeGo image command-line tool. .SS COMMANDS .TP \fBchroot (ch)\fR chroot into an image This command is used to chroot into a live image to do some changes. Examples: mic chroot \-s /fs/path # unpack your live image to /fs/path and chroot into it usage: mic chroot [ARGS...] Options: \-h, \-\-help show this help message and exit \-\-logfile=FILE Save debug information to FILE \-v, \-\-verbose Output verbose information \-d, \-\-debug Output debugging information \-o OUTDIR, \-\-outdir=OUTDIR Output directory to use (default: current work dir) \-\-convert\-only Just convert an image, this will skip chroot and directly convert an image/filesytem with \-c option together \-e EXECUTE, \-\-execute=EXECUTE Execute the given command within the chroot instead of an interactive shell \-c CONVERTTO, \-\-convert\-to=CONVERTTO Convert it to the specified type live image on exiting, the allowed value is livecd or liveusb \-b BINDMOUNTS, \-\-bind\-mounts=BINDMOUNTS Specify bind mount list, for example: \-b "/proc:/proc;/:/parentroot" \-\-unpack\-only Just unpack an image, this is used tounpack an image with \-s option together \-s SAVETO, \-\-save\-to=SAVETO Save unpacked filesystem to the specified path .TP \fBconvert (cv)\fR convert an image format to another one This command is used to convert a live, raw, vmdk or vdi image to a live image. Examples: mic convert \-I \-T liveusb # convert your image to a live USB image usage: mic convert [ARGS...] Options: \-h, \-\-help show this help message and exit \-\-overlay\-size\-mb=OVERLAYSIZEMB Overlay size in MB as unit, it means how size changes you can save in your live USB disk. \-\-fstype=FSTYPE File system type for live USB image, ext3 or vfat, the default is vfat. \-i, \-\-interactive Directly write into a USB disk. \-S SUFFIX, \-\-suffix=SUFFIX Image name suffix (default: date stamp) \-P PREFIX, \-\-prefix=PREFIX Image name prefix (default: meego) \-o OUTDIR, \-\-outdir=OUTDIR Output directory to use (default: current work dir) \-t TMPDIR, \-\-tmpdir=TMPDIR Temporary directory to use (default: /var/tmp) \-T DSTFORMAT, \-\-target\-format=DSTFORMAT Target image format, possible values are: livecd and liveusb \-I SRCIMG, \-\-source\-image=SRCIMG Source image which was created by mic-image-creator or an image file system. \-F SRCFORMAT, \-\-source\-format=SRCFORMAT Source image format, possible values are: raw, vmdk or vdi (default: automatically detect image type). .TP \fBcreate (cr)\fR Create an image This command is used to create various images, including live CD, live USB, loop, raw/KVM/QEMU, VMWare/vmdk, VirtualBox/vdi, Moorestown/mrstnand, jffs2 and ubi. Examples: mic create # create an image according to the default config mic create \-\-format=liveusb # create a live USB image usage: mic create [ARGS...] Options: \-h, \-\-help show this help message and exit \-\-volumeid=VOLUMEID Specify volume id, valid only for livecd \-\-pkgmgr=PKGMGR Specify the package manager, the available package managers have zypper and yum currently. \-\-save\-kernel Save kernel image file into outdir \-\-traceback Dump call stack \-\-logfile=FILE Save debug information to FILE \-v, \-\-verbose Output verbose information \-d, \-\-debug Output debugging information \-\-bootimg\-only Create boot image only. \-\-kernel\-rpm\-path=KERNEL_RPM_PATH Local path to kernel rpm package. \-\-kernel\-rpm\-url=KERNEL_RPM_URL Remote URL of kernel rpm package. \-\-kernel\-path=KERNEL_PATH Local path of kernel file (vmlinuz). \-\-kernel\-url=KERNEL_URL Remote URL of kernel file (vmlinuz). \-\-initrd\-path=INITRD_PATH Local path of INITRD image. \-\-initrd\-url=INITRD_URL Remote URL of INITRD image. \-\-overlay\-size\-mb=OVERLAY_SIZE_MB Overlay size in MB as unit, it means how size changes you can save in your live USB disk. \-\-fstype=FSTYPE File system type for live USB file image, ext3 or vfat, the default is vfat. \-i, \-\-interactive Directly write into a USB disk. \-\-include\-source Generate a image with source rpms included \-\-compress\-disk\-image=COMPRESS_DISK_IMAGE Compress the disk image that is created. When using \-\-release option default is bz2, otherwise default is none. Supported compression methods: bz2, none \-p PACKAGE, \-\-package=PACKAGE Package format, this option will package up output into a given-format package, currently only tar, tar.gz and tar.bz2 are supported, the default is none, i.e. doesn't package up output \-\-local\-pkgs\-path=LOCAL_PKGS_PATH Path for local pkgs (rpms) to be installed \-\-record\-pkgs=RECORD_PKGS Record the installed packages, valid values: name, content \-\-alt\-initrd\-name=ALT_INITRD_NAME Name of alternate INITRD image, if NOT to use the one from kernel package \-\-run\-mode=RUN_MODE Specify run mode, 0 means legacy, 1 means bootstrap, by default it is gotten from config file. \-\-use\-comps Use comps instead of patterns if comps exists \-a ARCH, \-\-arch=ARCH Specify target arch of image, for example: arm \-B BOOTSTRAP, \-\-bootstrap=BOOTSTRAP Use a given bootstrap env to create image \-\-default\-ks=DEFAULT_KS Set which kickstart file from repos to select in advance, if specified, there isn't interaction needed any more. \-\-repo=REPO Specify additional repo, it may be a simple URL or a complicated tuple string, you can specify multiple repos using this option multiple times \-\-ignore\-siteconf Ignore site configs, this will ignore the default site configs, also ignore \-\-siteconf option. \-\-siteconf=SITECONF Specify site config file, it can be used to set tmpdir, cachedir, outputdir, it also can be used to remap/reroute a repo in kickstart to another equivalent repo, the default site configs are /etc/mic2/mic2.conf and ~/.mic2.conf. \-\-mainrepo=MAINREPO Specify main repo name, it must be a repo name in your kickstart file \-\-rebuild\-bootstrap Rebuild the bootstrap \-b, \-\-build\-bootstrap Build a bootstrap, it should be used with \-B or \-\-bootstrap together \-S SUFFIX, \-\-suffix=SUFFIX Image name suffix (default: date stamp) \-P PREFIX, \-\-prefix=PREFIX Image name prefix (default: meego) \-\-genchecksum Generate checksum for image file if this option is provided \-\-release=RELEASE Generate a MeeGo release with all necessary files for publishing. \-o OUTDIR, \-\-outdir=OUTDIR Output directory to use (default: current work dir) \-k CACHEDIR, \-\-cache=CACHEDIR Cache directory to use (default: private cache) \-t TMPDIR, \-\-tmpdir=TMPDIR Temporary directory to use (default: /var/tmp) \-f FORMAT, \-\-format=FORMAT Image format, you can specify as fs, livecd, liveusb, loop, raw, nand, mrstnand, ubi, jffs2, vdi or vmdk \-c CONFIG, \-\-config=CONFIG Path to kickstart config file .TP \fBhelp (?)\fR give detailed help on a specific sub-command usage: mic help [SUBCOMMAND] .TP \fBlaunchvm (lv)\fR launch a virtual machine image This command is used to launch a virtual machine image. Examples: mic launch # launch a virtual machine image usage: mic launchvm [ARGS...] .TP \fBman\fR generates a man page usage: mic man .TP \fBwrite (wr)\fR write a live image to usb disk This command is used to write a live image to usb disk. Examples: mic write # write a live image to usb disk usage: mic write [ARGS...] Options: \-h, \-\-help show this help message and exit \-g, \-\-gui Run in GUI mode \-c, \-\-console Run in console mode .SS GLOBAL OPTIONS Options: \-\-version show program's version number and exit \-h, \-\-help show this help message and exit .SH "SEE ALSO" Type 'mic help ' for more detailed help on a specific subcommand. .PP For additional information, see * http://www.meego.com/ * http://moblin.org/projects/moblin-image-creator-2 .SH AUTHOR mic was written by Yi Yang, Anas Nashif and Jianfeng Ding. This man page is automatically generated.