man pages section 8: System Administration Commands

cmiadm (8)

Name

cmiadm - CMI Administration utility

Synopsis

/usr/sbin/cmiadm show-status

/usr/sbin/cmiadm remove-resv [<resv-key> | -a]

/usr/sbin/cmiadm show-cmigrp

/usr/sbin/cmiadm show-seg

Description

The cmiadm command administers aspects of the CMI environment and any related drivers. For more information, see Coherent Memory Interfaces.

Sub Commands

The following subcommands are supported on all CMI implementations:

cmiadm show-status

Indicates whether CMI functionality is supported on the domain.

cmiadm show-resv [–v]

Displays a list of the reservations objects on the domain. The display includes the reservation key, size in megabytes, and the context count.

If –v is specified, it displays available size and owner UID as well. If CMI memory allocated from deleted reservation objects are still active, those reservation objects are included in the list. Starred key indicates that its reservation object was deleted.

cmiadm remove-resv [<resv-key>] | –a]

Removes the reservation specified by the <resv-key>, or all reservations with a zero context count if –a is specified on the domain.

The following subcommands are supported on Fujitsu platforms:

cmiadm show-cmigrp

Lists CMI groups to which all or part of CMI resources are assigned exclusively, and display allocated CPUs and assigned CMI resource information per CMI group. List of CMI groups are displayed only when some CMI resources are assigned to particular group of CPUs exclusively.

cmiadm show-seg

Lists the CMI segment ids including imported segments, and each segment status.

Exit Status

The cmiadm show-status subcommand returns the following exit values:

0

CMI enabled on the domain

1

An error occurred

2

CMI disabled on the domain

3

CMI not supported on current platform

The other subcommands return the following exit values:

0

Successful completion

1

An error occurred

2

CMI disabled on the domain

3

CMI not supported on current platform

Examples

Example 1 Showing status

# cmiadm show-status
CMI Enabled

Example 2 Showing Reservations

# cmiadm show-resv
KEY       SIZE (MB)      CTX COUNT
----      ----           ---------
4321      1000              0
4322      2000              2
4324      1000              1
4329      1000              0

Example 3 Remove a Reservation and show updated list

# cmiadm remove-resv  4329
# cmiadm show-resv
KEY       SIZE (MB)       CTX COUNT
----      ----            ---------
4321      1000               0
4322      2000               2
4324      1000               1

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Uncommitted Availability system/cmi

See Also

cmi(7), libcmi(3LIB)