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

From: Andre Albsmeier <mail_at_fbsd2.e4m.org>
Date: Sat, 01 Aug 2026 05:55:31 UTC
Thanks to all who helped here!

BTW, when checking the commit link

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

I noticed that the commit details no longer appear. Is it only
me who is (not) seeing this?

	-Andre

On Fri, 31-Jul-2026 at 23:32:59 +0000, Alexander Ziaee wrote:
> 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 .