Commands Reference, Volume 1

attachrset Command

Purpose

Attaches an rset to a process.

Syntax

attachrset [ -P ]  [ -F ]  rsetname pid

attachrset [ -P ]  [ -F ] [ -c CPUlist ] [ -m MEMlist ] pid

Description

The attachrset command attaches an rset to a process. The command limits the specified process to run only on the processors and/or memory regions contained in the rset. An rset name in the system registry can be attached to the process. Or, an rset containing the specified processors and memory regions can be attached to the process.

Flags

-P	Attaches an rset as a partition rset.
-F	Forces the rset attachment to occur. This option will remove a bindprocessor bind in the process before attaching the new rset. If the -P option is also specified, it will also detach the effective rset from the process before attaching the new rset.
-c CPUlist	List of CPUs to be in the rset. This can be one or more CPUs or CPU ranges.
-m MEMlist	List of memory regions to be in the rset. This can be one or more memory regions or ranges.

Parameters

rsetname	The name of the rset to be attached to the process. 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.
pid	Process ID to connect rset.

Security

The user must have root authority or have CAP_NUMA_ATTACH capability and read access to the specified rset registry name (if -r option used) and target process must have the same effective userid as the command issuer. The user must have root authority to set the partition rset on a process (the -P option).

Examples

To attach an rset containing CPUs 0-7 to process 18838, type:
```
attachrset -c 0-7 18838
```
To attach rset named test/cpus0to7 to process 20124, type:
```
attachrset test/cpus0to7 20124
```

Files

/usr/bin/attachrset

Contains the attachrset command.

Related Information

The detachrset, execrset, lsrset, mkrset, and rmrset commands.