PSRSET(8) | System Manager's Manual | PSRSET(8)

# 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 NetBSD 5.0.

September 23, 2008 | NetBSD 6.0