genode/base-hw/include/signal_session/signal_session.h
2013-02-22 20:28:28 +01:00

107 lines
2.8 KiB
C++

/*
* \brief Signal session interface
* \author Martin Stein
* \date 2012-05-05
*/
/*
* Copyright (C) 2012-2013 Genode Labs GmbH
*
* This file is part of the Genode OS framework, which is distributed
* under the terms of the GNU General Public License version 2.
*/
#ifndef _INCLUDE__SIGNAL_SESSION__SIGNAL_SESSION_H_
#define _INCLUDE__SIGNAL_SESSION__SIGNAL_SESSION_H_
/* Genode includes */
#include <base/capability.h>
#include <base/exception.h>
#include <session/session.h>
namespace Genode
{
class Signal_receiver;
class Signal_context;
/*
* The 'dst' of this cap is used to communicate the ID of the
* corresponding signal-receiver kernel-object or 0 if the cap is invalid.
*/
typedef Capability<Signal_receiver> Signal_receiver_capability;
/*
* The 'dst' of this cap is used to communicate the ID of the
* corresponding signal-context kernel-object or 0 if the cap is invalid.
*/
typedef Capability<Signal_context> Signal_context_capability;
/**
* Signal session interface
*/
struct Signal_session : Session
{
class Out_of_metadata : public Exception { };
/**
* String that can be used to refer to this service
*/
static const char * service_name() { return "SIGNAL"; }
/**
* Destructor
*/
virtual ~Signal_session() { }
/**
* Create a new signal-receiver kernel-object
*
* \return a cap that acts as reference to the created object
*
* \throw Out_of_metadata
*/
virtual Signal_receiver_capability alloc_receiver() = 0;
/**
* Create a new signal-context kernel-object
*
* \param r names the signal receiver that shall provide
* the new context
* \param imprint every signal that occures on the new context gets
* signed with this value
*
* \return a cap that acts as reference to the created object
*
* \throw Out_of_metadata
*/
virtual Signal_context_capability
alloc_context(Signal_receiver_capability const r,
unsigned const imprint) = 0;
/**
* Free signal-context
*
* \param cap capability of signal-context to release
*/
virtual void free_context(Signal_context_capability cap) = 0;
/*********************
** RPC declaration **
*********************/
GENODE_RPC_THROW(Rpc_alloc_receiver, Signal_receiver_capability,
alloc_receiver, GENODE_TYPE_LIST(Out_of_metadata));
GENODE_RPC_THROW(Rpc_alloc_context, Signal_context_capability,
alloc_context, GENODE_TYPE_LIST(Out_of_metadata),
Signal_receiver_capability, unsigned);
GENODE_RPC(Rpc_free_context, void, free_context,
Signal_context_capability);
GENODE_RPC_INTERFACE(Rpc_alloc_receiver, Rpc_alloc_context,
Rpc_free_context);
};
}
#endif /* _INCLUDE__SIGNAL_SESSION__SIGNAL_SESSION_H_ */