NAME

psrset - control processor sets

SYNOPSIS

psrset [setid ...] psrset -a setid cpuid ... psrset -b setid pid ... psrset -c[ cpuid ...] psrset -d setid psrset -e setid command psrset -i[ setid ...] psrset -p psrset -r cpuid ... psrset -u pid ...

DESCRIPTION

The psrset command can be used to control and inspect processor sets.

The system always contains at least one processor set: the default set. The default set must contain at least one online processor (CPU) at all times.

Available options:

-a
Assign one or more processors (CPUs) to the set setid. In the current implementation, a CPU may only be present in one set. CPU IDs are as reported and used by the cpuctl(8) command.

-b
Bind one or more processes to the set setid. All LWPs within the processes will be affected. Bindings are inherited when new LWPs or processes are forked. However, setting a new binding on a parent process does not affect the bindings of its existing child processes.

-c
Create a new processor set. If successful, the ID of the new set will be printed. If a list of CPU IDs is provided, those CPUs will be assigned to the set upon creation. Otherwise, the set will be created empty.

-d
Delete the processor set specified by setid. Any LWPs bound to the set will be re-bound to the default processor set.

-e
Execute a command within the processor set specified by setid.

-i
List all processor sets. For each set, print the member CPUs. If psrset is run without any options, it behaves as if -i were given.

-p
List all CPUs. For each CPU, print the associated processor set.

-r
Remove a CPU from its current set, and return it back to the default processor set.

-u
Bind the specified processes to the system default processor set.

SEE ALSO

pset(3), cpuctl(8), schedctl(8)

HISTORY

The psrset command first appeared in NetBSD5.0.