src/exit.c

   1 /*
   2 Copyright (C) 2001-2009, Parrot Foundation.
   3 $Id$
   4
   5 =head1 NAME
   6
   7 src/exit.c - Exit Handling
   8
   9 =head1 DESCRIPTION
  10
  11 Parrot's version of C<exit()>, C<on_exit()>, and friends.
  12
  13 C<Parrot_on_exit()> allows you register exit handlers which will be
  14 called by C<Parrot_exit()> when the interpreter exits.
  15
  16 =head2 Functions
  17
  18 =over 4
  19
  20 =cut
  21
  22 */
  23
  24 #include <stdlib.h>
  25 #include "parrot/parrot.h"
  26
  27 /* HEADERIZER HFILE: include/parrot/exit.h */
  28
  29 /*
  30
  31 =item C<void Parrot_on_exit(PARROT_INTERP, exit_handler_f function, void *arg)>
  32
  33 Register the specified function to be called on exit.
  34
  35 =cut
  36
  37 */
  38
  39 PARROT_EXPORT
  40 void
  41 Parrot_on_exit(PARROT_INTERP, NOTNULL(exit_handler_f function), ARGIN_NULLOK(void *arg))
  42 {
  43     ASSERT_ARGS(Parrot_on_exit)
  44     /* RT#46403  we might want locking around the list access.   I'm sure this
  45      * will be the least of the threading issues. */
  46
  47     handler_node_t * const new_node = mem_allocate_typed(handler_node_t);
  48
  49     new_node->function        = function;
  50     new_node->arg             = arg;
  51     new_node->next            = interp->exit_handler_list;
  52     interp->exit_handler_list = new_node;
  53 }
  54
  55 /*
  56
  57 =item C<void Parrot_exit(PARROT_INTERP, int status)>
  58
  59 Exit, calling any registered exit handlers.
  60
  61 =cut
  62
  63 */
  64
  65 PARROT_EXPORT
  66 PARROT_DOES_NOT_RETURN
  67 void
  68 Parrot_exit(PARROT_INTERP, int status)
  69 {
  70     ASSERT_ARGS(Parrot_exit)
  71     /* call all the exit handlers */
  72     /* we are well "below" the runloop now, where lo_var_ptr
  73      * is set usually - exit handlers may run some resource-hungry
  74      * stuff like printing profile stats - a GC run would kill
  75      * resources - RT#46405 reset stacktop or better disable GC
  76      */
  77     /*
  78      * we don't allow new exit_handlers being installed inside exit handlers
  79      * - do we?
  80      * and: interp->exit_handler_list is gone, after the last exit handler
  81      *      (Parrot_really_destroy) has run
  82      */
  83     handler_node_t *node = interp->exit_handler_list;
  84
  85     Parrot_block_GC_mark(interp);
  86     Parrot_block_GC_sweep(interp);
  87
  88     while (node) {
  89         handler_node_t * const next = node->next;
  90
  91         (node->function)(interp, status, node->arg);
  92         mem_sys_free(node);
  93         node = next;
  94     }
  95
  96     exit(status);
  97 }
  98
  99 /*
 100
 101 =back
 102
 103 =head1 SEE ALSO
 104
 105 F<include/parrot/exit.h> and F<t/src/exit.t>.
 106
 107 =head1 HISTORY
 108
 109 Initial version by Josh Wilmes.
 110
 111 =cut
 112
 113 */
 114
 115
 116 /*
 117  * Local variables:
 118  *   c-file-style: "parrot"
 119  * End:
 120  * vim: expandtab shiftwidth=4:
 121  */