NIXTAMAL-LOCK(1)

📦 version 2.4.0, in nixpkgs unstable

nixtamal-lock(1) — lock all not-yet-locked inputs 💅

Okay so bestie, welcome to NIXTAMAL-LOCK(1) — the manual page for nixtamal-lock, and it is literally here to lock all your not-yet-locked inputs. Main character energy only. ✨

💖 NAME 💖

nixtamal-lock — Lock all not-yet-locked inputs.

That’s the whole vibe: if an input isn’t locked yet, this command locks it. Periodt. 🎀

✨ SYNOPSIS ✨

nixtamal lock [OPTION]… [INPUT_NAME]…

🎀 LICENSE 🎀

GNU General Public License, version 3.0 later (GPL-3.0-or-later)

🦋 MAKER 🦋

toastal <https://toast.al/contact/>

🌸 FUNDING 🌸

See: https://toast.al/funding/

🧚 ARGUMENTS 🧚

  • INPUT_NAME — Input names to lock (if already locked, will skip). Lowkey efficient, no cap. 💅

💅 OPTIONS 💅

  • --color=WHEN (absent=auto or NIXTAMAL_OUTPUT_COLOR env) — Colorize the output. WHEN must be one of auto, always or never.
  • --directory=PATH (absent NIXTAMAL_DIRECTORY env) — Working directory for Nixtamal-related files (default: $PWD/nix/tamal).
  • -f, --force — Force input to lock. Useful if you’re changing the manifest in a manner that otherwise wouldn’t trigger a lock, such as changing a URL or hash algorithm. Fr fr, sometimes you gotta make it happen. 🔥
  • -j INT, --jobs=INT (absent=80 or NIXTAMAL_JOBS env) — Nixtamal’s executor pool domain size.
  • --no-tui — Disable the TUI & use Logs.app for status output.
  • -p PATCH_NAME, --patch=PATCH_NAME — Patch name(s) to lock (if already locked, will skip).
  • -q, --quiet — Be quiet. Takes over -v and --verbosity.
  • --relock — Alias for --force.
  • --skip-patch-check (absent NIXTAMAL_SKIP_PATCH_CHECK env) — Skip checking that patches apply. Faster & works offline, but broken patches lock silently & fail at build instead. > 🚨 Bestie, that caveat is real: silent broken patch now, build-time chaos later. 🙈
  • -v, --verbose — Increase verbosity. Repeatable, but more than twice does not bring more.
  • --verbosity=LEVEL (absent=warning or NIXTAMAL_LOG_LEVEL env) — Be more or less verbose. LEVEL must be one of quiet, error, warning, info or debug. Takes over -v.

👑 COMMON OPTIONS 👑

  • --help[=FMT] (default=auto) — Show this help in format FMT. The value FMT must be one of auto, pager, groff or plain. With auto, the format is pager or plain whenever the TERM env var is dumb or undefined.
  • --version — Show version information.

🌈 EXIT STATUS 🌈

nixtamal lock exits with:

  • 0 — on success.
  • 65 — Nixtamal working directory or manifest not set up. Run nixtamal set-up.
  • 66 — Version mismatch between manifest and lockfile. Run nixtamal lock, but might require removing the lockfile first until nixtaml fast-forward is made.
  • 67 — Manifest ∨ lockfile is not using the latest schema version. Run nixtamal upgrade to upgrade.
  • 68 — Failed to parse the manifest file.
  • 69 — Failed to parse the lockfile.
  • 70 — Failed to serialize lockfile.
  • 71 — Fresh command execution threw an exception.
  • 72 — Fresh command output nothing.
  • 73 — Prefetch command threw an exception.
  • 74 — Prefetch command output was unusable.
  • 75 — Prefetch command flopped on JSON output.
  • 76 — Darcs context file is missing or invalid. Try running nixtamal lock on the input.
  • 77 — Vendored patch file is missing. Try running nixtamal lock to fetch it.
  • 78 — Silo error (such as bad hex in generation number).
  • 79 — Version not found or invalid in manifest file.
  • 80 — Upgrading Nixtamal failed.
  • 81 — BLAKE3 hash algorithm is requested but this Nix doesn’t support it.
  • 82 — Input kind mismatch between manifest & lockfile which prevents values to be melded.
  • 83 — Blueprint scaffolding failed to write files.
  • 84 — A patch failed to apply.
  • 85 — An input references patches that are not defined in the manifest.
  • 123 — on indiscriminate errors reported on standard error.
  • 124 — on command line parsing errors.
  • 125 — on unexpected internal errors (bugs).

🫶 ENVIRONMENT 🫶

These environment variables affect the execution of nixtamal lock:

  • NIXTAMAL_DIRECTORY — Directory for Nixtamal
  • NIXTAMAL_JOBS — See option --jobs.
  • NIXTAMAL_LOG_LEVEL — See option --verbosity.
  • NIXTAMAL_OUTPUT_COLOR — See option --color.
  • NIXTAMAL_SKIP_PATCH_CHECK — See option --skip-patch-check.

💀 BUGS 💀

No tracker is set up; contact the maker directly or join the XMPP chatroom @ <xmpp:nixtamal@chat.toastal.in.th?join>.

⭐ SEE ALSO ⭐

💖 That’s the whole page, bestie — Nixtamal 2.4.0, NIXTAMAL-LOCK(1), and the original footer didn’t print a date, so no fake date, just this cute sign-off. Periodt. 🎀

📦 where this page comes from