Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ nice(2) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                                  nice(2)



        _________________________________________________________________
        nice                                                  System Call
        Change priority of a process.
        _________________________________________________________________


        SYNTAX

        None.

        int     nice  (incr)
        int     incr;


        PARAMETERS

        incr           A positive or negative value that is to be added
                       to the calling process's priority.


        DESCRIPTION

        The value of <incr> is added to the priority of the calling
        process.  A more positive priority value results in a lower level
        of service from the CPU.

        If the new priority would be greater than 19, the process's
        priority is set to 19.  If the new priority would be less than
        -20, the process's priority is set to -20.


        ACCESS CONTROL

        The effective-user-id of the calling process must be 0 (i.e., the
        process must be super-user) for nice to accept a value for <incr>
        that is less than 0 or greater than 39.  If this condition is not
        met, <incr> will be treated as 0, and errno will be set to EPERM.


        RETURN VALUE

        Nice always returns the calling process's priority upon
        completion of the system call.  If an error occurred on the call,
        the process's priority will be unchanged and errno will be set to
        indicate the error.  Errno should be set to zero before the call
        and checked afterwards, regardless of the return value.


        EXCEPTIONS

        EPERM          The value of <incr> is negative or greater than 39



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                                  nice(2)



                       and the effective-user-id of the calling process
                       is not 0.


        SEE ALSO

        The related system call:  exec.















































        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026