← Back to branch summary

~ubuntu-branches/ubuntu/trusty/util-linux/trusty-proposed

« back to all changes in this revision

Viewing changes to schedutils/chrt.1

  • Committer: Package Import Robot
  • Author(s): LaMont Jones
  • Date: 2011-11-03 15:38:23 UTC
  • mto: (4.5.5 sid) (1.6.4)
  • mto: This revision was merged to the branch mainline in revision 85.
  • Revision ID: package-import@ubuntu.com-20111103153823-10sx16jprzxlhkqf
Import upstream version 2.20.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
schedutils/chrt.1
25
25
.\" 2002-05-11 Robert Love <rml@tech9.net>
26
26
.\"     Initial version
27
27
.\"
28
 
.TH CHRT "1" "June 2010" "schedutils" "Linux User's Manual"
 
28
.TH CHRT 1 "June 2010" "util-linux" "User Commands"
29
29
.SH NAME
30
 
chrt \- manipulate real-time attributes of a process
 
30
chrt \- manipulate the real-time attributes of a process
31
31
.SH SYNOPSIS
32
32
.B chrt
33
33
.RI [ options ]\  prio
39
39
.RI [ prio ]\  pid
40
40
.SH DESCRIPTION
41
41
.PP
42
 
.BR chrt (1)
43
 
sets or retrieves the real-time scheduling attributes of an existing PID, or
44
 
runs COMMAND with the given attributes.  Both policy (one of
 
42
.B chrt
 
43
sets or retrieves the real-time scheduling attributes of an existing \fIpid\fR,
 
44
or runs \fIcommand\fR with the given attributes.  Both policy (one of
45
45
.BR SCHED_OTHER ,
46
46
.BR SCHED_FIFO ,
47
47
.BR SCHED_RR ,
52
52
.PP
53
53
The
54
54
.BR SCHED_BATCH
55
 
policy is supported since Linux 2.6.16. The
 
55
policy is supported since Linux 2.6.16.  The
56
56
.BR SCHED_IDLE
57
57
policy is supported since Linux 2.6.23.
58
58
.PP
62
62
since Linux 2.6.31.
63
63
.SH OPTIONS
64
64
.TP
65
 
.B -p, --pid
66
 
operate on an existing PID and do not launch a new task
 
65
.B -a, --all-tasks
 
66
Set or retrieve the scheduling attributes of all the tasks (threads) for a
 
67
given PID.
67
68
.TP
68
69
.B -b, --batch
69
 
set scheduling policy to
 
70
Set scheduling policy to
70
71
.BR SCHED_BATCH
71
 
(Linux specific)
 
72
(Linux specific).
72
73
.TP
73
74
.B -f, --fifo
74
 
set scheduling policy to
75
 
.BR SCHED_FIFO
 
75
Set scheduling policy to
 
76
.BR SCHED_FIFO .
76
77
.TP
77
78
.B -i, --idle
78
 
set scheduling policy to
 
79
Set scheduling policy to
79
80
.BR SCHED_IDLE
80
 
(Linux specific)
 
81
(Linux specific).
81
82
.TP
82
83
.B -m, --max
83
 
show minimum and maximum valid priorities, then exit
 
84
Show minimum and maximum valid priorities, then exit.
84
85
.TP
85
86
.B -o, --other
86
 
set policy scheduling policy to
87
 
.BR SCHED_OTHER
 
87
Set policy scheduling policy to
 
88
.BR SCHED_OTHER .
 
89
.TP
 
90
.B -p, --pid
 
91
Operate on an existing PID and do not launch a new task.
88
92
.TP
89
93
.B -r, --rr
90
 
set scheduling policy to
 
94
Set scheduling policy to
91
95
.BR SCHED_RR
92
 
(the default)
 
96
(the default).
93
97
.TP
94
98
.B -R, --reset-on-fork
95
 
add
 
99
Add
96
100
.B SCHED_RESET_ON_FORK
97
101
flag to the
98
102
.B SCHED_FIFO
99
103
or
100
104
.B SCHED_RR
101
 
scheduling policy (Linux specific)
 
105
scheduling policy (Linux specific).
102
106
.TP
103
107
.B -v, --verbose
104
 
show status information
 
108
Show status information.
105
109
.TP
106
110
.B -h, --help
107
 
display usage information and exit
 
111
Display usage information and exit.
108
112
.TP
109
113
.B -V, --version
110
 
display version information and exit
 
114
Display version information and exit.
111
115
.SH USAGE
112
116
.TP
113
 
The default behavior is to run a new command::
114
 
chrt prio command [arguments]
 
117
The default behavior is to run a new command:
 
118
.B chrt
 
119
.I prio
 
120
.IR command\  [ arguments ]
115
121
.TP
116
122
You can also retrieve the real-time attributes of an existing task:
117
 
chrt -p pid
 
123
.B chrt \-p
 
124
.I pid
118
125
.TP
119
126
Or set them:
120
 
chrt -p prio pid
 
127
.B chrt \-p
 
128
.I prio pid
121
129
.SH PERMISSIONS
122
130
A user must possess
123
131
.BR CAP_SYS_NICE