d71f0a9606
This patch alleviates the need for a Native_capability::Dst at the API level. The former use case of this type as argument to Deprecated_env::reinit uses the opaque Native_capability::Raw type instead. The 'Raw' type contains the portion of the capability that is transferred as-is when delegating the capability (i.e., when installing the parent capability into a new component, or when installing a new parent capability into a new forked Noux process). This information can be retrieved via the new Native_capability::raw method. Furthermore, this patch moves the functions for retriving the parent capability to base/internal/parent_cap.h, which is meant to be implemented in platform-specific ways. It replaces the former set of startup/internal/_main_parent_cap.h headers. Issue #1993
169 lines
3.1 KiB
C++
169 lines
3.1 KiB
C++
/*
|
|
* \brief Platform-specific capability type
|
|
* \author Norman Feske
|
|
* \author Alexander Boettcher
|
|
* \date 2009-10-02
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2009-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__BASE__NATIVE_CAPABILITY_H_
|
|
|
|
/* Genode includes */
|
|
#include <base/native_capability_tpl.h>
|
|
#include <base/stdint.h>
|
|
#include <base/cap_map.h>
|
|
|
|
/* NOVA includes */
|
|
#include <nova/syscalls.h>
|
|
|
|
namespace Genode {
|
|
|
|
class Native_capability
|
|
{
|
|
public:
|
|
|
|
typedef Nova::Obj_crd Dst;
|
|
|
|
struct Raw { };
|
|
|
|
private:
|
|
|
|
struct _Raw
|
|
{
|
|
Dst dst;
|
|
|
|
_Raw() : dst() { }
|
|
|
|
_Raw(addr_t sel, unsigned rights)
|
|
: dst(sel, 0, rights) { }
|
|
} _cap;
|
|
|
|
addr_t _rcv_window;
|
|
|
|
enum { INVALID_INDEX = ~0UL };
|
|
|
|
protected:
|
|
|
|
inline void _inc() const
|
|
{
|
|
Cap_index idx(cap_map()->find(local_name()));
|
|
idx.inc();
|
|
}
|
|
|
|
inline void _dec() const
|
|
{
|
|
Cap_index idx(cap_map()->find(local_name()));
|
|
idx.dec();
|
|
}
|
|
|
|
public:
|
|
|
|
/**
|
|
* Constructors
|
|
*/
|
|
|
|
Native_capability()
|
|
: _cap(), _rcv_window(INVALID_INDEX) {}
|
|
|
|
explicit
|
|
Native_capability(addr_t sel, unsigned rights = 0x1f)
|
|
{
|
|
if (sel == INVALID_INDEX)
|
|
_cap = _Raw();
|
|
else {
|
|
_cap = _Raw(sel, rights);
|
|
_inc();
|
|
}
|
|
|
|
_rcv_window = INVALID_INDEX;
|
|
}
|
|
|
|
Native_capability(const Native_capability &o)
|
|
: _cap(o._cap), _rcv_window(o._rcv_window)
|
|
{ if (valid()) _inc(); }
|
|
|
|
~Native_capability() { if (valid()) _dec(); }
|
|
|
|
/**
|
|
* Overloaded comparison operator
|
|
*/
|
|
bool operator==(const Native_capability &o) const {
|
|
return local_name() == o.local_name(); }
|
|
|
|
/**
|
|
* Copy constructor
|
|
*/
|
|
Native_capability& operator=
|
|
(const Native_capability &o)
|
|
{
|
|
if (this == &o)
|
|
return *this;
|
|
|
|
if (valid()) _dec();
|
|
|
|
_cap = o._cap;
|
|
_rcv_window = o._rcv_window;
|
|
|
|
if (valid()) _inc();
|
|
|
|
return *this;
|
|
}
|
|
|
|
/**
|
|
* Check whether the selector of the Native_cap and
|
|
* the capability type is valid.
|
|
*/
|
|
bool valid() const { return !_cap.dst.is_null(); }
|
|
|
|
Dst dst() const { return _cap.dst; }
|
|
|
|
/**
|
|
* Return the local_name. On NOVA it is the same as the
|
|
* destination value.
|
|
*/
|
|
addr_t local_name() const
|
|
{
|
|
if (valid())
|
|
return _cap.dst.base();
|
|
else
|
|
return INVALID_INDEX;
|
|
}
|
|
|
|
/**
|
|
* Set one specific cap selector index as receive
|
|
* window for the next IPC. This can be used to make
|
|
* sure that the to be received mapped capability will
|
|
* be placed at a specific index.
|
|
*/
|
|
void rcv_window(addr_t rcv) { _rcv_window = rcv; }
|
|
|
|
/**
|
|
* Return the selector of the rcv_window.
|
|
*/
|
|
addr_t rcv_window() const { return _rcv_window; }
|
|
|
|
/**
|
|
* Return an invalid Dst object
|
|
*/
|
|
static Dst invalid() { return Dst(); }
|
|
|
|
/**
|
|
* Return a invalid Native_capability
|
|
*/
|
|
static Native_capability invalid_cap()
|
|
{
|
|
return Native_capability();
|
|
}
|
|
|
|
Raw raw() const { return Raw(); }
|
|
};
|
|
}
|
|
|
|
#endif /* _INCLUDE__BASE__NATIVE_CAPABILITY_H_ */
|