arch/all-hosted/hostlib/lock.c

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