git: 868158f7fd2a - main - nvmecontrol.8: Explain non-operational power modes

From: Alexander Ziaee <ziaee_at_FreeBSD.org>
Date: Fri, 31 Jul 2026 23:32:59 UTC
The branch main has been updated by ziaee:

URL: https://cgit.FreeBSD.org/src/commit/?id=868158f7fd2a172ef22f1b6b682cc1d38e54cf63

commit 868158f7fd2a172ef22f1b6b682cc1d38e54cf63
Author:     Andre Albsmeier <mail@fbsd2.e4m.org>
AuthorDate: 2026-07-31 23:27:23 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-07-31 23:30:05 +0000

    nvmecontrol.8: Explain non-operational power modes
    
    `nvmecontrol power -l ...` lists the available power modes.
    Non-operational modes are marked with an asterisk. While here,
    add <device-id | namespace-id> to the "nvmecontrol power" synopsis.
    
    MFC after:              3 days
    Reviewed by:            dab, imp, michaelo, ziaee
    Differential Revision:  https://reviews.freebsd.org/D58480
---
 sbin/nvmecontrol/nvmecontrol.8 | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/sbin/nvmecontrol/nvmecontrol.8 b/sbin/nvmecontrol/nvmecontrol.8
index 05d0feb347f9..6499da9f72e7 100644
--- a/sbin/nvmecontrol/nvmecontrol.8
+++ b/sbin/nvmecontrol/nvmecontrol.8
@@ -33,7 +33,7 @@
 .\"
 .\" Author: Jim Harris <jimharris@FreeBSD.org>
 .\"
-.Dd February 20, 2026
+.Dd July 31, 2026
 .Dt NVMECONTROL 8
 .Os
 .Sh NAME
@@ -175,6 +175,7 @@
 .Op Fl l
 .Op Fl p power_state
 .Op Fl w workload_hint
+.Aq Ar device-id | Ar namespace-id
 .Nm
 .Ic selftest
 .Aq Fl c Ar code
@@ -629,6 +630,9 @@ Manage the power modes of the NVMe controller.
 .Bl -tag -width 6n
 .It Fl l
 List all supported power modes.
+Modes marked with an asterisk
+.Pq Dq *
+are non-operational power modes.
 .It Fl p Ar mode
 Set the power mode to
 .Ar mode .