genode/repos/os/include/packet_stream_rx/rpc_object.h
Norman Feske ca971bbfd8 Move repositories to 'repos/' subdirectory
This patch changes the top-level directory layout as a preparatory
step for improving the tools for managing 3rd-party source codes.
The rationale is described in the issue referenced below.

Issue #1082
2014-05-14 16:08:00 +02:00

117 lines
3.6 KiB
C++

/*
* \brief Server-side interface for packet-stream reception
* \author Norman Feske
* \date 2010-03-01
*/
/*
* Copyright (C) 2010-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__PACKET_STREAM_RX__RPC_OBJECT_H_
#define _INCLUDE__PACKET_STREAM_RX__RPC_OBJECT_H_
#include <packet_stream_rx/packet_stream_rx.h>
#include <base/rpc_server.h>
namespace Packet_stream_rx {
template <typename CHANNEL>
class Rpc_object : public Genode::Rpc_object<CHANNEL, Rpc_object<CHANNEL> >
{
private:
Genode::Rpc_entrypoint &_ep;
Genode::Capability<CHANNEL> _cap;
typename CHANNEL::Source _source;
Genode::Signal_context_capability _sigh_ready_to_submit;
Genode::Signal_context_capability _sigh_ack_avail;
public:
/**
* Constructor
*
* \param ds dataspace used as communication buffer
* for the receive packet stream
* \param buffer_alloc allocator used for managing the communication
* buffer of the receive packet stream
* \param ep entry point used for serving the channel's RPC
* interface
*/
Rpc_object(Genode::Dataspace_capability ds,
Genode::Range_allocator *buffer_alloc,
Genode::Rpc_entrypoint &ep)
: _ep(ep), _cap(_ep.manage(this)), _source(buffer_alloc, ds),
/* init signal handlers with default handlers of source */
_sigh_ready_to_submit(_source.sigh_ready_to_submit()),
_sigh_ack_avail(_source.sigh_ack_avail()) { }
/**
* Destructor
*/
~Rpc_object() { _ep.dissolve(this); }
/*
* The 'sigh_ack_avail()' and 'sigh_ready_to_submit()' functions
* may be called at session-creation time to override the default
* data-flow signal handlers as provided by the packet-stream source.
* The default handlers let the server block in the event of data
* congestion. By installing custom signal handlers, a server
* implementation is able to avoid blocking for a single event by
* facilitating the use of a select-like mode of operation.
*
* Note that calling these functions after the finished creation of
* the session has no effect because the client queries the signal
* handlers only once at session-creation time.
*/
/**
* Override default handler for server-side ready-to-submit signals
*
* Must be called at constuction time only.
*/
void sigh_ready_to_submit(Genode::Signal_context_capability sigh) {
_sigh_ready_to_submit = sigh; }
/**
* Override default handler for server-side ack-avail signals
*
* Must be called at constuction time only.
*/
void sigh_ack_avail(Genode::Signal_context_capability sigh) {
_sigh_ack_avail = sigh; }
typename CHANNEL::Source *source() { return &_source; }
Genode::Capability<CHANNEL> cap() const { return _cap; }
/*******************
** RPC functions **
*******************/
Genode::Dataspace_capability dataspace() { return _source.dataspace(); }
void sigh_ready_to_ack(Genode::Signal_context_capability sigh) {
_source.register_sigh_ready_to_ack(sigh); }
void sigh_packet_avail(Genode::Signal_context_capability sigh) {
_source.register_sigh_packet_avail(sigh); }
virtual Genode::Signal_context_capability sigh_ready_to_submit() {
return _sigh_ready_to_submit; }
virtual Genode::Signal_context_capability sigh_ack_avail() {
return _sigh_ack_avail; }
};
}
#endif /* _INCLUDE__PACKET_STREAM_RX__RPC_OBJECT_H_ */