.\" Copyright (c) 1980, 1991, 1993 .\" 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 8.1 (Berkeley) 6/4/93 .\" %FreeBSD: src/lib/libc/sys/getpriority. 2, v 1.4. 2.5 2001/12/14 18:34:00 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/getpriority. 2, v 1.8 2001/12/23 00:03:42 horikawa Exp $ .Dd June 4, 1993 .Dt GETPRIORITY 2 .Os .Sh 명칭 .Nm getpriority , .Nm setpriority .Nd 프로그램 스케줄 우선 순위를 취득 / 설정 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/time.h .In sys/resource.h .Ft int .Fn getpriority "int which" "int who" .Ft int .Fn setpriority "int which" "int who" "int prio" .Sh 해설 .Fa which 및 .Fa who 그리고 지시받는 프로세스, 프로세스 그룹, 또는 유저의 스케줄 우선 순위는 .Fn getpriority 호출로 취득되어 .Fn setpriority 호출로 설정됩니다. .Fa which (은)는, .Dv PRIO_PROCESS , .Dv PRIO_PGRP 또는 .Dv PRIO_USER 의 어떤 것인가여, .Fa who 하 .Fa which 에 관련해 해석됩니다 .Dv ( PRIO_PROCESS 의 경우는 프로세스 식별자, .Dv PRIO_PGRP 의 경우는 프로세스 그룹 식별자, 및 .Dv PRIO_USER 의 경우는 유저 ID). .Fa who 의 값이 0 인 것은, 현재의 프로세스, 프로세스 그룹, 또는 유저를 나타냅니다. .Fa prio (은)는 -20 으로부터 20 의 범위의 값입니다. 디폴트의 우선 순위는 0 입니다. 우선 순위가 낮으면 스케줄 조정에는 보다 형편이 좋아집니다. .Pp .Fn getpriority 호출은, 지정의 프로세스중 한쪽이 향수하는 최고의 우선 순위를 돌려주어 옵니다 (가장 작은 수치입니다). .Fn setpriority 호출은, 지정된 모든 프로세스의 우선 순위를 지정의 값에 설정합니다. 슈퍼 유저만이 우선 순위를 낮게 할 수 있습니다. .Sh 반환값 .Fn getpriority (은)는 처리를 올바르게 완료해도 값 -1 을 돌려주는 일이 있으므로, 호출 전에 외부 변수 .Va errno (을)를 클리어 하고 나서, 후에 이것을 체크해 -1 가 에러인지, 또는 정당한 값인지 판정할 필요가 있습니다. .Pp .Rv -std setpriority .Sh 에러 .Fn getpriority (와)과 .Fn setpriority (은)는 다음의 경우에 실패합니다. .Bl -tag -width Er .It Bq Er ESRCH 지정되었다 .Fa which (와)과 .Fa who 의 값을 사용해, 프로세스가 발견되지 않았습니다. .It Bq Er EINVAL .Fa which 하지만 .Dv PRIO_PROCESS , .Dv PRIO_PGRP 또는 .Dv PRIO_USER 의 어떤 것이기도 하지 않았습니다. .El .Pp .Bl -tag -width Er 상기의 에러 뿐만이 아니라, .Fn setpriority (은)는 다음의 경우에 실패합니다. .It Bq Er EPERM 프로세스는 검출되었지만, 그 실효 ID 도 열매 유저 ID 의 어느쪽이나, 호출측의 실효 유저 ID 에 일치하지 않았습니다. .It Bq Er EACCES 슈퍼 유저가 아닌 것이 프로세스의 우선 순위를 내리려고 했습니다. .El .Sh 관련 항목 .Xr nice 1 , .Xr fork 2 , .Xr renice 8 .Sh 역사 .Fn getpriority 함수는 .Bx 4.2 그리고 처음 등장했습니다.