JIGIT-MKIMAGE(1)

💖 JIGIT-MKIMAGE(1) 💖

okay so bestie, welcome to jigit-mkimage from the Jigit jigdo tools — this is a General Commands Manual situation and I'm about to make it make sense, no cap ✨

🌸 NAME 🌸

jigit-mkimage — create an ISO image from jigdo files. that's it, that's the whole vibe 🦋

---

✨ SYNOPSIS ✨

jigit-mkimage -j jigdo -t template [options]...

jigit-mkimage -t template -z [options]...

jigit-mkimage -f md5-list -t template -M missing-list [options]...

jigit-mkimage -F sha256-list -t template -M missing-list [options]...

like, four whole moods. pick your fighter 💅

---

🎀 DESCRIPTION 🎀

so jigit-mkimage literally knows how to parse a jigdo template file — the kind that gets used all the time when you're making Debian CDs and DVDs. it can either actually do the thing and convert a template file + its associated files into a whole ISO image (hence the name jigit-mkimage, we love an on-the-nose queen 👑), or, if you hand it some command line options, it'll just spill useful information about the template file instead. glow-up or gossip, your choice 🫶

• -t template file — the jigdo .template file is the single most important thing jigit-mkimage needs, and you must specify it for all operations. main character energy, fr fr.
• -j jigdo file — the jigdo .jigdo file will normally accompany 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

a SHA256 file uses a similar format, but needs more space for the bigger checksum output (64 characters rather than 32). math is math 💀

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

• -m item=path — used in conjunction with a jigdo file; specify where jigit-mkimage should look on the local filesystem to find the files it needs to make an image. (e.g. "Debian=/mirror/debian"). yes the quotes matter, she's specific 💅
• -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/SHA256 file along with the template file and -M <file>. jigit-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 jigit-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. she's a talker, let her talk 🗣️
• -l logfile — jigit-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. jigit-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. vintage behavior, honestly iconic 🎀
• -o outfile — jigit-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 — jigit-mkimage will normally check the MD5/SHA256 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! 🚨

bestie. POTENTIALLY DANGEROUS is not a drill. that's a whole capital-letters warning, respect it.

• -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/SHA256 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/SHA256 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. (yes, "will ignored". she said what she said 💜)

---

🌈 EXAMPLES 🌈

1. jigit-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.

2. jigit-mkimage -z -t test.template

find out how big the ISO image would be from expanding test.template.

3. jigit-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). the whole friend group 💞

---

👑 COPYRIGHT 👑

Copyright 2004-2019 Steve McIntyre (steve@einval.com)

jigit-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)

---

and that's the whole page, bestie — this one's from the Jigit jigdo tools, dated November 2019. go build something gorgeous 💖✨🎀