bf92232698
This patch is the first step of re-organizing the internal structure of the libc. The original version involved many direct calls of global functions (often with side effects) across compilation units, which made the control flow (e.g., the initialization sequence) hard to follow. The new version replaces those ad-hoc interactions with dedicated interfaces (like suspend.h, resume.h, select.h, current_time.h). The underlying facilities are provided by the central Libc::Kernel and selectively propagated to the various compilation units. The latter is done by a sequence of 'init_*' calls, which eventually will be replaced by constructor calls. The addition of new headers increases the chance for name clashes with existing (public) headers. To disambiguate libc-internal header files from public headers, this patch moves the former into a new 'internal/' subdirectory. This makes the include directives easier to follow and the libc's source-tree structure more tidy. There are still a few legacies left, which cannot easily be removed right now (e.g., because noux relies on them). However, the patch moves those bad apples to legacy.h and legacy.cc, which highlights the deprecation of those functions. Issue #3497
47 lines
1.1 KiB
C++
47 lines
1.1 KiB
C++
/*
|
|
* \brief Interface executing code in the context of the libc kernel
|
|
* \author Norman Feske
|
|
* \date 2019-09-18
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2019 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 _LIBC__INTERNAL__KERNEL_ROUTINE_H_
|
|
#define _LIBC__INTERNAL__KERNEL_ROUTINE_H_
|
|
|
|
/* libc-internal includes */
|
|
#include <internal/types.h>
|
|
|
|
namespace Libc {
|
|
|
|
/**
|
|
* Base class to be implemented by a kernel routine
|
|
*/
|
|
struct Kernel_routine : Interface
|
|
{
|
|
virtual void execute_in_kernel() = 0;
|
|
};
|
|
|
|
struct Kernel_routine_scheduler : Interface
|
|
{
|
|
/**
|
|
* Register routine to be called once on the next libc-kernel activation
|
|
*
|
|
* The specified routine is executed only once. For a repeated execution,
|
|
* the routine must call 'register_kernel_routine' with itself as
|
|
* argument.
|
|
*
|
|
* This mechanism is used by 'fork' to implement the blocking for the
|
|
* startup of a new child and for 'wait4'.
|
|
*/
|
|
virtual void register_kernel_routine(Kernel_routine &) = 0;
|
|
};
|
|
}
|
|
|
|
#endif /* _LIBC__INTERNAL__KERNEL_ROUTINE_H_ */
|