manual/util-linux/original/man1/chrt.1

   1 '\" t
   2 .\"     Title: chrt
   3 .\"    Author: [see the "AUTHOR(S)" section]
   4 .\" Generator: Asciidoctor 2.0.15
   5 .\"      Date: 2022-02-17
   6 .\"    Manual: User Commands
   7 .\"    Source: util-linux 2.38
   8 .\"  Language: English
   9 .\"
  10 .TH "CHRT" "1" "2022-02-17" "util\-linux 2.38" "User Commands"
  11 .ie \n(.g .ds Aq \(aq
  12 .el       .ds Aq '
  13 .ss \n[.ss] 0
  14 .nh
  15 .ad l
  16 .de URL
  17 \fI\\$2\fP <\\$1>\\$3
  18 ..
  19 .als MTO URL
  20 .if \n[.g] \{\
  21 .  mso www.tmac
  22 .  am URL
  23 .    ad l
  24 .  .
  25 .  am MTO
  26 .    ad l
  27 .  .
  28 .  LINKSTYLE blue R < >
  29 .\}
  30 .SH "NAME"
  31 chrt \- manipulate the real\-time attributes of a process
  32 .SH "SYNOPSIS"
  33 .sp
  34 \fBchrt\fP [options] \fIpriority command argument\fP ...
  35 .sp
  36 \fBchrt\fP [options] \fB\-p\fP [\fIpriority\fP] \fIPID\fP
  37 .SH "DESCRIPTION"
  38 .sp
  39 \fBchrt\fP sets or retrieves the real\-time scheduling attributes of an existing \fIPID\fP, or runs \fIcommand\fP with the given attributes.
  40 .SH "POLICIES"
  41 .sp
  42 \fB\-o\fP, \fB\-\-other\fP
  43 .RS 4
  44 Set scheduling policy to \fBSCHED_OTHER\fP (time\-sharing scheduling). This is the default Linux scheduling policy.
  45 .RE
  46 .sp
  47 \fB\-f\fP, \fB\-\-fifo\fP
  48 .RS 4
  49 Set scheduling policy to \fBSCHED_FIFO\fP (first in\-first out).
  50 .RE
  51 .sp
  52 \fB\-r\fP, \fB\-\-rr\fP
  53 .RS 4
  54 Set scheduling policy to \fBSCHED_RR\fP (round\-robin scheduling). When no policy is defined, the \fBSCHED_RR\fP is used as the default.
  55 .RE
  56 .sp
  57 \fB\-b\fP, \fB\-\-batch\fP
  58 .RS 4
  59 Set scheduling policy to \fBSCHED_BATCH\fP (scheduling batch processes). Linux\-specific, supported since 2.6.16. The priority argument has to be set to zero.
  60 .RE
  61 .sp
  62 \fB\-i\fP, \fB\-\-idle\fP
  63 .RS 4
  64 Set scheduling policy to \fBSCHED_IDLE\fP (scheduling very low priority jobs). Linux\-specific, supported since 2.6.23. The priority argument has to be set to zero.
  65 .RE
  66 .sp
  67 \fB\-d\fP, \fB\-\-deadline\fP
  68 .RS 4
  69 Set scheduling policy to \fBSCHED_DEADLINE\fP (sporadic task model deadline scheduling). Linux\-specific, supported since 3.14. The priority argument has to be set to zero. See also \fB\-\-sched\-runtime\fP, \fB\-\-sched\-deadline\fP and \fB\-\-sched\-period\fP. The relation between the options required by the kernel is runtime \(lA deadline \(lA period. \fBchrt\fP copies \fIperiod\fP to \fIdeadline\fP if \fB\-\-sched\-deadline\fP is not specified and \fIdeadline\fP to \fIruntime\fP if \fB\-\-sched\-runtime\fP is not specified. It means that at least \fB\-\-sched\-period\fP has to be specified. See \fBsched\fP(7) for more details.
  70 .RE
  71 .SH "SCHEDULING OPTIONS"
  72 .sp
  73 \fB\-T\fP, \fB\-\-sched\-runtime\fP \fInanoseconds\fP
  74 .RS 4
  75 Specifies runtime parameter for \fBSCHED_DEADLINE\fP policy (Linux\-specific).
  76 .RE
  77 .sp
  78 \fB\-P\fP, \fB\-\-sched\-period\fP \fInanoseconds\fP
  79 .RS 4
  80 Specifies period parameter for \fBSCHED_DEADLINE\fP policy (Linux\-specific).
  81 .RE
  82 .sp
  83 \fB\-D\fP, \fB\-\-sched\-deadline\fP \fInanoseconds\fP
  84 .RS 4
  85 Specifies deadline parameter for \fBSCHED_DEADLINE\fP policy (Linux\-specific).
  86 .RE
  87 .sp
  88 \fB\-R\fP, \fB\-\-reset\-on\-fork\fP
  89 .RS 4
  90 Use \fBSCHED_RESET_ON_FORK\fP or \fBSCHED_FLAG_RESET_ON_FORK\fP flag. Linux\-specific, supported since 2.6.31.
  91 .RE
  92 .sp
  93 Each thread has a \fIreset\-on\-fork\fP scheduling flag. When this flag is set, children created by \fBfork\fP(2) do not inherit privileged scheduling policies. After the \fIreset\-on\-fork\fP flag has been enabled, it can be reset only if the thread has the \fBCAP_SYS_NICE\fP capability. This flag is disabled in child processes created by \fBfork\fP(2).
  94 .sp
  95 More precisely, if the \fIreset\-on\-fork\fP flag is set, the following rules apply for subsequently created children:
  96 .sp
  97 .RS 4
  98 .ie n \{\
  99 \h'-04'\(bu\h'+03'\c
 100 .\}
 101 .el \{\
 102 .  sp -1
 103 .  IP \(bu 2.3
 104 .\}
 105 If the calling thread has a scheduling policy of \fBSCHED_FIFO\fP or \fBSCHED_RR\fP, the policy is reset to \fBSCHED_OTHER\fP in child processes.
 106 .RE
 107 .sp
 108 .RS 4
 109 .ie n \{\
 110 \h'-04'\(bu\h'+03'\c
 111 .\}
 112 .el \{\
 113 .  sp -1
 114 .  IP \(bu 2.3
 115 .\}
 116 If the calling process has a negative nice value, the nice value is reset to zero in child processes.
 117 .RE
 118 .SH "OPTIONS"
 119 .sp
 120 \fB\-a\fP, \fB\-\-all\-tasks\fP
 121 .RS 4
 122 Set or retrieve the scheduling attributes of all the tasks (threads) for a given PID.
 123 .RE
 124 .sp
 125 \fB\-m\fP, \fB\-\-max\fP
 126 .RS 4
 127 Show minimum and maximum valid priorities, then exit.
 128 .RE
 129 .sp
 130 \fB\-p\fP, \fB\-\-pid\fP
 131 .RS 4
 132 Operate on an existing PID and do not launch a new task.
 133 .RE
 134 .sp
 135 \fB\-v\fP, \fB\-\-verbose\fP
 136 .RS 4
 137 Show status information.
 138 .RE
 139 .sp
 140 \fB\-h\fP, \fB\-\-help\fP
 141 .RS 4
 142 Display help text and exit.
 143 .RE
 144 .sp
 145 \fB\-V\fP, \fB\-\-version\fP
 146 .RS 4
 147 Print version and exit.
 148 .RE
 149 .SH "USAGE"
 150 .sp
 151 The default behavior is to run a new command:
 152 .RS 4
 153 \fBchrt\fP \fIpriority\fP \fIcommand\fP [\fIarguments\fP]
 154 .RE
 155 .sp
 156 You can also retrieve the real\-time attributes of an existing task:
 157 .RS 4
 158 \fBchrt \-p\fP \fIPID\fP
 159 .RE
 160 .sp
 161 Or set them:
 162 .RS 4
 163 \fBchrt \-r \-p\fP \fIpriority PID\fP
 164 .RE
 165 .SH "PERMISSIONS"
 166 .sp
 167 A user must possess \fBCAP_SYS_NICE\fP to change the scheduling attributes of a process. Any user can retrieve the scheduling information.
 168 .SH "NOTES"
 169 .sp
 170 Only \fBSCHED_FIFO\fP, \fBSCHED_OTHER\fP and \fBSCHED_RR\fP are part of POSIX 1003.1b Process Scheduling. The other scheduling attributes may be ignored on some systems.
 171 .sp
 172 Linux\(aq default scheduling policy is \fBSCHED_OTHER\fP.
 173 .SH "AUTHORS"
 174 .sp
 175 .MTO "rml\(attech9.net" "Robert Love" ","
 176 .MTO "kzak\(atredhat.com" "Karel Zak" ""
 177 .SH "SEE ALSO"
 178 .sp
 179 \fBnice\fP(1),
 180 \fBrenice\fP(1),
 181 \fBtaskset\fP(1),
 182 \fBsched\fP(7)
 183 .sp
 184 See \fBsched_setscheduler\fP(2) for a description of the Linux scheduling scheme.
 185 .SH "REPORTING BUGS"
 186 .sp
 187 For bug reports, use the issue tracker at \c
 188 .URL "https://github.com/util\-linux/util\-linux/issues" "" "."
 189 .SH "AVAILABILITY"
 190 .sp
 191 The \fBchrt\fP command is part of the util\-linux package which can be downloaded from \c
 192 .URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."