Index for Section 1

Alphabetical listing for R

Bottom of page

runon(1)
NAME
  runon - Runs a command on a specific CPU or processor set

SYNOPSIS
  runon cpu_num command [argument...]

  runon -p  [-x] pset_id command [argument...]

  runon -r  rad_id  command [argument...]

DESCRIPTION
  The runon utility runs the specified command (command) on the specified CPU
  (cpu_num), Processor Set (pset) or Resource Affinity Domain (RAD). The
  argument variable specifies any options or arguments for the specified
  command.  All the threads created by the command inherit the CPU binding to
  the specified CPU (cpu_num), including threads created as the result of a
  fork.

  If the -p option is used, the specified command is bound to a processor set
  rather than to a specific processor.	Because a processor set can contain
  more than one processor, the -p option is useful for multi-threaded
  applications.	 In addition, you can use the -x option to specify exclusive
  access to a processor set.

OPTIONS
  -p  Binds to a processor set instead of a processor.	 You must specify the
      processor set identification number (pset_id), which is a unique
      integer that identifies the processor set and is returned by the
      pset_create command.

      You can specify the -x option with the -p option.

  -r  Invokes Resource Affinity Domain (RAD) binding, which binds the command
      to a RAD identifier (rad_id) instead of an individual processor or
      pset. The RAD structure holds data associated with a NUMA building
      block.

      In this release, and for the purpose of using the runon command, a RAD
      is analogous to a hardware Quad Building Block or QBB. The hardware QBB
      identifier also identifies the RAD. However, in future releases a RAD
      will be defined as a related set of memory, processors, and I/O that
      might not map to a discrete QBB.

  -x  Specifies exclusive use of a processor set. Use the -x option only with
      the -p option.





SEE ALSO
  Commands:  pset_assign_cpu(1), pset_assign_pid(1), pset_create(1),
  pset_info(1), psradm(8)

  Files:  processor_sets(4)

  Other:  numa_intro(3)

Index for Section 1

Alphabetical listing for R

Top of page