nice(1)

nice1

Execute a utility with an altered scheduling priority

Usage

nice [-n increment] utility [argument ...]

Overview

nice runs utility at an altered scheduling priority. If an increment is given, it is used; otherwise an increment of 10 is assumed. The superuser can run utilities with priorities higher than normal by using a negative increment. The priority can be adjusted over a range of -20 (the highest) to 20 (the lowest).

The options are as follows:

-n increment

A positive or negative decimal integer used to modify the system scheduling priority of utility.

Exit status

The nice utility exits with one of the following values:

1-125

An error occurred.

126

The utility was found but could not be invoked.

127

The utility could not be found.

Otherwise, the exit status of nice shall be that of utility.

Releases

61 releases since OpenBSD 2.1; the text changed 10 times.

  1. 2.1
  2. 2.2–2.3
  3. 2.4–2.5
  4. 2.6
  5. 2.7–2.8
  6. 2.9–3.3
  7. 3.4–4.1
  8. 4.2–4.4
  9. 4.5–4.8
  10. 4.9–6.6
  11. 6.7–8.0

Standards

The nice utility is compliant with the IEEE Std 1003.1-2008 (“POSIX.1”) specification.

The historic -increment option has been deprecated but is still supported in this implementation.

nice also exists as a built-in to csh(1), though with a different syntax.

History

A nice utility appeared in Version 4 AT&T UNIX.

From man 8.0-current-20261101 in OpenBSD 8.0-current (2026-11-01). Parsed by carta from the page's mdoc source.