+ NIXTAMAL(1) +
++ NAME +
++ nixtamal - fulfilling input pinning for Nix +
++ SYNOPSIS +
++ nixtamal COMMAND ⦠+
++ 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/ +
++ COMMANDS +
+-
+
- + check-soundness + [OPTION]⦠+ +
- + Checks that the manifest à lockfile is sound. + +
- + gc + [OPTION]⦠+ +
- + Garbage collect old generations (experimental). Requires + NIXTAMAL_EXPERIMENTAL_GC to be set & is probably still broken. Keeping + the freshest (configurable) number of generations. We suggest at least 2 + if favoring rebase-style workflows so swapping back & forth is less + trouble. + +
- + list-stale + [OPTION]⦠+ +
- + List stale inputs with fresh-cmd, without refreshing + +
- + lock + [OPTION]⦠[INPUT_NAME]⦠+ +
- + Lock all not-yet-locked inputs. + +
- + refresh + [OPTION]⦠[INPUT_NAME]⦠+ +
- + Refreshes all non-frozen inputs using the + fresh-cmdâââor the default fresh-cmd for certain + kinds with a reasonable default (Git). + +
- + set-up + [OPTION]⦠+ +
- + Set up working directory for Nixtamal. By default, also adds Nixpkgs from + upstream to the project's inputs. + +
- + show + [OPTION]⦠+ +
- + Shows current inputs as understood by Nixtamal for earthlings. + +
- + tweak + [OPTION]⦠+ +
- + Tweak the manifest file with $VISUAL, $EDITOR, or vi + +
- + upgrade + [OPTION]⦠+ +
- + Upgrade lockfile & manifest to current schema version. + +
+ 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 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 + +
- + Failed to parse the manifest file. + +
- + 68 + +
- + Failed to parse the lockfile. + +
- + 69 + +
- + Failed to serialize lockfile. + +
- + 70 + +
- + Fresh command execution threw an exception. + +
- + 71 + +
- + Fresh command output nothing. + +
- + 72 + +
- + Prefetch command threw an exception. + +
- + 73 + +
- + Prefetch command output was unusable. + +
- + 74 + +
- + Prefetch command flopped on JSON output. + +
- + 75 + +
- + Snag when trying to work with the Darcs context. + +
- + 76 + +
- + Silo error (such as bad hex in generation number). + +
- + 77 + +
- + Version not found or invalid in manifest file. + +
- + 78 + +
- + Upgrading Nixtamal failed. + +
- + 79 + +
- + BLAKE3 hash algorithm is requested but this Nix doesnât support + it. + +
- + 80 + +
- + Input kind mismatch between manifest & lockfile which prevents values + to be melded. + +
- + 123 + +
- + on indiscriminate errors reported on standard error. + +
- + 124 + +
- + on command line parsing errors. + +
- + 125 + +
- + on unexpected internal errors (bugs). + +
+ BUGS +
++ No tracker is set up; contact the maker directly or join the XMPP + chatroom @ <xmpp:nixtamal@chat.toastal.in.th?join>. +
++ SEE + ALSO +
+-
+
- + nixtamal-manifest(5) + +
- + manifest.kdl format + +
| + | + Nixtamal 1.4.1 + | +