mirror of
https://github.com/genodelabs/genode.git
synced 2025-01-13 08:19:56 +00:00
aa66b5d62f
This patch adjusts the implementation of the base library and core such that the code no longer relies on deprecated APIs except for very few cases, mainly to keep those deprecated APIs in tact for now. The most prominent changes are: - Removing the use of base/printf.h - Removing of the log backend for printf. The 'Console' with the format-string parser is still there along with 'snprintf.h' because the latter is still used at a few places, most prominently the 'Connection' classes. - Removing the notion of a RAM session, which does not exist in Genode anymore. Still the types were preserved (by typedefs to PD session) to keep up compatibility. But this transition should come to an end now. - Slight rennovation of core's tracing service, e.g., the use of an Attached_dataspace as the Argument_buffer. - Reducing the reliance on global accessors like deprecated_env() or core_env(). Still there is a longish way to go to eliminate all such calls. A useful pattern (or at least a stop-gap solution) is to pass the 'Env' to the individual compilation units via init functions. - Avoiding the use of the old 'Child_policy::resolve_session_request' interface that returned a 'Service' instead of a 'Route'. Issue #1987
139 lines
3.7 KiB
C++
139 lines
3.7 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-2017 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 _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/capability.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
|
|
*
|
|
* \noapi
|
|
* \deprecated
|
|
*/
|
|
extern Env_deprecated *env_deprecated();
|
|
|
|
/**
|
|
* Return the interface to the component's environment
|
|
*
|
|
* \deprecated
|
|
*/
|
|
static inline Env_deprecated *env() __attribute__((deprecated));
|
|
static inline Env_deprecated *env()
|
|
{
|
|
return env_deprecated();
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* 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 : Interface
|
|
{
|
|
/**
|
|
* 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() { return pd_session(); }
|
|
virtual Ram_session_capability ram_session_cap() { return pd_session_cap(); }
|
|
|
|
/**
|
|
* 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_ */
|