miser_cpuset(1)

NAME
     miser_cpuset - define and manage a set of CPUs

SYNOPSIS
     miser_cpuset  [-q queue [-A command]|[-c -f file]|[-d]|[-l][-m]|[-Q]] | -C | -Q

DESCRIPTION
     The miser_cpuset command is used to create and destroy cpusets, to
     retrieve information about existing cpusets, and to attach a process and
     all of its children to a cpuset.

     A cpuset is a named set of CPUs, which may be defined to be restricted or
     open. A restricted cpuset only allows processes that are members of the
     cpuset to run on the set of CPUs. An open cpuset allows any process to
     run on its cpus, but a process that is a member of the cpuset can only
     run on the CPUs belonging to the cpuset.

     A cpuset is defined by a cpuset configuration file and a name (see
     miser_cpuset(4) for a definition of the file format). The cpuset
     configuration file is used to list the CPUs that are members of the
     cpuset. It also contains any additional parameters required to define the
     cpuset. A cpuset name is between three and eight characters long; names
     of two or less characters are reserved.

     The file permissions of the configuration file define access to the
     cpuset. When permissions need to be checked, the current permissions of
     the file are used. It is therefore possible to change access to
     particular cpuset without having to tear it down and recreate it, simply
     by changing the access permissions.  Read access allows a user to
     retrieve information about a cpuset while execute permission allows the
     user to attach a process to the cpuset.

OPTIONS
     -q queue  -A command
          Runs the command on the cpuset identified by the -q parameter. If
          the user does not have access permissions or the cpuset does not
          exist, an error is returned.

     -q cpuset_name -c -f  filename
          Creates a cpuset with the configuration file specified by the -f
          parameter and the name specified by the -q parameter. If the cpuset
          name already exists, a CPU specified in the cpuset configuration
          file is already a member of a cpuset, or the user does not have the
          requisite permissions, the operation fails.

     -q cpuset_name -l
          Lists all the processes in the cpuset.

     -q cpuset_name -m
          Moves all the attached processes out of the cpuset.
     -q cpuset_name -d
          Destroys the specified cpuset. A cpuset can only be destroyed if
          there are no processes currently attached to it.

     -q cpuset_name -Q
          Prints a list of the cpus that belong to the cpuset.

     -C   Prints the name of the cpuset to which the process is currently
          attached.

     -Q   Lists the names of all the cpusets currently defined.

RESTRICTIONS
     A CPU can belong to at most one cpuset.

     CPU 0 cannot belong to an EXCLUSIVE cpuset.

     A CPU cannot be both restricted or isolated (see mpadmin(1) and sysmp(2))
     and also be a member of a cpuset.

     Only the superuser can create or destroy cpusets.

     runon(1) can not run a command on a cpu that is part of a cpuset unless
     the user has permission to access the cpuset.


SEE ALSO
     miser_cpuset(4), sysmp(2), mpadmin(1), runon(1).