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.

Where the system has symmetric multithreading (SMT), is is recommended that CPUs representing different threads within a single core are not assigned to different processor sets.

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.

January 9, 2020 | NetBSD 10.1