MIC(1)								   User Commands							    MIC(1)

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.

mic 0.24.12							     Jun 2011								    MIC(1)