1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
/*
(c) Copyright 2001-2009 The world wide DirectFB Open Source Community (directfb.org)
(c) Copyright 2000-2004 Convergence (integrated media) GmbH
All rights reserved.
Written by Denis Oliver Kropp <dok@directfb.org>,
Andreas Hundt <andi@fischlustig.de>,
Sven Neumann <neo@directfb.org>,
Ville Syrjälä <syrjala@sci.fi> and
Claudio Ciccani <klan@users.sf.net>.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
#ifndef __FUSION__FUSION_H__
#define __FUSION__FUSION_H__
#include <sys/types.h>
#include <fusion/types.h>
typedef enum {
FER_ANY,
FER_MASTER,
FER_SLAVE
} FusionEnterRole;
typedef enum {
FFA_CLOSE,
FFA_FORK
} FusionForkAction;
typedef enum {
FFS_PREPARE,
FFS_PARENT,
FFS_CHILD
} FusionForkState;
typedef void (*FusionForkCallback) ( FusionForkAction action, FusionForkState state );
/*
* Enters a fusion world by joining or creating it.
*
* If <b>world_index</b> is negative, the next free index is used to create a new world.
* Otherwise the world with the specified index is joined or created.
*/
DirectResult fusion_enter( int world_index,
int abi_version,
FusionEnterRole role,
FusionWorld **ret_world );
/*
* Exits the fusion world.
*
* If 'emergency' is true the function won't join but kill the dispatcher thread.
*/
DirectResult fusion_exit( FusionWorld *world,
bool emergency );
DirectResult fusion_stop_dispatcher( FusionWorld *world,
bool emergency );
/*
* Sets the fork() action of the calling Fusionee within the world.
*/
void fusion_world_set_fork_action( FusionWorld *world,
FusionForkAction action );
/*
* Gets the current fork() action.
*/
FusionForkAction fusion_world_get_fork_action( FusionWorld *world );
/*
* Registers a callback called upon fork().
*/
void fusion_world_set_fork_callback( FusionWorld *world,
FusionForkCallback callback );
/*
* Return the index of the specified world.
*/
int fusion_world_index( const FusionWorld *world );
/*
* Return the own Fusion ID within the specified world.
*/
FusionID fusion_id( const FusionWorld *world );
/*
* Return if the world is a multi application world.
*/
bool fusion_is_multi( const FusionWorld *world );
/*
* Return the thread ID of the Fusion Dispatcher within the specified world.
*/
pid_t fusion_dispatcher_tid( const FusionWorld *world );
/*
* Return true if this process is the master.
*/
bool fusion_master( const FusionWorld *world );
/*
* Wait until all pending messages are processed.
*/
DirectResult fusion_sync( const FusionWorld *world );
/*
* Sends a signal to one or more fusionees and optionally waits
* for their processes to terminate.
*
* A fusion_id of zero means all fusionees but the calling one.
* A timeout of zero means infinite waiting while a negative value
* means no waiting at all.
*/
DirectResult fusion_kill( FusionWorld *world,
FusionID fusion_id,
int signal,
int timeout_ms );
/* Check if a pointer points to the shared memory. */
bool fusion_is_shared( FusionWorld *world,
const void *ptr );
#endif
|
