2005-07-14 17:26:26 +02:00
|
|
|
#ifndef CONFIG_H
|
|
|
|
|
#define CONFIG_H
|
|
|
|
|
|
|
|
|
|
/* This file defines the kernel configuration. It allows to set sizes of some
|
|
|
|
|
* kernel buffers and to enable or disable debugging code, timing features,
|
|
|
|
|
* and individual kernel calls.
|
|
|
|
|
*
|
2005-08-04 11:26:36 +02:00
|
|
|
* Changes:
|
|
|
|
|
* Jul 11, 2005 Created. (Jorrit N. Herder)
|
2005-07-14 17:26:26 +02:00
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/* In embedded and sensor applications, not all the kernel calls may be
|
|
|
|
|
* needed. In this section you can specify which kernel calls are needed
|
|
|
|
|
* and which are not. The code for unneeded kernel calls is not included in
|
|
|
|
|
* the system binary, making it smaller. If you are not sure, it is best
|
|
|
|
|
* to keep all kernel calls enabled.
|
|
|
|
|
*/
|
2005-09-11 18:44:06 +02:00
|
|
|
#define USE_FORK 1 /* fork a new process */
|
|
|
|
|
#define USE_NEWMAP 1 /* set a new memory map */
|
|
|
|
|
#define USE_EXEC 1 /* update process after execute */
|
New RS and new signal handling for system processes.
UPDATING INFO:
20100317:
/usr/src/etc/system.conf updated to ignore default kernel calls: copy
it (or merge it) to /etc/system.conf.
The hello driver (/dev/hello) added to the distribution:
# cd /usr/src/commands/scripts && make clean install
# cd /dev && MAKEDEV hello
KERNEL CHANGES:
- Generic signal handling support. The kernel no longer assumes PM as a signal
manager for every process. The signal manager of a given process can now be
specified in its privilege slot. When a signal has to be delivered, the kernel
performs the lookup and forwards the signal to the appropriate signal manager.
PM is the default signal manager for user processes, RS is the default signal
manager for system processes. To enable ptrace()ing for system processes, it
is sufficient to change the default signal manager to PM. This will temporarily
disable crash recovery, though.
- sys_exit() is now split into sys_exit() (i.e. exit() for system processes,
which generates a self-termination signal), and sys_clear() (i.e. used by PM
to ask the kernel to clear a process slot when a process exits).
- Added a new kernel call (i.e. sys_update()) to swap two process slots and
implement live update.
PM CHANGES:
- Posix signal handling is no longer allowed for system processes. System
signals are split into two fixed categories: termination and non-termination
signals. When a non-termination signaled is processed, PM transforms the signal
into an IPC message and delivers the message to the system process. When a
termination signal is processed, PM terminates the process.
- PM no longer assumes itself as the signal manager for system processes. It now
makes sure that every system signal goes through the kernel before being
actually processes. The kernel will then dispatch the signal to the appropriate
signal manager which may or may not be PM.
SYSLIB CHANGES:
- Simplified SEF init and LU callbacks.
- Added additional predefined SEF callbacks to debug crash recovery and
live update.
- Fixed a temporary ack in the SEF init protocol. SEF init reply is now
completely synchronous.
- Added SEF signal event type to provide a uniform interface for system
processes to deal with signals. A sef_cb_signal_handler() callback is
available for system processes to handle every received signal. A
sef_cb_signal_manager() callback is used by signal managers to process
system signals on behalf of the kernel.
- Fixed a few bugs with memory mapping and DS.
VM CHANGES:
- Page faults and memory requests coming from the kernel are now implemented
using signals.
- Added a new VM call to swap two process slots and implement live update.
- The call is used by RS at update time and in turn invokes the kernel call
sys_update().
RS CHANGES:
- RS has been reworked with a better functional decomposition.
- Better kernel call masks. com.h now defines the set of very basic kernel calls
every system service is allowed to use. This makes system.conf simpler and
easier to maintain. In addition, this guarantees a higher level of isolation
for system libraries that use one or more kernel calls internally (e.g. printf).
- RS is the default signal manager for system processes. By default, RS
intercepts every signal delivered to every system process. This makes crash
recovery possible before bringing PM and friends in the loop.
- RS now supports fast rollback when something goes wrong while initializing
the new version during a live update.
- Live update is now implemented by keeping the two versions side-by-side and
swapping the process slots when the old version is ready to update.
- Crash recovery is now implemented by keeping the two versions side-by-side
and cleaning up the old version only when the recovery process is complete.
DS CHANGES:
- Fixed a bug when the process doing ds_publish() or ds_delete() is not known
by DS.
- Fixed the completely broken support for strings. String publishing is now
implemented in the system library and simply wraps publishing of memory ranges.
Ideally, we should adopt a similar approach for other data types as well.
- Test suite fixed.
DRIVER CHANGES:
- The hello driver has been added to the Minix distribution to demonstrate basic
live update and crash recovery functionalities.
- Other drivers have been adapted to conform the new SEF interface.
2010-03-17 02:15:29 +01:00
|
|
|
#define USE_CLEAR 1 /* clean up after process exit */
|
|
|
|
|
#define USE_EXIT 1 /* a system process wants to exit */
|
2005-09-11 18:44:06 +02:00
|
|
|
#define USE_TRACE 1 /* process information and tracing */
|
|
|
|
|
#define USE_GETKSIG 1 /* retrieve pending kernel signals */
|
|
|
|
|
#define USE_ENDKSIG 1 /* finish pending kernel signals */
|
|
|
|
|
#define USE_KILL 1 /* send a signal to a process */
|
|
|
|
|
#define USE_SIGSEND 1 /* send POSIX-style signal */
|
|
|
|
|
#define USE_SIGRETURN 1 /* sys_sigreturn(proc_nr, ctxt_ptr, flags) */
|
|
|
|
|
#define USE_ABORT 1 /* shut down MINIX */
|
|
|
|
|
#define USE_GETINFO 1 /* retrieve a copy of kernel data */
|
|
|
|
|
#define USE_TIMES 1 /* get process and system time info */
|
|
|
|
|
#define USE_SETALARM 1 /* schedule a synchronous alarm */
|
2009-08-15 23:37:26 +02:00
|
|
|
#define USE_VTIMER 1 /* set or retrieve a process-virtual timer */
|
2005-09-11 18:44:06 +02:00
|
|
|
#define USE_DEVIO 1 /* read or write a single I/O port */
|
|
|
|
|
#define USE_VDEVIO 1 /* process vector with I/O requests */
|
|
|
|
|
#define USE_SDEVIO 1 /* perform I/O request on a buffer */
|
|
|
|
|
#define USE_IRQCTL 1 /* set an interrupt policy */
|
|
|
|
|
#define USE_PRIVCTL 1 /* system privileges control */
|
|
|
|
|
#define USE_UMAP 1 /* map virtual to physical address */
|
2011-06-10 16:28:20 +02:00
|
|
|
#define USE_UMAP_REMOTE 1 /* sys_umap on behalf of another process */
|
2005-09-11 18:44:06 +02:00
|
|
|
#define USE_VIRCOPY 1 /* copy using virtual addressing */
|
|
|
|
|
#define USE_PHYSCOPY 1 /* copy using physical addressing */
|
|
|
|
|
#define USE_MEMSET 1 /* write char to a given memory area */
|
Merge of David's ptrace branch. Summary:
o Support for ptrace T_ATTACH/T_DETACH and T_SYSCALL
o PM signal handling logic should now work properly, even with debuggers
being present
o Asynchronous PM/VFS protocol, full IPC support for senda(), and
AMF_NOREPLY senda() flag
DETAILS
Process stop and delay call handling of PM:
o Added sys_runctl() kernel call with sys_stop() and sys_resume()
aliases, for PM to stop and resume a process
o Added exception for sending/syscall-traced processes to sys_runctl(),
and matching SIGKREADY pseudo-signal to PM
o Fixed PM signal logic to deal with requests from a process after
stopping it (so-called "delay calls"), using the SIGKREADY facility
o Fixed various PM panics due to race conditions with delay calls versus
VFS calls
o Removed special PRIO_STOP priority value
o Added SYS_LOCK RTS kernel flag, to stop an individual process from
running while modifying its process structure
Signal and debugger handling in PM:
o Fixed debugger signals being dropped if a second signal arrives when
the debugger has not retrieved the first one
o Fixed debugger signals being sent to the debugger more than once
o Fixed debugger signals unpausing process in VFS; removed PM_UNPAUSE_TR
protocol message
o Detached debugger signals from general signal logic and from being
blocked on VFS calls, meaning that even VFS can now be traced
o Fixed debugger being unable to receive more than one pending signal in
one process stop
o Fixed signal delivery being delayed needlessly when multiple signals
are pending
o Fixed wait test for tracer, which was returning for children that were
not waited for
o Removed second parallel pending call from PM to VFS for any process
o Fixed process becoming runnable between exec() and debugger trap
o Added support for notifying the debugger before the parent when a
debugged child exits
o Fixed debugger death causing child to remain stopped forever
o Fixed consistently incorrect use of _NSIG
Extensions to ptrace():
o Added T_ATTACH and T_DETACH ptrace request, to attach and detach a
debugger to and from a process
o Added T_SYSCALL ptrace request, to trace system calls
o Added T_SETOPT ptrace request, to set trace options
o Added TO_TRACEFORK trace option, to attach automatically to children
of a traced process
o Added TO_ALTEXEC trace option, to send SIGSTOP instead of SIGTRAP upon
a successful exec() of the tracee
o Extended T_GETUSER ptrace support to allow retrieving a process's priv
structure
o Removed T_STOP ptrace request again, as it does not help implementing
debuggers properly
o Added MINIX3-specific ptrace test (test42)
o Added proper manual page for ptrace(2)
Asynchronous PM/VFS interface:
o Fixed asynchronous messages not being checked when receive() is called
with an endpoint other than ANY
o Added AMF_NOREPLY senda() flag, preventing such messages from
satisfying the receive part of a sendrec()
o Added asynsend3() that takes optional flags; asynsend() is now a
#define passing in 0 as third parameter
o Made PM/VFS protocol asynchronous; reintroduced tell_fs()
o Made PM_BASE request/reply number range unique
o Hacked in a horrible temporary workaround into RS to deal with newly
revealed RS-PM-VFS race condition triangle until VFS is asynchronous
System signal handling:
o Fixed shutdown logic of device drivers; removed old SIGKSTOP signal
o Removed is-superuser check from PM's do_procstat() (aka getsigset())
o Added sigset macros to allow system processes to deal with the full
signal set, rather than just the POSIX subset
Miscellaneous PM fixes:
o Split do_getset into do_get and do_set, merging common code and making
structure clearer
o Fixed setpriority() being able to put to sleep processes using an
invalid parameter, or revive zombie processes
o Made find_proc() global; removed obsolete proc_from_pid()
o Cleanup here and there
Also included:
o Fixed false-positive boot order kernel warning
o Removed last traces of old NOTIFY_FROM code
THINGS OF POSSIBLE INTEREST
o It should now be possible to run PM at any priority, even lower than
user processes
o No assumptions are made about communication speed between PM and VFS,
although communication must be FIFO
o A debugger will now receive incoming debuggee signals at kill time
only; the process may not yet be fully stopped
o A first step has been made towards making the SYSTEM task preemptible
2009-09-30 11:57:22 +02:00
|
|
|
#define USE_RUNCTL 1 /* control stop flags of a process */
|
New RS and new signal handling for system processes.
UPDATING INFO:
20100317:
/usr/src/etc/system.conf updated to ignore default kernel calls: copy
it (or merge it) to /etc/system.conf.
The hello driver (/dev/hello) added to the distribution:
# cd /usr/src/commands/scripts && make clean install
# cd /dev && MAKEDEV hello
KERNEL CHANGES:
- Generic signal handling support. The kernel no longer assumes PM as a signal
manager for every process. The signal manager of a given process can now be
specified in its privilege slot. When a signal has to be delivered, the kernel
performs the lookup and forwards the signal to the appropriate signal manager.
PM is the default signal manager for user processes, RS is the default signal
manager for system processes. To enable ptrace()ing for system processes, it
is sufficient to change the default signal manager to PM. This will temporarily
disable crash recovery, though.
- sys_exit() is now split into sys_exit() (i.e. exit() for system processes,
which generates a self-termination signal), and sys_clear() (i.e. used by PM
to ask the kernel to clear a process slot when a process exits).
- Added a new kernel call (i.e. sys_update()) to swap two process slots and
implement live update.
PM CHANGES:
- Posix signal handling is no longer allowed for system processes. System
signals are split into two fixed categories: termination and non-termination
signals. When a non-termination signaled is processed, PM transforms the signal
into an IPC message and delivers the message to the system process. When a
termination signal is processed, PM terminates the process.
- PM no longer assumes itself as the signal manager for system processes. It now
makes sure that every system signal goes through the kernel before being
actually processes. The kernel will then dispatch the signal to the appropriate
signal manager which may or may not be PM.
SYSLIB CHANGES:
- Simplified SEF init and LU callbacks.
- Added additional predefined SEF callbacks to debug crash recovery and
live update.
- Fixed a temporary ack in the SEF init protocol. SEF init reply is now
completely synchronous.
- Added SEF signal event type to provide a uniform interface for system
processes to deal with signals. A sef_cb_signal_handler() callback is
available for system processes to handle every received signal. A
sef_cb_signal_manager() callback is used by signal managers to process
system signals on behalf of the kernel.
- Fixed a few bugs with memory mapping and DS.
VM CHANGES:
- Page faults and memory requests coming from the kernel are now implemented
using signals.
- Added a new VM call to swap two process slots and implement live update.
- The call is used by RS at update time and in turn invokes the kernel call
sys_update().
RS CHANGES:
- RS has been reworked with a better functional decomposition.
- Better kernel call masks. com.h now defines the set of very basic kernel calls
every system service is allowed to use. This makes system.conf simpler and
easier to maintain. In addition, this guarantees a higher level of isolation
for system libraries that use one or more kernel calls internally (e.g. printf).
- RS is the default signal manager for system processes. By default, RS
intercepts every signal delivered to every system process. This makes crash
recovery possible before bringing PM and friends in the loop.
- RS now supports fast rollback when something goes wrong while initializing
the new version during a live update.
- Live update is now implemented by keeping the two versions side-by-side and
swapping the process slots when the old version is ready to update.
- Crash recovery is now implemented by keeping the two versions side-by-side
and cleaning up the old version only when the recovery process is complete.
DS CHANGES:
- Fixed a bug when the process doing ds_publish() or ds_delete() is not known
by DS.
- Fixed the completely broken support for strings. String publishing is now
implemented in the system library and simply wraps publishing of memory ranges.
Ideally, we should adopt a similar approach for other data types as well.
- Test suite fixed.
DRIVER CHANGES:
- The hello driver has been added to the Minix distribution to demonstrate basic
live update and crash recovery functionalities.
- Other drivers have been adapted to conform the new SEF interface.
2010-03-17 02:15:29 +01:00
|
|
|
#define USE_UPDATE 1 /* update a process into another */
|
2010-04-08 15:41:35 +02:00
|
|
|
#define USE_STATECTL 1 /* let a process control its state */
|
2005-07-14 17:26:26 +02:00
|
|
|
|
|
|
|
|
/* Length of program names stored in the process table. This is only used
|
|
|
|
|
* for the debugging dumps that can be generated with the IS server. The PM
|
|
|
|
|
* server keeps its own copy of the program name.
|
|
|
|
|
*/
|
2005-09-11 18:44:06 +02:00
|
|
|
#define P_NAME_LEN 8
|
2005-07-14 17:26:26 +02:00
|
|
|
|
|
|
|
|
/* This section contains defines for valuable system resources that are used
|
|
|
|
|
* by device drivers. The number of elements of the vectors is determined by
|
|
|
|
|
* the maximum needed by any given driver. The number of interrupt hooks may
|
|
|
|
|
* be incremented on systems with many device drivers.
|
|
|
|
|
*/
|
2011-07-31 16:20:34 +02:00
|
|
|
#ifndef USE_APIC
|
2005-07-14 17:26:26 +02:00
|
|
|
#define NR_IRQ_HOOKS 16 /* number of interrupt hooks */
|
2010-09-02 17:43:54 +02:00
|
|
|
#else
|
|
|
|
|
#define NR_IRQ_HOOKS 64 /* number of interrupt hooks */
|
|
|
|
|
#endif
|
2005-07-14 17:26:26 +02:00
|
|
|
#define VDEVIO_BUF_SIZE 64 /* max elements per VDEVIO request */
|
|
|
|
|
|
2010-09-15 16:09:52 +02:00
|
|
|
#define K_PARAM_SIZE 512
|
2005-07-14 17:26:26 +02:00
|
|
|
|
|
|
|
|
#endif /* CONFIG_H */
|
|
|
|
|
|
