b49e588c1c
This patch replaces the former 'Pd_session::bind_thread' function by a PD-capability argument of the 'Cpu_session::create_thread' function, and removes the ancient thread-start protocol via 'Rm_session::add_client' and 'Cpu_session::set_pager'. Threads are now bound to PDs at their creation time and implicitly paged according to the address space of the PD. Note the API change: This patch changes the signature of the 'Child' and 'Process' constructors. There is a new 'address_space' argument, which represents the region map representing the child's address space. It is supplied separately to the PD session capability (which principally can be invoked to obtain the PD's address space) to allow the population of the address space without relying on an 'Pd_session::address_space' RPC call. Furthermore, a new (optional) env_pd argument allows the explicit overriding of the PD capability handed out to the child as part of its environment. It can be used to intercept the interaction of the child with its PD session at core. This is used by Noux. Issue #1938
187 lines
3.6 KiB
C++
187 lines
3.6 KiB
C++
/*
|
|
* \brief Thread facility
|
|
* \author Norman Feske
|
|
* \date 2015-05-01
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2015 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 _CORE__INCLUDE__PLATFORM_THREAD_H_
|
|
#define _CORE__INCLUDE__PLATFORM_THREAD_H_
|
|
|
|
/* Genode includes */
|
|
#include <base/thread_state.h>
|
|
#include <base/native_types.h>
|
|
#include <util/string.h>
|
|
|
|
/* core includes */
|
|
#include <pager.h>
|
|
#include <ipc_pager.h>
|
|
#include <address_space.h>
|
|
#include <thread_sel4.h>
|
|
#include <install_mapping.h>
|
|
|
|
namespace Genode {
|
|
|
|
class Platform_pd;
|
|
class Platform_thread;
|
|
}
|
|
|
|
|
|
class Genode::Platform_thread : public List<Platform_thread>::Element
|
|
{
|
|
private:
|
|
|
|
Pager_object *_pager = nullptr;
|
|
|
|
String<128> _name;
|
|
|
|
/**
|
|
* Virtual address of the IPC buffer within the PDs address space
|
|
*
|
|
* The value is 0 for the PD's main thread. For all other threads,
|
|
* the value is somewhere within the stack area.
|
|
*/
|
|
addr_t const _utcb;
|
|
|
|
Thread_info _info;
|
|
|
|
Cap_sel const _pager_obj_sel;
|
|
|
|
/*
|
|
* Selectors within the PD's CSpace
|
|
*
|
|
* Allocated when the thread is started.
|
|
*/
|
|
Cap_sel _fault_handler_sel { 0 };
|
|
Cap_sel _ep_sel { 0 };
|
|
|
|
friend class Platform_pd;
|
|
|
|
Platform_pd *_pd = nullptr;
|
|
|
|
enum { INITIAL_IPC_BUFFER_VIRT = 0x1000 };
|
|
|
|
public:
|
|
|
|
/**
|
|
* Constructor
|
|
*/
|
|
Platform_thread(size_t, const char *name = 0, unsigned priority = 0,
|
|
Affinity::Location = Affinity::Location(), addr_t utcb = 0);
|
|
|
|
/**
|
|
* Destructor
|
|
*/
|
|
~Platform_thread();
|
|
|
|
/**
|
|
* Start thread
|
|
*
|
|
* \param ip instruction pointer to start at
|
|
* \param sp stack pointer to use
|
|
* \param cpu_no target cpu
|
|
*
|
|
* \retval 0 successful
|
|
* \retval -1 thread could not be started
|
|
*/
|
|
int start(void *ip, void *sp, unsigned int cpu_no = 0);
|
|
|
|
/**
|
|
* Pause this thread
|
|
*/
|
|
void pause();
|
|
|
|
/**
|
|
* Enable/disable single stepping
|
|
*/
|
|
void single_step(bool) { }
|
|
|
|
/**
|
|
* Resume this thread
|
|
*/
|
|
void resume();
|
|
|
|
/**
|
|
* Cancel currently blocking operation
|
|
*/
|
|
void cancel_blocking();
|
|
|
|
/**
|
|
* Override thread state with 's'
|
|
*
|
|
* \throw Cpu_session::State_access_failed
|
|
*/
|
|
void state(Thread_state s);
|
|
|
|
/**
|
|
* Read thread state
|
|
*
|
|
* \throw Cpu_session::State_access_failed
|
|
*/
|
|
Thread_state state();
|
|
|
|
/**
|
|
* Return the address space to which the thread is bound
|
|
*/
|
|
Weak_ptr<Address_space> address_space();
|
|
|
|
/**
|
|
* Return execution time consumed by the thread
|
|
*/
|
|
unsigned long long execution_time() const { return 0; }
|
|
|
|
|
|
/************************
|
|
** Accessor functions **
|
|
************************/
|
|
|
|
/**
|
|
* Set pager capability
|
|
*/
|
|
Pager_object *pager(Pager_object *pager) const { return _pager; }
|
|
void pager(Pager_object *pager) { _pager = pager; }
|
|
Pager_object *pager() { return _pager; }
|
|
|
|
/**
|
|
* Return identification of thread when faulting
|
|
*/
|
|
unsigned long pager_object_badge() const { return _pager_obj_sel.value(); }
|
|
|
|
/**
|
|
* Set the executing CPU for this thread
|
|
*/
|
|
void affinity(Affinity::Location) { }
|
|
|
|
/**
|
|
* Get the executing CPU for this thread
|
|
*/
|
|
Affinity::Location affinity() const { return Affinity::Location(); }
|
|
|
|
/**
|
|
* Set CPU quota of the thread
|
|
*/
|
|
void quota(size_t) { /* not supported */ }
|
|
|
|
/**
|
|
* Get thread name
|
|
*/
|
|
const char *name() const { return "noname"; }
|
|
|
|
|
|
/*****************************
|
|
** seL4-specific interface **
|
|
*****************************/
|
|
|
|
Cap_sel tcb_sel() const { return _info.tcb_sel; }
|
|
|
|
void install_mapping(Mapping const &mapping);
|
|
};
|
|
|
|
#endif /* _CORE__INCLUDE__PLATFORM_THREAD_H_ */
|