man(1)

📦 version 0.2, in nixos 26.05, nixpkgs unstable

💅 man(1) — the mkbom man page, bestie edition

okay so this is the manual page for mkbom, filed under section 1 of the man manual, and I'm gonna walk you through it like we're texting at 2am. stay with me 🫶

✨ NAME ✨

mkbom — literally makes a bill-of-materials file. that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

mkbom [-i] [-u uid] [-g gid] source target-bom-file

like, that's the shape of it. source in, target-bom-file out. iconic. ✨

🦋 DESCRIPTION 🦋

okay so picture this: mkbom creates a bill-of-materials file — the one specified by target-bom-file — from the contents of the directory specified by source. 💖 and what's that even for? it's for making Mac OS X installer packages, no cap. 🔥

OR — and this is the fun part — if you pass the -i option, mkbom can build that bill-of-materials file from a text file specified by source, which lists the contents of a directory in the format generated by lsbom and ls4mkbom. so it's giving "read the guest list instead of counting heads." 🎀

and there's a tutorial if you want the full lore: http://hogliux.github.io/bomutils/tutorial.html — go read it, it's giving study date energy 📚

  • -i — treat source as a file containing a list of files and folders in the format generated by lsbom and ls4mkbom. so source is a list, not a directory, got it? 🗒️
  • -u — every file or folder entry listed for a BOM contains the owner's user and group identifier (e.g. 500/501). and here's the tea: typically, these Linux values are meaningless on the Mac platform 😭 so use the -u option to force the user identifier to a specific value. typically, this value should be 0 (i.e. root). 👑
⚠️ heads up bestie: this option cannot be used with the -i option, because in that case the user identifier is read from the source file list. them's the rules 💅
  • -g — similar to the -u option but forces the group identifier to a specific value. typically this value should be 80 (i.e. admin). 🫶
⚠️ same deal: this option cannot be used with the -i option, because in that case the group identifier is read from the source file list. no mixing, periodt. 🚫

👀 SEE ALSO 👀

go touch grass in these other pages, iykyk:

💀 BUGS 💀

long paths and some characters in filenames will cause mkbom to fail on Windows. not me finding out the hard way 🙈 that's it, that's the bug. 💀

🌈 AUTHOR 🌈

Fabian Renn (fabian.renn@gmail.com) — http://hogliux.github.io/bomutils ✨ absolute icon, we stan 👑

and that's the whole page!! version 1.0, dated 19 April 2014, from the man(1) manual — mwah, go build something cute 🎀💖🦋

📦 where this page comes from