NAME

run - run a program

SYNOPSIS

run [-C cacheflags] [-b bias] [-m memflags] [ [-n nice] | [ [-s policy][-P priority] ] ] [-q quantum] [-t] [-u universe] command
run

DESCRIPTION

In the first form, run executes command in the environment described by the list of options, and exits with the command’s exit value.  The portion of the environment that may be set by run is

−C cacheflags
Runs command with the given cache flags.  Cacheflags is a comma-separated list of keywords specifying the cache mode to use for the stack and data regions.  Valid keywords are: copyback, writethrough, data_copyback, stack_copyback, data_writethrough, or stack_writethrough. 

−P priority
Runs command with the given priority.  Priority is an integer value that is valid for the current scheduling policy (see the -s option) Refer to sched_get_priority_min(3p4) and sched_get_priority_max(3p4) for information on determining the proper values.  max is also a valid priority value and will result in command running at the highest priority within its scheduling policy.  Only the super-user or a user with the ACC_SETPRI access vector can improve a process’s priority, i.e. make it higher than the default priority.  Higher numerical values represent more favorable scheduling priorities.  This option cannot be used at the same time as the -n option. 

−b bias
Runs command with the given CPU bias.  Only the super-user or a user with ACC_MPADVISE privilege can add processors to a bias.  Bias is a comma-separated list of CPU IDs or CPU ID ranges.  For example: "1,3-5,7". 

−m memflags
Runs command with the given memory flags.  Memflags is a comma-separated list of keywords requesting that some or all of a program be loaded into local memory.  Valid keywords are: global, local, hard, text_local, data_local, stack_local, pcb_local, text_hard, data_hard, stack_hard or pcb_hard. 

−n nice
Runs command with the given nice value.  Only the super-user or a user with the ACC_SETPRI privilege can lower a nice value.  This option cannot be used at the same time as the -s option or the -P option. 

−q quantum
Runs command with the given quantum.  Only the super-user or a user with the ACC_SETPRI privilege can increase a quantum. 

−s scheduling policy
Runs command under the specified scheduling policy.  Valid keywords are: SCHED_FIFO, SCHED_RR, and SCHED_OTHER.  Refer to sched_setscheduler(3p4) and sched_getscheduler(3p4) for more information on scheduling policies.  This option cannot be used at the same time as the -n option. 

−u universe
Runs command in the given universe. 

−t Time command, showing the elapsed, user, and system time, and a full description of the command’s resource usage, printed on standard error. 

In the second form run prints the current values of the above attributes. 

EXAMPLES

The command run -b 0-3 -n 10 make & runs make(1) in the background on any of CPUs 0-3 at a nice of 10. 

The command run -s SCHED_RR -P max date runs date(1) with the highest priority in the SCHED_RR (i.e. Round Robin) scheduling policy. 

SEE ALSO

universe(1), nice(1), renice(1), time(1),  rerun(1). 
memory(7), mpadvise(2), getpriority(2), getquantum(2), getuniverse(2), and cache(7) for descriptions of memory flags, CPU bias, nice, quantum, universe, nice values, and cache attributes. 
sched_get_priority_min(3p4), sched_get_priority_max(3p4), sched_getscheduler(3p4), sched_setscheduler(3p4), sched_getparam(3p4), and sched_setparam(3p4) for descriptions of priorities and scheduling policies. 

CX/UX User’s Reference Manual