PSRSET(8)

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 9.5