runon(1)						      General Commands Manual							  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

       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.  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,  pro-
	      cessors,	and I/O that might not map to a discrete QBB.  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)

																	  runon(1)