ucpset(2)                           CLIX                           ucpset(2)



  NAME

    ucpset - Sets a process to a User Controlled Priority (UCP)

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    #include <sys/ucp.h>

    int ucpset(
      int pid ,
      int pri ,
      int flag );

  PARAMETERS

    pid    Specifies a process identifier.

    pri    Represents a priority.

    flag   Specifies an integer flag.

  DESCRIPTION

    The ucpset() function sets the process with process ID pid to the User
    Controlled Priority (UCP) priority pri.  If pid has a value of 0, the
    calling process is changed.  A maximum pri value of 127 and a minimum pri
    value of 0 are imposed by the system.  The process must have superuser
    privileges.

    A process at UCP priority 0 will be run before any other UCP process and
    before any other non-UCP user process.  The time sharing between two
    processes running at the same UCP priority is not defined.

    The flag parameter determines whether the UCP priority is carried over to
    child processes.  If flag is set to UCP_FLAG, the UCP priority is not
    carried over to any child processes.

  RETURN VALUES

    Upon successful completion, a value of 0 is returned.  Otherwise, a value
    of -1 is returned and errno is set to indicate the error.

  ERRORS

    The ucpset() function fails if one or more of the following is true:

    [EPERM]    The effective user ID of the calling process is not superuser.



  2/94 - Intergraph Corporation                                              1

  ucpset(2)                           CLIX                           ucpset(2)



    [EINVAL]   The pri value was greater than 127 or less than 0.

    [ESRCH]    Process ID pid does not exist.

  RELATED INFORMATION

    Commands:  ucpnice(1)

    Functions:  ucpsig(2), ucprelse(2), ucpinq(2), ucppri(2), ucpclr(2)













































  2                                              Intergraph Corporation - 2/94