Relicense Sortix to the ISC license.
I hereby relicense all my work on Sortix under the ISC license as below.
All Sortix contributions by other people are already under this license,
are not substantial enough to be copyrightable, or have been removed.
All imported code from other projects is compatible with this license.
All GPL licensed code from other projects had previously been removed.
Copyright 2011-2016 Jonas 'Sortie' Termansen and contributors.
Permission to use, copy, modify, and distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
2016-03-02 22:38:16 +00:00
|
|
|
/*
|
2021-02-06 20:23:43 +00:00
|
|
|
* Copyright (c) 2011, 2012, 2013, 2014, 2017, 2021 Jonas 'Sortie' Termansen.
|
Relicense Sortix to the ISC license.
I hereby relicense all my work on Sortix under the ISC license as below.
All Sortix contributions by other people are already under this license,
are not substantial enough to be copyrightable, or have been removed.
All imported code from other projects is compatible with this license.
All GPL licensed code from other projects had previously been removed.
Copyright 2011-2016 Jonas 'Sortie' Termansen and contributors.
Permission to use, copy, modify, and distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
2016-03-02 22:38:16 +00:00
|
|
|
*
|
|
|
|
|
* Permission to use, copy, modify, and distribute this software for any
|
|
|
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
|
|
|
* copyright notice and this permission notice appear in all copies.
|
|
|
|
|
*
|
|
|
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
|
|
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
|
|
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
|
|
|
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
|
|
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
|
|
|
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
|
|
|
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
|
*
|
|
|
|
|
* sortix/kernel/interrupt.h
|
|
|
|
|
* High level interrupt services.
|
|
|
|
|
*/
|
2012-02-29 12:36:11 +00:00
|
|
|
|
2022-07-07 23:09:15 +00:00
|
|
|
#ifndef _INCLUDE_SORTIX_KERNEL_INTERRUPT_H
|
|
|
|
|
#define _INCLUDE_SORTIX_KERNEL_INTERRUPT_H
|
2012-02-29 12:36:11 +00:00
|
|
|
|
2013-10-27 21:17:11 +00:00
|
|
|
#include <stddef.h>
|
|
|
|
|
|
2013-01-09 22:30:36 +00:00
|
|
|
#include <sortix/kernel/decl.h>
|
2014-03-03 23:11:13 +00:00
|
|
|
#include <sortix/kernel/registers.h>
|
2013-01-09 22:30:36 +00:00
|
|
|
|
2014-01-31 12:19:27 +00:00
|
|
|
namespace Sortix {
|
2014-09-29 21:17:36 +00:00
|
|
|
|
|
|
|
|
struct interrupt_context;
|
|
|
|
|
|
2017-03-24 22:44:55 +00:00
|
|
|
class Thread;
|
|
|
|
|
|
2014-09-29 21:17:36 +00:00
|
|
|
struct interrupt_handler
|
|
|
|
|
{
|
|
|
|
|
void (*handler)(struct interrupt_context*, void*);
|
|
|
|
|
void* context;
|
|
|
|
|
struct interrupt_handler* next;
|
|
|
|
|
struct interrupt_handler* prev;
|
|
|
|
|
};
|
|
|
|
|
|
2017-03-24 22:13:54 +00:00
|
|
|
struct interrupt_work
|
|
|
|
|
{
|
|
|
|
|
struct interrupt_work* next;
|
|
|
|
|
void (*handler)(void*);
|
|
|
|
|
void* context;
|
|
|
|
|
};
|
|
|
|
|
|
2014-09-29 21:17:36 +00:00
|
|
|
} // namespace Sortix
|
|
|
|
|
|
|
|
|
|
namespace Sortix {
|
2012-02-29 12:36:11 +00:00
|
|
|
namespace Interrupt {
|
|
|
|
|
|
2014-01-31 12:19:27 +00:00
|
|
|
#if defined(__i386__) || defined(__x86_64__)
|
2013-06-19 22:01:04 +00:00
|
|
|
const unsigned int IRQ0 = 32;
|
|
|
|
|
const unsigned int IRQ1 = 33;
|
|
|
|
|
const unsigned int IRQ2 = 34;
|
|
|
|
|
const unsigned int IRQ3 = 35;
|
|
|
|
|
const unsigned int IRQ4 = 36;
|
|
|
|
|
const unsigned int IRQ5 = 37;
|
|
|
|
|
const unsigned int IRQ6 = 38;
|
|
|
|
|
const unsigned int IRQ7 = 39;
|
|
|
|
|
const unsigned int IRQ8 = 40;
|
|
|
|
|
const unsigned int IRQ9 = 41;
|
|
|
|
|
const unsigned int IRQ10 = 42;
|
|
|
|
|
const unsigned int IRQ11 = 43;
|
|
|
|
|
const unsigned int IRQ12 = 44;
|
|
|
|
|
const unsigned int IRQ13 = 45;
|
|
|
|
|
const unsigned int IRQ14 = 46;
|
|
|
|
|
const unsigned int IRQ15 = 47;
|
2014-01-31 12:19:27 +00:00
|
|
|
#endif
|
2012-02-29 12:36:11 +00:00
|
|
|
|
Multithreaded kernel and improvement of signal handling.
Pardon the big ass-commit, this took months to develop and debug and the
refactoring got so far that a clean merge became impossible. The good news
is that this commit does quite a bit of cleaning up and generally improves
the kernel quality.
This makes the kernel fully pre-emptive and multithreaded. This was done
by rewriting the interrupt code, the scheduler, introducing new threading
primitives, and rewriting large parts of the kernel. During the past few
commits the kernel has had its device drivers thread secured; this commit
thread secures large parts of the core kernel. There still remains some
parts of the kernel that is _not_ thread secured, but this is not a problem
at this point. Each user-space thread has an associated kernel stack that
it uses when it goes into kernel mode. This stack is by default 8 KiB since
that value works for me and is also used by Linux. Strange things tends to
happen on x86 in case of a stack overflow - there is no ideal way to catch
such a situation right now.
The system call conventions were changed, too. The %edx register is now
used to provide the errno value of the call, instead of the kernel writing
it into a registered global variable. The system call code has also been
updated to better reflect the native calling conventions: not all registers
have to be preserved. This makes system calls faster and simplifies the
assembly. In the kernel, there is no longer the event.h header or the hacky
method of 'resuming system calls' that closely resembles cooperative
multitasking. If a system call wants to block, it should just block.
The signal handling was also improved significantly. At this point, signals
cannot interrupt kernel threads (but can always interrupt user-space threads
if enabled), which introduces some problems with how a SIGINT could
interrupt a blocking read, for instance. This commit introduces and uses a
number of new primitives such as kthread_lock_mutex_signal() that attempts
to get the lock but fails if a signal is pending. In this manner, the kernel
is safer as kernel threads cannot be shut down inconveniently, but in return
for complexity as blocking operations must check they if they should fail.
Process exiting has also been refactored significantly. The _exit(2) system
call sets the exit code and sends SIGKILL to all the threads in the process.
Once all the threads have cleaned themselves up and exited, a worker thread
calls the process's LastPrayer() method that unmaps memory, deletes the
address space, notifies the parent, etc. This provides a very robust way to
terminate processes as even half-constructed processes (during a failing fork
for instance) can be gracefully terminated.
I have introduced a number of kernel threads to help avoid threading problems
and simplify kernel design. For instance, there is now a functional generic
kernel worker thread that any kernel thread can schedule jobs for. Interrupt
handlers run with interrupts off (hence they cannot call kthread_ functions
as it may deadlock the system if another thread holds the lock) therefore
they cannot use the standard kernel worker threads. Instead, they use a
special purpose interrupt worker thread that works much like the generic one
expect that interrupt handlers can safely queue work with interrupts off.
Note that this also means that interrupt handlers cannot allocate memory or
print to the kernel log/screen as such mechanisms uses locks. I'll introduce
a lock free algorithm for such cases later on.
The boot process has also changed. The original kernel init thread in
kernel.cpp creates a new bootstrap thread and becomes the system idle thread.
Note that pid=0 now means the kernel, as there is no longer a system idle
process. The bootstrap thread launches all the kernel worker threads and then
creates a new process and loads /bin/init into it and then creates a thread
in pid=1, which starts the system. The bootstrap thread then quietly waits
for pid=1 to exit after which it shuts down/reboots/panics the system.
In general, the introduction of race conditions and dead locks have forced me
to revise a lot of the design and make sure it was thread secure. Since early
parts of the kernel was quite hacky, I had to refactor such code. So it seems
that the risk of dead locks forces me to write better code.
Note that a real preemptive multithreaded kernel simplifies the construction
of blocking system calls. My hope is that this will trigger a clean up of
the filesystem code that current is almost beyond repair.
Almost all of the kernel was modified during this refactoring. To the extent
possible, these changes have been backported to older non-multithreaded
kernel, but many changes were tightly coupled and went into this commit.
Of interest is the implementation of the kthread_ api based on the design
of pthreads; this library allows easy synchronization mechanisms and
includes C++-style scoped locks. This commit also introduces new worker
threads and tested mechanisms for interrupt handlers to schedule work in a
kernel worker thread.
A lot of code have been rewritten from scratch and has become a lot more
stable and correct.
Share and enjoy!
2012-08-01 15:30:34 +00:00
|
|
|
extern "C" unsigned long asm_is_cpu_interrupted;
|
2012-04-11 13:46:32 +00:00
|
|
|
|
2014-01-31 12:19:27 +00:00
|
|
|
inline bool IsEnabled()
|
|
|
|
|
{
|
|
|
|
|
#if defined(__i386__) || defined(__x86_64__)
|
|
|
|
|
unsigned long is_enabled;
|
|
|
|
|
asm("pushf\t\n"
|
|
|
|
|
"pop %0\t\n"
|
|
|
|
|
"and $0x000200, %0" : "=r"(is_enabled));
|
|
|
|
|
return is_enabled != 0;
|
|
|
|
|
#else
|
|
|
|
|
#warning "You need to implement checking if interrupts are on"
|
|
|
|
|
#endif
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
inline void Enable()
|
|
|
|
|
{
|
|
|
|
|
#if defined(__i386__) || defined(__x86_64__)
|
|
|
|
|
asm volatile("sti");
|
|
|
|
|
#else
|
|
|
|
|
#warning "You need to implement enabling interrupts"
|
|
|
|
|
#endif
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
inline void Disable()
|
|
|
|
|
{
|
|
|
|
|
#if defined(__i386__) || defined(__x86_64__)
|
|
|
|
|
asm volatile("cli");
|
|
|
|
|
#else
|
|
|
|
|
#warning "You need to implement disabling interrupts"
|
|
|
|
|
#endif
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
inline bool IsCPUInterrupted()
|
|
|
|
|
{
|
|
|
|
|
return asm_is_cpu_interrupted != 0;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
inline bool SetEnabled(bool is_enabled)
|
2012-04-13 15:42:21 +00:00
|
|
|
{
|
2021-02-06 20:23:43 +00:00
|
|
|
bool was_enabled = IsEnabled();
|
2014-01-31 12:19:27 +00:00
|
|
|
if ( is_enabled )
|
|
|
|
|
Enable();
|
|
|
|
|
else
|
|
|
|
|
Disable();
|
2021-02-06 20:23:43 +00:00
|
|
|
return was_enabled;
|
2012-04-13 15:42:21 +00:00
|
|
|
}
|
2012-02-29 12:36:11 +00:00
|
|
|
|
2014-09-29 21:17:36 +00:00
|
|
|
void RegisterHandler(unsigned int index, struct interrupt_handler* handler);
|
|
|
|
|
void UnregisterHandler(unsigned int index, struct interrupt_handler* handler);
|
2012-02-29 12:36:11 +00:00
|
|
|
void Init();
|
Multithreaded kernel and improvement of signal handling.
Pardon the big ass-commit, this took months to develop and debug and the
refactoring got so far that a clean merge became impossible. The good news
is that this commit does quite a bit of cleaning up and generally improves
the kernel quality.
This makes the kernel fully pre-emptive and multithreaded. This was done
by rewriting the interrupt code, the scheduler, introducing new threading
primitives, and rewriting large parts of the kernel. During the past few
commits the kernel has had its device drivers thread secured; this commit
thread secures large parts of the core kernel. There still remains some
parts of the kernel that is _not_ thread secured, but this is not a problem
at this point. Each user-space thread has an associated kernel stack that
it uses when it goes into kernel mode. This stack is by default 8 KiB since
that value works for me and is also used by Linux. Strange things tends to
happen on x86 in case of a stack overflow - there is no ideal way to catch
such a situation right now.
The system call conventions were changed, too. The %edx register is now
used to provide the errno value of the call, instead of the kernel writing
it into a registered global variable. The system call code has also been
updated to better reflect the native calling conventions: not all registers
have to be preserved. This makes system calls faster and simplifies the
assembly. In the kernel, there is no longer the event.h header or the hacky
method of 'resuming system calls' that closely resembles cooperative
multitasking. If a system call wants to block, it should just block.
The signal handling was also improved significantly. At this point, signals
cannot interrupt kernel threads (but can always interrupt user-space threads
if enabled), which introduces some problems with how a SIGINT could
interrupt a blocking read, for instance. This commit introduces and uses a
number of new primitives such as kthread_lock_mutex_signal() that attempts
to get the lock but fails if a signal is pending. In this manner, the kernel
is safer as kernel threads cannot be shut down inconveniently, but in return
for complexity as blocking operations must check they if they should fail.
Process exiting has also been refactored significantly. The _exit(2) system
call sets the exit code and sends SIGKILL to all the threads in the process.
Once all the threads have cleaned themselves up and exited, a worker thread
calls the process's LastPrayer() method that unmaps memory, deletes the
address space, notifies the parent, etc. This provides a very robust way to
terminate processes as even half-constructed processes (during a failing fork
for instance) can be gracefully terminated.
I have introduced a number of kernel threads to help avoid threading problems
and simplify kernel design. For instance, there is now a functional generic
kernel worker thread that any kernel thread can schedule jobs for. Interrupt
handlers run with interrupts off (hence they cannot call kthread_ functions
as it may deadlock the system if another thread holds the lock) therefore
they cannot use the standard kernel worker threads. Instead, they use a
special purpose interrupt worker thread that works much like the generic one
expect that interrupt handlers can safely queue work with interrupts off.
Note that this also means that interrupt handlers cannot allocate memory or
print to the kernel log/screen as such mechanisms uses locks. I'll introduce
a lock free algorithm for such cases later on.
The boot process has also changed. The original kernel init thread in
kernel.cpp creates a new bootstrap thread and becomes the system idle thread.
Note that pid=0 now means the kernel, as there is no longer a system idle
process. The bootstrap thread launches all the kernel worker threads and then
creates a new process and loads /bin/init into it and then creates a thread
in pid=1, which starts the system. The bootstrap thread then quietly waits
for pid=1 to exit after which it shuts down/reboots/panics the system.
In general, the introduction of race conditions and dead locks have forced me
to revise a lot of the design and make sure it was thread secure. Since early
parts of the kernel was quite hacky, I had to refactor such code. So it seems
that the risk of dead locks forces me to write better code.
Note that a real preemptive multithreaded kernel simplifies the construction
of blocking system calls. My hope is that this will trigger a clean up of
the filesystem code that current is almost beyond repair.
Almost all of the kernel was modified during this refactoring. To the extent
possible, these changes have been backported to older non-multithreaded
kernel, but many changes were tightly coupled and went into this commit.
Of interest is the implementation of the kthread_ api based on the design
of pthreads; this library allows easy synchronization mechanisms and
includes C++-style scoped locks. This commit also introduces new worker
threads and tested mechanisms for interrupt handlers to schedule work in a
kernel worker thread.
A lot of code have been rewritten from scratch and has become a lot more
stable and correct.
Share and enjoy!
2012-08-01 15:30:34 +00:00
|
|
|
void WorkerThread(void* user);
|
2017-03-24 22:13:54 +00:00
|
|
|
void ScheduleWork(struct interrupt_work* work);
|
2012-02-29 12:36:11 +00:00
|
|
|
|
2017-03-24 22:44:55 +00:00
|
|
|
extern Thread* interrupt_worker_thread;
|
|
|
|
|
extern bool interrupt_worker_thread_boost;
|
|
|
|
|
|
2012-02-29 12:36:11 +00:00
|
|
|
} // namespace Interrupt
|
|
|
|
|
} // namespace Sortix
|
|
|
|
|
|
2011-08-05 12:25:00 +00:00
|
|
|
#endif
|