// Copyright (c) 2020, Intel Corporation.
// SPDX-License-Identifier: BSD-3-Clause

ifdef::manpage[]
ipmctl-show-pcd(1)
==================
endif::manpage[]

NAME
----
ipmctl-show-pcd - Shows the platform configuration data for one or more PMem modules

SYNOPSIS
--------
[listing]
ipmctl show [OPTIONS] -pcd [TARGETS]

DESCRIPTION
-----------
Shows the platform configuration data for one or more PMem modules.

OPTIONS
-------
-h::
-help::
  Displays help for the command.

-ddrt::
  Used to specify DDRT as the desired transport protocol for the current invocation of ipmctl.

-smbus::
  Used to specify SMBUS as the desired transport protocol for the current invocation of ipmctl.

NOTE: The -ddrt and -smbus options are mutually exclusive and may not be used together.

-lpmb::
  Used to specify large transport payload size for the current invocation of ipmctl.

-spmb::
  Used to specify small transport payload size for the current invocation of ipmctl.

NOTE: The -lpmb and -spmb options are mutually exclusive and may not be used together.

TARGETS
-------
-dimm [DimmIDs]::
  Restricts output to the platform configuration data on specific PMem modules by
  supplying one or more comma-separated PMem module identifiers. The default is to
  display the platform configuration data for all manageable PMem modules.

-pcd [Config|LSA]::
  Restricts output to a specific partition of the platform configuration data.
  The default is to display both. One of:
  - Config - Configuration management information
  - LSA - Namespace label storage area

EXAMPLES
--------
Shows the configuration information from the platform configuration data for all
manageable PMem modules.
[listing]
ipmctl show -dimm -pcd

Shows the configuration information from the platform configuration data for
PMem module 0x1.
[listing]
ipmctl show -dimm -pcd Config

LIMITATIONS
-----------
The specified PMem modules must be manageable by the host software.

RETURN DATA
-----------
Returns the formatted data from the requested platform configuration data for
the specified PMem modules for debugging and troubleshooting purposes.
