mkrset Command

Purpose

Makes an rset containing the specified CPUs and memory regions and places it in the system registry.

Syntax

mkrset -c CPUlist [ -m MEMlist ] rsetname

Description

The mkrset command creates and places into the system registry an rset or exclusive rset (xrset) with the specified set of CPUs and/or memory regions. The rset name must not exist in the registry. The owner and group IDs of the rset will be set to the owner and group IDs of the command issuer. The rset will have read/write owner permissions and read permission for group and other. When used to create an xrset, the mkrset command changes the state of the corresponding CPUs on the system to exclusive mode. Creating an xrset requires root privilege.

Flags

Item Description
-c List of CPUs to be in the rset. This can be one or more CPUs or CPU ranges.
-m List of memory regions to be in the rset. This can be one or more memory regions or ranges.

Parameters

Item Description
rsetname The name of the rset to be placed in the system registry. The name consists of a namespace and an rsname separated by a "/" (slash). Both the namespace and rsname may contain up to 255 characters. See the rs_registername() service for additional information about character set limits of rset names.

Security

The user must have root authority or CAP_NUMA_ATTACH and CAP_PROPAGATE capability.

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in AIX® Version 7.1 Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

  1. To make an rset containing CPUs 0-7 named test/cpus0to7, type:
    mkrset -c 0-7 test/cpus0to7
  2. To make an rset containing CPUs 1, 3, 5, 6, 7, 10 named test/lotsofcpus, type:
    mkrset -c 1 3 5-7 10 test/lotsofcpus

Files

Item Description
/usr/bin/mkrset Contains the mkrset command.