arch/all-unix/exec/stackswap.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Change the stack of a task.
   6     Lang: english
   7 */
   8 #include <stdlib.h>
   9 #include <aros/debug.h>
  10
  11 /******************************************************************************
  12
  13     NAME */
  14 #include <exec/tasks.h>
  15 #include <proto/exec.h>
  16
  17         AROS_LH1(void, StackSwap,
  18
  19 /*  SYNOPSIS */
  20         AROS_LHA(struct StackSwapStruct *, sss, A0),
  21
  22 /*  LOCATION */
  23         struct ExecBase *, SysBase, 122, Exec)
  24
  25 /*  FUNCTION
  26         Change the stack of a task.
  27
  28     INPUTS
  29         sss - The description of the new stack
  30
  31     RESULT
  32         There will be a new stack.
  33
  34     NOTES
  35         Calling this routine the first time will change sss and
  36         calling it a second time, the changes will be undone.
  37
  38     EXAMPLE
  39
  40     BUGS
  41         This function isn't really portable across compilers, as
  42         it relies on the compiler NOT TO perform certain kind
  43         of optimizations.
  44
  45         This function is therefore declared obsolete and should
  46         never be used. In its place CallWithStack() can be used instead.
  47
  48     SEE ALSO
  49
  50     INTERNALS
  51         This is a symmetrical routine. If you call it twice, then
  52         everything will be as it was before.
  53
  54     HISTORY
  55
  56 ******************************************************************************/
  57 {
  58     AROS_LIBFUNC_INIT
  59
  60     kprintf("StackSwap() is deprecated and should NEVER be called. ABORTING.\n");
  61     abort();
  62
  63     AROS_LIBFUNC_EXIT
  64 } /* StackSwap */