Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
move iwannadie from processes to contextes back
[simgrid.git] / include / simix / context.h
1 /* a fast and simple context switching library                              */
2
3 /* Copyright (c) 2009, 2010. The SimGrid Team.
4  * All rights reserved.                                                     */
5
6 /* This program is free software; you can redistribute it and/or modify it
7  * under the terms of the license (GNU LGPL) which comes with this package. */
8
9 #ifndef _XBT_CONTEXT_H
10 #define _XBT_CONTEXT_H
11
12 #include "xbt/swag.h"
13 #include "simix/datatypes.h"
14 #include "simix/context.h"
15
16 SG_BEGIN_DECL()
17 /******************************** Context *************************************/
18 typedef struct s_smx_context *smx_context_t;
19 typedef struct s_smx_context_factory *smx_context_factory_t;
20
21 /* Process creation/destruction callbacks */
22 typedef void (*void_pfn_smxprocess_t) (smx_process_t);
23
24
25 /* The following function pointer types describe the interface that any context
26    factory should implement */
27
28
29 typedef smx_context_t(*smx_pfn_context_factory_create_context_t)
30   (xbt_main_func_t, int, char **, void_pfn_smxprocess_t, void* data);
31 typedef int (*smx_pfn_context_factory_finalize_t) (smx_context_factory_t*);
32 typedef void (*smx_pfn_context_free_t) (smx_context_t);
33 typedef void (*smx_pfn_context_start_t) (smx_context_t);
34 typedef void (*smx_pfn_context_stop_t) (smx_context_t);
35 typedef void (*smx_pfn_context_suspend_t) (smx_context_t context);
36 typedef void (*smx_pfn_context_runall_t) (xbt_swag_t processes);
37 typedef smx_context_t (*smx_pfn_context_self_t) (void);
38 typedef void* (*smx_pfn_context_get_data_t) (smx_context_t context);
39
40 /* interface of the context factories */
41 typedef struct s_smx_context_factory {
42   const char *name;
43   smx_pfn_context_factory_create_context_t create_context;
44   smx_pfn_context_factory_finalize_t finalize;
45   smx_pfn_context_free_t free;
46   smx_pfn_context_stop_t stop;
47   smx_pfn_context_suspend_t suspend;
48   smx_pfn_context_runall_t runall;
49   smx_pfn_context_self_t self;
50   smx_pfn_context_get_data_t get_data;
51 } s_smx_context_factory_t;
52
53
54
55 /*Hack: let msg load directly the right factory */
56 typedef void (*SIMIX_ctx_factory_initializer_t)(smx_context_factory_t*);
57 extern SIMIX_ctx_factory_initializer_t factory_initializer_to_use;
58
59 extern int _surf_parallel_contexts;
60 smx_context_t smx_current_context;
61
62 /* *********************** */
63 /* Context type definition */
64 /* *********************** */
65 /* the following function pointers types describe the interface that all context
66    concepts must implement */
67 /* each context type derive from this structure, so they must contain this structure
68  * at their begining -- OOP in C :/ */
69 typedef struct s_smx_context {
70   s_xbt_swag_hookup_t hookup;
71   xbt_main_func_t code;
72   int argc;
73   char **argv;
74   void_pfn_smxprocess_t cleanup_func;
75   int iwannadie:1;
76   void *data;   /* Here SIMIX stores the smx_process_t containing the context */
77 } s_smx_ctx_base_t;
78
79 /* methods of this class */
80 void smx_ctx_base_factory_init(smx_context_factory_t *factory);
81 int smx_ctx_base_factory_finalize(smx_context_factory_t *factory);
82
83 smx_context_t
84 smx_ctx_base_factory_create_context_sized(size_t size,
85                                           xbt_main_func_t code, int argc,
86                                           char **argv,
87                                           void_pfn_smxprocess_t cleanup,
88                                           void* data);
89 void smx_ctx_base_free(smx_context_t context);
90 void smx_ctx_base_stop(smx_context_t context);
91 smx_context_t smx_ctx_base_self(void);
92 void *smx_ctx_base_get_data(smx_context_t context);
93
94 SG_END_DECL()
95
96 #endif                          /* !_XBT_CONTEXT_H */