.TH NICE 1 2022-03-06 "OMKOV coreutils" "General Commands Manual"
.SH NAME
nice \(em invoke with an altered nice value
.SH SYNOPSYS
\fBnice\fR [-n \fIincrement\fR] [\fIcommand\fR [\fIargument\fR...]]
.SH DESCRIPTION
Invoke \fIcommand\fR with the specified nice \fIincrement\fR value. If no
\fIincrement\fR is given, it will default to 10. If no \fIcommand\fR is given,
the current nice value will be output.
.SH OPTIONS
The following options are supported:
.TP
.B -n \fIincrement\fR
Nice increment value.
.TP
.B --help
Display help message.
.TP
.B --version
Display version message.
.SH OPERANDS
The following operands are supported:
.TP
.I command
A command to invoke with the altered nice value.
.TP
.I argument
An argument to pass to \fIcommand\fR.
.SH EXIT STATUS
Upon successful completion, the exit status of \fInice\fR shall be the exit
status of \fIcommand\fR. Otherwise, the following exit values will be returned:
.TP
1-125
An error occurred.
.TP
\ \ 126
\fIcommand\fR was found but could not be invoked.
.TP
\ \ 127
\fIcommand\fR was not found.
.SH STANDARDS
This utility is compliant with the IEEE Std 1003.2-2017 (POSIX) specification.
.SH COPYRIGHT
.nf
Copyright (C) 2020, Jakob Wakeling
MIT Licence (https://opensource.org/licenses/MIT)
.fi