su_str(3K)                     DG/UX R4.11MU05                    su_str(3K)


NAME
       sustr: sustrsleep, sustrwakeup, sustrnextevent - implement
       sleep(3C) and wakeup in a multiprocessor environment

SYNOPSIS
       vpecvaluetype  sustrnextevent(
       caddrt               resource        /* READ ONLY*/ )

       int               sustrsleep(
       caddrt               resource,       /* READ ONLY*/
       vpecvaluetype      nextecvalue   /* READ ONLY*/ )

       void              sustrwakeup(
       caddrt               resource        /* READ ONLY*/ )

   where:
       nextecvalue   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:
       sustrsleep        Await a specified event
       sustrwakeup       Advance eventcount associated with resource
       sustrnextevent   Returns next value of eventcount

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

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

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

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

DIAGNOSTICS
   Return Value
       For sustrnextevent:

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

       For sustrsleep:

       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 sustrwakeup: none.

   Errors
       None.

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


Licensed material--property of copyright holder(s)