1nice(1)                          User Commands                         nice(1)
2
3
4

NAME

6       nice - invoke a command with an altered scheduling priority
7

SYNOPSIS

9       /usr/bin/nice [-increment | -n increment] command
10            [argument]...
11
12
13       /usr/xpg4/bin/nice [-increment | -n increment] command
14            [argument]...
15
16
17   csh Builtin
18       nice [-increment | +increment] [command]
19
20

DESCRIPTION

22       The nice utility invokes command, requesting that it be run with a dif‐
23       ferent system scheduling priority. The priocntl(1) command  is  a  more
24       general interface to scheduler functions.
25
26
27       The invoking process (generally the user's shell) must be in a schedul‐
28       ing class that supports nice.
29
30
31       If the C shell (see csh(1)) is used, the full path of the command  must
32       be  specified.  Otherwise,  the  csh  built-in  version of nice will be
33       invoked. See csh Builtin below.
34
35   /usr/bin/nice
36       If nice executes commands with arguments, it  uses  the  default  shell
37       /usr/bin/sh (see sh(1)).
38
39   /usr/xpg4/bin/nice
40       If nice executes commands with arguments, it uses /usr/xpg4/bin/sh (see
41       ksh(1)).
42
43   csh Builtin
44       nice is also a csh built-in command with behavior  different  from  the
45       utility versions.  See csh(1) for description.
46

OPTIONS

48       The following options are supported:
49
50       -increment | -n increment    increment  is a positive or negative deci‐
51                                    mal integer that has the  same  effect  on
52                                    the  execution  of  the  utility as if the
53                                    utility had  called  the  nice()  function
54                                    with  the  numeric  value of the increment
55                                    option-argument.   See   nice(2).   nice()
56                                    errors, other than EINVAL, are ignored. If
57                                    not  specified,  an  increment  of  10  is
58                                    assumed.
59
60                                    The  super-user may run commands with pri‐
61                                    ority higher than normal by using a  nega‐
62                                    tive  increment  such  as  -10. A negative
63                                    increment assigned by an unprivileged user
64                                    is ignored.
65
66

OPERANDS

68       The following operands are supported:
69
70       command     The  name  of  a  command that is to be invoked. If command
71                   names  any  of  the   special   built-in   utilities   (see
72                   shell_builtins(1)), the results are undefined.
73
74
75       argument    Any string to be supplied as an argument when invoking com‐
76                   mand.
77
78

ENVIRONMENT VARIABLES

80       See environ(5) for descriptions of the following environment  variables
81       that affect the execution of nice: LANG, LC_ALL, LC_CTYPE, LC_MESSAGES,
82       PATH, and NLSPATH.
83

EXIT STATUS

85       If command is invoked, the exit status of nice will be the exit  status
86       of command. Otherwise, nice will exit with one of the following values:
87
88       1-125    An error occurred.
89
90
91       126      command was found but could not be invoked.
92
93
94       127      command could not be found.
95
96

ATTRIBUTES

98       See attributes(5) for descriptions of the following attributes:
99
100   /usr/bin/nice
101       ┌─────────────────────────────┬─────────────────────────────┐
102       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
103       ├─────────────────────────────┼─────────────────────────────┤
104       │Availability                 │SUNWcsu                      │
105       ├─────────────────────────────┼─────────────────────────────┤
106       │CSI                          │Enabled                      │
107       └─────────────────────────────┴─────────────────────────────┘
108
109   /usr/xpg4/bin/nice
110       ┌─────────────────────────────┬─────────────────────────────┐
111       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
112       ├─────────────────────────────┼─────────────────────────────┤
113       │Availability                 │SUNWxcu4                     │
114       ├─────────────────────────────┼─────────────────────────────┤
115       │CSI                          │Enabled                      │
116       ├─────────────────────────────┼─────────────────────────────┤
117       │Interface Stability          │Standard                     │
118       └─────────────────────────────┴─────────────────────────────┘
119

SEE ALSO

121       csh(1),   ksh(1),   nohup(1),  priocntl(1),  sh(1),  shell_builtins(1),
122       nice(2), attributes(5), environ(5), standards(5)
123
124
125
126SunOS 5.11                        23 Jan 2004                          nice(1)
Impressum