procutils: include missing header

[thirdparty/util-linux.git] / schedutils / chrt.1

.\" chrt(1) manpage
.\"
.\" Copyright (C) 2004 Robert Love
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
.\" 2002-05-11 Robert Love <rml@tech9.net>
.\" 	Initial version
.\"
.TH CHRT "1" "June 2010" "schedutils" "Linux User's Manual"
.SH NAME
chrt \- manipulate real-time attributes of a process
.SH SYNOPSIS
.B chrt
.RI [ options ]\  prio
.IR command\  [ arg ]...
.br
.B chrt
.RI [ options ]
.B \-p
.RI [ prio ]\  pid
.SH DESCRIPTION
.PP
.BR chrt (1)
sets or retrieves the real-time scheduling attributes of an existing PID, or
runs COMMAND with the given attributes.  Both policy (one of
.BR SCHED_OTHER ,
.BR SCHED_FIFO ,
.BR SCHED_RR ,
.BR SCHED_BATCH ,
or
.BR SCHED_IDLE )
and priority can be set and retrieved.
.PP
The
.BR SCHED_BATCH
policy is supported since Linux 2.6.16. The
.BR SCHED_IDLE
policy is supported since Linux 2.6.23.
.PP
The
.BR SCHED_RESET_ON_FORK
flag for policies SCHED_RR and SCHED_FIFO is supported
since Linux 2.6.31.
.SH OPTIONS
.TP
.B -p, --pid
operate on an existing PID and do not launch a new task
.TP
.B -b, --batch
set scheduling policy to
.BR SCHED_BATCH
(Linux specific)
.TP
.B -f, --fifo
set scheduling policy to
.BR SCHED_FIFO
.TP
.B -i, --idle
set scheduling policy to
.BR SCHED_IDLE
(Linux specific)
.TP
.B -m, --max
show minimum and maximum valid priorities, then exit
.TP
.B -o, --other
set policy scheduling policy to
.BR SCHED_OTHER
.TP
.B -r, --rr
set scheduling policy to
.BR SCHED_RR
(the default)
.TP
.B -R, --reset-on-fork
add
.B SCHED_RESET_ON_FORK
flag to the
.B SCHED_FIFO
or
.B SCHED_RR
scheduling policy (Linux specific)
.TP
.B -v, --verbose
show status information
.TP
.B -h, --help
display usage information and exit
.TP
.B -V, --version
display version information and exit
.SH USAGE
.TP
The default behavior is to run a new command::
chrt prio command [arguments]
.TP
You can also retrieve the real-time attributes of an existing task:
chrt -p pid
.TP
Or set them:
chrt -p prio pid
.SH PERMISSIONS
A user must possess
.BR CAP_SYS_NICE
to change the scheduling attributes of a process.  Any user can retrieve the
scheduling information.
.SH NOTES
Only
.BR SCHED_FIFO ,
.BR SCHED_OTHER
and
.BR SCHED_RR
are part of POSIX 1003.1b Process Scheduling. The other scheduling attributes
may be ignored on some systems.
.SH AUTHOR
Written by Robert M. Love.
.SH COPYRIGHT
Copyright \(co 2004 Robert M. Love
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH "SEE ALSO"
.BR taskset (1),
.BR nice (1),
.BR renice (1)
.sp
See
.BR sched_setscheduler (2)
for a description of the Linux scheduling scheme.
.SH AVAILABILITY
The chrt command is part of the util-linux package and is available from
ftp://ftp.kernel.org/pub/linux/utils/util-linux/.