~ubuntu-branches/ubuntu/utopic/eglibc/utopic

« back to all changes in this revision

Viewing changes to linuxthreads/man/pthread_setschedparam.man

  • Committer: Package Import Robot
  • Author(s): Adam Conrad
  • Date: 2012-10-26 05:14:58 UTC
  • mfrom: (1.5.1) (4.4.22 experimental)
  • Revision ID: package-import@ubuntu.com-20121026051458-oryotr4i03ob5pab
Tags: 2.16-0ubuntu1
* Merge with unreleased 2.16 in Debian experimental, remaining changes:
  - Drop the Breaks line from libc6, which refers to a Debian transition
  - Remove the libc6 recommends on libc6-i686, which we don't build
  - Enable libc6{,-dev}-armel on armhf and libc6{-dev}-armhf on armel
  - Ship update-locale and validlocale in /usr/sbin in libc-bin
  - Don't build locales or locales-all in Ubuntu, we rely on langpacks
  - Heavily mangle the way we do service restarting on major upgrades
  - Use different MIN_KERNEL_SUPPORTED versions than Debian, due to
    buildd needs.  This should be universally bumped to 3.2.0 once all
    our buildds (including the PPA guests) are running precise kernels
  - Build i386 variants as -march=i686, build amd64 with -O3, and build
    ppc64 variants (both 64-bit and 32-bit) with -O3 -fno-tree-vectorize
  - Re-enable unsubmitted-ldconfig-cache-abi.diff and rebuild the cache
    on upgrades from previous versions that used a different constant
  - debian/patches/any/local-CVE-2012-3406.diff: switch to malloc when
    array grows too large to handle via alloca extension (CVE-2012-3406)
  - Build generic i386/i686 flavour with -mno-tls-direct-seg-refs
* Changes added/dropped with this merge while reducing our delta:
  - Stop building glibc docs from the eglibc source, and instead make
    the glibc-docs stub have a hard dependency on glibc-doc-reference
  - Remove outdated conflicts against ancient versions of ia32-libs
  - Drop the tzdata dependency from libc6, it's in required and minimal
  - Use gcc-4.7/g++-4.7 by default on all our supported architectures
  - Save our historical changelog as changelog.ubuntu in the source
  - Drop nscd's libaudit build-dep for now, as libaudit is in universe
  - Drop the unnecessary Breaks from libc6 to locales and locales-all
  - Ship xen's ld.so.conf.d snippet as /etc/ld.so.conf.d/libc6-xen.conf
* Disable hard failures on the test suite for the first upload to raring

Show diffs side-by-side

added added

removed removed

Lines of Context:
14
14
 
15
15
.SH DESCRIPTION
16
16
 
17
 
!pthread_setschedparam! sets the scheduling parameters for the thread
18
 
|target_thread| as indicated by |policy| and |param|. |policy| can be
19
 
either !SCHED_OTHER! (regular, non-realtime scheduling), !SCHED_RR!
20
 
(realtime, round-robin) or !SCHED_FIFO! (realtime, first-in
21
 
first-out). |param| specifies the scheduling priority for the two
22
 
realtime policies.  See !sched_setpolicy!(2) for more information on
 
17
\fBpthread_setschedparam\fP sets the scheduling parameters for the thread
 
18
\fItarget_thread\fP as indicated by \fIpolicy\fP and \fIparam\fP. \fIpolicy\fP can be
 
19
either \fBSCHED_OTHER\fP (regular, non-realtime scheduling), \fBSCHED_RR\fP
 
20
(realtime, round-robin) or \fBSCHED_FIFO\fP (realtime, first-in
 
21
first-out). \fIparam\fP specifies the scheduling priority for the two
 
22
realtime policies.  See \fBsched_setpolicy\fP(2) for more information on
23
23
scheduling policies.
24
24
 
25
 
The realtime scheduling policies !SCHED_RR! and !SCHED_FIFO! are
 
25
The realtime scheduling policies \fBSCHED_RR\fP and \fBSCHED_FIFO\fP are
26
26
available only to processes with superuser privileges.
27
27
 
28
 
!pthread_getschedparam! retrieves the scheduling policy and scheduling
29
 
parameters for the thread |target_thread| and store them in the
30
 
locations pointed to by |policy| and |param|, respectively.
 
28
\fBpthread_getschedparam\fP retrieves the scheduling policy and scheduling
 
29
parameters for the thread \fItarget_thread\fP and store them in the
 
30
locations pointed to by \fIpolicy\fP and \fIparam\fP, respectively.
31
31
 
32
32
.SH "RETURN VALUE"
33
 
!pthread_setschedparam! and !pthread_getschedparam! return 0 on
 
33
\fBpthread_setschedparam\fP and \fBpthread_getschedparam\fP return 0 on
34
34
success and a non-zero error code on error.
35
35
 
36
36
.SH ERRORS
37
 
On error, !pthread_setschedparam! returns the following error codes:
 
37
On error, \fBpthread_setschedparam\fP returns the following error codes:
38
38
.RS
39
39
.TP
40
 
!EINVAL!
41
 
|policy| is not one of !SCHED_OTHER!, !SCHED_RR!, !SCHED_FIFO!
42
 
 
43
 
.TP
44
 
!EINVAL!
45
 
the priority value specified by |param| is not valid for the specified policy
46
 
 
47
 
.TP
48
 
!EPERM!
 
40
\fBEINVAL\fP
 
41
\fIpolicy\fP is not one of \fBSCHED_OTHER\fP, \fBSCHED_RR\fP, \fBSCHED_FIFO\fP
 
42
 
 
43
.TP
 
44
\fBEINVAL\fP
 
45
the priority value specified by \fIparam\fP is not valid for the specified policy
 
46
 
 
47
.TP
 
48
\fBEPERM\fP
49
49
the calling process does not have superuser permissions
50
50
 
51
51
.TP
52
 
!ESRCH!
53
 
the |target_thread| is invalid or has already terminated
 
52
\fBESRCH\fP
 
53
the \fItarget_thread\fP is invalid or has already terminated
54
54
 
55
55
.TP
56
 
!EFAULT!
57
 
|param| points outside the process memory space
 
56
\fBEFAULT\fP
 
57
\fIparam\fP points outside the process memory space
58
58
.RE
59
59
 
60
 
On error, !pthread_getschedparam! returns the following error codes:
 
60
On error, \fBpthread_getschedparam\fP returns the following error codes:
61
61
.RS
62
62
.TP
63
 
!ESRCH!
64
 
the |target_thread| is invalid or has already terminated
 
63
\fBESRCH\fP
 
64
the \fItarget_thread\fP is invalid or has already terminated
65
65
 
66
66
.TP
67
 
!EFAULT!
68
 
|policy| or |param| point outside the process memory space
 
67
\fBEFAULT\fP
 
68
\fIpolicy\fP or \fIparam\fP point outside the process memory space
69
69
.RE
70
70
 
71
71
.SH AUTHOR
72
72
Xavier Leroy <Xavier.Leroy@inria.fr>
73
73
 
74
74
.SH "SEE ALSO"
75
 
!sched_setscheduler!(2),
76
 
!sched_getscheduler!(2),
77
 
!sched_getparam!(2),
78
 
!pthread_attr_setschedpolicy!(3),
79
 
!pthread_attr_setschedparam!(3).
 
75
\fBsched_setscheduler\fP(2),
 
76
\fBsched_getscheduler\fP(2),
 
77
\fBsched_getparam\fP(2),
 
78
\fBpthread_attr_setschedpolicy\fP(3),
 
79
\fBpthread_attr_setschedparam\fP(3).