NVME-OCP-CLEAR-FW(1)

πŸ’… NAME πŸ’…

ok so this is nvme-ocp-clear-fw-activate-history β€” the manual page lives in the NVMe Manual, and what it does is Clear the OCP Firmware Update History Log, bestie. that's the whole thing. iconic. πŸŽ€


✨ SYNOPSIS ✨

nvme [<global-options>] ocp clear-fw-activate-history <device>
                        [--no-uuid | -n]

πŸ¦‹ DESCRIPTION πŸ¦‹

so for whatever NVMe device you point at, this command clears the OCP Firmware Update History Log. bye bye history. πŸ’…

<device> is mandatory β€” you literally cannot skip it β€” and it can be either the NVMe character device (like /dev/nvme0) or the block device (like /dev/nvme0n1). either one, we're flexible. 🫢

if you run this command with no option added, it'll try to automatically detect the parameters of the command for you. cute, right? it will work successfully or fail gracefully for devices supporting UUID for Vendor Specific Information (that's NVMe 1.4 or later, and heads up: OCP 2.0 requires NVMe 1.4b). for devices that don't support OCP 2.0, the command will fail gracefully β€” unless you provide the --no-uuid option. so like, it's not gonna explode, it's just gonna be sad about it. 😭

for OCP 1.0 devices (before NVMe 1.4), the --no-uuid option is required. periodt.

⚠️ ngl this next bit is important: when the --no-uuid option is provided, results for devices before NVMe 1.4 without OCP support are undefined. like, undefined undefined. don't come crying to me. πŸ’€

on success it returns 0, and an error code otherwise.


🌸 OPTIONS 🌸

  • -n, --no-uuid β€” do not try to automatically detect the UUID index for this command (required for old OCP 1.0 support β€” yes, required, i said what i said ✨)

πŸ‘‘ GLOBAL OPTIONS πŸ‘‘

these ones are defined at the top-level nvme command, and bestie they're available to this subcommand too. sharing is caring. πŸ’–

  • --dry-run β€” print the command that would be executed, but do not actually execute it. it's giving visualization. manifesting the command. 🧚
  • --no-ioctl-probing β€” disable probing for 64-bit IOCTL support.
  • --no-retries β€” disable retry logic on transient errors. no second chances. πŸ’€
  • -o <fmt>, --output-format=<fmt> β€” set the reporting format to normal, tabular, 'json, or binary. only one output format may be used at a time, so pick your fighter. πŸŽ€
  • --output-format-version=<version> β€” select the output format version. version 1 uses the original field naming, while version 2 (the default) provides more consistent and script-friendly field names. other versions are rejected. πŸ™ˆ
  • --quiet β€” suppress informational messages. errors are still reported, and --quiet cancels any --verbose for the library log level. it's giving "i'm ignoring you but i still hear you." πŸ’…
  • --set-options=<key=value>[,<key=value>...] β€” set libnvme library options for this invocation. the supported keys are force-4k, mi-probe-enabled, test-base-dir and test-sysfs-dir. look at all those little keys. πŸ”₯
  • --timeout=<ms> β€” set the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff). we wait. forever. main character energy. 🫢
  • -v, --verbose β€” increase the level of detail in the output. may be specified multiple times to further increase verbosity. stack it. πŸ‘‘

and hey β€” these options can also be set as machine-wide defaults in nvme-cli.conf(5). a command-line flag always overrides the file. always. no cap. ⭐


🌈 EXAMPLES 🌈

  • clears OCP Firmware Activation History Log for the device:
# nvme ocp clear-fw-activate-history /dev/nvme0

πŸ’œ NVME πŸ’œ

part of the nvme-user suite. you belong here. πŸ¦‹


okay that's the whole page, mwah πŸ’– β€” this served NVMe realness, page NVME-OCP-CLEAR-FW(1), dated 10/30/2026. go clear some firmware history, bestie. slay. πŸŽ€βœ¨

πŸ“¦ where this page comes from