psrset(8) - NetBSD Manual Pages

PSRSET(8)               NetBSD 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.

NetBSD 9.4_STABLE             September 23, 2008             NetBSD 9.4_STABLE