From 7fe60435bce6595a9c58a9bfd8244d74b5320e96 Mon Sep 17 00:00:00 2001 From: Benjamin Franzke Date: Tue, 15 Jan 2013 08:46:13 +0100 Subject: Import DirectFB141_2k11R3_beta5 --- Source/DirectFB/lib/fusion/fusion.h | 142 ++++++++++++++++++++++++++++++++++++ 1 file changed, 142 insertions(+) create mode 100755 Source/DirectFB/lib/fusion/fusion.h (limited to 'Source/DirectFB/lib/fusion/fusion.h') diff --git a/Source/DirectFB/lib/fusion/fusion.h b/Source/DirectFB/lib/fusion/fusion.h new file mode 100755 index 0000000..bfe3da2 --- /dev/null +++ b/Source/DirectFB/lib/fusion/fusion.h @@ -0,0 +1,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 , + Andreas Hundt , + Sven Neumann , + Ville Syrjälä and + Claudio Ciccani . + + 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 + +#include + +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 world_index 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 + -- cgit