genode/repos/os/include/terminal_session/connection.h
Norman Feske 97a41394b4 Documentation changes on account of the book
This patch removes the outdates doc/architecture.txt since the
topics are covered by the book. We keep repos/os/doc/init.txt
because it contains a few details not present in the book (yet).
The patch streamlines the terminology a bit. Furthermore, it
slightly adjusts a few source-code comments to improve the book's
functional specification chapter.
2016-05-26 15:54:16 +02:00

78 lines
1.8 KiB
C++

/*
* \brief Connection to Terminal service
* \author Norman Feske
* \date 2011-08-12
*/
/*
* Copyright (C) 2011-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__TERMINAL_SESSION__CONNECTION_H_
#define _INCLUDE__TERMINAL_SESSION__CONNECTION_H_
#include <terminal_session/client.h>
#include <base/connection.h>
namespace Terminal { struct Connection; }
struct Terminal::Connection : Genode::Connection<Session>, Session_client
{
/**
* Wait for connection-established signal
*
* \noapi
*/
static void wait_for_connection(Genode::Capability<Session> cap)
{
using namespace Genode;
/* create signal receiver, just for the single signal */
Signal_context sig_ctx;
Signal_receiver sig_rec;
Signal_context_capability sig_cap = sig_rec.manage(&sig_ctx);
/* register signal handler */
cap.call<Rpc_connected_sigh>(sig_cap);
/* wati for signal */
sig_rec.wait_for_signal();
sig_rec.dissolve(&sig_ctx);
}
/**
* Constructor
*/
Connection(Genode::Env &env, char const *label = "")
:
Genode::Connection<Session>(env, session(env.parent(),
"ram_quota=%zd, label=\"%s\"",
2*4096, label)),
Session_client(cap())
{
wait_for_connection(cap());
}
/**
* Constructor
*
* \noapi
* \deprecated Use the constructor with 'Env &' as first
* argument instead
*/
Connection(char const *label = "")
:
Genode::Connection<Session>(session("ram_quota=%zd, label=\"%s\"",
2*4096, label)),
Session_client(cap())
{
wait_for_connection(cap());
}
};
#endif /* _INCLUDE__TERMINAL_SESSION__CONNECTION_H_ */