logo

utils-std

Collection of commonly available Unix tools git clone https://anongit.hacktivis.me/git/utils-std.git

nice.1 (1357B)


  1. .\" utils-std: Collection of commonly available Unix tools
  2. .\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
  3. .\" SPDX-License-Identifier: MPL-2.0
  4. .Dd 2024-04-18
  5. .Dt NICE 1
  6. .Os
  7. .Sh NAME
  8. .Nm nice
  9. .Nd invoke command with modified nice scheduling value
  10. .Sh SYNOPSIS
  11. .Nm
  12. .Op Fl n Ar increment
  13. .Ar command
  14. .Op Ar argument...
  15. .Sh DESCRIPTION
  16. .Nm
  17. runs
  18. .Ar command
  19. with a modified niceness, changing the scheduling of the process.
  20. .Pp
  21. 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
  22. .Ar command
  23. gets executed, without it's niceness changed.
  24. .Sh OPTIONS
  25. .Bl -tag -width Ds
  26. .It Fl n Ar increment
  27. Positive or negative integer used to adjust the niceness of the process. (default: 0)
  28. .El
  29. .Sh EXIT STATUS
  30. If
  31. .Ar command
  32. is invoked, the exit status of
  33. .Nm
  34. shall be the exit status of
  35. .Ar command ;
  36. Otherwise, the
  37. .Nm
  38. utility shall exit with one of the following values:
  39. .Bl -tag -width Ds
  40. .It 125
  41. An error occurred within the
  42. .Nm
  43. utility.
  44. .It 126
  45. .Ar command
  46. was found but couldn't be invoked.
  47. .It 127
  48. .Ar command
  49. wasn't found.
  50. .El
  51. .Sh SEE ALSO
  52. .Xr renice 1 ,
  53. .Xr nice 3
  54. .Sh STANDARDS
  55. .Nm
  56. should be compliant with the
  57. IEEE Std 1003.1-2024 (“POSIX.1”)
  58. specification.
  59. .Sh AUTHORS
  60. .An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me