rom/exec/findsemaphore.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Search a semaphore by name
   6     Lang: english
   7 */
   8 #include <exec/execbase.h>
   9 #include <aros/libcall.h>
  10 #include <proto/exec.h>
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15
  16         AROS_LH1(struct SignalSemaphore *, FindSemaphore,
  17
  18 /*  SYNOPSIS */
  19         AROS_LHA(CONST_STRPTR, name, A1),
  20
  21 /*  LOCATION */
  22         struct ExecBase *, SysBase, 99, Exec)
  23
  24 /*  FUNCTION
  25         Find a semaphore with a given name in the system global semaphore list.
  26         Note that this call doesn't arbitrate for the list - use Forbid() to
  27         do this yourself.
  28
  29     INPUTS
  30         name - Pointer to name.
  31
  32     RESULT
  33         Address of semaphore structure found or NULL.
  34
  35     NOTES
  36
  37     EXAMPLE
  38
  39     BUGS
  40
  41     SEE ALSO
  42
  43     INTERNALS
  44
  45 ******************************************************************************/
  46 {
  47     AROS_LIBFUNC_INIT
  48
  49     /* Nothing spectacular - just look into the list */
  50     return (struct SignalSemaphore *)FindName(&SysBase->SemaphoreList,name);
  51     AROS_LIBFUNC_EXIT
  52 } /* FindSemaphore */
  53