su_str(3K)                        SDK R4.11                       su_str(3K)


NAME
       su_str: su_str_sleep, su_str_wakeup, su_str_next_event - implement
       sleep(3C) and wakeup in a multiprocessor environment

SYNOPSIS
       vp_ec_value_type  su_str_next_event(
       caddr_t               resource        /* READ ONLY*/ )

       int               su_str_sleep(
       caddr_t               resource,       /* READ ONLY*/
       vp_ec_value_type      next_ec_value   /* READ ONLY*/ )

       void              su_str_wakeup(
       caddr_t               resource        /* READ ONLY*/ )

   where:
       next_ec_value   The value of the eventcount to await.
       resource        A pointer to the resource being sought, awaited, or
                       freed.

DESCRIPTION
       The following routines are described in this man page:
       su_str_sleep        Await a specified event
       su_str_wakeup       Advance eventcount associated with resource
       su_str_next_event   Returns next value of eventcount

   su_str_next_event
       This routine returns the next value of an eventcount associated with
       resource.

   su_str_sleep
       This routine awaits an event specified by the eventcount value
       next_ec_value or the eventcounter specified by resource or a process
       interrupt event.

       This routine awaits a su_str_wakeup(resource) operation that advances
       the eventcounter associated with resource to next_ec_value.  This
       routine should be used only by a module or driver open/close routine.

   su_str_wakeup
       This routine causes the eventcount associated with resource to be
       advanced.

DIAGNOSTICS
   Return Value
       For su_str_next_event:

       count  The value that the eventcount associated with resource will
              attain when it is next advanced is returned.

       For su_str_sleep:

       0      Sleep was awakened by wakeup.

       1      Sleep was awakened by an interrupt signal (process is either
              being terminated or it must handle a signal).

       For su_str_wakeup: none.

   Errors
       None.

SEE ALSO
       event_counters(3C).  sleep(3C).
       Programming in the DG/UX Kernel Environment.


Licensed material--property of copyright holder(s)