mirror of
https://github.com/genodelabs/genode.git
synced 2025-05-18 08:23:27 +00:00
73b463cdbb
We will eventually remove the delivery of the number of occurred signals to the recipient. There haven't been any convincing use cases for this feature. In the contrary, it actually led to wrong design choices in the past where the rate of signals carried information (such as the progress of time) that should better be obtained via an explicit RPC call. The old 'Signal_rpc_member' template retains the old interface for now. But the new 'Signal_handler' omits the 'unsigned' argument from the handler function.
70 lines
2.1 KiB
C++
70 lines
2.1 KiB
C++
/*
|
|
* \brief Utility for dispatching signals at at RPC entrypoint
|
|
* \author Norman Feske
|
|
* \date 2013-09-07
|
|
*
|
|
* \deprecated This header merely exists to maintain API compatibility
|
|
* to Genode 15.11. Its functionality moved to base/signal.h.
|
|
* The header will eventually be removed.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 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__OS__SIGNAL_RPC_DISPATCHER_H_
|
|
#define _INCLUDE__OS__SIGNAL_RPC_DISPATCHER_H_
|
|
|
|
#include <base/signal.h>
|
|
|
|
namespace Genode { template <typename, typename> class Signal_rpc_member; }
|
|
|
|
|
|
/**
|
|
* Signal dispatcher for handling signals by an object method
|
|
*
|
|
* This utility associates object methods with signals. It is intended to
|
|
* be used as a member variable of the class that handles incoming signals
|
|
* of a certain type. The constructor takes a pointer-to-member to the
|
|
* signal-handling method as argument. If a signal is received at the
|
|
* common signal reception code, this method will be invoked by calling
|
|
* 'Signal_dispatcher_base::dispatch'.
|
|
*
|
|
* \param T type of signal-handling class
|
|
* \param EP type of entrypoint handling signal RPC
|
|
*
|
|
* \deprecated this class template is superseded by the 'Signal_handler'
|
|
* in base/signal.h
|
|
*/
|
|
template <typename T, typename EP = Genode::Entrypoint>
|
|
struct Genode::Signal_rpc_member : Genode::Signal_dispatcher_base,
|
|
Genode::Signal_context_capability
|
|
{
|
|
EP &ep;
|
|
T &obj;
|
|
void (T::*member) (unsigned);
|
|
|
|
/**
|
|
* Constructor
|
|
*
|
|
* \param ep entrypoint managing this signal RPC
|
|
* \param obj,member object and method to call when
|
|
* the signal occurs
|
|
*/
|
|
Signal_rpc_member(EP &ep, T &obj, void (T::*member)(unsigned))
|
|
: Signal_context_capability(ep.manage(*this)),
|
|
ep(ep), obj(obj), member(member) { }
|
|
|
|
~Signal_rpc_member() { ep.dissolve(*this); }
|
|
|
|
/**
|
|
* Interface of Signal_dispatcher_base
|
|
*/
|
|
void dispatch(unsigned num) { (obj.*member)(num); }
|
|
};
|
|
|
|
#endif /* _INCLUDE__OS__SIGNAL_RPC_DISPATCHER_H_ */
|