NAME

       mkimage - Create an ISO image from jigdo files

SYNOPSIS

       mkimage -j igdo -t emplate [options]...

       mkimage -t emplate -z [options]...

       mkimage -f d5-list -t emplate -M issing-list [options]...

DESCRIPTION

       mkimage knows how to parse a jigdo template file, commonly used when creating Debian CDs and DVDs. It can
       be  used  to  actually  convert  a  template  file and associated files into an ISO image (hence the name
       mkimage), or with some command line options it will output useful information  about  the  template  file
       instead.

       -t template file
              The jigdo .template file is the most important thing that mkimage needs, and must be specified for
              all operations.

       -j jigdo file
              The  jigdo  .jigdo  file  will normally acompany the .template file. To rebuild the image you must
              specify at least one of the jigdo file and an MD5 file (-f).

       -f MD5 file
              A file listing files available locally and  their  MD5  sums,  in  the  same  format  as  used  by
              genisoimage:

         MD5sum   File size  Path
         32 chars 12 chars   to end of line

       The MD5sum must be written in standard hexadecimal notation, the file size must list the size of the file
       in bytes, and the path must list the absolute path to the file. For example:

       00006dcd58ff0756c36d2efae21be376         14736  /mirror/debian/file1
       000635c69b254a1be8badcec3a8d05c1        211822  /mirror/debian/file2
       00083436a3899a09633fc1026ef1e66e         22762  /mirror/debian/file3

       To rebuild an image you must specify at least one of the MD5 file and a jigdo file (-j).

       -m item=path
              Used  in  conjunction with a jigdo file; specify where mkimage should look on the local filesystem
              to find the files it needs to make an image. (e.g. "Debian=/mirror/debian").

       -M missing file
              If you're not sure if you have all the files needs to create an image, specify both the jigdo file
              and an MD5 file along with the template file and -M <file>. mkimage will check to see that all the
              files are available instead of building the image. Any files that are missing will  be  listed  in
              the file specified here. See jigit for usage examples.

       -v     Make  mkimage more verbose. Additional -v arguments will make it more verbose again. Default level
              is 0 (almost no output). 1 will print progress in % while the image is being created; 2 will  list
              every file and data block that is appended to the image.

       -l logfile
              mkimage  will  normally write to stderr when it reports progress. Specify a logfile (or /dev/null)
              if you want it elsewhere.

       -O     Skip checking the validity  of  specified  jigdo  files.  mkimage  will  normally  check  for  the
              "JigsawDownload"  header  as a sanity check, but some very old jigdo files produced by Debian pre-
              dated the addition of this header.

       -o outfile
              mkimage will normally write the ISO image to stdout, ready for piping into  cdrecord  or  to  iso-
              image.pl. Specify an output filename if you want it written to disk instead.

       -q     mkimage  will  normally  check  the MD5 sum of every file it reads and writes, and will fail if it
              finds any mismatches. Specify -q to tell it not to. This will normally run more quickly,  but  can
              leave you with a broken image so is POTENTIALLY DANGEROUS. Use with care!

       -s start offset
              Rather  than  start  at  the beginning of the image, skip to the specified offset and start output
              there. Probably only useful in iso-image.pl when resuming a download. Specifying a non-zero offset
              also implies -q, as it's difficult to check MD5 sums when you're not checking the whole image.  -e
              end offset Rather than end at the end of the image, stop at the specified  offset.  Probably  only
              useful in iso-image.pl when resuming a download. Specifying an end offset also implies -q, as it's
              difficult to check MD5 sums when you're not checking the whole image.

       -z     Simply  parse the template file and print the size of the image that would be generated, in bytes.
              Only needs the template file to be specified, any other arguments will ignored.

EXAMPLES

       mkimage -f MD5 -j test.jigdo -t test.template -M missing
              Read in the files MD5, test.jigdo and  test.template  and  check  if  all  the  needed  files  are
              available. If any are missing, list them in missing.

       mkimage -z -t test.template
              Find out how big the ISO image would be from expanding test.template.

       mkimage -v -f MD5 -t test.template -o test.iso
              Build  the  iso  image  in  test.iso,  using  files  listed in MD5 to fill in what's needed by the
              template file test.template. Show progress as the image is built.

SEE ALSO

       jigdo-file(1), jigit(1), jigsum(1) and jigdump(1).

COPYRIGHT

       Copyright 2004 Steve McIntyre (steve@einval.com)

       mkimage may be copied under the terms and conditions of version 2 of the GNU General Public  License,  as
       published by the Free Software Foundation (Cambridge, MA, USA).

AUTHOR

       Written by Steve McIntyre (steve@einval.com)

Jigit jigdo tools                                September 2004                                       MKIMAGE(1)