| 1 |
.TH "libnvme" 9 "struct nvme_id_psd" "November 2025" "API Manual" LINUX |
| 2 |
.SH NAME |
| 3 |
struct nvme_id_psd \- Power Management data structure |
| 4 |
.SH SYNOPSIS |
| 5 |
struct nvme_id_psd { |
| 6 |
.br |
| 7 |
.BI " __le16 mp;" |
| 8 |
.br |
| 9 |
.BI " __u8 rsvd2;" |
| 10 |
.br |
| 11 |
.BI " __u8 flags;" |
| 12 |
.br |
| 13 |
.BI " __le32 enlat;" |
| 14 |
.br |
| 15 |
.BI " __le32 exlat;" |
| 16 |
.br |
| 17 |
.BI " __u8 rrt;" |
| 18 |
.br |
| 19 |
.BI " __u8 rrl;" |
| 20 |
.br |
| 21 |
.BI " __u8 rwt;" |
| 22 |
.br |
| 23 |
.BI " __u8 rwl;" |
| 24 |
.br |
| 25 |
.BI " __le16 idlp;" |
| 26 |
.br |
| 27 |
.BI " __u8 ips;" |
| 28 |
.br |
| 29 |
.BI " __u8 rsvd19;" |
| 30 |
.br |
| 31 |
.BI " __le16 actp;" |
| 32 |
.br |
| 33 |
.BI " __u8 apws;" |
| 34 |
.br |
| 35 |
.BI " __u8 epfrt;" |
| 36 |
.br |
| 37 |
.BI " __u8 fqvt;" |
| 38 |
.br |
| 39 |
.BI " __u8 epfvt;" |
| 40 |
.br |
| 41 |
.BI " __u8 epfr_fqv_ts;" |
| 42 |
.br |
| 43 |
.BI " __u8 epfvts;" |
| 44 |
.br |
| 45 |
.BI " __u8 rsvd28[4];" |
| 46 |
.br |
| 47 |
.BI " |
| 48 |
}; |
| 49 |
.br |
| 50 |
|
| 51 |
.SH Members |
| 52 |
.IP "mp" 12 |
| 53 |
Maximum Power indicates the sustained maximum power consumed by the |
| 54 |
NVM subsystem in this power state. The power in Watts is equal to |
| 55 |
the value in this field multiplied by the scale specified in the Max |
| 56 |
Power Scale bit (see \fIenum nvme_psd_flags\fP). A value of 0 indicates |
| 57 |
Maximum Power is not reported. |
| 58 |
.IP "rsvd2" 12 |
| 59 |
Reserved |
| 60 |
.IP "flags" 12 |
| 61 |
Additional decoding flags, see \fIenum nvme_psd_flags\fP. |
| 62 |
.IP "enlat" 12 |
| 63 |
Entry Latency indicates the maximum latency in microseconds |
| 64 |
associated with entering this power state. A value of 0 indicates |
| 65 |
Entry Latency is not reported. |
| 66 |
.IP "exlat" 12 |
| 67 |
Exit Latency indicates the maximum latency in microseconds |
| 68 |
associated with exiting this power state. A value of 0 indicates |
| 69 |
Exit Latency is not reported. |
| 70 |
.IP "rrt" 12 |
| 71 |
Relative Read Throughput indicates the read throughput rank |
| 72 |
associated with this power state relative to others. The value in |
| 73 |
this is less than the number of supported power states. |
| 74 |
.IP "rrl" 12 |
| 75 |
Relative Read Latency indicates the read latency rank associated |
| 76 |
with this power state relative to others. The value in this field is |
| 77 |
less than the number of supported power states. |
| 78 |
.IP "rwt" 12 |
| 79 |
Relative Write Throughput indicates write throughput rank associated |
| 80 |
with this power state relative to others. The value in this field is |
| 81 |
less than the number of supported power states |
| 82 |
.IP "rwl" 12 |
| 83 |
Relative Write Latency indicates the write latency rank associated |
| 84 |
with this power state relative to others. The value in this field is |
| 85 |
less than the number of supported power states |
| 86 |
.IP "idlp" 12 |
| 87 |
Idle Power indicates the typical power consumed by the NVM |
| 88 |
subsystem over 30 seconds in this power state when idle. |
| 89 |
.IP "ips" 12 |
| 90 |
Idle Power Scale indicates the scale for \fIstruct nvme_id_psd\fP.idlp, |
| 91 |
see \fIenum nvme_psd_ps\fP for decoding this field. |
| 92 |
.IP "rsvd19" 12 |
| 93 |
Reserved |
| 94 |
.IP "actp" 12 |
| 95 |
Active Power indicates the largest average power consumed by the |
| 96 |
NVM subsystem over a 10 second period in this power state with |
| 97 |
the workload indicated in the Active Power Workload field. |
| 98 |
.IP "apws" 12 |
| 99 |
Bits 7-6: Active Power Scale(APS) indicates the scale for the \fIstruct |
| 100 |
nvme_id_psd\fP.actp, see \fIenum nvme_psd_ps\fP for decoding this value. |
| 101 |
Bits 2-0: Active Power Workload(APW) indicates the workload |
| 102 |
used to calculate maximum power for this power state. |
| 103 |
See \fIenum nvme_psd_workload\fP for decoding this field. |
| 104 |
.IP "epfrt" 12 |
| 105 |
Emergency power fail recovery time |
| 106 |
.IP "fqvt" 12 |
| 107 |
Forced quiescence vault time |
| 108 |
.IP "epfvt" 12 |
| 109 |
Emergency power fail vault time |
| 110 |
.IP "epfr_fqv_ts" 12 |
| 111 |
Bits 7-4: Forced quiescence vault time scale |
| 112 |
Bits 3-0: Emergency power fail recovery time scale |
| 113 |
.IP "epfvts" 12 |
| 114 |
Bits 3-0: Emergency power fail vault time scale |
| 115 |
.IP "rsvd28" 12 |
| 116 |
Reserved |