rom/exec/addsemaphore.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Add a semaphore to the public list of semaphores.
   6     Lang: english
   7 */
   8 #include "exec_intern.h"
   9 #include <exec/semaphores.h>
  10 #include <proto/exec.h>
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15
  16         AROS_LH1(void, AddSemaphore,
  17
  18 /*  SYNOPSIS */
  19         AROS_LHA(struct SignalSemaphore *, sigSem, A1),
  20
  21 /*  LOCATION */
  22         struct ExecBase *, SysBase, 100, Exec)
  23
  24 /*  FUNCTION
  25         Adds a semaphore to the system public semaphore list. Since the
  26         semaphore gets initialized by this function it must be free at
  27         this time. Also the ln_Name field must be set.
  28
  29     INPUTS
  30         sigSem - Pointer to semaphore structure
  31
  32     RESULT
  33
  34     NOTES
  35         Semaphores are shared between the tasks that use them and must
  36         therefore lie in public (or at least shared) memory.
  37
  38     EXAMPLE
  39
  40     BUGS
  41
  42     SEE ALSO
  43
  44     INTERNALS
  45
  46 *****************************************************************************/
  47 {
  48     AROS_LIBFUNC_INIT
  49
  50     /* Initialize semaphore */
  51     InitSemaphore(sigSem);
  52
  53     /* Arbitrate for the semaphore list */
  54     Forbid();
  55     /* Add the semaphore */
  56     Enqueue(&SysBase->SemaphoreList,&sigSem->ss_Link);
  57
  58     /* All done. */
  59     Permit();
  60     AROS_LIBFUNC_EXIT
  61 } /* AddSemaphore */
  62