nethsm-provision(1)

📦 version 0.10.0, in arch rolling

💅 nethsm-provision(1) — General Commands Manual

okay so bestie, this is the manpage for nethsm-provision from the nethsm command family — the whole General Commands Manual vibe. sit down, grab a lil snack 🍓, and let's get into it.

✨ NAME ✨

nethsm-provision — literally The "nethsm provision" command. that's the name, that's the energy, periodt. 🎀

🌸 SYNOPSIS 🌸

nethsm provision [-a|--auth-passphrase-file]
[-A|--admin-passphrase-file] [-c|--config] [-s|--system-time]
[-l|--label] [-U|--unlock-passphrase-file] [-u|--user] [-h|--help]

🦋 DESCRIPTION 🦋

The "nethsm provision" command. no cap, that's what the original says — it's the provisioning command in the nethsm toolkit, and the options below are the whole menu. 👑

💖 OPTIONS 💖

  • -a, --auth-passphrase-file <AUTH_PASSPHRASE_FILE> — the path to a file containing a passphrase for authentication 🔐

the passphrase inside that file must be the one for the user chosen for the command. that's not optional, bestie.

this option can be provided multiple times, which is needed for commands that require multiple roles at once. when you've got multiple passphrase files, ordering matters — the files get assigned to the respective user provided by the --user option.

may also be specified with the NETHSM_AUTH_PASSPHRASE_FILE environment variable.

  • -A, --admin-passphrase-file <ADMIN_PASSPHRASE_FILE> — the path to a file containing the admin passphrase 👑

the passphrase must be >= 10 and <= 200 characters long. yes, we're counting. ✨

may also be specified with the NETHSM_ADMIN_PASSPHRASE_FILE environment variable.

  • -c, --config <CONFIG> — the path to a custom configuration file 📁

if specified, the custom configuration file is used instead of the default configuration file location.

may also be specified with the NETHSM_CONFIG environment variable.

  • -s, --system-time <SYSTEM_TIME> — the initial system time for the device ⏰

must be provided as an ISO 8601 formatted UTC timestamp. no freestyle dates, iykyk.

may also be specified with the NETHSM_SYSTEM_TIME environment variable.

  • -l, --label <LABEL> — a label uniquely identifying a device in the configuration file 🏷️

must be provided if more than one device is setup in the configuration file. so if it's a whole group chat of devices, you gotta name yours.

may also be specified with the NETHSM_LABEL environment variable.

  • -U, --unlock-passphrase-file <UNLOCK_PASSPHRASE_FILE> — the path to a file containing the unlock passphrase 🔓

the passphrase must be >= 10 and <= 200 characters long.

may also be specified with the NETHSM_UNLOCK_PASSPHRASE_FILE environment variable.

  • -u, --user <USER> — a user name which is used for a command 🫶

can be provided, if no user name is setup in the configuration file for a device. must be provided, if several user names of the same target role are setup in the configuration file for a device. lowkey it's the "are you gonna tell me who this is or am i gonna have to guess" option.

this option can be provided multiple times, which is needed for commands that require multiple roles at once.

may also be specified with the NETHSM_USER environment variable.

  • -h, --help — print help (see a summary with '-h') 🙈

that's right, the short -h gives you the summary version. cute and quick.

💀 quick vibe check: the --auth-passphrase-file files line up with the --user entries in order, so don't shuffle them like a playlist. bestie behaviour only.

and that's the whole page, no gatekeeping 💜 — brought to you by the nethsm-provision manpage, a.k.a. nethsm-provision(1), living its best life in the General Commands Manual. mwah, go provision something iconic. 🌈⭐🎀

📦 where this page comes from