ucpsig(2)                           CLIX                           ucpsig(2)



  NAME

    ucpsig - Sets process to a User Controlled Priority (UCP) on receipt of a
    signal

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    #include <sys/ucp.h>

    int ucpsig(
      int pri ,
      int flag ,
      longlong sigmask );

  PARAMETERS

    pri       Represents a user priority.

    flag      Specifies an integer flag.

    sigmask   Specifies a mask to determine the correct signal to set.

  DESCRIPTION

    The sigmask parameter specifies a set of signals that causes the calling
    process to run at User Controlled Priority (UCP) pri when handling these
    signals.  The value of sigmask is created by setting the bit corresponding
    to the desired signal, (1L << ((signum) - 1)).  The process is returned to
    its previous priority when either sigrelse() or ucprelse() is called.

    Clearing a signal that was previously set in sigmask is accomplished by
    calling ucpsig() with a different sigmask.

    The calling process must have superuser privileges.  A maximum pri value
    of 127 and a minimum of 0 are imposed by the system.

    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.

  NOTES

    If ucpset() is called from within a signal-handling routine, the process
    will finish handling the signal at the new priority and upon release will
    maintain the new priority.  (It will not return to the priority it was
    running at before receiving the signal.)




  2/94 - Intergraph Corporation                                              1

  ucpsig(2)                           CLIX                           ucpsig(2)



    If ucpclr() is called from within a signal-handling routine, the process
    will finish handling the signal at a non-UCP priority and will remain at
    that priority after the signal is released.

  CAUTIONS

    It is recommended that ucpsig() be used with sigset() and not with
    signal().

  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 ucpsig() function fails if one or more of the following is true:

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

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

  RELATED INFORMATION

    Functions:  ucprelse(2), ucppri(2), ucpinq(2), ucpnice(1), ucpset(2),
    ucpclr(2), sigset(2), signal(2)




























  2                                              Intergraph Corporation - 2/94