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
126 lines
3.4 KiB
C++
126 lines
3.4 KiB
C++
/*
|
|
* \brief Environment of a component
|
|
* \author Norman Feske
|
|
* \date 2006-07-01
|
|
*
|
|
* \deprecated This interface will be removed once all components are
|
|
* adjusted to the new API of base/component.h
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2006-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__DEPRECATED__ENV_H_
|
|
#define _INCLUDE__DEPRECATED__ENV_H_
|
|
|
|
#include <parent/capability.h>
|
|
#include <parent/parent.h>
|
|
#include <region_map/region_map.h>
|
|
#include <rm_session/rm_session.h> /* deprecated, kept for API compatibility only */
|
|
#include <ram_session/ram_session.h>
|
|
#include <cpu_session/cpu_session.h>
|
|
#include <cpu_session/capability.h>
|
|
#include <pd_session/capability.h>
|
|
#include <base/allocator.h>
|
|
#include <base/snprintf.h>
|
|
#include <base/lock.h>
|
|
|
|
namespace Genode {
|
|
|
|
struct Env_deprecated;
|
|
|
|
/**
|
|
* Return the interface to the component's environment
|
|
*/
|
|
extern Env_deprecated *env();
|
|
}
|
|
|
|
|
|
/**
|
|
* Component runtime environment
|
|
*
|
|
* The environment of a Genode component is defined by its parent. The 'Env'
|
|
* class allows the component to interact with its environment. It is
|
|
* initialized at the startup of the component.
|
|
*/
|
|
struct Genode::Env_deprecated
|
|
{
|
|
/**
|
|
* Communication channel to our parent
|
|
*/
|
|
virtual Parent *parent() = 0;
|
|
|
|
/**
|
|
* RAM session of the component
|
|
*
|
|
* The RAM Session represents a budget of memory (quota) that is
|
|
* available to the component. This budget can be used to allocate
|
|
* RAM dataspaces.
|
|
*/
|
|
virtual Ram_session *ram_session() = 0;
|
|
virtual Ram_session_capability ram_session_cap() = 0;
|
|
|
|
/**
|
|
* CPU session of the component
|
|
*
|
|
* This session is used to create the threads of the component.
|
|
*/
|
|
virtual Cpu_session *cpu_session() = 0;
|
|
virtual Cpu_session_capability cpu_session_cap() = 0;
|
|
|
|
/**
|
|
* Region-manager session of the component as created by the parent
|
|
*
|
|
* \deprecated This function exists for API compatibility only.
|
|
* The functionality of the former RM service is now
|
|
* provided by the 'Region_map' interface.
|
|
*/
|
|
virtual Region_map *rm_session() = 0;
|
|
|
|
/**
|
|
* PD session of the component as created by the parent
|
|
*/
|
|
virtual Pd_session *pd_session() = 0;
|
|
virtual Pd_session_capability pd_session_cap() = 0;
|
|
|
|
/**
|
|
* Heap backed by the RAM session of the environment
|
|
*/
|
|
virtual Allocator *heap() = 0;
|
|
|
|
/**
|
|
* Reload parent capability and reinitialize environment resources
|
|
*
|
|
* This function is solely used for implementing fork semantics.
|
|
* After forking a process, the new child process is executed
|
|
* within a copy of the address space of the forking process.
|
|
* Thereby, the new process inherits the original 'env' object of
|
|
* the forking process, which is meaningless in the context of the
|
|
* new process. By calling this function, the new process is able
|
|
* to reinitialize its 'env' with meaningful capabilities obtained
|
|
* via its updated parent capability.
|
|
*
|
|
* \noapi
|
|
*/
|
|
virtual void reinit(Native_capability::Raw) = 0;
|
|
|
|
/**
|
|
* Reinitialize main-thread object
|
|
*
|
|
* \param stack_area_rm new RM session of the stack area
|
|
*
|
|
* This function is solely used for implementing fork semantics
|
|
* as provided by the Noux environment.
|
|
*
|
|
* \noapi
|
|
*/
|
|
virtual void reinit_main_thread(Capability<Region_map> &stack_area_rm) = 0;
|
|
|
|
};
|
|
|
|
#endif /* _INCLUDE__DEPRECATED__ENV_H_ */
|