mirror of
https://github.com/genodelabs/genode.git
synced 2024-12-26 08:51:08 +00:00
b1f63e3356
This patch removes 'platform_env.h' from the public API headers because this header was not part of the API anyway.
104 lines
2.5 KiB
C++
104 lines
2.5 KiB
C++
/*
|
|
* \brief Environment of a process
|
|
* \author Norman Feske
|
|
* \date 2006-07-01
|
|
*
|
|
* The environment of a Genode process is defined by its parent and initialized
|
|
* on startup.
|
|
*/
|
|
|
|
/*
|
|
* 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__BASE__ENV_H_
|
|
#define _INCLUDE__BASE__ENV_H_
|
|
|
|
#include <parent/capability.h>
|
|
#include <parent/parent.h>
|
|
#include <rm_session/rm_session.h>
|
|
#include <ram_session/ram_session.h>
|
|
#include <cpu_session/cpu_session.h>
|
|
#include <cpu_session/capability.h>
|
|
#include <pd_session/pd_session.h>
|
|
#include <base/allocator.h>
|
|
#include <base/snprintf.h>
|
|
#include <base/lock.h>
|
|
|
|
namespace Genode {
|
|
|
|
class Env
|
|
{
|
|
public:
|
|
|
|
virtual ~Env() { }
|
|
|
|
/**
|
|
* Communication channel to our parent
|
|
*/
|
|
virtual Parent *parent() = 0;
|
|
|
|
/**
|
|
* RAM session for the program
|
|
*
|
|
* The RAM Session represents a quota of memory that is
|
|
* available to the program. Quota can be used to allocate
|
|
* RAM-Dataspaces.
|
|
*/
|
|
virtual Ram_session *ram_session() = 0;
|
|
virtual Ram_session_capability ram_session_cap() = 0;
|
|
|
|
/**
|
|
* CPU session for the program
|
|
*
|
|
* This session is used to create threads.
|
|
*/
|
|
virtual Cpu_session *cpu_session() = 0;
|
|
virtual Cpu_session_capability cpu_session_cap() = 0;
|
|
|
|
/**
|
|
* Region manager session of the program
|
|
*/
|
|
virtual Rm_session *rm_session() = 0;
|
|
|
|
/**
|
|
* Pd session of the program
|
|
*/
|
|
virtual Pd_session *pd_session() = 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.
|
|
*/
|
|
virtual void reload_parent_cap(Capability<Parent>::Dst, long) = 0;
|
|
};
|
|
|
|
extern Env *env();
|
|
|
|
/**
|
|
* Return parent capability
|
|
*
|
|
* Platforms have to implement this function for environment
|
|
* initialization.
|
|
*/
|
|
Parent_capability parent_cap();
|
|
}
|
|
|
|
#endif /* _INCLUDE__BASE__ENV_H_ */
|