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

ifdef::manpage[]
ipmctl-delete-goal(1)
=====================
endif::manpage[]

NAME
----
ipmctl-delete-goal - Deletes the memory allocation goal from DCPMMs

SYNOPSIS
--------
[verse]
ipmctl delete [OPTIONS] -goal [TARGETS]

DESCRIPTION
-----------
Deletes the memory allocation goal from one or more DCPMMs. This command only
deletes a memory allocation goal request that has not yet been processed by
platform firmware (BIOS).

If the dimm target is used and the specified dimms do not include all dimms
that are part of a memory allocation goal request the result will be dimms
(those not included) that have a broken request which will be rejected by
platform firmware (BIOS) upon the next reboot.

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.

ifdef::os_build[]
-o (text|nvmxml)::
-output (text|nvmxml)::
    Changes the output format. One of: "text" (default) or "nvmxml".
endif::os_build[]

TARGETS
-------
-dimm [DimmIDs]::
  Deletes the memory allocation goal from specific DCPMMs by optionally supplying one or
  more comma-separated DCPMM identifiers. The default is to delete the memory
  allocation goals from all manageable DCPMMs.

-socket [SocketIds]::
  Deletes the memory allocation goal from the DCPMMs on specific sockets by
  supplying the socket target and one or more comma-separated socket
  identifiers. The default is to delete the memory allocation goals from
  manageable DCPMMs on all sockets.

EXAMPLES
--------
Deletes the memory allocation goal from all DCPMMs on all sockets.
[verse]
ipmctl delete -goal

LIMITATIONS
-----------
In order to successfully execute this command:

- The caller must have the appropriate privileges.

- The specified DCPMM(s) must be manageable by the host software and unlocked if
  security is enabled.

- Given socket and all specified DCPMMs must contain a memory allocation goal.

RETURN DATA
-----------
For each DCPMM, the CLI will indicate the status of the operation. If a failure occurs
when deleting the memory allocation goals from multiple DCPMMs, the process will
output a failure message for those DCPMMs that did not succeed and a success
message for those that did.

SAMPLE OUTPUT
-------------
[verse]
Delete memory allocation goal from DIMM (DimmID): Success

[verse]
Delete memory allocation goal from DIMM (DimmID): Error (Code) - (Description)
