SCHEDCTL(8)						    BSD System Manager's Manual 					       SCHEDCTL(8)

NAME

     schedctl -- control scheduling of processes and threads

SYNOPSIS

     schedctl [-A cpus] [-C class] [-P pri] [-t lid] -p pid | command

DESCRIPTION

     The schedctl command can be used to control the scheduling of processes and threads.  It also returns information about the current schedul-
     ing parameters of the process or thread.  Only the super-user may change the scheduling parameters.  schedctl can also be used to start a new
     command using the specified parameters.

     Available options:

     -A cpus	Set of the processors on which process or thread should run, that is, affinity.  Processors are defined as numbers (starting from
		zero) and separated by commas.	A value of -1 is used to unset the affinity.

     -C class	Scheduling class (policy), one of:

		SCHED_OTHER   Time-sharing (TS) scheduling policy.  The default policy in NetBSD.

		SCHED_FIFO    First in, first out (FIFO) scheduling policy.

		SCHED_RR      Round-robin scheduling policy.

     -P pri	Priority for the process or thread.  Value should be in the range from SCHED_PRI_MIN (0) to SCHED_PRI_MAX (63).  Setting of prior-
		ity for the process or thread running at SCHED_OTHER policy is not allowed.

     -p pid	The target process which will be affected.  If the process has more than one thread, all of them will be affected.

		If -p is not given, a command to execute must be given on the command line.

     -t lid	Thread in the specified process.  If specified, only this thread in the process will be affected.  May only be specified if -p is
		also given.

EXAMPLES

     Show scheduling information about the process whose ID is ``123'':

	   # schedctl -p 123

     Set the affinity to CPU 0 and CPU 1, policy to SCHED_RR, and priority to 63 for thread whose ID is ``1'' in process whose ID is ``123'':

	   # schedctl -p 123 -t 1 -A 0,1 -C SCHED_RR -P 63

     Run the top(1) command with real-time priority:

	   # schedctl -C SCHED_FIFO top

SEE ALSO

     nice(1), getpriority(2), setpriority(2), psrset(8), renice(8)

HISTORY

     The schedctl command first appeared in NetBSD 5.0.

BSD
								  March 21, 2011							       BSD