// 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.
