2009-10-01 12:33:01 +02:00
|
|
|
/* This file defines constants for use in message communication (mostly)
|
|
|
|
* between system processes.
|
|
|
|
*
|
|
|
|
* A number of protocol message request and response types are defined. For
|
|
|
|
* debugging purposes, each protocol is assigned its own unique number range.
|
|
|
|
* The following such message type ranges have been allocated:
|
|
|
|
*
|
|
|
|
* 1 - 0xFF POSIX requests (see callnr.h)
|
|
|
|
* 0x200 - 0x2FF Data link layer requests and responses
|
|
|
|
* 0x300 - 0x3FF Bus controller requests and responses
|
|
|
|
* 0x400 - 0x4FF Block and character device requests
|
|
|
|
* 0x500 - 0x5FF Block and character device responses
|
|
|
|
* 0x600 - 0x6FF Kernel calls to SYSTEM task
|
|
|
|
* 0x700 - 0x7FF Reincarnation Server (RS) requests
|
|
|
|
* 0x800 - 0x8FF Data Store (DS) requests
|
|
|
|
* 0x900 - 0x9FF Requests from PM to VFS, and responses
|
|
|
|
* (0xA00 - 0xAFF old TTY and LOG requests, being phased out)
|
|
|
|
* 0xA00 - 0xAFF Requests from VFS to file systems (see vfsif.h)
|
|
|
|
* 0xB00 - 0xBFF Requests from VM to VFS
|
|
|
|
* 0xC00 - 0xCFF Virtual Memory (VM) requests
|
|
|
|
* 0xD00 - 0xDFF IPC server requests
|
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
|
|
|
* 0xE00 - 0xEFF Common system messages (e.g. system signals)
|
Userspace scheduling
- cotributed by Bjorn Swift
- In this first phase, scheduling is moved from the kernel to the PM
server. The next steps are to a) moving scheduling to its own server
and b) include useful information in the "out of quantum" message,
so that the scheduler can make use of this information.
- The kernel process table now keeps record of who is responsible for
scheduling each process (p_scheduler). When this pointer is NULL,
the process will be scheduled by the kernel. If such a process runs
out of quantum, the kernel will simply renew its quantum an requeue
it.
- When PM loads, it will take over scheduling of all running
processes, except system processes, using sys_schedctl().
Essentially, this only results in taking over init. As children
inherit a scheduler from their parent, user space programs forked by
init will inherit PM (for now) as their scheduler.
- Once a process has been assigned a scheduler, and runs out of
quantum, its RTS_NO_QUANTUM flag will be set and the process
dequeued. The kernel will send a message to the scheduler, on the
process' behalf, informing the scheduler that it has run out of
quantum. The scheduler can take what ever action it pleases, based
on its policy, and then reschedule the process using the
sys_schedule() system call.
- Balance queues does not work as before. While the old in-kernel
function used to renew the quantum of processes in the highest
priority run queue, the user-space implementation only acts on
processes that have been bumped down to a lower priority queue.
This approach reacts slower to changes than the old one, but saves
us sending a sys_schedule message for each process every time we
balance the queues. Currently, when processes are moved up a
priority queue, their quantum is also renewed, but this can be
fiddled with.
- do_nice has been removed from kernel. PM answers to get- and
setpriority calls, updates it's own nice variable as well as the
max_run_queue. This will be refactored once scheduling is moved to a
separate server. We will probably have PM update it's local nice
value and then send a message to whoever is scheduling the process.
- changes to fix an issue in do_fork() where processes could run out
of quantum but bypassing the code path that handles it correctly.
The future plan is to remove the policy from do_fork() and implement
it in userspace too.
2010-03-29 13:07:20 +02:00
|
|
|
* 0xF00 - 0xFFF Scheduling messages
|
2009-10-01 12:33:01 +02:00
|
|
|
* 0x1000 - 0x10FF Notify messages
|
|
|
|
*
|
|
|
|
* Zero and negative values are widely used for OK and error responses.
|
|
|
|
*/
|
|
|
|
|
2005-07-27 15:09:38 +02:00
|
|
|
#ifndef _MINIX_COM_H
|
2005-08-03 13:53:36 +02:00
|
|
|
#define _MINIX_COM_H
|
2005-07-27 15:09:38 +02:00
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
/*===========================================================================*
|
2005-05-27 15:57:00 +02:00
|
|
|
* Magic process numbers *
|
2005-04-21 16:53:53 +02:00
|
|
|
*===========================================================================*/
|
|
|
|
|
2006-03-03 10:43:06 +01:00
|
|
|
/* These may not be any valid endpoint (see <minix/endpoint.h>). */
|
2010-03-03 00:12:13 +01:00
|
|
|
#define ANY ((endpoint_t) 0x7ace) /* used to indicate 'any process' */
|
|
|
|
#define NONE ((endpoint_t) 0x6ace) /* used to indicate 'no process at all' */
|
|
|
|
#define SELF ((endpoint_t) 0x8ace) /* used to indicate 'own process' */
|
2009-09-29 22:13:41 +02:00
|
|
|
#define _MAX_MAGIC_PROC (SELF) /* used by <minix/endpoint.h>
|
|
|
|
to determine generation size */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
/*===========================================================================*
|
|
|
|
* Process numbers of processes in the system image *
|
|
|
|
*===========================================================================*/
|
|
|
|
|
|
|
|
/* The values of several task numbers depend on whether they or other tasks
|
|
|
|
* are enabled. They are defined as (PREVIOUS_TASK - ENABLE_TASK) in general.
|
|
|
|
* ENABLE_TASK is either 0 or 1, so a task either gets a new number, or gets
|
|
|
|
* the same number as the previous task and is further unused. Note that the
|
|
|
|
* order should correspond to the order in the task table defined in table.c.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Kernel tasks. These all run in the same address space. */
|
2010-03-03 00:12:13 +01:00
|
|
|
#define IDLE ((endpoint_t) -4) /* runs when no one else can run */
|
|
|
|
#define CLOCK ((endpoint_t) -3) /* alarms and other clock functions */
|
|
|
|
#define SYSTEM ((endpoint_t) -2) /* request system functionality */
|
|
|
|
#define KERNEL ((endpoint_t) -1) /* pseudo-process for IPC and scheduling */
|
2005-05-24 16:35:58 +02:00
|
|
|
#define HARDWARE KERNEL /* for hardware interrupt handlers */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
/* Number of tasks. Note that NR_PROCS is defined in <minix/config.h>. */
|
2009-09-29 22:13:41 +02:00
|
|
|
#define MAX_NR_TASKS 1023
|
2005-09-16 16:23:14 +02:00
|
|
|
#define NR_TASKS 4
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2005-07-26 14:50:41 +02:00
|
|
|
/* User-space processes, that is, device drivers, servers, and INIT. */
|
2010-03-03 00:12:13 +01:00
|
|
|
#define PM_PROC_NR ((endpoint_t) 0) /* process manager */
|
|
|
|
#define FS_PROC_NR ((endpoint_t) 1) /* file system */
|
2008-11-19 13:26:10 +01:00
|
|
|
#define VFS_PROC_NR FS_PROC_NR /* FS has been renamed to VFS. */
|
2010-03-03 00:12:13 +01:00
|
|
|
#define RS_PROC_NR ((endpoint_t) 2) /* reincarnation server */
|
|
|
|
#define MEM_PROC_NR ((endpoint_t) 3) /* memory driver (RAM disk, null, etc.) */
|
|
|
|
#define LOG_PROC_NR ((endpoint_t) 4) /* log device driver */
|
|
|
|
#define TTY_PROC_NR ((endpoint_t) 5) /* terminal (TTY) driver */
|
|
|
|
#define DS_PROC_NR ((endpoint_t) 6) /* data store server */
|
|
|
|
#define MFS_PROC_NR ((endpoint_t) 7) /* minix root filesystem */
|
|
|
|
#define VM_PROC_NR ((endpoint_t) 8) /* memory server */
|
|
|
|
#define PFS_PROC_NR ((endpoint_t) 9) /* pipe filesystem */
|
|
|
|
#define LAST_SPECIAL_PROC_NR 10 /* An untyped version for
|
|
|
|
computation in macros.*/
|
|
|
|
#define INIT_PROC_NR ((endpoint_t) LAST_SPECIAL_PROC_NR) /* init
|
|
|
|
-- goes multiuser */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2009-12-11 01:08:19 +01:00
|
|
|
/* Root system process and root user process. */
|
|
|
|
#define ROOT_SYS_PROC_NR RS_PROC_NR
|
|
|
|
#define ROOT_USR_PROC_NR INIT_PROC_NR
|
|
|
|
|
2005-05-11 11:02:00 +02:00
|
|
|
/* Number of processes contained in the system image. */
|
2010-03-03 00:12:13 +01:00
|
|
|
#define NR_BOOT_PROCS (NR_TASKS + LAST_SPECIAL_PROC_NR + 1)
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
/*===========================================================================*
|
|
|
|
* Kernel notification types *
|
|
|
|
*===========================================================================*/
|
|
|
|
|
|
|
|
/* Kernel notification types. In principle, these can be sent to any process,
|
|
|
|
* so make sure that these types do not interfere with other message types.
|
|
|
|
* Notifications are prioritized because of the way they are unhold() and
|
|
|
|
* blocking notifications are delivered. The lowest numbers go first. The
|
|
|
|
* offset are used for the per-process notification bit maps.
|
|
|
|
*/
|
2005-07-25 14:03:00 +02:00
|
|
|
#define NOTIFY_MESSAGE 0x1000
|
2010-03-23 01:09:11 +01:00
|
|
|
/* FIXME the old is_notify(a) should be replaced by is_ipc_notify(status). */
|
2010-04-08 15:41:35 +02:00
|
|
|
#define is_ipc_notify(ipc_status) (IPC_STATUS_CALL(ipc_status) == NOTIFY)
|
|
|
|
#define is_notify(a) ((unsigned) ((a) - NOTIFY_MESSAGE) < 0x100)
|
|
|
|
#define is_ipc_asynch(ipc_status) \
|
|
|
|
(is_ipc_notify(ipc_status) || IPC_STATUS_CALL(ipc_status) == SENDA)
|
2005-07-25 14:03:00 +02:00
|
|
|
#define NOTIFY_FROM(p_nr) (NOTIFY_MESSAGE | ((p_nr) + NR_TASKS))
|
2005-07-14 17:14:44 +02:00
|
|
|
|
2005-05-19 11:38:29 +02:00
|
|
|
/* Shorthands for message parameters passed with notifications. */
|
2005-07-14 17:14:44 +02:00
|
|
|
#define NOTIFY_ARG m2_l1
|
|
|
|
#define NOTIFY_TIMESTAMP m2_l2
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2005-12-02 15:40:51 +01:00
|
|
|
/*===========================================================================*
|
|
|
|
* Messages for BUS controller drivers *
|
|
|
|
*===========================================================================*/
|
|
|
|
#define BUSC_RQ_BASE 0x300 /* base for request types */
|
|
|
|
#define BUSC_RS_BASE 0x380 /* base for response types */
|
|
|
|
|
|
|
|
#define BUSC_PCI_INIT (BUSC_RQ_BASE + 0) /* First message to
|
|
|
|
* PCI driver
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_FIRST_DEV (BUSC_RQ_BASE + 1) /* Get index (and
|
|
|
|
* vid/did) of the
|
|
|
|
* first PCI device
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_NEXT_DEV (BUSC_RQ_BASE + 2) /* Get index (and
|
|
|
|
* vid/did) of the
|
|
|
|
* next PCI device
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_FIND_DEV (BUSC_RQ_BASE + 3) /* Get index of a
|
|
|
|
* PCI device based on
|
|
|
|
* bus/dev/function
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_IDS (BUSC_RQ_BASE + 4) /* Get vid/did from an
|
|
|
|
* index
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_DEV_NAME (BUSC_RQ_BASE + 5) /* Get the name of a
|
|
|
|
* PCI device
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_SLOT_NAME (BUSC_RQ_BASE + 6) /* Get the name of a
|
|
|
|
* PCI slot
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_RESERVE (BUSC_RQ_BASE + 7) /* Reserve a PCI dev */
|
|
|
|
#define BUSC_PCI_ATTR_R8 (BUSC_RQ_BASE + 8) /* Read 8-bit
|
|
|
|
* attribute value
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_ATTR_R16 (BUSC_RQ_BASE + 9) /* Read 16-bit
|
|
|
|
* attribute value
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_ATTR_R32 (BUSC_RQ_BASE + 10) /* Read 32-bit
|
|
|
|
* attribute value
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_ATTR_W8 (BUSC_RQ_BASE + 11) /* Write 8-bit
|
|
|
|
* attribute value
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_ATTR_W16 (BUSC_RQ_BASE + 12) /* Write 16-bit
|
|
|
|
* attribute value
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_ATTR_W32 (BUSC_RQ_BASE + 13) /* Write 32-bit
|
|
|
|
* attribute value
|
|
|
|
*/
|
2006-01-12 15:34:00 +01:00
|
|
|
#define BUSC_PCI_RESCAN (BUSC_RQ_BASE + 14) /* Rescan bus */
|
2006-07-10 14:13:29 +02:00
|
|
|
#define BUSC_PCI_DEV_NAME_S (BUSC_RQ_BASE + 15) /* Get the name of a
|
|
|
|
* PCI device
|
|
|
|
* (safecopy)
|
|
|
|
*/
|
|
|
|
#define BUSC_PCI_SLOT_NAME_S (BUSC_RQ_BASE + 16) /* Get the name of a
|
|
|
|
* PCI slot (safecopy)
|
|
|
|
*/
|
2007-04-23 14:01:47 +02:00
|
|
|
#define BUSC_PCI_SET_ACL (BUSC_RQ_BASE + 17) /* Set the ACL for a
|
2006-10-20 17:01:32 +02:00
|
|
|
* driver (safecopy)
|
|
|
|
*/
|
2007-04-23 14:01:47 +02:00
|
|
|
#define BUSC_PCI_DEL_ACL (BUSC_RQ_BASE + 18) /* Delete the ACL of a
|
|
|
|
* driver
|
|
|
|
*/
|
2008-02-25 15:39:19 +01:00
|
|
|
#define IOMMU_MAP (BUSC_RQ_BASE + 32) /* Ask IOMMU to map
|
|
|
|
* a segment of memory
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
2005-12-02 15:40:51 +01:00
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
/*===========================================================================*
|
|
|
|
* Messages for BLOCK and CHARACTER device drivers *
|
|
|
|
*===========================================================================*/
|
|
|
|
|
2005-08-03 13:53:36 +02:00
|
|
|
/* Message types for device drivers. */
|
2005-07-25 14:03:00 +02:00
|
|
|
#define DEV_RQ_BASE 0x400 /* base for device request types */
|
|
|
|
#define DEV_RS_BASE 0x500 /* base for device response types */
|
|
|
|
|
2005-10-20 22:34:34 +02:00
|
|
|
#define CANCEL (DEV_RQ_BASE + 0) /* force a task to cancel */
|
2005-08-03 13:53:36 +02:00
|
|
|
#define DEV_OPEN (DEV_RQ_BASE + 6) /* open a minor device */
|
|
|
|
#define DEV_CLOSE (DEV_RQ_BASE + 7) /* close a minor device */
|
|
|
|
#define TTY_SETPGRP (DEV_RQ_BASE + 10) /* set process group */
|
|
|
|
#define TTY_EXIT (DEV_RQ_BASE + 11) /* process group leader exited */
|
2005-07-27 15:09:38 +02:00
|
|
|
#define DEV_SELECT (DEV_RQ_BASE + 12) /* request select() attention */
|
|
|
|
#define DEV_STATUS (DEV_RQ_BASE + 13) /* request driver status */
|
2008-02-21 16:57:35 +01:00
|
|
|
#define DEV_REOPEN (DEV_RQ_BASE + 14) /* reopen a minor device */
|
2005-07-25 14:03:00 +02:00
|
|
|
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
#define DEV_READ_S (DEV_RQ_BASE + 20) /* (safecopy) read from minor */
|
|
|
|
#define DEV_WRITE_S (DEV_RQ_BASE + 21) /* (safecopy) write to minor */
|
|
|
|
#define DEV_SCATTER_S (DEV_RQ_BASE + 22) /* (safecopy) write from a vector */
|
|
|
|
#define DEV_GATHER_S (DEV_RQ_BASE + 23) /* (safecopy) read into a vector */
|
|
|
|
#define DEV_IOCTL_S (DEV_RQ_BASE + 24) /* (safecopy) I/O control code */
|
2008-11-19 13:26:10 +01:00
|
|
|
#define DEV_MMAP_S (DEV_RQ_BASE + 25) /* (safecopy) mmap interface */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
|
2010-04-08 15:41:35 +02:00
|
|
|
#define IS_DEV_RQ(type) (((type) & ~0xff) == DEV_RQ_BASE)
|
|
|
|
|
2005-07-27 15:09:38 +02:00
|
|
|
#define DEV_REPLY (DEV_RS_BASE + 0) /* general task reply */
|
|
|
|
#define DEV_CLONED (DEV_RS_BASE + 1) /* return cloned minor */
|
|
|
|
#define DEV_REVIVE (DEV_RS_BASE + 2) /* driver revives process */
|
|
|
|
#define DEV_IO_READY (DEV_RS_BASE + 3) /* selected device ready */
|
|
|
|
#define DEV_NO_STATUS (DEV_RS_BASE + 4) /* empty status reply */
|
2008-02-21 16:57:35 +01:00
|
|
|
#define DEV_REOPEN_REPL (DEV_RS_BASE + 5) /* reply to DEV_REOPEN */
|
|
|
|
#define DEV_CLOSE_REPL (DEV_RS_BASE + 6) /* reply to DEV_CLOSE */
|
|
|
|
#define DEV_SEL_REPL1 (DEV_RS_BASE + 7) /* first reply to DEV_SELECT */
|
|
|
|
#define DEV_SEL_REPL2 (DEV_RS_BASE + 8) /* (opt) second reply to DEV_SELECT */
|
2005-07-25 14:03:00 +02:00
|
|
|
|
2010-04-08 15:41:35 +02:00
|
|
|
#define IS_DEV_RS(type) (((type) & ~0xff) == DEV_RS_BASE)
|
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
/* Field names for messages to block and character device drivers. */
|
|
|
|
#define DEVICE m2_i1 /* major-minor device */
|
2006-03-03 10:43:06 +01:00
|
|
|
#define IO_ENDPT m2_i2 /* which (proc/endpoint) wants I/O? */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define COUNT m2_i3 /* how many bytes to transfer */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
#define REQUEST m2_i3 /* ioctl request code */
|
|
|
|
#define POSITION m2_l1 /* file offset (low 4 bytes) */
|
|
|
|
#define HIGHPOS m2_l2 /* file offset (high 4 bytes) */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define ADDRESS m2_p1 /* core buffer address */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
#define IO_GRANT m2_p1 /* grant id (for DEV_*_S variants) */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2005-06-17 15:34:47 +02:00
|
|
|
/* Field names for DEV_SELECT messages to device drivers. */
|
2005-07-27 15:09:38 +02:00
|
|
|
#define DEV_MINOR m2_i1 /* minor device */
|
2005-06-17 15:34:47 +02:00
|
|
|
#define DEV_SEL_OPS m2_i2 /* which select operations are requested */
|
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
/* Field names used in reply messages from tasks. */
|
2006-03-03 10:43:06 +01:00
|
|
|
#define REP_ENDPT m2_i1 /* # of proc on whose behalf I/O was done */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define REP_STATUS m2_i2 /* bytes transferred or error number */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
#define REP_IO_GRANT m2_i3 /* DEV_REVIVE: grant by which I/O was done */
|
2005-08-03 13:53:36 +02:00
|
|
|
# define SUSPEND -998 /* status to suspend caller, reply later */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
/* Field names for messages to TTY driver. */
|
|
|
|
#define TTY_LINE DEVICE /* message parameter: terminal line */
|
|
|
|
#define TTY_REQUEST COUNT /* message parameter: ioctl request code */
|
|
|
|
#define TTY_SPEK POSITION/* message parameter: ioctl speed, erasing */
|
|
|
|
#define TTY_PGRP m2_i3 /* message parameter: process group */
|
|
|
|
|
|
|
|
/* Field names for the QIC 02 status reply from tape driver */
|
|
|
|
#define TAPE_STAT0 m2_l1
|
|
|
|
#define TAPE_STAT1 m2_l2
|
|
|
|
|
|
|
|
/*===========================================================================*
|
|
|
|
* Messages for networking layer *
|
|
|
|
*===========================================================================*/
|
|
|
|
|
2005-08-04 21:23:03 +02:00
|
|
|
/* Message types for network layer requests. This layer acts like a driver. */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define NW_OPEN DEV_OPEN
|
|
|
|
#define NW_CLOSE DEV_CLOSE
|
|
|
|
#define NW_READ DEV_READ
|
|
|
|
#define NW_WRITE DEV_WRITE
|
|
|
|
#define NW_IOCTL DEV_IOCTL
|
|
|
|
#define NW_CANCEL CANCEL
|
|
|
|
|
2005-08-04 21:23:03 +02:00
|
|
|
/* Base type for data link layer requests and responses. */
|
2009-10-01 12:33:01 +02:00
|
|
|
#define DL_RQ_BASE 0x200
|
|
|
|
#define DL_RS_BASE 0x280
|
2005-08-04 21:23:03 +02:00
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
/* Message types for data link layer requests. */
|
2010-05-18 00:22:53 +02:00
|
|
|
#define DL_CONF (DL_RQ_BASE + 0)
|
|
|
|
#define DL_GETSTAT_S (DL_RQ_BASE + 1)
|
|
|
|
#define DL_WRITEV_S (DL_RQ_BASE + 2)
|
|
|
|
#define DL_READV_S (DL_RQ_BASE + 3)
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
/* Message type for data link layer replies. */
|
2010-05-18 00:22:53 +02:00
|
|
|
#define DL_CONF_REPLY (DL_RS_BASE + 0)
|
|
|
|
#define DL_STAT_REPLY (DL_RS_BASE + 1)
|
|
|
|
#define DL_TASK_REPLY (DL_RS_BASE + 2)
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
/* Field names for data link layer messages. */
|
2010-05-18 00:22:53 +02:00
|
|
|
#define DL_ENDPT m2_i2
|
2005-04-21 16:53:53 +02:00
|
|
|
#define DL_COUNT m2_i3
|
|
|
|
#define DL_MODE m2_l1
|
2010-05-18 00:22:53 +02:00
|
|
|
#define DL_FLAGS m2_l1
|
2006-07-10 14:13:29 +02:00
|
|
|
#define DL_GRANT m2_l2
|
2010-05-18 00:22:53 +02:00
|
|
|
#define DL_STAT m3_i1
|
|
|
|
#define DL_HWADDR m3_ca1
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2010-05-18 00:22:53 +02:00
|
|
|
/* Bits in 'DL_FLAGS' field of DL replies. */
|
|
|
|
# define DL_NOFLAGS 0x00
|
2005-04-21 16:53:53 +02:00
|
|
|
# define DL_PACK_SEND 0x01
|
|
|
|
# define DL_PACK_RECV 0x02
|
|
|
|
|
|
|
|
/* Bits in 'DL_MODE' field of DL requests. */
|
|
|
|
# define DL_NOMODE 0x0
|
2010-05-18 00:22:53 +02:00
|
|
|
# define DL_PROMISC_REQ 0x1
|
|
|
|
# define DL_MULTI_REQ 0x2
|
|
|
|
# define DL_BROAD_REQ 0x4
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
/*===========================================================================*
|
|
|
|
* SYSTASK request types and field names *
|
|
|
|
*===========================================================================*/
|
|
|
|
|
|
|
|
/* System library calls are dispatched via a call vector, so be careful when
|
|
|
|
* modifying the system call numbers. The numbers here determine which call
|
|
|
|
* is made from the call vector.
|
|
|
|
*/
|
2005-07-25 14:03:00 +02:00
|
|
|
#define KERNEL_CALL 0x600 /* base for kernel calls to SYSTEM */
|
|
|
|
|
2005-08-04 21:23:03 +02:00
|
|
|
# define SYS_FORK (KERNEL_CALL + 0) /* sys_fork() */
|
|
|
|
# define SYS_EXEC (KERNEL_CALL + 1) /* sys_exec() */
|
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 SYS_CLEAR (KERNEL_CALL + 2) /* sys_clear() */
|
Userspace scheduling
- cotributed by Bjorn Swift
- In this first phase, scheduling is moved from the kernel to the PM
server. The next steps are to a) moving scheduling to its own server
and b) include useful information in the "out of quantum" message,
so that the scheduler can make use of this information.
- The kernel process table now keeps record of who is responsible for
scheduling each process (p_scheduler). When this pointer is NULL,
the process will be scheduled by the kernel. If such a process runs
out of quantum, the kernel will simply renew its quantum an requeue
it.
- When PM loads, it will take over scheduling of all running
processes, except system processes, using sys_schedctl().
Essentially, this only results in taking over init. As children
inherit a scheduler from their parent, user space programs forked by
init will inherit PM (for now) as their scheduler.
- Once a process has been assigned a scheduler, and runs out of
quantum, its RTS_NO_QUANTUM flag will be set and the process
dequeued. The kernel will send a message to the scheduler, on the
process' behalf, informing the scheduler that it has run out of
quantum. The scheduler can take what ever action it pleases, based
on its policy, and then reschedule the process using the
sys_schedule() system call.
- Balance queues does not work as before. While the old in-kernel
function used to renew the quantum of processes in the highest
priority run queue, the user-space implementation only acts on
processes that have been bumped down to a lower priority queue.
This approach reacts slower to changes than the old one, but saves
us sending a sys_schedule message for each process every time we
balance the queues. Currently, when processes are moved up a
priority queue, their quantum is also renewed, but this can be
fiddled with.
- do_nice has been removed from kernel. PM answers to get- and
setpriority calls, updates it's own nice variable as well as the
max_run_queue. This will be refactored once scheduling is moved to a
separate server. We will probably have PM update it's local nice
value and then send a message to whoever is scheduling the process.
- changes to fix an issue in do_fork() where processes could run out
of quantum but bypassing the code path that handles it correctly.
The future plan is to remove the policy from do_fork() and implement
it in userspace too.
2010-03-29 13:07:20 +02:00
|
|
|
# define SYS_SCHEDULE (KERNEL_CALL + 3) /* sys_schedule() */
|
2005-08-04 21:23:03 +02:00
|
|
|
# define SYS_PRIVCTL (KERNEL_CALL + 4) /* sys_privctl() */
|
|
|
|
# define SYS_TRACE (KERNEL_CALL + 5) /* sys_trace() */
|
|
|
|
# define SYS_KILL (KERNEL_CALL + 6) /* sys_kill() */
|
|
|
|
|
|
|
|
# define SYS_GETKSIG (KERNEL_CALL + 7) /* sys_getsig() */
|
|
|
|
# define SYS_ENDKSIG (KERNEL_CALL + 8) /* sys_endsig() */
|
|
|
|
# define SYS_SIGSEND (KERNEL_CALL + 9) /* sys_sigsend() */
|
|
|
|
# define SYS_SIGRETURN (KERNEL_CALL + 10) /* sys_sigreturn() */
|
|
|
|
|
|
|
|
# define SYS_NEWMAP (KERNEL_CALL + 11) /* sys_newmap() */
|
|
|
|
# define SYS_SEGCTL (KERNEL_CALL + 12) /* sys_segctl() */
|
|
|
|
# define SYS_MEMSET (KERNEL_CALL + 13) /* sys_memset() */
|
|
|
|
|
|
|
|
# define SYS_UMAP (KERNEL_CALL + 14) /* sys_umap() */
|
|
|
|
# define SYS_VIRCOPY (KERNEL_CALL + 15) /* sys_vircopy() */
|
|
|
|
# define SYS_PHYSCOPY (KERNEL_CALL + 16) /* sys_physcopy() */
|
2005-07-26 16:54:49 +02:00
|
|
|
|
2005-08-04 21:23:03 +02:00
|
|
|
# define SYS_IRQCTL (KERNEL_CALL + 19) /* sys_irqctl() */
|
|
|
|
# define SYS_INT86 (KERNEL_CALL + 20) /* sys_int86() */
|
|
|
|
# define SYS_DEVIO (KERNEL_CALL + 21) /* sys_devio() */
|
|
|
|
# define SYS_SDEVIO (KERNEL_CALL + 22) /* sys_sdevio() */
|
|
|
|
# define SYS_VDEVIO (KERNEL_CALL + 23) /* sys_vdevio() */
|
2005-07-26 16:54:49 +02:00
|
|
|
|
2005-08-04 21:23:03 +02:00
|
|
|
# define SYS_SETALARM (KERNEL_CALL + 24) /* sys_setalarm() */
|
|
|
|
# define SYS_TIMES (KERNEL_CALL + 25) /* sys_times() */
|
|
|
|
# define SYS_GETINFO (KERNEL_CALL + 26) /* sys_getinfo() */
|
|
|
|
# define SYS_ABORT (KERNEL_CALL + 27) /* sys_abort() */
|
2005-09-30 14:47:03 +02:00
|
|
|
# define SYS_IOPENABLE (KERNEL_CALL + 28) /* sys_enable_iop() */
|
2006-06-23 17:07:41 +02:00
|
|
|
# define SYS_SAFECOPYFROM (KERNEL_CALL + 31) /* sys_safecopyfrom() */
|
|
|
|
# define SYS_SAFECOPYTO (KERNEL_CALL + 32) /* sys_safecopyto() */
|
2006-06-23 13:54:03 +02:00
|
|
|
# define SYS_VSAFECOPY (KERNEL_CALL + 33) /* sys_vsafecopy() */
|
2006-06-23 17:35:05 +02:00
|
|
|
# define SYS_SETGRANT (KERNEL_CALL + 34) /* sys_setgrant() */
|
2006-07-10 14:13:29 +02:00
|
|
|
# define SYS_READBIOS (KERNEL_CALL + 35) /* sys_readbios() */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
|
2006-10-30 16:53:38 +01:00
|
|
|
# define SYS_SPROF (KERNEL_CALL + 36) /* sys_sprof() */
|
|
|
|
# define SYS_CPROF (KERNEL_CALL + 37) /* sys_cprof() */
|
|
|
|
# define SYS_PROFBUF (KERNEL_CALL + 38) /* sys_profbuf() */
|
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
# define SYS_STIME (KERNEL_CALL + 39) /* sys_stime() */
|
2007-08-07 13:55:28 +02:00
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
# define SYS_VMCTL (KERNEL_CALL + 43) /* sys_vmctl() */
|
|
|
|
# define SYS_SYSCTL (KERNEL_CALL + 44) /* sys_sysctl() */
|
2008-02-21 16:57:35 +01:00
|
|
|
|
2009-08-15 23:37:26 +02:00
|
|
|
# define SYS_VTIMER (KERNEL_CALL + 45) /* sys_vtimer() */
|
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 SYS_RUNCTL (KERNEL_CALL + 46) /* sys_runctl() */
|
2010-01-14 16:24:16 +01:00
|
|
|
# define SYS_SAFEMAP (KERNEL_CALL + 47) /* sys_safemap() */
|
|
|
|
# define SYS_SAFEREVMAP (KERNEL_CALL + 48) /* sys_saferevmap() sys_saferevmap2() */
|
|
|
|
# define SYS_SAFEUNMAP (KERNEL_CALL + 49) /* sys_safeunmap() */
|
2010-03-12 16:58:41 +01:00
|
|
|
# define SYS_GETMCONTEXT (KERNEL_CALL + 50) /* sys_getmcontext() */
|
|
|
|
# define SYS_SETMCONTEXT (KERNEL_CALL + 51) /* sys_setmcontext() */
|
2009-08-15 23:37:26 +02:00
|
|
|
|
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 SYS_UPDATE (KERNEL_CALL + 52) /* sys_update() */
|
|
|
|
# define SYS_EXIT (KERNEL_CALL + 53) /* sys_exit() */
|
|
|
|
|
Userspace scheduling
- cotributed by Bjorn Swift
- In this first phase, scheduling is moved from the kernel to the PM
server. The next steps are to a) moving scheduling to its own server
and b) include useful information in the "out of quantum" message,
so that the scheduler can make use of this information.
- The kernel process table now keeps record of who is responsible for
scheduling each process (p_scheduler). When this pointer is NULL,
the process will be scheduled by the kernel. If such a process runs
out of quantum, the kernel will simply renew its quantum an requeue
it.
- When PM loads, it will take over scheduling of all running
processes, except system processes, using sys_schedctl().
Essentially, this only results in taking over init. As children
inherit a scheduler from their parent, user space programs forked by
init will inherit PM (for now) as their scheduler.
- Once a process has been assigned a scheduler, and runs out of
quantum, its RTS_NO_QUANTUM flag will be set and the process
dequeued. The kernel will send a message to the scheduler, on the
process' behalf, informing the scheduler that it has run out of
quantum. The scheduler can take what ever action it pleases, based
on its policy, and then reschedule the process using the
sys_schedule() system call.
- Balance queues does not work as before. While the old in-kernel
function used to renew the quantum of processes in the highest
priority run queue, the user-space implementation only acts on
processes that have been bumped down to a lower priority queue.
This approach reacts slower to changes than the old one, but saves
us sending a sys_schedule message for each process every time we
balance the queues. Currently, when processes are moved up a
priority queue, their quantum is also renewed, but this can be
fiddled with.
- do_nice has been removed from kernel. PM answers to get- and
setpriority calls, updates it's own nice variable as well as the
max_run_queue. This will be refactored once scheduling is moved to a
separate server. We will probably have PM update it's local nice
value and then send a message to whoever is scheduling the process.
- changes to fix an issue in do_fork() where processes could run out
of quantum but bypassing the code path that handles it correctly.
The future plan is to remove the policy from do_fork() and implement
it in userspace too.
2010-03-29 13:07:20 +02:00
|
|
|
# define SYS_SCHEDCTL (KERNEL_CALL + 54) /* sys_schedctl() */
|
2010-04-08 15:41:35 +02:00
|
|
|
# define SYS_STATECTL (KERNEL_CALL + 55) /* sys_statectl() */
|
Userspace scheduling
- cotributed by Bjorn Swift
- In this first phase, scheduling is moved from the kernel to the PM
server. The next steps are to a) moving scheduling to its own server
and b) include useful information in the "out of quantum" message,
so that the scheduler can make use of this information.
- The kernel process table now keeps record of who is responsible for
scheduling each process (p_scheduler). When this pointer is NULL,
the process will be scheduled by the kernel. If such a process runs
out of quantum, the kernel will simply renew its quantum an requeue
it.
- When PM loads, it will take over scheduling of all running
processes, except system processes, using sys_schedctl().
Essentially, this only results in taking over init. As children
inherit a scheduler from their parent, user space programs forked by
init will inherit PM (for now) as their scheduler.
- Once a process has been assigned a scheduler, and runs out of
quantum, its RTS_NO_QUANTUM flag will be set and the process
dequeued. The kernel will send a message to the scheduler, on the
process' behalf, informing the scheduler that it has run out of
quantum. The scheduler can take what ever action it pleases, based
on its policy, and then reschedule the process using the
sys_schedule() system call.
- Balance queues does not work as before. While the old in-kernel
function used to renew the quantum of processes in the highest
priority run queue, the user-space implementation only acts on
processes that have been bumped down to a lower priority queue.
This approach reacts slower to changes than the old one, but saves
us sending a sys_schedule message for each process every time we
balance the queues. Currently, when processes are moved up a
priority queue, their quantum is also renewed, but this can be
fiddled with.
- do_nice has been removed from kernel. PM answers to get- and
setpriority calls, updates it's own nice variable as well as the
max_run_queue. This will be refactored once scheduling is moved to a
separate server. We will probably have PM update it's local nice
value and then send a message to whoever is scheduling the process.
- changes to fix an issue in do_fork() where processes could run out
of quantum but bypassing the code path that handles it correctly.
The future plan is to remove the policy from do_fork() and implement
it in userspace too.
2010-03-29 13:07:20 +02:00
|
|
|
|
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
|
|
|
/* Total */
|
2010-04-08 15:41:35 +02:00
|
|
|
#define NR_SYS_CALLS 56 /* number of kernel calls */
|
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
|
|
|
|
Initialization protocol for system services.
SYSLIB CHANGES:
- SEF framework now supports a new SEF Init request type from RS. 3 different
callbacks are available (init_fresh, init_lu, init_restart) to specify
initialization code when a service starts fresh, starts after a live update,
or restarts.
SYSTEM SERVICE CHANGES:
- Initialization code for system services is now enclosed in a callback SEF will
automatically call at init time. The return code of the callback will
tell RS whether the initialization completed successfully.
- Each init callback can access information passed by RS to initialize. As of
now, each system service has access to the public entries of RS's system process
table to gather all the information required to initialize. This design
eliminates many existing or potential races at boot time and provides a uniform
initialization interface to system services. The same interface will be reused
for the upcoming publish/subscribe model to handle dynamic
registration / deregistration of system services.
VM CHANGES:
- Uniform privilege management for all system services. Every service uses the
same call mask format. For boot services, VM copies the call mask from init
data. For dynamic services, VM still receives the call mask via rs_set_priv
call that will be soon replaced by the upcoming publish/subscribe model.
RS CHANGES:
- The system process table has been reorganized and split into private entries
and public entries. Only the latter ones are exposed to system services.
- VM call masks are now entirely configured in rs/table.c
- RS has now its own slot in the system process table. Only kernel tasks and
user processes not included in the boot image are now left out from the system
process table.
- RS implements the initialization protocol for system services.
- For services in the boot image, RS blocks till initialization is complete and
panics when failure is reported back. Services are initialized in their order of
appearance in the boot image priv table and RS blocks to implements synchronous
initialization for every system service having the flag SF_SYNCH_BOOT set.
- For services started dynamically, the initialization protocol is implemented
as though it were the first ping for the service. In this case, if the
system service fails to report back (or reports failure), RS brings the service
down rather than trying to restart it.
2010-01-08 02:20:42 +01:00
|
|
|
#define SYS_CALL_MASK_SIZE BITMAP_CHUNKS(NR_SYS_CALLS)
|
2005-07-26 16:54:49 +02:00
|
|
|
|
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
|
|
|
/* Basic kernel calls allowed to every system process. */
|
|
|
|
#define SYS_BASIC_CALLS \
|
|
|
|
SYS_EXIT, SYS_SAFECOPYFROM, SYS_SAFECOPYTO, SYS_VSAFECOPY, SYS_GETINFO, \
|
|
|
|
SYS_TIMES, SYS_SETALARM, SYS_SETGRANT, SYS_SAFEMAP, SYS_SAFEREVMAP, \
|
2010-04-08 15:41:35 +02:00
|
|
|
SYS_SAFEUNMAP, SYS_PROFBUF, SYS_SYSCTL, SYS_STATECTL
|
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
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
/* Field names for SYS_MEMSET. */
|
2005-07-29 17:02:27 +02:00
|
|
|
#define MEM_PTR m2_p1 /* base */
|
|
|
|
#define MEM_COUNT m2_l1 /* count */
|
|
|
|
#define MEM_PATTERN m2_l2 /* pattern to write */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
/* Field names for SYS_DEVIO, SYS_VDEVIO, SYS_SDEVIO. */
|
|
|
|
#define DIO_REQUEST m2_i3 /* device in or output */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
# define _DIO_INPUT 0x001
|
|
|
|
# define _DIO_OUTPUT 0x002
|
|
|
|
# define _DIO_DIRMASK 0x00f
|
|
|
|
# define _DIO_BYTE 0x010
|
|
|
|
# define _DIO_WORD 0x020
|
|
|
|
# define _DIO_LONG 0x030
|
|
|
|
# define _DIO_TYPEMASK 0x0f0
|
|
|
|
# define _DIO_SAFE 0x100
|
|
|
|
# define _DIO_SAFEMASK 0xf00
|
|
|
|
# define DIO_INPUT_BYTE (_DIO_INPUT|_DIO_BYTE)
|
|
|
|
# define DIO_INPUT_WORD (_DIO_INPUT|_DIO_WORD)
|
2010-01-05 20:39:27 +01:00
|
|
|
# define DIO_INPUT_LONG (_DIO_INPUT|_DIO_LONG)
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
# define DIO_OUTPUT_BYTE (_DIO_OUTPUT|_DIO_BYTE)
|
|
|
|
# define DIO_OUTPUT_WORD (_DIO_OUTPUT|_DIO_WORD)
|
2010-01-05 20:39:27 +01:00
|
|
|
# define DIO_OUTPUT_LONG (_DIO_OUTPUT|_DIO_LONG)
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
# define DIO_SAFE_INPUT_BYTE (_DIO_INPUT|_DIO_BYTE|_DIO_SAFE)
|
|
|
|
# define DIO_SAFE_INPUT_WORD (_DIO_INPUT|_DIO_WORD|_DIO_SAFE)
|
2010-01-05 20:39:27 +01:00
|
|
|
# define DIO_SAFE_INPUT_LONG (_DIO_INPUT|_DIO_LONG|_DIO_SAFE)
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
# define DIO_SAFE_OUTPUT_BYTE (_DIO_OUTPUT|_DIO_BYTE|_DIO_SAFE)
|
|
|
|
# define DIO_SAFE_OUTPUT_WORD (_DIO_OUTPUT|_DIO_WORD|_DIO_SAFE)
|
2010-01-05 20:39:27 +01:00
|
|
|
# define DIO_SAFE_OUTPUT_LONG (_DIO_OUTPUT|_DIO_LONG|_DIO_SAFE)
|
2005-04-21 16:53:53 +02:00
|
|
|
#define DIO_PORT m2_l1 /* single port address */
|
|
|
|
#define DIO_VALUE m2_l2 /* single I/O value */
|
|
|
|
#define DIO_VEC_ADDR m2_p1 /* address of buffer or (p,v)-pairs */
|
|
|
|
#define DIO_VEC_SIZE m2_l2 /* number of elements in vector */
|
2006-03-03 10:43:06 +01:00
|
|
|
#define DIO_VEC_ENDPT m2_i2 /* number of process where vector is */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
#define DIO_OFFSET m2_i1 /* offset from grant */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
/* Field names for SYS_SETALARM. */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define ALRM_EXP_TIME m2_l1 /* expire time for the alarm call */
|
|
|
|
#define ALRM_ABS_TIME m2_i2 /* set to 1 to use absolute alarm time */
|
|
|
|
#define ALRM_TIME_LEFT m2_l1 /* how many ticks were remaining */
|
|
|
|
|
|
|
|
/* Field names for SYS_IRQCTL. */
|
2010-01-19 22:19:59 +01:00
|
|
|
#define IRQ_REQUEST m5_s1 /* what to do? */
|
2005-04-21 16:53:53 +02:00
|
|
|
# define IRQ_SETPOLICY 1 /* manage a slot of the IRQ table */
|
2005-05-12 18:07:15 +02:00
|
|
|
# define IRQ_RMPOLICY 2 /* remove a slot of the IRQ table */
|
|
|
|
# define IRQ_ENABLE 3 /* enable interrupts */
|
|
|
|
# define IRQ_DISABLE 4 /* disable interrupts */
|
2010-01-19 22:19:59 +01:00
|
|
|
#define IRQ_VECTOR m5_s2 /* irq vector */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define IRQ_POLICY m5_i1 /* options for IRQCTL request */
|
2005-09-16 16:23:14 +02:00
|
|
|
# define IRQ_REENABLE 0x001 /* reenable IRQ line after interrupt */
|
|
|
|
# define IRQ_BYTE 0x100 /* byte values */
|
|
|
|
# define IRQ_WORD 0x200 /* word values */
|
|
|
|
# define IRQ_LONG 0x400 /* long values */
|
2005-05-02 16:30:04 +02:00
|
|
|
#define IRQ_HOOK_ID m5_l3 /* id of irq hook at kernel */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2005-04-29 17:36:43 +02:00
|
|
|
/* Field names for SYS_SEGCTL. */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define SEG_SELECT m4_l1 /* segment selector returned */
|
|
|
|
#define SEG_OFFSET m4_l2 /* offset in segment returned */
|
|
|
|
#define SEG_PHYS m4_l3 /* physical address of segment */
|
|
|
|
#define SEG_SIZE m4_l4 /* segment size */
|
2005-04-29 17:36:43 +02:00
|
|
|
#define SEG_INDEX m4_l5 /* segment index in remote map */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
/* Field names for SYS_ABORT. */
|
|
|
|
#define ABRT_HOW m1_i1 /* RBT_REBOOT, RBT_HALT, etc. */
|
2006-03-03 10:43:06 +01:00
|
|
|
#define ABRT_MON_ENDPT m1_i2 /* process where monitor params are */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define ABRT_MON_LEN m1_i3 /* length of monitor params */
|
|
|
|
#define ABRT_MON_ADDR m1_p1 /* virtual address of monitor params */
|
|
|
|
|
2005-04-29 17:36:43 +02:00
|
|
|
/* Field names for _UMAP, _VIRCOPY, _PHYSCOPY. */
|
2010-01-19 22:19:59 +01:00
|
|
|
#define CP_SRC_SPACE m5_s1 /* T or D space (stack is also D) */
|
2006-03-03 10:43:06 +01:00
|
|
|
#define CP_SRC_ENDPT m5_i1 /* process to copy from */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define CP_SRC_ADDR m5_l1 /* address where data come from */
|
2010-01-19 22:19:59 +01:00
|
|
|
#define CP_DST_SPACE m5_s2 /* T or D space (stack is also D) */
|
2006-03-03 10:43:06 +01:00
|
|
|
#define CP_DST_ENDPT m5_i2 /* process to copy to */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define CP_DST_ADDR m5_l2 /* address where data go to */
|
|
|
|
#define CP_NR_BYTES m5_l3 /* number of bytes to copy */
|
|
|
|
|
|
|
|
/* Field names for SYS_GETINFO. */
|
|
|
|
#define I_REQUEST m7_i3 /* what info to get */
|
2005-04-29 17:36:43 +02:00
|
|
|
# define GET_KINFO 0 /* get kernel information structure */
|
2005-04-21 16:53:53 +02:00
|
|
|
# define GET_IMAGE 1 /* get system image table */
|
2005-06-03 15:55:06 +02:00
|
|
|
# define GET_PROCTAB 2 /* get kernel process table */
|
|
|
|
# define GET_RANDOMNESS 3 /* get randomness buffer */
|
2005-04-21 16:53:53 +02:00
|
|
|
# define GET_MONPARAMS 4 /* get monitor parameters */
|
|
|
|
# define GET_KENV 5 /* get kernel environment string */
|
2005-05-02 16:30:04 +02:00
|
|
|
# define GET_IRQHOOKS 6 /* get the IRQ table */
|
2005-04-21 16:53:53 +02:00
|
|
|
# define GET_KMESSAGES 7 /* get kernel messages */
|
2005-07-14 17:14:44 +02:00
|
|
|
# define GET_PRIVTAB 8 /* get kernel privileges table */
|
2005-04-21 16:53:53 +02:00
|
|
|
# define GET_KADDRESSES 9 /* get various kernel addresses */
|
|
|
|
# define GET_SCHEDINFO 10 /* get scheduling queues */
|
|
|
|
# define GET_PROC 11 /* get process slot if given process */
|
2005-04-29 17:36:43 +02:00
|
|
|
# define GET_MACHINE 12 /* get machine information */
|
2005-06-01 11:34:18 +02:00
|
|
|
# define GET_LOCKTIMING 13 /* get lock()/unlock() latency timing */
|
2005-07-29 12:21:04 +02:00
|
|
|
# define GET_BIOSBUFFER 14 /* get a buffer for BIOS calls */
|
2005-11-14 16:58:07 +01:00
|
|
|
# define GET_LOADINFO 15 /* get load average information */
|
2007-04-23 14:01:47 +02:00
|
|
|
# define GET_IRQACTIDS 16 /* get the IRQ masks */
|
2009-12-11 01:08:19 +01:00
|
|
|
# define GET_PRIV 17 /* get privilege structure */
|
2008-11-19 13:26:10 +01:00
|
|
|
# define GET_HZ 18 /* get HZ value */
|
|
|
|
# define GET_WHOAMI 19 /* get own name and endpoint */
|
2009-04-02 17:24:44 +02:00
|
|
|
# define GET_RANDOMNESS_BIN 20 /* get one randomness bin */
|
2009-12-02 12:52:26 +01:00
|
|
|
# define GET_IDLETSC 21 /* get cumulative idle time stamp counter */
|
2010-01-05 20:39:27 +01:00
|
|
|
# define GET_AOUTHEADER 22 /* get a.out headers from the boot image */
|
|
|
|
#define I_ENDPT m7_i4 /* calling process (may only be SELF) */
|
2005-04-21 16:53:53 +02:00
|
|
|
#define I_VAL_PTR m7_p1 /* virtual address at caller */
|
|
|
|
#define I_VAL_LEN m7_i1 /* max length of value */
|
2005-09-16 16:23:14 +02:00
|
|
|
#define I_VAL_PTR2 m7_p2 /* second virtual address */
|
2006-03-03 10:43:06 +01:00
|
|
|
#define I_VAL_LEN2_E m7_i2 /* second length, or proc nr */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2008-11-19 13:26:10 +01:00
|
|
|
/* GET_WHOAMI fields. */
|
|
|
|
#define GIWHO_EP m3_i1
|
|
|
|
#define GIWHO_NAME m3_ca1
|
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
/* Field names for SYS_TIMES. */
|
2007-08-07 13:55:28 +02:00
|
|
|
#define T_ENDPT m4_l1 /* process to request time info for */
|
|
|
|
#define T_USER_TIME m4_l1 /* user time consumed by process */
|
|
|
|
#define T_SYSTEM_TIME m4_l2 /* system time consumed by process */
|
|
|
|
#define T_BOOTTIME m4_l3 /* Boottime in seconds (also for SYS_STIME) */
|
|
|
|
#define T_BOOT_TICKS m4_l5 /* number of clock ticks since boot time */
|
|
|
|
|
2010-04-08 15:41:35 +02:00
|
|
|
/* Field names for SYS_TRACE, SYS_PRIVCTL, SYS_STATECTL. */
|
2010-01-05 20:39:27 +01:00
|
|
|
#define CTL_ENDPT m2_i1 /* process number of the caller */
|
2005-09-16 16:23:14 +02:00
|
|
|
#define CTL_REQUEST m2_i2 /* server control request */
|
|
|
|
#define CTL_ARG_PTR m2_p1 /* pointer to argument */
|
|
|
|
#define CTL_ADDRESS m2_l1 /* address at traced process' space */
|
|
|
|
#define CTL_DATA m2_l2 /* data field for tracing */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2009-11-03 12:12:23 +01:00
|
|
|
/* SYS_PRIVCTL with CTL_REQUEST == SYS_PRIV_QUERY_MEM */
|
|
|
|
#define CTL_PHYSSTART m2_l1 /* physical memory start in bytes*/
|
|
|
|
#define CTL_PHYSLEN m2_l2 /* length in bytes */
|
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
/* Subfunctions for SYS_PRIVCTL */
|
|
|
|
#define SYS_PRIV_ALLOW 1 /* Allow process to run */
|
|
|
|
#define SYS_PRIV_DISALLOW 2 /* Disallow process to run */
|
|
|
|
#define SYS_PRIV_SET_SYS 3 /* Set a system privilege structure */
|
|
|
|
#define SYS_PRIV_SET_USER 4 /* Set a user privilege structure */
|
|
|
|
#define SYS_PRIV_ADD_IO 5 /* Add I/O range (struct io_range) */
|
|
|
|
#define SYS_PRIV_ADD_MEM 6 /* Add memory range (struct mem_range)
|
|
|
|
*/
|
|
|
|
#define SYS_PRIV_ADD_IRQ 7 /* Add IRQ */
|
|
|
|
#define SYS_PRIV_QUERY_MEM 8 /* Verify memory privilege. */
|
|
|
|
|
2006-06-23 17:35:05 +02:00
|
|
|
/* Field names for SYS_SETGRANT */
|
|
|
|
#define SG_ADDR m2_p1 /* address */
|
|
|
|
#define SG_SIZE m2_i2 /* no. of entries */
|
2006-06-23 17:07:41 +02:00
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
/* Field names for SYS_GETKSIG, _ENDKSIG, _KILL, _SIGSEND, _SIGRETURN. */
|
|
|
|
#define SIG_ENDPT m2_i1 /* process number for inform */
|
2005-09-16 16:23:14 +02:00
|
|
|
#define SIG_NUMBER m2_i2 /* signal number to send */
|
|
|
|
#define SIG_FLAGS m2_i3 /* signal flags field */
|
|
|
|
#define SIG_MAP m2_l1 /* used by kernel to pass signal bit map */
|
|
|
|
#define SIG_CTXT_PTR m2_p1 /* pointer to info to restore signal context */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2010-03-12 16:58:41 +01:00
|
|
|
/* Field names for SYS_FORK, _EXEC, _EXIT, _NEWMAP, GETMCONTEXT, SETMCONTEXT.*/
|
2010-01-05 20:39:27 +01:00
|
|
|
#define PR_ENDPT m1_i1 /* indicates a process */
|
|
|
|
#define PR_PRIORITY m1_i2 /* process priority */
|
|
|
|
#define PR_SLOT m1_i2 /* indicates a process slot */
|
|
|
|
#define PR_STACK_PTR m1_p1 /* used for stack ptr in sys_exec, sys_getsp */
|
|
|
|
#define PR_NAME_PTR m1_p2 /* tells where program name is for dmp */
|
|
|
|
#define PR_IP_PTR m1_p3 /* initial value for ip after exec */
|
|
|
|
#define PR_MEM_PTR m1_p1 /* tells where memory map is for sys_newmap
|
2006-05-11 16:47:31 +02:00
|
|
|
* and sys_fork
|
|
|
|
*/
|
2010-01-05 20:39:27 +01:00
|
|
|
#define PR_FORK_FLAGS m1_i3 /* optional flags for fork operation */
|
|
|
|
#define PR_FORK_MSGADDR m1_p1 /* reply message address of forked child */
|
2010-03-12 16:58:41 +01:00
|
|
|
#define PR_CTX_PTR m1_p1 /* pointer to mcontext_t structure */
|
2005-07-29 12:21:04 +02:00
|
|
|
|
2008-11-19 13:26:10 +01:00
|
|
|
/* Flags for PR_FORK_FLAGS. */
|
|
|
|
#define PFF_VMINHIBIT 0x01 /* Don't schedule until release by VM. */
|
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
/* Field names for SYS_INT86 */
|
|
|
|
#define INT86_REG86 m1_p1 /* pointer to registers */
|
|
|
|
|
2006-06-23 13:54:03 +02:00
|
|
|
/* Field names for SYS_SAFECOPY* */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
#define SCP_FROM_TO m2_i1 /* from/to whom? */
|
2010-01-05 20:39:27 +01:00
|
|
|
#define SCP_SEG m2_i2 /* my own segment */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
#define SCP_GID m2_i3 /* grant id */
|
|
|
|
#define SCP_OFFSET m2_l1 /* offset within grant */
|
|
|
|
#define SCP_ADDRESS m2_p1 /* my own address */
|
|
|
|
#define SCP_BYTES m2_l2 /* bytes from offset */
|
|
|
|
|
2006-06-23 13:54:03 +02:00
|
|
|
/* Field names for SYS_VSAFECOPY* */
|
|
|
|
#define VSCP_VEC_ADDR m2_p1 /* start of vector */
|
|
|
|
#define VSCP_VEC_SIZE m2_l2 /* elements in vector */
|
|
|
|
|
2010-01-14 16:24:16 +01:00
|
|
|
/* Field names for SYS_SAFEMAPs */
|
|
|
|
#define SMAP_EP m2_i1
|
|
|
|
#define SMAP_GID m2_i2
|
|
|
|
#define SMAP_OFFSET m2_i3
|
|
|
|
#define SMAP_SEG m2_p1
|
|
|
|
#define SMAP_ADDRESS m2_l1
|
|
|
|
#define SMAP_BYTES m2_l2
|
|
|
|
#define SMAP_FLAG m2_s1
|
|
|
|
|
2006-10-30 16:53:38 +01:00
|
|
|
/* Field names for SYS_SPROF, _CPROF, _PROFBUF. */
|
|
|
|
#define PROF_ACTION m7_i1 /* start/stop/reset/get */
|
|
|
|
#define PROF_MEM_SIZE m7_i2 /* available memory for data */
|
|
|
|
#define PROF_FREQ m7_i3 /* sample frequency */
|
|
|
|
#define PROF_ENDPT m7_i4 /* endpoint of caller */
|
|
|
|
#define PROF_CTL_PTR m7_p1 /* location of info struct */
|
|
|
|
#define PROF_MEM_PTR m7_p2 /* location of profiling data */
|
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
/* Field names for SYS_READBIOS. */
|
2006-07-10 14:13:29 +02:00
|
|
|
#define RDB_SIZE m2_i1
|
|
|
|
#define RDB_ADDR m2_l1
|
|
|
|
#define RDB_BUF m2_p1
|
|
|
|
|
2008-11-19 13:26:10 +01:00
|
|
|
/* Field names for SYS_VMCTL. */
|
|
|
|
#define SVMCTL_WHO m1_i1
|
|
|
|
#define SVMCTL_PARAM m1_i2 /* All SYS_VMCTL requests. */
|
|
|
|
#define SVMCTL_VALUE m1_i3
|
2010-01-14 16:24:16 +01:00
|
|
|
#define SVMCTL_MRG_TARGET m2_i1 /* MEMREQ_GET reply: target process */
|
|
|
|
#define SVMCTL_MRG_ADDR m2_i2 /* MEMREQ_GET reply: address */
|
|
|
|
#define SVMCTL_MRG_LENGTH m2_i3 /* MEMREQ_GET reply: length */
|
|
|
|
#define SVMCTL_MRG_FLAG m2_s1 /* MEMREQ_GET reply: flag */
|
|
|
|
#define SVMCTL_MRG_EP2 m2_l1 /* MEMREQ_GET reply: source process */
|
|
|
|
#define SVMCTL_MRG_ADDR2 m2_l2 /* MEMREQ_GET reply: source address */
|
|
|
|
#define SVMCTL_MRG_REQUESTOR m2_p1 /* MEMREQ_GET reply: requestor */
|
2009-11-11 13:07:06 +01:00
|
|
|
#define SVMCTL_MAP_VIR_ADDR m1_p1
|
2010-05-12 10:31:05 +02:00
|
|
|
#define SVMCTL_PTROOT m1_i3
|
|
|
|
#define SVMCTL_PTROOT_V m1_p1
|
2009-11-11 13:07:06 +01:00
|
|
|
|
|
|
|
/* Reply message for VMCTL_KERN_PHYSMAP */
|
|
|
|
#define SVMCTL_MAP_FLAGS m2_i1 /* VMMF_* */
|
|
|
|
#define SVMCTL_MAP_PHYS_ADDR m2_l1
|
|
|
|
#define SVMCTL_MAP_PHYS_LEN m2_l2
|
|
|
|
|
|
|
|
#define VMMF_UNCACHED (1L << 0)
|
2008-11-19 13:26:10 +01:00
|
|
|
|
|
|
|
/* Values for SVMCTL_PARAM. */
|
|
|
|
#define VMCTL_CLEAR_PAGEFAULT 12
|
|
|
|
#define VMCTL_I386_GETCR3 13
|
|
|
|
#define VMCTL_MEMREQ_GET 14
|
|
|
|
#define VMCTL_MEMREQ_REPLY 15
|
2008-12-11 15:10:17 +01:00
|
|
|
#define VMCTL_INCSP 16
|
2008-12-18 15:30:55 +01:00
|
|
|
#define VMCTL_NOPAGEZERO 18
|
2009-09-21 16:23:10 +02:00
|
|
|
#define VMCTL_I386_KERNELLIMIT 19
|
|
|
|
#define VMCTL_I386_FREEPDE 23
|
|
|
|
#define VMCTL_ENABLE_PAGING 24
|
|
|
|
#define VMCTL_I386_INVLPG 25
|
|
|
|
#define VMCTL_FLUSHTLB 26
|
2009-11-11 13:07:06 +01:00
|
|
|
#define VMCTL_KERN_PHYSMAP 27
|
|
|
|
#define VMCTL_KERN_MAP_REPLY 28
|
2010-05-12 10:31:05 +02:00
|
|
|
#define VMCTL_SETADDRSPACE 29
|
2008-11-19 13:26:10 +01:00
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
/* Codes and field names for SYS_SYSCTL. */
|
|
|
|
#define SYSCTL_CODE m1_i1 /* SYSCTL_CODE_* below */
|
|
|
|
#define SYSCTL_ARG1 m1_p1
|
|
|
|
#define SYSCTL_ARG2 m1_i2
|
|
|
|
#define SYSCTL_CODE_DIAG 1 /* Print diagnostics. */
|
|
|
|
#define SYSCTL_CODE_STACKTRACE 2 /* Print process stack. */
|
|
|
|
#define DIAG_BUFSIZE (80*25)
|
|
|
|
|
2009-08-15 23:37:26 +02:00
|
|
|
/* Field names for SYS_VTIMER. */
|
|
|
|
#define VT_WHICH m2_i1 /* which timer to set/retrieve */
|
|
|
|
# define VT_VIRTUAL 1 /* the ITIMER_VIRTUAL timer */
|
|
|
|
# define VT_PROF 2 /* the ITIMER_PROF timer */
|
|
|
|
#define VT_SET m2_i2 /* 1 for setting a timer, 0 retrieval only */
|
|
|
|
#define VT_VALUE m2_l1 /* new/previous value of the timer */
|
|
|
|
#define VT_ENDPT m2_l2 /* process to set/retrieve the timer for */
|
|
|
|
|
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
|
|
|
/* Field names for SYS_RUNCTL. */
|
|
|
|
#define RC_ENDPT m1_i1 /* which process to stop or resume */
|
|
|
|
#define RC_ACTION m1_i2 /* set or clear stop flag */
|
2009-10-01 12:36:09 +02:00
|
|
|
# define RC_STOP 0 /* stop the process */
|
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 RC_RESUME 1 /* clear the stop flag */
|
2009-10-01 12:36:09 +02:00
|
|
|
#define RC_FLAGS m1_i3 /* request flags */
|
|
|
|
# define RC_DELAY 1 /* delay stop if process is sending */
|
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
|
|
|
|
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
|
|
|
/* Field names for SYS_UPDATE. */
|
|
|
|
#define SYS_UPD_SRC_ENDPT m1_i1 /* source endpoint */
|
|
|
|
#define SYS_UPD_DST_ENDPT m1_i2 /* destination endpoint */
|
|
|
|
|
2010-04-08 15:41:35 +02:00
|
|
|
/* Subfunctions for SYS_STATECTL */
|
|
|
|
#define SYS_STATE_CLEAR_IPC_REFS 1 /* clear IPC references */
|
|
|
|
|
2005-08-03 13:53:36 +02:00
|
|
|
/*===========================================================================*
|
2005-10-20 22:34:34 +02:00
|
|
|
* Messages for the Reincarnation Server *
|
2005-08-03 13:53:36 +02:00
|
|
|
*===========================================================================*/
|
|
|
|
|
2005-10-20 22:34:34 +02:00
|
|
|
#define RS_RQ_BASE 0x700
|
2005-08-03 13:53:36 +02:00
|
|
|
|
2005-10-20 22:34:34 +02:00
|
|
|
#define RS_UP (RS_RQ_BASE + 0) /* start system service */
|
|
|
|
#define RS_DOWN (RS_RQ_BASE + 1) /* stop system service */
|
2006-10-20 17:01:32 +02:00
|
|
|
#define RS_REFRESH (RS_RQ_BASE + 2) /* refresh system service */
|
|
|
|
#define RS_RESTART (RS_RQ_BASE + 3) /* restart system service */
|
2009-12-17 02:53:26 +01:00
|
|
|
#define RS_SHUTDOWN (RS_RQ_BASE + 4) /* alert about shutdown */
|
Basic System Event Framework (SEF) with ping and live update.
SYSLIB CHANGES:
- SEF must be used by every system process and is thereby part of the system
library.
- The framework provides a receive() interface (sef_receive) for system
processes to automatically catch known system even messages and process them.
- SEF provides a default behavior for each type of system event, but allows
system processes to register callbacks to override the default behavior.
- Custom (local to the process) or predefined (provided by SEF) callback
implementations can be registered to SEF.
- SEF currently includes support for 2 types of system events:
1. SEF Ping. The event occurs every time RS sends a ping to figure out
whether a system process is still alive. The default callback implementation
provided by SEF is to notify RS back to let it know the process is alive
and kicking.
2. SEF Live update. The event occurs every time RS sends a prepare to update
message to let a system process know an update is available and to prepare
for it. The live update support is very basic for now. SEF only deals with
verifying if the prepare state can be supported by the process, dumping the
state for debugging purposes, and providing an event-driven programming
model to the process to react to state changes check-in when ready to update.
- SEF should be extended in the future to integrate support for more types of
system events. Ideally, all the cross-cutting concerns should be integrated into
SEF to avoid duplicating code and ease extensibility. Examples include:
* PM notify messages primarily used at shutdown.
* SYSTEM notify messages primarily used for signals.
* CLOCK notify messages used for system alarms.
* Debug messages. IS could still be in charge of fkey handling but would
forward the debug message to the target process (e.g. PM, if the user
requested debug information about PM). SEF would then catch the message and
do nothing unless the process has registered an appropriate callback to
deal with the event. This simplifies the programming model to print debug
information, avoids duplicating code, and reduces the effort to print
debug information.
SYSTEM PROCESSES CHANGES:
- Every system process registers SEF callbacks it needs to override the default
system behavior and calls sef_startup() right after being started.
- sef_startup() does almost nothing now, but will be extended in the future to
support callbacks of its own to let RS control and synchronize with every
system process at initialization time.
- Every system process calls sef_receive() now rather than receive() directly,
to let SEF handle predefined system events.
RS CHANGES:
- RS supports a basic single-component live update protocol now, as follows:
* When an update command is issued (via "service update *"), RS notifies the
target system process to prepare for a specific update state.
* If the process doesn't respond back in time, the update is aborted.
* When the process responds back, RS kills it and marks it for refreshing.
* The process is then automatically restarted as for a buggy process and can
start running again.
* Live update is currently prototyped as a controlled failure.
2009-12-21 15:12:21 +01:00
|
|
|
#define RS_UPDATE (RS_RQ_BASE + 5) /* update system service */
|
2009-12-17 02:53:26 +01:00
|
|
|
|
2009-09-21 17:25:15 +02:00
|
|
|
#define RS_LOOKUP (RS_RQ_BASE + 8) /* lookup server name */
|
2005-08-03 13:53:36 +02:00
|
|
|
|
Initialization protocol for system services.
SYSLIB CHANGES:
- SEF framework now supports a new SEF Init request type from RS. 3 different
callbacks are available (init_fresh, init_lu, init_restart) to specify
initialization code when a service starts fresh, starts after a live update,
or restarts.
SYSTEM SERVICE CHANGES:
- Initialization code for system services is now enclosed in a callback SEF will
automatically call at init time. The return code of the callback will
tell RS whether the initialization completed successfully.
- Each init callback can access information passed by RS to initialize. As of
now, each system service has access to the public entries of RS's system process
table to gather all the information required to initialize. This design
eliminates many existing or potential races at boot time and provides a uniform
initialization interface to system services. The same interface will be reused
for the upcoming publish/subscribe model to handle dynamic
registration / deregistration of system services.
VM CHANGES:
- Uniform privilege management for all system services. Every service uses the
same call mask format. For boot services, VM copies the call mask from init
data. For dynamic services, VM still receives the call mask via rs_set_priv
call that will be soon replaced by the upcoming publish/subscribe model.
RS CHANGES:
- The system process table has been reorganized and split into private entries
and public entries. Only the latter ones are exposed to system services.
- VM call masks are now entirely configured in rs/table.c
- RS has now its own slot in the system process table. Only kernel tasks and
user processes not included in the boot image are now left out from the system
process table.
- RS implements the initialization protocol for system services.
- For services in the boot image, RS blocks till initialization is complete and
panics when failure is reported back. Services are initialized in their order of
appearance in the boot image priv table and RS blocks to implements synchronous
initialization for every system service having the flag SF_SYNCH_BOOT set.
- For services started dynamically, the initialization protocol is implemented
as though it were the first ping for the service. In this case, if the
system service fails to report back (or reports failure), RS brings the service
down rather than trying to restart it.
2010-01-08 02:20:42 +01:00
|
|
|
#define RS_INIT (RS_RQ_BASE + 20) /* service init message */
|
Basic System Event Framework (SEF) with ping and live update.
SYSLIB CHANGES:
- SEF must be used by every system process and is thereby part of the system
library.
- The framework provides a receive() interface (sef_receive) for system
processes to automatically catch known system even messages and process them.
- SEF provides a default behavior for each type of system event, but allows
system processes to register callbacks to override the default behavior.
- Custom (local to the process) or predefined (provided by SEF) callback
implementations can be registered to SEF.
- SEF currently includes support for 2 types of system events:
1. SEF Ping. The event occurs every time RS sends a ping to figure out
whether a system process is still alive. The default callback implementation
provided by SEF is to notify RS back to let it know the process is alive
and kicking.
2. SEF Live update. The event occurs every time RS sends a prepare to update
message to let a system process know an update is available and to prepare
for it. The live update support is very basic for now. SEF only deals with
verifying if the prepare state can be supported by the process, dumping the
state for debugging purposes, and providing an event-driven programming
model to the process to react to state changes check-in when ready to update.
- SEF should be extended in the future to integrate support for more types of
system events. Ideally, all the cross-cutting concerns should be integrated into
SEF to avoid duplicating code and ease extensibility. Examples include:
* PM notify messages primarily used at shutdown.
* SYSTEM notify messages primarily used for signals.
* CLOCK notify messages used for system alarms.
* Debug messages. IS could still be in charge of fkey handling but would
forward the debug message to the target process (e.g. PM, if the user
requested debug information about PM). SEF would then catch the message and
do nothing unless the process has registered an appropriate callback to
deal with the event. This simplifies the programming model to print debug
information, avoids duplicating code, and reduces the effort to print
debug information.
SYSTEM PROCESSES CHANGES:
- Every system process registers SEF callbacks it needs to override the default
system behavior and calls sef_startup() right after being started.
- sef_startup() does almost nothing now, but will be extended in the future to
support callbacks of its own to let RS control and synchronize with every
system process at initialization time.
- Every system process calls sef_receive() now rather than receive() directly,
to let SEF handle predefined system events.
RS CHANGES:
- RS supports a basic single-component live update protocol now, as follows:
* When an update command is issued (via "service update *"), RS notifies the
target system process to prepare for a specific update state.
* If the process doesn't respond back in time, the update is aborted.
* When the process responds back, RS kills it and marks it for refreshing.
* The process is then automatically restarted as for a buggy process and can
start running again.
* Live update is currently prototyped as a controlled failure.
2009-12-21 15:12:21 +01:00
|
|
|
#define RS_LU_PREPARE (RS_RQ_BASE + 21) /* prepare to update message */
|
|
|
|
|
2005-10-20 22:34:34 +02:00
|
|
|
# define RS_CMD_ADDR m1_p1 /* command string */
|
|
|
|
# define RS_CMD_LEN m1_i1 /* length of command */
|
|
|
|
# define RS_PERIOD m1_i2 /* heartbeat period */
|
|
|
|
# define RS_DEV_MAJOR m1_i3 /* major device number */
|
|
|
|
|
2006-10-25 15:40:36 +02:00
|
|
|
# define RS_ENDPOINT m1_i1 /* endpoint number in reply */
|
|
|
|
|
2009-09-21 16:23:10 +02:00
|
|
|
# define RS_NAME m1_p1 /* name */
|
|
|
|
# define RS_NAME_LEN m1_i1 /* namelen */
|
|
|
|
|
2010-04-27 13:17:30 +02:00
|
|
|
# define RS_INIT_RESULT m7_i1 /* init result */
|
|
|
|
# define RS_INIT_TYPE m7_i2 /* init type */
|
|
|
|
# define RS_INIT_RPROCTAB_GID m7_i3 /* init rproc table gid */
|
|
|
|
# define RS_INIT_OLD_ENDPOINT m7_i4 /* init old endpoint */
|
Initialization protocol for system services.
SYSLIB CHANGES:
- SEF framework now supports a new SEF Init request type from RS. 3 different
callbacks are available (init_fresh, init_lu, init_restart) to specify
initialization code when a service starts fresh, starts after a live update,
or restarts.
SYSTEM SERVICE CHANGES:
- Initialization code for system services is now enclosed in a callback SEF will
automatically call at init time. The return code of the callback will
tell RS whether the initialization completed successfully.
- Each init callback can access information passed by RS to initialize. As of
now, each system service has access to the public entries of RS's system process
table to gather all the information required to initialize. This design
eliminates many existing or potential races at boot time and provides a uniform
initialization interface to system services. The same interface will be reused
for the upcoming publish/subscribe model to handle dynamic
registration / deregistration of system services.
VM CHANGES:
- Uniform privilege management for all system services. Every service uses the
same call mask format. For boot services, VM copies the call mask from init
data. For dynamic services, VM still receives the call mask via rs_set_priv
call that will be soon replaced by the upcoming publish/subscribe model.
RS CHANGES:
- The system process table has been reorganized and split into private entries
and public entries. Only the latter ones are exposed to system services.
- VM call masks are now entirely configured in rs/table.c
- RS has now its own slot in the system process table. Only kernel tasks and
user processes not included in the boot image are now left out from the system
process table.
- RS implements the initialization protocol for system services.
- For services in the boot image, RS blocks till initialization is complete and
panics when failure is reported back. Services are initialized in their order of
appearance in the boot image priv table and RS blocks to implements synchronous
initialization for every system service having the flag SF_SYNCH_BOOT set.
- For services started dynamically, the initialization protocol is implemented
as though it were the first ping for the service. In this case, if the
system service fails to report back (or reports failure), RS brings the service
down rather than trying to restart it.
2010-01-08 02:20:42 +01:00
|
|
|
|
Basic System Event Framework (SEF) with ping and live update.
SYSLIB CHANGES:
- SEF must be used by every system process and is thereby part of the system
library.
- The framework provides a receive() interface (sef_receive) for system
processes to automatically catch known system even messages and process them.
- SEF provides a default behavior for each type of system event, but allows
system processes to register callbacks to override the default behavior.
- Custom (local to the process) or predefined (provided by SEF) callback
implementations can be registered to SEF.
- SEF currently includes support for 2 types of system events:
1. SEF Ping. The event occurs every time RS sends a ping to figure out
whether a system process is still alive. The default callback implementation
provided by SEF is to notify RS back to let it know the process is alive
and kicking.
2. SEF Live update. The event occurs every time RS sends a prepare to update
message to let a system process know an update is available and to prepare
for it. The live update support is very basic for now. SEF only deals with
verifying if the prepare state can be supported by the process, dumping the
state for debugging purposes, and providing an event-driven programming
model to the process to react to state changes check-in when ready to update.
- SEF should be extended in the future to integrate support for more types of
system events. Ideally, all the cross-cutting concerns should be integrated into
SEF to avoid duplicating code and ease extensibility. Examples include:
* PM notify messages primarily used at shutdown.
* SYSTEM notify messages primarily used for signals.
* CLOCK notify messages used for system alarms.
* Debug messages. IS could still be in charge of fkey handling but would
forward the debug message to the target process (e.g. PM, if the user
requested debug information about PM). SEF would then catch the message and
do nothing unless the process has registered an appropriate callback to
deal with the event. This simplifies the programming model to print debug
information, avoids duplicating code, and reduces the effort to print
debug information.
SYSTEM PROCESSES CHANGES:
- Every system process registers SEF callbacks it needs to override the default
system behavior and calls sef_startup() right after being started.
- sef_startup() does almost nothing now, but will be extended in the future to
support callbacks of its own to let RS control and synchronize with every
system process at initialization time.
- Every system process calls sef_receive() now rather than receive() directly,
to let SEF handle predefined system events.
RS CHANGES:
- RS supports a basic single-component live update protocol now, as follows:
* When an update command is issued (via "service update *"), RS notifies the
target system process to prepare for a specific update state.
* If the process doesn't respond back in time, the update is aborted.
* When the process responds back, RS kills it and marks it for refreshing.
* The process is then automatically restarted as for a buggy process and can
start running again.
* Live update is currently prototyped as a controlled failure.
2009-12-21 15:12:21 +01:00
|
|
|
# define RS_LU_RESULT m1_i1 /* live update result */
|
|
|
|
# define RS_LU_STATE m1_i2 /* state required to update */
|
|
|
|
# define RS_LU_PREPARE_MAXTIME m1_i3 /* the max time to prepare */
|
|
|
|
|
2005-10-20 22:34:34 +02:00
|
|
|
/*===========================================================================*
|
|
|
|
* Messages for the Data Store Server *
|
|
|
|
*===========================================================================*/
|
|
|
|
|
|
|
|
#define DS_RQ_BASE 0x800
|
|
|
|
|
2010-01-14 16:24:16 +01:00
|
|
|
#define DS_PUBLISH (DS_RQ_BASE + 0) /* publish data */
|
|
|
|
#define DS_RETRIEVE (DS_RQ_BASE + 1) /* retrieve data by name */
|
|
|
|
#define DS_SUBSCRIBE (DS_RQ_BASE + 2) /* subscribe to data updates */
|
|
|
|
#define DS_CHECK (DS_RQ_BASE + 3) /* retrieve updated data */
|
|
|
|
#define DS_DELETE (DS_RQ_BASE + 4) /* delete data */
|
|
|
|
#define DS_SNAPSHOT (DS_RQ_BASE + 5) /* take a snapshot */
|
|
|
|
#define DS_RETRIEVE_LABEL (DS_RQ_BASE + 6) /* retrieve label's name */
|
|
|
|
|
|
|
|
/* DS field names */
|
|
|
|
# define DS_KEY_GRANT m2_i1 /* key for the data */
|
|
|
|
# define DS_KEY_LEN m2_s1 /* length of key incl. '\0' */
|
2005-10-20 22:34:34 +02:00
|
|
|
# define DS_FLAGS m2_i2 /* flags provided by caller */
|
2006-07-13 16:50:23 +02:00
|
|
|
|
|
|
|
# define DS_VAL m2_l1 /* data (u32, char *, etc.) */
|
|
|
|
# define DS_VAL_LEN m2_l2 /* data length */
|
2010-01-14 16:24:16 +01:00
|
|
|
# define DS_NR_SNAPSHOT m2_i3 /* number of snapshot */
|
2010-04-08 15:41:35 +02:00
|
|
|
# define DS_OWNER m2_i3 /* owner */
|
2005-08-03 13:53:36 +02:00
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
/*===========================================================================*
|
2005-08-03 13:53:36 +02:00
|
|
|
* Miscellaneous messages used by TTY *
|
2005-04-21 16:53:53 +02:00
|
|
|
*===========================================================================*/
|
|
|
|
|
|
|
|
/* Miscellaneous request types and field names, e.g. used by IS server. */
|
2005-09-16 16:23:14 +02:00
|
|
|
#define FKEY_CONTROL 98 /* control a function key at the TTY */
|
|
|
|
# define FKEY_REQUEST m2_i1 /* request to perform at TTY */
|
2005-06-20 16:23:31 +02:00
|
|
|
# define FKEY_MAP 10 /* observe function key */
|
|
|
|
# define FKEY_UNMAP 11 /* stop observing function key */
|
|
|
|
# define FKEY_EVENTS 12 /* request open key presses */
|
2005-09-16 16:23:14 +02:00
|
|
|
# define FKEY_FKEYS m2_l1 /* F1-F12 keys pressed */
|
|
|
|
# define FKEY_SFKEYS m2_l2 /* Shift-F1-F12 keys pressed */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
#define DIAG_BASE 0xa00
|
2009-01-26 18:43:59 +01:00
|
|
|
#define DIAGNOSTICS_OLD (DIAG_BASE+1) /* output a string without FS in between */
|
|
|
|
#define DIAGNOSTICS_S_OLD (DIAG_BASE+2) /* grant-based version of DIAGNOSTICS */
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
# define DIAG_PRINT_BUF_G m1_p1
|
2005-09-16 16:23:14 +02:00
|
|
|
# define DIAG_BUF_COUNT m1_i1
|
. introduced DEV_READ_S, DEV_WRITE_S, DEV_SCATTER_S, DEV_GATHER_S
and DEV_IOCTL_S as replacements for DEV_READ, DEV_WRITE, DEV_SCATTER,
DEV_GATHER and DEV_IOCTL. Instead of a direct address, the *_S commands
pass 'grant ids' to the drivers which are referenced through a new set
of copy calls (sys_safecopyfrom and sys_safecopyto). in order for this
copy to succeed, the grant must have previously been created in the
address space of the granter.
. bitmap manipulation functions moved to <minix/bitmap.h>
. HIGHPOS introduced as field containing high 32 bits of position in
device I/O message; TTY_FLAGS no longer used
. IO_GRANT field introduced for GRANTs, to replace ADDRESS
. REP_IO_GRANT field for un-SUSPEND messages introduced to indicate
grant for which I/O was done to disambiguate messages
. SYS_SAFECOPYFROM and SYS_SAFECOPYTO introduced as new calls
. SYS_PRIV_SET_GRANTS code introduced as a code to set the address and
size of the grant table in a process' own address space
. 'type' and 'direction' field of _ins* and _outs* I/O functions
are merged into one by ORing _DIO_INPUT/_DIO_OUTPUT and _DIO_BYTE/_DIO_WORD
etc. This allows for an additional parameter, _DIO_SAFE, which indicates
the address in another address space isn't actually an address, but
a grant id. Also needs an offset, for which fields had to be merged.
. SCP_* are field names for SYS_SAFECOPY* functions
. DIAGNOSTICS and GET_KMESS moved to their own range above DIAG_BASE,
added DIAGNOSTICS_S which is a grant-based variant of DIAGNOSTICS
. removed obsolete BINCOMPAT and SRCCOMPAT options
. added GRANT_SEG type for use in vircopy - allows copying to a grant
id (without offset)
. added _MINIX_IOCTL_* macros that decode information encoded by
_IO* macros in ioctl codes, used to check which grants are necessary
for an ioctl
. introduced the type endpoint_t for process endpoints, changed some
prototypes and struct field types to match
. renamed protected to prot for g++
2006-06-20 10:38:15 +02:00
|
|
|
#define GET_KMESS (DIAG_BASE+3) /* get kmess from TTY */
|
2005-09-30 14:47:03 +02:00
|
|
|
# define GETKM_PTR m1_p1
|
2006-07-10 14:13:29 +02:00
|
|
|
#define GET_KMESS_S (DIAG_BASE+4) /* get kmess from TTY */
|
|
|
|
# define GETKM_GRANT m1_i1
|
2009-01-26 18:43:59 +01:00
|
|
|
#define ASYN_DIAGNOSTICS_OLD (DIAG_BASE+5) /* grant-based, replyless DIAGNOSTICS */
|
2005-09-30 14:47:03 +02:00
|
|
|
|
2009-01-26 18:43:59 +01:00
|
|
|
#define DIAG_REPL_OLD (DIAG_BASE+0x80+0) /* reply to DIAGNOSTICS(_S) */
|
2008-02-21 16:57:35 +01:00
|
|
|
|
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
|
|
|
/*===========================================================================*
|
|
|
|
* Messages used between PM and VFS *
|
|
|
|
*===========================================================================*/
|
|
|
|
|
2009-10-01 12:33:01 +02:00
|
|
|
#define PM_RQ_BASE 0x900
|
|
|
|
#define PM_RS_BASE 0x980
|
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
|
|
|
|
|
|
|
/* Requests from PM to VFS */
|
2010-01-05 20:39:27 +01:00
|
|
|
#define PM_INIT (PM_RQ_BASE + 0) /* Process table exchange */
|
2009-10-01 12:33:01 +02:00
|
|
|
#define PM_SETUID (PM_RQ_BASE + 1) /* Set new user ID */
|
|
|
|
#define PM_SETGID (PM_RQ_BASE + 2) /* Set group ID */
|
|
|
|
#define PM_SETSID (PM_RQ_BASE + 3) /* Set session leader */
|
|
|
|
#define PM_EXIT (PM_RQ_BASE + 4) /* Process exits */
|
|
|
|
#define PM_DUMPCORE (PM_RQ_BASE + 5) /* Process is to dump core */
|
|
|
|
#define PM_EXEC (PM_RQ_BASE + 6) /* Forwarded exec call */
|
|
|
|
#define PM_FORK (PM_RQ_BASE + 7) /* Newly forked 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 PM_SRV_FORK (PM_RQ_BASE + 8) /* fork for system services */
|
2009-10-01 12:33:01 +02:00
|
|
|
#define PM_UNPAUSE (PM_RQ_BASE + 9) /* Interrupt process call */
|
|
|
|
#define PM_REBOOT (PM_RQ_BASE + 10) /* System reboot */
|
- Introduce support for sticky bit.
- Revise VFS-FS protocol and update VFS/MFS/ISOFS accordingly.
- Clean up MFS by removing old, dead code (backwards compatibility is broken by
the new VFS-FS protocol, anyway) and rewrite other parts. Also, make sure all
functions have proper banners and prototypes.
- VFS should always provide a (syntactically) valid path to the FS; no need for
the FS to do sanity checks when leaving/entering mount points.
- Fix several bugs in MFS:
- Several path lookup bugs in MFS.
- A link can be too big for the path buffer.
- A mountpoint can become inaccessible when the creation of a new inode
fails, because the inode already exists and is a mountpoint.
- Introduce support for supplemental groups.
- Add test 46 to test supplemental group functionality (and removed obsolete
suppl. tests from test 2).
- Clean up VFS (not everything is done yet).
- ISOFS now opens device read-only. This makes the -r flag in the mount command
unnecessary (but will still report to be mounted read-write).
- Introduce PipeFS. PipeFS is a new FS that handles all anonymous and
named pipes. However, named pipes still reside on the (M)FS, as they are part
of the file system on disk. To make this work VFS now has a concept of
'mapped' inodes, which causes read, write, truncate and stat requests to be
redirected to the mapped FS, and all other requests to the original FS.
2009-12-20 21:27:14 +01:00
|
|
|
#define PM_SETGROUPS (PM_RQ_BASE + 11) /* Tell VFS about setgroups */
|
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
|
|
|
|
|
|
|
/* Replies from VFS to PM */
|
2010-01-05 20:39:27 +01:00
|
|
|
#define PM_SETUID_REPLY (PM_RS_BASE + 1)
|
|
|
|
#define PM_SETGID_REPLY (PM_RS_BASE + 2)
|
|
|
|
#define PM_SETSID_REPLY (PM_RS_BASE + 3)
|
|
|
|
#define PM_EXIT_REPLY (PM_RS_BASE + 4)
|
|
|
|
#define PM_CORE_REPLY (PM_RS_BASE + 5)
|
|
|
|
#define PM_EXEC_REPLY (PM_RS_BASE + 6)
|
|
|
|
#define PM_FORK_REPLY (PM_RS_BASE + 7)
|
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 PM_SRV_FORK_REPLY (PM_RS_BASE + 8)
|
2010-01-05 20:39:27 +01:00
|
|
|
#define PM_UNPAUSE_REPLY (PM_RS_BASE + 9)
|
|
|
|
#define PM_REBOOT_REPLY (PM_RS_BASE + 10)
|
|
|
|
#define PM_SETGROUPS_REPLY (PM_RS_BASE + 11)
|
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
|
|
|
|
|
|
|
/* Standard parameters for all requests and replies, except PM_REBOOT */
|
2010-01-05 20:39:27 +01:00
|
|
|
# define PM_PROC m1_i1 /* process endpoint */
|
|
|
|
|
|
|
|
/* Additional parameters for PM_INIT */
|
|
|
|
# define PM_SLOT m1_i2 /* process slot number */
|
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 PM_PID m1_i3 /* process pid */
|
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
|
|
|
|
|
|
|
/* Additional parameters for PM_SETUID and PM_SETGID */
|
|
|
|
# define PM_EID m1_i2 /* effective user/group id */
|
|
|
|
# define PM_RID m1_i3 /* real user/group id */
|
|
|
|
|
- Introduce support for sticky bit.
- Revise VFS-FS protocol and update VFS/MFS/ISOFS accordingly.
- Clean up MFS by removing old, dead code (backwards compatibility is broken by
the new VFS-FS protocol, anyway) and rewrite other parts. Also, make sure all
functions have proper banners and prototypes.
- VFS should always provide a (syntactically) valid path to the FS; no need for
the FS to do sanity checks when leaving/entering mount points.
- Fix several bugs in MFS:
- Several path lookup bugs in MFS.
- A link can be too big for the path buffer.
- A mountpoint can become inaccessible when the creation of a new inode
fails, because the inode already exists and is a mountpoint.
- Introduce support for supplemental groups.
- Add test 46 to test supplemental group functionality (and removed obsolete
suppl. tests from test 2).
- Clean up VFS (not everything is done yet).
- ISOFS now opens device read-only. This makes the -r flag in the mount command
unnecessary (but will still report to be mounted read-write).
- Introduce PipeFS. PipeFS is a new FS that handles all anonymous and
named pipes. However, named pipes still reside on the (M)FS, as they are part
of the file system on disk. To make this work VFS now has a concept of
'mapped' inodes, which causes read, write, truncate and stat requests to be
redirected to the mapped FS, and all other requests to the original FS.
2009-12-20 21:27:14 +01:00
|
|
|
/* Additional parameter for PM_SETGROUPS */
|
2010-01-05 20:39:27 +01:00
|
|
|
# define PM_GROUP_NO m1_i2 /* number of groups */
|
|
|
|
# define PM_GROUP_ADDR m1_p1 /* struct holding group data */
|
- Introduce support for sticky bit.
- Revise VFS-FS protocol and update VFS/MFS/ISOFS accordingly.
- Clean up MFS by removing old, dead code (backwards compatibility is broken by
the new VFS-FS protocol, anyway) and rewrite other parts. Also, make sure all
functions have proper banners and prototypes.
- VFS should always provide a (syntactically) valid path to the FS; no need for
the FS to do sanity checks when leaving/entering mount points.
- Fix several bugs in MFS:
- Several path lookup bugs in MFS.
- A link can be too big for the path buffer.
- A mountpoint can become inaccessible when the creation of a new inode
fails, because the inode already exists and is a mountpoint.
- Introduce support for supplemental groups.
- Add test 46 to test supplemental group functionality (and removed obsolete
suppl. tests from test 2).
- Clean up VFS (not everything is done yet).
- ISOFS now opens device read-only. This makes the -r flag in the mount command
unnecessary (but will still report to be mounted read-write).
- Introduce PipeFS. PipeFS is a new FS that handles all anonymous and
named pipes. However, named pipes still reside on the (M)FS, as they are part
of the file system on disk. To make this work VFS now has a concept of
'mapped' inodes, which causes read, write, truncate and stat requests to be
redirected to the mapped FS, and all other requests to the original FS.
2009-12-20 21:27:14 +01:00
|
|
|
|
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
|
|
|
/* Additional parameters for PM_EXEC */
|
|
|
|
# define PM_PATH m1_p1 /* executable */
|
|
|
|
# define PM_PATH_LEN m1_i2 /* length of path including
|
2010-01-05 20:39:27 +01:00
|
|
|
* terminating null character
|
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 PM_FRAME m1_p2 /* arguments and environment */
|
|
|
|
# define PM_FRAME_LEN m1_i3 /* size of frame */
|
|
|
|
|
|
|
|
/* Additional parameters for PM_EXEC_REPLY and PM_CORE_REPLY */
|
|
|
|
# define PM_STATUS m1_i2 /* OK or failure */
|
|
|
|
|
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
|
|
|
/* Additional parameters for PM_FORK and PM_SRV_FORK */
|
2010-01-05 20:39:27 +01:00
|
|
|
# define PM_PPROC m1_i2 /* parent process endpoint */
|
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 PM_CPID m1_i3 /* child pid */
|
2006-05-11 16:47:31 +02:00
|
|
|
|
|
|
|
/* Parameters for the EXEC_NEWMEM call */
|
|
|
|
#define EXC_NM_PROC m1_i1 /* process that needs new map */
|
|
|
|
#define EXC_NM_PTR m1_p1 /* parameters in struct exec_newmem */
|
|
|
|
/* Results:
|
|
|
|
* the status will be in m_type.
|
|
|
|
* the top of the stack will be in m1_i1.
|
|
|
|
* the following flags will be in m1_i2:
|
|
|
|
*/
|
|
|
|
#define EXC_NM_RF_LOAD_TEXT 1 /* Load text segment (otherwise the
|
|
|
|
* text segment is already present)
|
|
|
|
*/
|
|
|
|
#define EXC_NM_RF_ALLOW_SETUID 2 /* Setuid execution is allowed (tells
|
|
|
|
* FS to update its uid and gid
|
|
|
|
* fields.
|
|
|
|
*/
|
2008-11-19 13:26:10 +01:00
|
|
|
#define EXC_NM_RF_FULLVM 4
|
2006-05-11 16:47:31 +02:00
|
|
|
|
|
|
|
/* Parameters for the EXEC_RESTART call */
|
|
|
|
#define EXC_RS_PROC m1_i1 /* process that needs to be restarted */
|
|
|
|
#define EXC_RS_RESULT m1_i2 /* result of the exec */
|
|
|
|
|
2009-10-01 12:33:01 +02:00
|
|
|
/*===========================================================================*
|
|
|
|
* Messages used from VFS to file servers *
|
|
|
|
*===========================================================================*/
|
|
|
|
|
2007-08-07 13:55:28 +02:00
|
|
|
#define VFS_BASE 0xA00 /* Requests sent by VFS to filesystem
|
|
|
|
* implementations. See <minix/vfsif.h>
|
|
|
|
*/
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
/*===========================================================================*
|
|
|
|
* Miscellaneous field names *
|
|
|
|
*===========================================================================*/
|
|
|
|
|
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 COMMON_RQ_BASE 0xE00
|
|
|
|
|
2009-09-21 16:23:10 +02:00
|
|
|
/* PM field names */
|
|
|
|
/* BRK */
|
|
|
|
#define PMBRK_ADDR m1_p1
|
|
|
|
|
|
|
|
/* TRACE */
|
|
|
|
#define PMTRACE_ADDR m2_l1
|
|
|
|
|
|
|
|
#define PM_ENDPT m1_i1
|
|
|
|
#define PM_PENDPT m1_i2
|
|
|
|
|
2010-01-05 20:39:27 +01:00
|
|
|
/* Field names for GETSYSINFO_UP (PM). */
|
|
|
|
#define SIU_WHAT m2_i1
|
|
|
|
#define SIU_LEN m2_i2
|
|
|
|
#define SIU_WHERE m2_p1
|
|
|
|
|
|
|
|
/* Field names for SELECT (FS). */
|
|
|
|
#define SEL_NFDS m8_i1
|
|
|
|
#define SEL_READFDS m8_p1
|
|
|
|
#define SEL_WRITEFDS m8_p2
|
|
|
|
#define SEL_ERRORFDS m8_p3
|
|
|
|
#define SEL_TIMEOUT m8_p4
|
|
|
|
|
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
|
|
|
/* Field names for system signals (sent by a signal manager). */
|
|
|
|
#define SIGS_SIGNAL_RECEIVED (COMMON_RQ_BASE+0)
|
|
|
|
# define SIGS_SIG_NUM m2_i1
|
|
|
|
|
2008-11-19 13:26:10 +01:00
|
|
|
/*===========================================================================*
|
|
|
|
* Messages for VM server *
|
|
|
|
*===========================================================================*/
|
|
|
|
#define VM_RQ_BASE 0xC00
|
|
|
|
|
|
|
|
/* Calls from PM */
|
|
|
|
#define VM_EXIT (VM_RQ_BASE+0)
|
|
|
|
# define VME_ENDPOINT m1_i1
|
|
|
|
#define VM_FORK (VM_RQ_BASE+1)
|
|
|
|
# define VMF_ENDPOINT m1_i1
|
|
|
|
# define VMF_SLOTNO m1_i2
|
|
|
|
# define VMF_CHILD_ENDPOINT m1_i3 /* result */
|
|
|
|
#define VM_BRK (VM_RQ_BASE+2)
|
|
|
|
# define VMB_ENDPOINT m1_i1
|
|
|
|
# define VMB_ADDR m1_p1
|
|
|
|
# define VMB_RETADDR m1_p2 /* result */
|
|
|
|
#define VM_EXEC_NEWMEM (VM_RQ_BASE+3)
|
|
|
|
# define VMEN_ENDPOINT m1_i1
|
|
|
|
# define VMEN_ARGSPTR m1_p1
|
|
|
|
# define VMEN_ARGSSIZE m1_i2
|
|
|
|
# define VMEN_FLAGS m1_i3 /* result */
|
|
|
|
# define VMEN_STACK_TOP m1_p2 /* result */
|
|
|
|
#define VM_PUSH_SIG (VM_RQ_BASE+4)
|
|
|
|
# define VMPS_ENDPOINT m1_i1
|
|
|
|
# define VMPS_OLD_SP m1_p1 /* result */
|
|
|
|
#define VM_WILLEXIT (VM_RQ_BASE+5)
|
|
|
|
# define VMWE_ENDPOINT m1_i1
|
|
|
|
|
|
|
|
/* General calls. */
|
|
|
|
#define VM_MMAP (VM_RQ_BASE+10)
|
|
|
|
# define VMM_ADDR m5_l1
|
|
|
|
# define VMM_LEN m5_l2
|
2010-01-19 22:19:59 +01:00
|
|
|
# define VMM_PROT m5_s1
|
|
|
|
# define VMM_FLAGS m5_s2
|
2008-11-19 13:26:10 +01:00
|
|
|
# define VMM_FD m5_i1
|
|
|
|
# define VMM_OFFSET m5_i2
|
|
|
|
# define VMM_RETADDR m5_l1 /* result */
|
|
|
|
#define VM_UMAP (VM_RQ_BASE+11)
|
|
|
|
# define VMU_SEG m1_i1
|
|
|
|
# define VMU_OFFSET m1_p1
|
|
|
|
# define VMU_LENGTH m1_p2
|
|
|
|
# define VMU_RETADDR m1_p3
|
|
|
|
|
|
|
|
/* to VM: inform VM about a region of memory that is used for
|
|
|
|
* bus-master DMA
|
|
|
|
*/
|
|
|
|
#define VM_ADDDMA (VM_RQ_BASE+12)
|
|
|
|
# define VMAD_REQ m2_i2
|
|
|
|
# define VMAD_EP m2_i1
|
|
|
|
# define VMAD_START m2_l1
|
|
|
|
# define VMAD_SIZE m2_l2
|
|
|
|
|
|
|
|
/* to VM: inform VM that a region of memory that is no longer
|
|
|
|
* used for bus-master DMA
|
|
|
|
*/
|
|
|
|
#define VM_DELDMA (VM_RQ_BASE+13)
|
|
|
|
# define VMDD_REQ m2_i2
|
|
|
|
# define VMDD_EP m2_i1
|
|
|
|
# define VMDD_START m2_l1
|
|
|
|
# define VMDD_SIZE m2_l2
|
|
|
|
|
|
|
|
/* to VM: ask VM for a region of memory that should not
|
|
|
|
* be used for bus-master DMA any longer
|
|
|
|
*/
|
|
|
|
#define VM_GETDMA (VM_RQ_BASE+14)
|
|
|
|
# define VMGD_REQ m2_i2
|
|
|
|
# define VMGD_PROCP m2_i1
|
|
|
|
# define VMGD_BASEP m2_l1
|
|
|
|
# define VMGD_SIZEP m2_l2
|
|
|
|
|
|
|
|
#define VM_MAP_PHYS (VM_RQ_BASE+15)
|
|
|
|
# define VMMP_EP m1_i1
|
|
|
|
# define VMMP_PHADDR m1_p2
|
|
|
|
# define VMMP_LEN m1_i2
|
|
|
|
# define VMMP_VADDR_REPLY m1_p3
|
|
|
|
|
|
|
|
#define VM_UNMAP_PHYS (VM_RQ_BASE+16)
|
|
|
|
# define VMUP_EP m1_i1
|
|
|
|
# define VMUP_VADDR m1_p1
|
|
|
|
|
2009-09-21 16:23:10 +02:00
|
|
|
#define VM_MUNMAP (VM_RQ_BASE+17)
|
2008-11-19 13:26:10 +01:00
|
|
|
# define VMUM_ADDR m1_p1
|
|
|
|
# define VMUM_LEN m1_i1
|
|
|
|
|
2009-09-21 16:23:10 +02:00
|
|
|
#define VM_MUNMAP_TEXT (VM_RQ_BASE+19)
|
|
|
|
|
2010-05-05 13:35:04 +02:00
|
|
|
/* To VM: forget all my yielded blocks. */
|
|
|
|
#define VM_FORGETBLOCKS (VM_RQ_BASE+22)
|
|
|
|
|
|
|
|
/* To VM: forget this block. */
|
|
|
|
#define VM_FORGETBLOCK (VM_RQ_BASE+23)
|
|
|
|
#define VMFB_IDHI m1_i1
|
|
|
|
#define VMFB_IDLO m1_i2
|
|
|
|
|
|
|
|
/* To VM: combined yield+get call. */
|
|
|
|
#define VM_YIELDBLOCKGETBLOCK (VM_RQ_BASE+25)
|
|
|
|
#define VMYBGB_VADDR m2_p1
|
|
|
|
#define VMYBGB_GETIDHI m2_i1
|
|
|
|
#define VMYBGB_GETIDLO m2_i2
|
|
|
|
#define VMYBGB_LEN m2_i3
|
|
|
|
#define VMYBGB_YIELDIDHI m2_l1
|
|
|
|
#define VMYBGB_YIELDIDLO m2_l2
|
|
|
|
|
2008-11-19 13:26:10 +01:00
|
|
|
/* Calls from VFS. */
|
|
|
|
# define VMV_ENDPOINT m1_i1 /* for all VM_VFS_REPLY_* */
|
|
|
|
#define VM_VFS_REPLY_OPEN (VM_RQ_BASE+30)
|
|
|
|
# define VMVRO_FD m1_i2
|
|
|
|
#define VM_VFS_REPLY_MMAP (VM_RQ_BASE+31)
|
|
|
|
#define VM_VFS_REPLY_CLOSE (VM_RQ_BASE+32)
|
|
|
|
|
2009-09-21 16:23:10 +02:00
|
|
|
#define VM_REMAP (VM_RQ_BASE+33)
|
|
|
|
# define VMRE_D m1_i1
|
|
|
|
# define VMRE_S m1_i2
|
|
|
|
# define VMRE_DA m1_p1
|
|
|
|
# define VMRE_SA m1_p2
|
|
|
|
# define VMRE_RETA m1_p3
|
|
|
|
# define VMRE_SIZE m1_i3
|
|
|
|
|
|
|
|
#define VM_SHM_UNMAP (VM_RQ_BASE+34)
|
|
|
|
# define VMUN_ENDPT m2_i1
|
|
|
|
# define VMUN_ADDR m2_l1
|
|
|
|
|
|
|
|
#define VM_GETPHYS (VM_RQ_BASE+35)
|
|
|
|
# define VMPHYS_ENDPT m2_i1
|
|
|
|
# define VMPHYS_ADDR m2_l1
|
|
|
|
# define VMPHYS_RETA m2_l2
|
|
|
|
|
|
|
|
#define VM_GETREF (VM_RQ_BASE+36)
|
|
|
|
# define VMREFCNT_ENDPT m2_i1
|
|
|
|
# define VMREFCNT_ADDR m2_l1
|
|
|
|
# define VMREFCNT_RETC m2_i2
|
|
|
|
|
|
|
|
#define VM_RS_SET_PRIV (VM_RQ_BASE+37)
|
|
|
|
# define VM_RS_NR m2_i1
|
|
|
|
# define VM_RS_BUF m2_l1
|
|
|
|
|
|
|
|
#define VM_QUERY_EXIT (VM_RQ_BASE+38)
|
|
|
|
# define VM_QUERY_RET_PT m2_i1
|
|
|
|
# define VM_QUERY_IS_MORE m2_i2
|
|
|
|
|
|
|
|
#define VM_NOTIFY_SIG (VM_RQ_BASE+39)
|
|
|
|
# define VM_NOTIFY_SIG_ENDPOINT m1_i1
|
|
|
|
# define VM_NOTIFY_SIG_IPC m1_i2
|
|
|
|
|
2010-01-19 22:00:20 +01:00
|
|
|
#define VM_INFO (VM_RQ_BASE+40)
|
|
|
|
# define VMI_WHAT m2_i1
|
|
|
|
# define VMI_EP m2_i2
|
|
|
|
# define VMI_COUNT m2_i3
|
|
|
|
# define VMI_PTR m2_p1
|
|
|
|
# define VMI_NEXT m2_l1
|
|
|
|
|
|
|
|
/* VMI_WHAT values. */
|
|
|
|
#define VMIW_STATS 1
|
|
|
|
#define VMIW_USAGE 2
|
|
|
|
#define VMIW_REGION 3
|
2009-09-21 16:23:10 +02:00
|
|
|
|
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 VM_RS_UPDATE (VM_RQ_BASE+41)
|
|
|
|
# define VM_RS_SRC_ENDPT m1_i1
|
|
|
|
# define VM_RS_DST_ENDPT m1_i2
|
|
|
|
|
2008-11-19 13:26:10 +01:00
|
|
|
/* Total. */
|
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 NR_VM_CALLS 42
|
Initialization protocol for system services.
SYSLIB CHANGES:
- SEF framework now supports a new SEF Init request type from RS. 3 different
callbacks are available (init_fresh, init_lu, init_restart) to specify
initialization code when a service starts fresh, starts after a live update,
or restarts.
SYSTEM SERVICE CHANGES:
- Initialization code for system services is now enclosed in a callback SEF will
automatically call at init time. The return code of the callback will
tell RS whether the initialization completed successfully.
- Each init callback can access information passed by RS to initialize. As of
now, each system service has access to the public entries of RS's system process
table to gather all the information required to initialize. This design
eliminates many existing or potential races at boot time and provides a uniform
initialization interface to system services. The same interface will be reused
for the upcoming publish/subscribe model to handle dynamic
registration / deregistration of system services.
VM CHANGES:
- Uniform privilege management for all system services. Every service uses the
same call mask format. For boot services, VM copies the call mask from init
data. For dynamic services, VM still receives the call mask via rs_set_priv
call that will be soon replaced by the upcoming publish/subscribe model.
RS CHANGES:
- The system process table has been reorganized and split into private entries
and public entries. Only the latter ones are exposed to system services.
- VM call masks are now entirely configured in rs/table.c
- RS has now its own slot in the system process table. Only kernel tasks and
user processes not included in the boot image are now left out from the system
process table.
- RS implements the initialization protocol for system services.
- For services in the boot image, RS blocks till initialization is complete and
panics when failure is reported back. Services are initialized in their order of
appearance in the boot image priv table and RS blocks to implements synchronous
initialization for every system service having the flag SF_SYNCH_BOOT set.
- For services started dynamically, the initialization protocol is implemented
as though it were the first ping for the service. In this case, if the
system service fails to report back (or reports failure), RS brings the service
down rather than trying to restart it.
2010-01-08 02:20:42 +01:00
|
|
|
#define VM_CALL_MASK_SIZE BITMAP_CHUNKS(NR_VM_CALLS)
|
|
|
|
|
2010-04-27 01:21:26 +02:00
|
|
|
/* not handled as a normal VM call, thus at the end of the reserved rage */
|
|
|
|
#define VM_PAGEFAULT (VM_RQ_BASE+0xff)
|
|
|
|
# define VPF_ADDR m1_i1
|
|
|
|
# define VPF_FLAGS m1_i2
|
|
|
|
|
Initialization protocol for system services.
SYSLIB CHANGES:
- SEF framework now supports a new SEF Init request type from RS. 3 different
callbacks are available (init_fresh, init_lu, init_restart) to specify
initialization code when a service starts fresh, starts after a live update,
or restarts.
SYSTEM SERVICE CHANGES:
- Initialization code for system services is now enclosed in a callback SEF will
automatically call at init time. The return code of the callback will
tell RS whether the initialization completed successfully.
- Each init callback can access information passed by RS to initialize. As of
now, each system service has access to the public entries of RS's system process
table to gather all the information required to initialize. This design
eliminates many existing or potential races at boot time and provides a uniform
initialization interface to system services. The same interface will be reused
for the upcoming publish/subscribe model to handle dynamic
registration / deregistration of system services.
VM CHANGES:
- Uniform privilege management for all system services. Every service uses the
same call mask format. For boot services, VM copies the call mask from init
data. For dynamic services, VM still receives the call mask via rs_set_priv
call that will be soon replaced by the upcoming publish/subscribe model.
RS CHANGES:
- The system process table has been reorganized and split into private entries
and public entries. Only the latter ones are exposed to system services.
- VM call masks are now entirely configured in rs/table.c
- RS has now its own slot in the system process table. Only kernel tasks and
user processes not included in the boot image are now left out from the system
process table.
- RS implements the initialization protocol for system services.
- For services in the boot image, RS blocks till initialization is complete and
panics when failure is reported back. Services are initialized in their order of
appearance in the boot image priv table and RS blocks to implements synchronous
initialization for every system service having the flag SF_SYNCH_BOOT set.
- For services started dynamically, the initialization protocol is implemented
as though it were the first ping for the service. In this case, if the
system service fails to report back (or reports failure), RS brings the service
down rather than trying to restart it.
2010-01-08 02:20:42 +01:00
|
|
|
/* Basic vm calls allowed to every process. */
|
|
|
|
#define VM_BASIC_CALLS \
|
2010-05-05 13:35:04 +02:00
|
|
|
VM_MMAP, VM_MUNMAP, VM_MUNMAP_TEXT, VM_MAP_PHYS, VM_UNMAP_PHYS, \
|
|
|
|
VM_FORGETBLOCKS, VM_FORGETBLOCK, VM_YIELDBLOCKGETBLOCK
|
2009-09-21 16:23:10 +02:00
|
|
|
|
|
|
|
/*===========================================================================*
|
|
|
|
* Messages for IPC server *
|
|
|
|
*===========================================================================*/
|
|
|
|
#define IPC_BASE 0xD00
|
|
|
|
|
|
|
|
/* Shared Memory */
|
|
|
|
#define IPC_SHMGET (IPC_BASE+1)
|
|
|
|
# define SHMGET_KEY m2_l1
|
|
|
|
# define SHMGET_SIZE m2_l2
|
|
|
|
# define SHMGET_FLAG m2_i1
|
|
|
|
# define SHMGET_RETID m2_i2
|
|
|
|
#define IPC_SHMAT (IPC_BASE+2)
|
|
|
|
# define SHMAT_ID m2_i1
|
|
|
|
# define SHMAT_ADDR m2_l1
|
|
|
|
# define SHMAT_FLAG m2_i2
|
|
|
|
# define SHMAT_RETADDR m2_l2
|
|
|
|
#define IPC_SHMDT (IPC_BASE+3)
|
|
|
|
# define SHMDT_ADDR m2_l1
|
|
|
|
#define IPC_SHMCTL (IPC_BASE+4)
|
|
|
|
# define SHMCTL_ID m2_i1
|
|
|
|
# define SHMCTL_CMD m2_i2
|
|
|
|
# define SHMCTL_BUF m2_l1
|
|
|
|
# define SHMCTL_RET m2_i3
|
|
|
|
|
|
|
|
/* Semaphore */
|
|
|
|
#define IPC_SEMGET (IPC_BASE+5)
|
|
|
|
# define SEMGET_KEY m2_l1
|
|
|
|
# define SEMGET_NR m2_i1
|
|
|
|
# define SEMGET_FLAG m2_i2
|
|
|
|
# define SEMGET_RETID m2_i3
|
|
|
|
#define IPC_SEMCTL (IPC_BASE+6)
|
|
|
|
# define SEMCTL_ID m2_i1
|
|
|
|
# define SEMCTL_NUM m2_i2
|
|
|
|
# define SEMCTL_CMD m2_i3
|
|
|
|
# define SEMCTL_OPT m2_l1
|
|
|
|
#define IPC_SEMOP (IPC_BASE+7)
|
|
|
|
# define SEMOP_ID m2_i1
|
|
|
|
# define SEMOP_OPS m2_l1
|
|
|
|
# define SEMOP_SIZE m2_i2
|
2008-11-19 13:26:10 +01:00
|
|
|
|
Userspace scheduling
- cotributed by Bjorn Swift
- In this first phase, scheduling is moved from the kernel to the PM
server. The next steps are to a) moving scheduling to its own server
and b) include useful information in the "out of quantum" message,
so that the scheduler can make use of this information.
- The kernel process table now keeps record of who is responsible for
scheduling each process (p_scheduler). When this pointer is NULL,
the process will be scheduled by the kernel. If such a process runs
out of quantum, the kernel will simply renew its quantum an requeue
it.
- When PM loads, it will take over scheduling of all running
processes, except system processes, using sys_schedctl().
Essentially, this only results in taking over init. As children
inherit a scheduler from their parent, user space programs forked by
init will inherit PM (for now) as their scheduler.
- Once a process has been assigned a scheduler, and runs out of
quantum, its RTS_NO_QUANTUM flag will be set and the process
dequeued. The kernel will send a message to the scheduler, on the
process' behalf, informing the scheduler that it has run out of
quantum. The scheduler can take what ever action it pleases, based
on its policy, and then reschedule the process using the
sys_schedule() system call.
- Balance queues does not work as before. While the old in-kernel
function used to renew the quantum of processes in the highest
priority run queue, the user-space implementation only acts on
processes that have been bumped down to a lower priority queue.
This approach reacts slower to changes than the old one, but saves
us sending a sys_schedule message for each process every time we
balance the queues. Currently, when processes are moved up a
priority queue, their quantum is also renewed, but this can be
fiddled with.
- do_nice has been removed from kernel. PM answers to get- and
setpriority calls, updates it's own nice variable as well as the
max_run_queue. This will be refactored once scheduling is moved to a
separate server. We will probably have PM update it's local nice
value and then send a message to whoever is scheduling the process.
- changes to fix an issue in do_fork() where processes could run out
of quantum but bypassing the code path that handles it correctly.
The future plan is to remove the policy from do_fork() and implement
it in userspace too.
2010-03-29 13:07:20 +02:00
|
|
|
/*===========================================================================*
|
|
|
|
* Messages for Scheduling *
|
|
|
|
*===========================================================================*/
|
|
|
|
#define SCHEDULING_BASE 0xF00
|
|
|
|
|
|
|
|
#define SCHEDULING_NO_QUANTUM (SCHEDULING_BASE+1)
|
|
|
|
# define SCHEDULING_ENDPOINT m1_i1
|
|
|
|
# define SCHEDULING_PRIORITY m1_i2
|
|
|
|
# define SCHEDULING_QUANTUM m1_i3
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* _MINIX_COM_H */
|