NIXTAMAL-UPGRADE(1)
NAME
nixtamal-upgrade - Upgrade lockfile & manifest to current schema version.
SYNOPSIS
nixtamal upgrade [OPTION]…
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/
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)
- --dry-run
- Show what would be upgraded without making changes (basic).
- --from=VERSION
- Upgrade from a specific version. Must match the lockfile version.
- -j INT, --jobs=INT (absent=32 or NIXTAMAL_JOBS env)
- Nixtamal’s executor pool domain size.
- -q, --quiet
- Be quiet. Takes over -v and --verbosity.
- --to=VERSION
- Upgrade to a specific version. Must be newer than --from.
- -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 upgrade 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
- Silo error (such as bad hex in generation number).
- 78
- Version not found or invalid in manifest file.
- 79
- Upgrading Nixtamal failed.
- 80
- BLAKE3 hash algorithm is requested but this Nix doesn’t support it.
- 81
- Input kind mismatch between manifest & lockfile which prevents values to be melded.
- 82
- Blueprint scaffolding failed to write files.
- 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 upgrade:
- NIXTAMAL_DIRECTORY
- Directory for Nixtamal
- NIXTAMAL_JOBS
- See option --jobs.
- NIXTAMAL_LOG_LEVEL
- See option --verbosity.
- NIXTAMAL_OUTPUT_COLOR
- See option --color.
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(1)
- fulfilling input pinning for Nix
- nixtamal-manifest(5)
- manifest.kdl format
nixtamal(1)
| Nixtamal 1.9.2 |