.\" Copyright (c) 1994, Henrik Vestergaard Draboel
.\" 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 Henrik Vestergaard Draboel.
.\" 4.  The name of the author may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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.
.\"
.\" %FreeBSD: src/lib/libc/sys/rtprio. 2, v 1.13. 2.9 2001/12/14 18:34:01 ru Exp %
.\"
.\" $FreeBSD: doc/ja_JP.eucJP/man/man2/rtprio. 2, v 1.9 2001/12/23 00:03:42 horikawa Exp $
.Dd July 23, 1994
.Dt RTPRIO 2
.Os
.Sh 명칭
.Nm rtprio
.Nd 유틸리티나 프로세스의 리얼타임 / 아이돌 우선 순위의 취득과 수정
.Sh 프로그램 라이브러리
.Lb libc
.Sh 서식
.In sys/types.h
.In sys/rtprio.h
.Ft int
.Fn rtprio "int function" "pid_t pid" "struct rtprio *rtp"
.Sh 해설
.Fn rtprio
(을)를 사용해,
프로세스의 리얼타임 / 아이돌 우선 순위를 취득 또는 변경합니다.
.Pp
.Fa function
그리고 실행하는 조작을 지정합니다. 현재의 우선 순위를 취득하려면
RTP_LOOKUP, 우선 순위를 설정하려면 RTP_SET 입니다.
.Fa pid
(은)는, 대상의 프로세스를 지정합니다. 현재의 프로세스를 지정하려면 0 을 사용합니다.
.Pp
.Fa *rtp
(은)는, 우선 순위와 우선 순위의 타입을 지정하는데 사용하는 struct rtprio 를 가리킨다
포인터입니다. 이 구조체는 다음의 형태입니다.
.Bd -literal
struct rtprio {
	u_short	type;
	u_short prio;
};
.Ed
.Pp
.Nm type
의 값은, 리얼타임 우선 순위에 대해서는 RTP_PRIO_REALTIME,
통상의 우선 순위에 대해서는 RTP_PRIO_NORMAL,
아이돌 우선 순위에 대해서는 RTP_PRIO_IDLE 입니다.
.Nm prio
에 의해 지정하는 우선 순위는, 0 으로부터
.Dv RTP_PRIO_MAX (통상은 31)
의 범위가 됩니다. 0 이 지정 가능한 최고의 우선 순위입니다.
.Pp
리얼타임 우선 순위와 아이돌 우선 순위는,
fork()와 exec()를 통해서 계승됩니다.
.Pp
리얼타임 프로세스는, 그 이상의 우선 순위를 가지는 프로세스,
또는 끼어들어 에 의해서만 우선권을 취득할 수 있습니다.
아이돌 우선 순위의 프로세스는,
다른 리얼타임 또는 통상의 우선 순위 프로세스가
실행 가능하지 않을 때에만 실행됩니다.
우선 순위의 높은 리얼 / 아이돌의 프로세스는
우선 순위의 낮은 리얼 / 아이돌의 프로세스로부터 우선권을 취득합니다.
우선 순위가 동일한 리얼 / 아이돌의
프로세스는 라운드로빈 방식에서 실행됩니다.
.Sh 반환값
.Rv -std rtprio
.Sh 에러
.Fn rtprio
(은)는 다음의 경우에 처리를 실패합니다.
.Bl -tag -width Er
.It Bq Er EINVAL
지정되었다
.Fa prio
하지만 범위외였습니다.
.It Bq Er EPERM
호출 프로세스가 리얼타임 우선 순위를 설정할 수 없습니다.
root 만이 임의의 프로세스의 리얼 우선 순위를 변경할 수가 있습니다.
root 가 아닌 유저는 현재의 프로세스의 아이돌 우선 순위를 변경할 수 있을 뿐입니다.
.It Bq Er ESRCH
지정의 프로세스가 발견되지 않았습니다.
.El
.Sh 저자
.An -nosplit
오리지날의 저자는
.An Henrik Vestergaard Draboel Aq hvd@terry.ping.dk
입니다.
.Fx
에서의 실장은
.An David Greenman
에 의해 본질적으로 고쳐 써졌습니다.
.Sh 관련 항목
.Xr nice 1 ,
.Xr ps 1 ,
.Xr rtprio 1 ,
.Xr setpriority 2 ,
.Xr nice 3 ,
.Xr renice 8