usr/src/lib/libc/gen/nice.3

.\" Copyright (c) 1980, 1991, 1993
.\"     The Regents of the University of California.  All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)nice.3      8.1 (Berkeley) %G%
.\"
.Dd
.Dt NICE 3
.Os BSD 4
.Sh NAME
.Nm nice
.Nd set program scheduling priority
.Sh SYNOPSIS
.Fn nice "int incr"
.Sh DESCRIPTION
.Bf -symbolic
This interface is obsoleted by setpriority(2).
.Ef
.Pp
The
.Fn nice
function obtains the scheduling priority of the process
from the system and sets it to the priority value specified in
.Fa incr .
The priority is a value in the range -20 to 20.
The default priority is 0; lower priorities cause more favorable scheduling.
Only the super-user may lower priorities.
.Pp
Children inherit the priority of their parent processes via
.Xr fork 2 .
.Sh SEE ALSO
.Xr nice 1 ,
.Xr setpriority 2 ,
.Xr fork 2 ,
.Xr renice 8
.Sh HISTORY
A
.Fn nice
syscall appeared in
.At v6 .