nice.1 (1357B)
- .\" utils-std: Collection of commonly available Unix tools
- .\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
- .\" SPDX-License-Identifier: MPL-2.0
- .Dd 2024-04-18
- .Dt NICE 1
- .Os
- .Sh NAME
- .Nm nice
- .Nd invoke command with modified nice scheduling value
- .Sh SYNOPSIS
- .Nm
- .Op Fl n Ar increment
- .Ar command
- .Op Ar argument...
- .Sh DESCRIPTION
- .Nm
- runs
- .Ar command
- with a modified niceness, changing the scheduling of the process.
- .Pp
- As required by POSIX, if the user lacks the privileges to change the niceness a warning message is printed to stderr but the execution continues and
- .Ar command
- gets executed, without it's niceness changed.
- .Sh OPTIONS
- .Bl -tag -width Ds
- .It Fl n Ar increment
- Positive or negative integer used to adjust the niceness of the process. (default: 0)
- .El
- .Sh EXIT STATUS
- If
- .Ar command
- is invoked, the exit status of
- .Nm
- shall be the exit status of
- .Ar command ;
- Otherwise, the
- .Nm
- utility shall exit with one of the following values:
- .Bl -tag -width Ds
- .It 125
- An error occurred within the
- .Nm
- utility.
- .It 126
- .Ar command
- was found but couldn't be invoked.
- .It 127
- .Ar command
- wasn't found.
- .El
- .Sh SEE ALSO
- .Xr renice 1 ,
- .Xr nice 3
- .Sh STANDARDS
- .Nm
- should be compliant with the
- IEEE Std 1003.1-2024 (“POSIX.1”)
- specification.
- .Sh AUTHORS
- .An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me