arch/.unmaintained/dummy/forbid.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4 */
   5
   6 #include <exec/execbase.h>
   7
   8 /******************************************************************************
   9
  10     NAME */
  11 #include <proto/exec.h>
  12
  13         AROS_LH0(void, Forbid,
  14
  15 /*  LOCATION */
  16         struct ExecBase *, SysBase, 22, Exec)
  17
  18 /*  FUNCTION
  19         Forbid any further taskswitches until a matching call to Permit().
  20         Naturally disabling taskswitches means:
  21
  22         THIS CALL IS DANGEROUS
  23
  24         Do not use it without thinking very well about it or better do not
  25         use it at all. Most of the time you can live without it by using
  26         semaphores or similar.
  27
  28         Calls to Forbid() nest, i.e. for each call to Forbid() you need one
  29         call to Enable().
  30
  31     INPUTS
  32         None.
  33
  34     RESULT
  35         None.
  36
  37     NOTES
  38         To prevent deadlocks calling Wait() in forbidden state breaks the
  39         forbid - thus taskswitches may happen again.
  40
  41         This function preserves all registers.
  42
  43     EXAMPLE
  44
  45     BUGS
  46
  47     SEE ALSO
  48         Permit(), Disable(), Enable(), Wait()
  49
  50     INTERNALS
  51
  52     HISTORY
  53
  54 ******************************************************************************/
  55 {
  56     ++SysBase->TDNestCnt;
  57 } /* Forbid */