nice(1)

nice1

Execute a utility at an altered scheduling priority

Usage

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

Overview

The nice utility runs utility at an altered scheduling priority, by incrementing its “nice” value by the specified increment, or a default value of 10. The lower the nice value of a process, the higher its scheduling priority.

The superuser may specify a negative increment in order to run a utility with a higher scheduling priority.

Some shells may provide a builtin nice command which is similar or identical to this utility. Consult the builtin(1) manual page.

Environment

The PATH environment variable is used to locate the requested utility if the name contains no ‘/’ characters.

Exit status

If utility is invoked, the exit status of nice is the exit status of utility.

An exit status of 126 indicates utility was found, but could not be executed. An exit status of 127 indicates utility could not be found.

Examples

Execute utility ‘date’ at priority 5 assuming the priority of the shell is 0:

nice -n 5 date

Execute utility ‘date’ at priority -19 assuming the priority of the shell is 0 and you are the super-user:

nice -n 16 nice -n -35 date

Compatibility

The traditional -increment option has been deprecated but is still supported.

Releases

87 releases since FreeBSD 2.0.5-RELEASE; the text changed 48 times.

  1. 2.0.5–2.1.7.1
  2. 2.2.2
  3. 2.2.5–2.2.6
  4. 2.2.7–2.2.8
  5. 2.2.9
  6. 3.0–3.2
  7. 3.3–3.4
  8. 3.5–3.5.1
  9. 4.0–4.2
  10. 4.3
  11. 4.4–4.6.2
  12. 4.7
  13. 4.8–4.11
  14. 5.0
  15. 5.1–5.5
  16. 6.0–6.3
  17. 6.4
  18. 7.0
  19. 7.1
  20. 7.2
  21. 7.3
  22. 7.4
  23. 8.0
  24. 8.1
  25. 8.2
  26. 8.3
  27. 8.4
  28. 9.0
  29. 9.1
  30. 9.2
  31. 9.3
  32. 10.0
  33. 10.1
  34. 10.2
  35. 10.3
  36. 10.4
  37. 11.0
  38. 11.1
  39. 11.2
  40. 11.3
  41. 11.4
  42. 12.0
  43. 12.1
  44. 12.2
  45. 12.3
  46. 12.4
  47. 13.0–13.2
  48. 13.3–14.5
  49. 15.0–16.0

Standards

The nice utility conforms to IEEE Std 1003.1-2001 (“POSIX.1”).

History

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

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.