NAME¶

mic - MeeGo image command-line tool.

SYNOPSIS¶

mic [ GLOBALOPTS] SUBCOMMAND [OPTS] [ARGS...] mic help SUBCOMMAND

DESCRIPTION¶

MeeGo image command-line tool.

COMMANDS¶

chroot (ch)

chroot into an image

 

This command is used to chroot into a live image to do some changes.

 

Examples:
mic chroot -s /fs/path <your live image> # 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

 

 

convert (cv)

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 <yourimage> -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).

 

 

create (cr)

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

 

 

help (?)

give detailed help on a specific sub-command

 

usage:
mic help [SUBCOMMAND]

 

launchvm (lv)

launch a virtual machine image

 

This command is used to launch a virtual machine image.

 

Examples:
mic launch <your vm image> # launch a virtual machine image

 

usage:
mic launchvm [ARGS...]

 

 

man

generates a man page

 

usage:
mic man

 

write (wr)

write a live image to usb disk

 

This command is used to write a live image to usb disk.

 

Examples:
mic write <your live image> # 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

 

 

 

GLOBAL OPTIONS¶

Options:
--version show program's version number and exit
-h, --help show this help message and exit

SEE ALSO¶

Type 'mic help <subcommand>' for more detailed help on a specific subcommand. For additional information, see
* http://www.meego.com/
* http://moblin.org/projects/moblin-image-creator-2

AUTHOR¶

mic was written by Yi Yang, Anas Nashif and Jianfeng Ding. This man page is automatically generated.