[unix-history] / usr / src / lib / libc / gen / nice.3

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)nice.3	6.2 (Berkeley) %G%
.\"
.TH NICE 3C ""
.UC 4
.SH NAME
nice \- set program priority
.SH SYNOPSIS
.B nice(incr)
.SH DESCRIPTION
.ft B
This interface is obsoleted by setpriority(2).
.ft R
.PP
The scheduling
priority of the process is augmented by
.IR incr .
Positive priorities get less
service than normal.
Priority 10 is recommended to users
who wish to execute long-running programs
without flak from the administration.
.PP
Negative increments are ignored except on behalf of 
the super-user.
The priority is limited to the range
\-20 (most urgent) to 20 (least).
.PP
The priority of a process is
passed to a child process by
.IR fork (2).
For a privileged process to return to normal priority
from an unknown state,
.I nice
should be called successively with arguments
\-40 (goes to priority \-20 because of truncation),
20 (to get to 0),
then 0 (to maintain compatibility with previous versions
of this call).
.SH "SEE ALSO"
nice(1), setpriority(2), fork(2), renice(8)
Commit	Line	Data
f42730df KM	1	.\" Copyright (c) 1980 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
79e6b3c8	5	.\" @(#)nice.3 6.2 (Berkeley) %G%
f42730df	6	.\"
707ea59c	7	.TH NICE 3C ""
f42730df KM	8	.UC 4
	9	.SH NAME
	10	nice \- set program priority
	11	.SH SYNOPSIS
	12	.B nice(incr)
	13	.SH DESCRIPTION
1eea0041 KM	14	.ft B
	15	This interface is obsoleted by setpriority(2).
	16	.ft R
	17	.PP
f42730df KM	18	The scheduling
	19	priority of the process is augmented by
	20	.IR incr .
	21	Positive priorities get less
	22	service than normal.
	23	Priority 10 is recommended to users
	24	who wish to execute long-running programs
	25	without flak from the administration.
	26	.PP
	27	Negative increments are ignored except on behalf of
	28	the super-user.
	29	The priority is limited to the range
	30	\-20 (most urgent) to 20 (least).
	31	.PP
	32	The priority of a process is
	33	passed to a child process by
	34	.IR fork (2).
	35	For a privileged process to return to normal priority
	36	from an unknown state,
	37	.I nice
	38	should be called successively with arguments
	39	\-40 (goes to priority \-20 because of truncation),
	40	20 (to get to 0),
	41	then 0 (to maintain compatibility with previous versions
	42	of this call).
	43	.SH "SEE ALSO"
1eea0041	44	nice(1), setpriority(2), fork(2), renice(8)