(C) 1998 AROS - The Amiga Research OS


NAME
#include <proto/exec.h>

void Forbid ()

LOCATION
In SysBase at offset 22

SYNOPSIS

FUNCTION
Forbid any further taskswitches until a matching call to Permit(). Naturally disabling taskswitches means:

THIS CALL IS DANGEROUS

Do not use it without thinking very well about it or better do not use it at all. Most of the time you can live without it by using semaphores or similar.

Calls to Forbid() nest, i.e. for each call to Forbid() you need one call to Permit().

INPUTS
None.

RESULT
The multitasking state will be disabled AFTER this function returns to the caller.

EXAMPLE
No you really don't want to use this function.
SEE ALSO
Permit(), Disable(), Enable(), Wait()

NOTES
This function preserves all registers.

To prevent deadlocks calling Wait() in forbidden state breaks the forbid - thus taskswitches may happen again.

BUGS
The only architecture that you can rely on the registers being saved is on the Motorola mc68000 family.

INTERNALS
If you want to preserve all the registers, replace this function in your $(KERNEL) directory. Otherwise this function is satisfactory.

HISTORY
#ifndef UseExecstubs