arch/all-hosted/hostlib/lock.c

   1 #include <aros/libcall.h>
   2 #include <proto/exec.h>
   3
   4 #include "hostlib_intern.h"
   5
   6 /*****************************************************************************
   7
   8     NAME */
   9 #include <proto/hostlib.h>
  10
  11         AROS_LH0(void, HostLib_Lock,
  12
  13 /*  SYNOPSIS */
  14
  15 /*  LOCATION */
  16         struct HostLibBase *, HostLibBase, 7, HostLib)
  17
  18 /*  FUNCTION
  19         Acquire global host OS call semaphore.
  20
  21     INPUTS
  22         None.
  23
  24     RESULT
  25         None.
  26
  27     NOTES
  28         Host OS calls are typically not reentrant. You have to
  29         call this function before you may use any host OS API.
  30         Use HostLib_Unlock() function when you're done with it.
  31
  32         This function has negative impact on AROS multitasking, so
  33         use it gently.
  34
  35     EXAMPLE
  36
  37     BUGS
  38
  39     SEE ALSO
  40         HostLib_Unlock()
  41
  42     INTERNALS
  43         The actual implementation of this function depends on
  44         the host OS. Do not assume anything particular about it.
  45         For example under Windows it's Forbid(), not a semaphore.
  46
  47 *****************************************************************************/
  48 {
  49     AROS_LIBFUNC_INIT
  50
  51     HOSTLIB_LOCK();
  52
  53     AROS_LIBFUNC_EXIT
  54 }