genode/repos/os/include/uplink_session/client.h
Martin Stein cf72d1aac3 os: introduce new "Uplink" session
Adds new Uplink session interface, the corresponding client side (Client,
Connection), and the corresponding API archives. An Uplink session is almost
the same as a NIC session with the difference that the roles of the end points
are swapped. An Uplink client is the one that provides a network interface
(for instance, a NIC driver) whereas an Uplink server is the one that uses
that network interface (for instance, a networking stack).

Therefore, in contrast to the NIC session, MAC address and link state come from
the Uplink client. The link state is reflected through the lifetime of an
Uplink session: The client requests the session only when the link state is
"UP" and closes it whenever the link state becomes "DOWN" again. The MAC
address is transmitted from the Uplink client to the Uplink server as an
argument of the session request.

Ref #3961
2021-01-25 13:48:09 +01:00

62 lines
1.5 KiB
C++

/*
* \brief Client-side Uplink session interface
* \author Martin Stein
* \date 2020-11-30
*/
/*
* Copyright (C) 2020 Genode Labs GmbH
*
* This file is part of the Genode OS framework, which is distributed
* under the terms of the GNU Affero General Public License version 3.
*/
#ifndef _UPLINK_SESSION__CLIENT_H_
#define _UPLINK_SESSION__CLIENT_H_
/* Genode includes */
#include <base/rpc_client.h>
#include <uplink_session/capability.h>
#include <packet_stream_tx/client.h>
#include <packet_stream_rx/client.h>
namespace Uplink { class Session_client; }
class Uplink::Session_client : public Genode::Rpc_client<Session>
{
private:
Packet_stream_tx::Client<Tx> _tx;
Packet_stream_rx::Client<Rx> _rx;
public:
/**
* Constructor
*
* \param tx_buffer_alloc allocator used for managing the
* transmission buffer
*/
Session_client(Session_capability session,
Genode::Range_allocator &tx_buffer_alloc,
Genode::Region_map &rm)
:
Genode::Rpc_client<Session>(session),
_tx(call<Rpc_tx_cap>(), rm, tx_buffer_alloc),
_rx(call<Rpc_rx_cap>(),rm )
{ }
/******************************
** Uplink session interface **
******************************/
Tx *tx_channel() override { return &_tx; }
Rx *rx_channel() override { return &_rx; }
Tx::Source *tx() override { return _tx.source(); }
Rx::Sink *rx() override { return _rx.sink(); }
};
#endif /* _UPLINK_SESSION__CLIENT_H_ */