.\" Copyright (c) 1980, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)getpriority.2	6.9 (Berkeley) 3/10/91
.\"
.\" Modified 1993-07-24 by Rik Faith <faith@cs.unc.edu>
.\" Modified 1996-07-01 by Andries Brouwer <aeb@cwi.nl>
.\" Modified 1996-11-06 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified 2001-10-21 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"    Corrected statement under EPERM to clarify privileges required
.\" Modified 2002-06-21 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"    Clarified meaning of 0 value for 'who' argument
.\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
.\"         all rights reserved.
.\" Translated 1997-02-22, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\" Modified 2001-08-17, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\" Modified 2001-10-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" Updated 2001-12-13, Kentaro Shirakata <argrath@ub32.org>
.\" Updated 2002-10-16, Kentaro Shirakata <argrath@ub32.org>
.\" Updated 2005-02-24, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" Updated 2005-10-07, Akihiro MOTOKI
.\"
.\"WORD:	scheduling		塼
.\"WORD:	piority			ͥ
.\"WORD:	call			
.\"WORD:	user-ID			UID
.\"WORD:	process			ץ
.\"WORD:	user			桼
.\"WORD:	super user		ѡ桼
.\"WORD:	effective user-ID	¸UID
.\"WORD:	real user-ID		UID
.\"
.TH GETPRIORITY 2 2002-09-20 "Linux" "Linux Programmer's Manual"
.SH ̾
getpriority, setpriority \- ץΥ塼󥰤ͥ٤/ꤹ
.SH 
.B #include <sys/time.h>
.br
.B #include <sys/resource.h>
.sp
.BI "int getpriority(int " which ", int " who );
.br
.BI "int setpriority(int " which ", int " who ", int " prio );
.SH 
ƥॳ
.BR getpriority ()

.BR setpriority ()
ϡ
.I which

.I who
ǻꤵ줿ץץ롼ס桼
塼ͥ (scheduling priority) 
򤽤줾Ԥ

.I which
ͤ
.BR PRIO_PROCESS ,
.BR PRIO_PGRP ,
.BR PRIO_USER ,
Τɤ줫Ĥǡ
.I who

.I which
˱Ʋᤵ
.RB ( PRIO_PROCESS
ȥץ̻ҡ
.B PRIO_PGRP
ȥץ롼׼̻ҡ
.B PRIO_USER
 UID (桼ID) Ȳᤵ)
.I who
ʤС(줾)ƤӽФץ
ƤӽФץΥץ롼ס
ƤӽФץμUID ̣롣
.I prio
 \-20  19 ϰϤͤ (âʲդι򻲾ȤΤ)
ǥեȤͥ٤ 0 Ǥ;
ʿۤɡͭʥ塼󥰤Ȥʤ롣

.BR getpriority ()
ϻꤷץκǤ⤤ͥ (ŪˤϺǾ) ֤
.BR setpriority ()
ϻꤷץƤͥ٤ꤷͤꤹ롣
ͥ٤򺣤꾮ͤǤΤϥѡ桼Ǥ롣
.SH ֤
.BR getpriority ()
ˤ \-1 ֤ͤǽΤǡ
ƤӽФ˳ѿ
.I errno
򥯥ꥢƤӽФθ֤ͤ \-1 ͤ
顼Ƚ̤ɬפ롣
.BR setpriority ()
ϥ顼ʤ 0 ֤顼 \-1 ֤

.SH 顼
.TP
.B EINVAL
.I which

.BR PRIO_PROCESS ,
.BR PRIO_PGRP ,
.B PRIO_USER
ΤǤʤ
.TP
.B ESRCH
.I which

.I who
ǻꤵ줿ץ¸ߤʤ
.PP
嵭ΤΤ˲ä
.BR setpriority ()
ǤϰʲΥ顼:
.TP
.B EACCES
ƤӽФץͥ٤򲼤褦Ȥɬפø
äƤʤä (Linux ξ硢
.B CAP_SYS_NICE
ѥӥƥʤä)
Linux 2.6.12 ʹߤǤϡƤӽФץͥ٤
ѹоݤΥץΥ꥽
.B RLIMIT_NICE
ΥեȡߥåȤϰϳꤷ褦ȤˤΤߡ
Υ顼ȯ롣ܺ٤
.BR getrlimit (2)
򻲾ȡ
.TP
.B EPERM
ץϸĤäΥץμ¸ (effective) UID 
ƤӽФμ¸UID ˤ (real) UID ˤפ
ƤӽФøäƤʤä (Linux ξ硢
.B CAP_SYS_NICE
ѥӥƥʤä)
ʲΡաפ⻲ȤΤȡ
.SH 
SVr4, 4.4BSD (δؿ 4.2BSD Ǻǽо줷),
POSIX.1-2001.
.SH 
.BR fork (2)
Ǻ줿ҥץϡ
ƥץ nice ͤѾ롣
.BR execve (2)
 nice ͤ¸롣

.B EPERM
ȯξܺ٤ϥƥ˰¸롣
嵭 POSIX.1-2001 ΤΤǤꡢƤ System V ƥ
˽äƤ褦Ǥ롣
2.6.12  Linux ͥǤϡƤӽФμ UID ޤ
¸ UID ץ \fIwho\fP  (¸ UID Ǥʤ)
 UID ˰פɬפ롣
Linux 2.6.12 ʹߤǤϡƤӽФμ¹ UID ץ \fIwho\fP
μ UID ¸ UID Τ줫Ȱפɬפ롣
Ƥ BSD ƥ (SunOS 4.1.3, Ultrix 4.2,
4.3BSD, FreeBSD 4.3, OpenBSD-2.5) ϡ
2.6.12 ʹߤ Linux Ʊư򤹤롣
.LP
ºݤͥ٤ͤϰϤϥͥΥСˤäưۤʤ롣
1.3.36  Linux Ǥϡͥ٤ϰϤ̵  15 Ǥ롣
1.3.43 ʹߤ Linux Ǥϡͥ٤ϰϤ \-20  19 Ǥ롣
ͥǤϡnice ͤϼºݤˤ 40  1 ϰϤȤä
ɽƤ (ͤϥ顼ɤȤʤ뤿)ͤ
ƥॳ
.BR setpriority ()

.BR getpriority ()
ǻѤƤ롣
glibc ΤΥƥॳΥåѡؿˤơnice ͤ
桼ΰ (user-land) ȥͥɽδ֤ѴԤ롣
Ѵϰʲ̤:
.I "unice\ =\ 20\ \-\ knice"
.LP
ĤΥƥǤϡnice ͤϰϤ \20  20 Ǥ롣
.LP
ߤǤ
.I <sys/time.h>
򥤥󥯥롼ɤɬפϤʤ󥯥롼ɤаܿ뤳ȤǤ
(ºݤˤ
.I <sys/resource.h>

.I rusage
¤ΤƤ뤬ΥեɤǻѤƤ
.I struct timeval

.I <sys/time.h>
Ƥ)
.SH Ϣ
.BR nice (1),
.BR fork (2),
.BR capabilities (7),
.BR renice (8)