Commands Reference, Volume 2

execrset Command

Purpose

Runs a program or command attached to an rset.

Syntax

execrset [ -P ] [ -F ] -c CPUlist [ -m MEMlist ] -e command [ parameters ]

execrset [ -P ] [ -F ] rsetname [ -e ] command [ parameters ]

Description

The execrset command executes a command with an attachment to an rset. It causes the specified command to be limited to running only on the processors and/or memory regions contained in the rset. An rset name in the system registry can be used to specify the processors and/or memory regions the command is allowed to use. Or, an rset containing the specified processors and memory regions can be attached to the process.

Flags

-F	Force the execrset command to occur. This flag removes a bindprocessor bind in the process before issuing the command. If the -P flag is also specified, it detaches the effective rset from the process before issuing the command
-P	Attaches an rset as a partition rset.
-c CPUlist	List of CPUs to be in the rset to be attached to the process which executes the program or command. 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.
-e command [ parameters ]	Specifies the command to run followed by any parameters. The -e flag must be the last flag used in the command.

Parameters

rsetname

The name of the rset in the system registry to be attached to the process executing the program or command

Security

The user must have root authority or have CAP_NUMA_ATTACH capability. The user must have root authority to attach a partition rset to the command's process (the -P flag).

Examples

To run the test1 program on CPUs 0-7, type:
```
execrset -c 0-7 -e test1
```
To run the 'test2 parm1 parm2' program with an attachment to rset named test/cpus0to15, type:
```
execrset test/cpus0to15 test parm1 parm2
```
To run the ls -l command on CPU 0, type:
```
execrset -c 0 -e ls -l
```

Files

/usr/bin/execrset

Contains the execrset command.

Related Information

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