npingler-update(1)

📦
version 0.6.0 · 2 versions
, in nixpkgs unstable

💖 NAME 💖

okay bestie, welcome to npingler-update(1) — the General Commands Manual entry for the npingler update command. It does exactly what it says on the tin: Update the npins and switch to the updated profile. periodt ✨

🌸 SYNOPSIS 🌸

npingler update [--no-switch] [--hostname] [--profile]
[--diff-derivations] [--pin-registry-root] [--root-registry-path]
[--pin-channels-root] [--root-profile] [--extra-nix-args]
[--extra-nix-build-args] [--extra-nix-eval-args]
[--extra-nix-env-set-args] [--config] [--file] [--log-filter] [--debug]
[-v|--verbose] [--dry] [-h|--help]

🦋 DESCRIPTION 🦋

Update the npins and switch to the updated profile. That's the whole vibe — no extra lore, no secret side quests. 💅

✨ OPTIONS ✨

  • --no-switch — Don't build or switch to the updated profile. sometimes we're just not ready for the profile glow-up, and that's valid 🫶
  • --hostname <HOSTNAME> — The hostname to build the configuration for.

This corresponds to the npingler.${hostname} output attribute in your flake. May also be specified with the HOSTNAME environment variable.

  • --config <CONFIG> — Path to the configuration file to use.

Defaults to ~/.config/npingler/config.toml.

  • --file <FILE> — Path or directory containing npingler Nix expressions.

Defaults to the --config directory.

  • -h, --help — Print help (see a summary with '-h'). honestly iconic of it 💖

🎀 NIX PROFILE OPTIONS 🎀

  • --profile <PROFILE> — Profile to use for nix profile operations. May also be specified with the NIX_PROFILE environment variable.
  • --diff-derivations <DIFF_DERIVATIONS> — A command, like nix-diff or nvd, to use to diff derivations. This will be executed to display a diff of the changes being made to your profile before building it.

This may contain shell-quoted arguments.

🌈 NIX REGISTRY OPTIONS 🌈

  • --pin-registry-root <PIN_REGISTRY_ROOT> — Pin Nix Flake registry entries for the root user.

[possible values: true, false]

  • --root-registry-path <ROOT_REGISTRY_PATH> — The Nix Flake registry path for the root user, defaults to /etc/nix/registry.json. May also be specified with the ROOT_NIX_REGISTRY environment variable.

🧚 NIX CHANNEL OPTIONS 🧚

  • --pin-channels-root <PIN_CHANNELS_ROOT> — Pin Nix channels for the root user.

[possible values: true, false]

  • --root-profile <ROOT_PROFILE> — The root user's Nix profile path. Defaults to /nix/var/nix/profiles/per-user/root/channels. May also be specified with the ROOT_NIX_PROFILE environment variable.

🔥 NIX COMMAND ARG OPTIONS 🔥

  • --extra-nix-args <EXTRA_NIX_ARGS> — Extra args for nix invocations.

This is for all nix binary ("nix3") invocations, but does not apply to (e.g.) nix-env.

  • --extra-nix-build-args <EXTRA_NIX_BUILD_ARGS> — Extra args for nix build invocations.
Note this is NOT for nix-build, which we do not invoke. do not come for nix-build, bestie 💀
  • --extra-nix-eval-args <EXTRA_NIX_EVAL_ARGS> — Extra args for nix eval invocations.
  • --extra-nix-env-set-args <EXTRA_NIX_ENV_SET_ARGS> — Extra args for nix-env --set invocations.

🍓 LOGGING OPTIONS 🍓

  • --log-filter <LOG_FILTER> — Tracing log filter.

See: https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives May also be specified with the NPINGLER_LOG environment variable.

  • --debug — Alias for --log-filter=trace.
  • -v, --verbose — Alias for --log-filter=debug.
  • --dry — Don't actually change the configuration. look but don't touch energy 🙈

cute sign-off: the footer gives source/version update and the manual tag npingler-update(1); no separate date is printed, so no fake date from me — mwah 💋🫶

📦 where this page comes from