Module Name: src
Committed By: yamt
Date: Fri Apr 13 15:14:27 UTC 2012
Modified Files:
src/lib/libc/sys: getpriority.2
Log Message:
- fix ambiguous sentences.
- mention scheduling class.
To generate a diff of this commit:
cvs rdiff -u -r1.18 -r1.19 src/lib/libc/sys/getpriority.2
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/sys/getpriority.2
diff -u src/lib/libc/sys/getpriority.2:1.18 src/lib/libc/sys/getpriority.2:1.19
--- src/lib/libc/sys/getpriority.2:1.18 Wed Mar 11 13:39:14 2009
+++ src/lib/libc/sys/getpriority.2 Fri Apr 13 15:14:27 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: getpriority.2,v 1.18 2009/03/11 13:39:14 joerg Exp $
+.\" $NetBSD: getpriority.2,v 1.19 2012/04/13 15:14:27 yamt Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)getpriority.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd April 25, 2004
+.Dd April 13, 2012
.Dt GETPRIORITY 2
.Os
.Sh NAME
@@ -55,6 +55,12 @@ is obtained with the
call and set with the
.Fn setpriority
call.
+.Pp
+The priority is maintained in a per-process basis and
+affects scheduling of LWPs which belong to the process and use the
+.Dv SCHED_OTHER
+scheduling class.
+.Pp
.Fa which
is one of
.Dv PRIO_PROCESS ,
@@ -78,7 +84,7 @@ denotes the current process, process gro
.Fa prio
is a value in the range -20 to 20.
The default priority is 0;
-lower priorities cause more favorable scheduling.
+numerically lower priority values cause more favorable scheduling.
A value of 19 or 20
will schedule a process only when nothing at priority \*(Le 0 is runnable.
.Pp
@@ -90,7 +96,7 @@ The
.Fn setpriority
call sets the priorities of all of the specified processes
to the specified value.
-Only the super-user may lower priorities.
+Only the super-user may lower priority values.
.Sh RETURN VALUES
Since
.Fn getpriority
@@ -133,11 +139,12 @@ will fail if:
A process was located, but neither its effective nor real user
ID matched the effective user ID of the caller.
.It Bq Er EACCES
-A non super-user attempted to lower a process priority.
+A non super-user attempted to lower a process priority value.
.El
.Sh SEE ALSO
.Xr nice 1 ,
.Xr fork 2 ,
+.Xr sched 3 ,
.Xr renice 8
.Sh HISTORY
The
