rom/exec/attemptsemaphoreshared.c

   1 /*
   2     Copyright © 1995-2011, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Try to lock a semaphore shared.
   6     Lang: english
   7 */
   8
   9 #include <exec/semaphores.h>
  10 #include <proto/exec.h>
  11
  12 #include "exec_intern.h"
  13 #include "exec_util.h"
  14 #include "semaphores.h"
  15
  16 /*****************************************************************************
  17
  18     NAME */
  19
  20         AROS_LH1(ULONG, AttemptSemaphoreShared,
  21
  22 /*  SYNOPSIS */
  23         AROS_LHA(struct SignalSemaphore *, sigSem, A0),
  24
  25 /*  LOCATION */
  26         struct ExecBase *, SysBase, 120, Exec)
  27
  28 /*  FUNCTION
  29         Tries to get a shared lock on a signal semaphore. If the lock cannot
  30         be obtained false is returned. There may be more than one shared lock
  31         at a time but an exclusive lock prevents all other locks. The lock
  32         must be released with ReleaseSemaphore().
  33
  34     INPUTS
  35         sigSem - pointer to semaphore structure
  36
  37     RESULT
  38         True if the semaphore could be obtained, false otherwise.
  39
  40     NOTES
  41
  42     EXAMPLE
  43
  44     BUGS
  45
  46     SEE ALSO
  47         ReleaseSemaphore()
  48
  49     INTERNALS
  50
  51 *****************************************************************************/
  52 {
  53     AROS_LIBFUNC_INIT
  54
  55     struct TraceLocation tp = CURRENT_LOCATION("AttemptSemaphoreShared");
  56
  57     return InternalAttemptSemaphore(sigSem, NULL, &tp, SysBase);
  58
  59     AROS_LIBFUNC_EXIT
  60 } /* AttemptSemaphoreShared */