1IPMCTL-SHOW-PERFORMANCE(1)          ipmctl          IPMCTL-SHOW-PERFORMANCE(1)
2
3
4

NAME

6       ipmctl-show-performance - Shows performance metrics for one or more
7       PMem modules
8

SYNOPSIS

10           ipmctl show [OPTIONS] -performance [METRICS] [TARGETS]
11

DESCRIPTION

13       Shows performance metrics for one or more PMem modules.
14

OPTIONS

16       -h, -help
17           Displays help for the command.
18
19       -ddrt
20           Used to specify DDRT as the desired transport protocol for the
21           current invocation of ipmctl.
22
23       -smbus
24           Used to specify SMBUS as the desired transport protocol for the
25           current invocation of ipmctl.
26
27           Note
28           The -ddrt and -smbus options are mutually exclusive and may not be
29           used together.
30
31       -o (text|nvmxml), -output (text|nvmxml)
32           Changes the output format. One of: "text" (default) or "nvmxml".
33

METRICS

35       Restricts output to a specific performance metric by supplying the
36       metric name. See RETURN DATA for more information. One of:
37
38       •   MediaReads
39
40       •   MediaWrites
41
42       •   ReadRequests
43
44       •   WriteRequests
45
46       •   TotalMediaReads
47
48       •   TotalMediaWrites
49
50       •   TotalReadRequests
51
52       •   TotalWriteRequests
53
54       The default is to display all performance metrics.
55

TARGETS

57       -dimm [DimmIDs]
58           Restricts output to the performance metrics for specific PMem
59           module by supplying one or more comma separated PMem module
60           identifiers. The default is to display performance metrics for all
61           manageable PMem module.
62

EXAMPLES

64       Shows all performance metrics for all PMem modules in the server.
65
66           ipmctl show -dimm -performance
67
68       Shows the number of 64 byte reads since last AC cycle for all PMem
69       modules in the server.
70
71           ipmctl show -dimm -performance MediaReads
72

LIMITATIONS

74       In order to successfully execute this command:
75
76       •   The caller must have the appropriate privileges.
77
78       •   The specified PMem modules must be manageable by the host software.
79

RETURN DATA

81       This command displays a table of the specified metrics for each
82       specified PMem module. Applying a specific PMem module target limits
83       the rows in the table. Applying a specific metric name target limits
84       the columns in the table.
85
86       DimmID
87           The PMem module identifier
88
89       MediaReads
90           Number of 64 byte reads from media on the PMem module since last AC
91           cycle.
92
93       MediaWrites
94           Number of 64 byte writes to media on the PMem module since last AC
95           cycle.
96
97       ReadRequests
98           Number of DDRT read transactions the PMem module has serviced since
99           last AC cycle.
100
101       WriteRequests
102           Number of DDRT write transactions the PMem module has serviced
103           since last AC cycle.
104
105       TotalMediaReads
106           Number of 64 byte reads from media on the PMem module over its
107           lifetime.
108
109       TotalMediaWrites
110           Number of 64 byte writes to media on the PMem module over its
111           lifetime.
112
113       TotalReadRequest
114           Number of DDRT read transactions the PMem module has serviced over
115           its lifetime.
116
117       TotalWriteRequest
118           Number of DDRT write transactions the PMem module has serviced over
119           its lifetime.
120
121
122
123ipmctl                            2023-07-20        IPMCTL-SHOW-PERFORMANCE(1)