2005-04-21 16:53:53 +02:00
|
|
|
#ifndef _IPC_H
|
|
|
|
|
#define _IPC_H
|
|
|
|
|
|
2008-11-19 13:26:10 +01:00
|
|
|
#include <minix/type.h>
|
|
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
/*==========================================================================*
|
|
|
|
|
* Types relating to messages. *
|
|
|
|
|
*==========================================================================*/
|
|
|
|
|
|
|
|
|
|
#define M1 1
|
|
|
|
|
#define M3 3
|
|
|
|
|
#define M4 4
|
2010-01-13 00:08:50 +01:00
|
|
|
#define M3_STRING 14 /* legacy m3_ca1 size (must not be changed) */
|
|
|
|
|
#define M3_LONG_STRING 16 /* current m3_ca1 size (may be increased) */
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
|
typedef struct {int m1i1, m1i2, m1i3; char *m1p1, *m1p2, *m1p3;} mess_1;
|
2006-10-25 15:40:36 +02:00
|
|
|
typedef struct {int m2i1, m2i2, m2i3; long m2l1, m2l2; char *m2p1;
|
|
|
|
|
short m2s1;} mess_2;
|
2010-01-13 00:08:50 +01:00
|
|
|
typedef struct {int m3i1, m3i2; char *m3p1; char m3ca1[M3_LONG_STRING];} mess_3;
|
2005-04-21 16:53:53 +02:00
|
|
|
typedef struct {long m4l1, m4l2, m4l3, m4l4, m4l5;} mess_4;
|
2010-01-19 22:19:59 +01:00
|
|
|
typedef struct {short m5s1, m5s2; int m5i1, m5i2; long m5l1, m5l2, m5l3;}mess_5;
|
2006-10-25 15:40:36 +02:00
|
|
|
typedef struct {long m6l1, m6l2, m6l3; short m6s1, m6s2, m6s3; char m6c1, m6c2;
|
|
|
|
|
char *m6p1, *m6p2;} mess_6;
|
2005-04-21 16:53:53 +02:00
|
|
|
typedef struct {int m7i1, m7i2, m7i3, m7i4; char *m7p1, *m7p2;} mess_7;
|
2005-06-06 13:40:32 +02:00
|
|
|
typedef struct {int m8i1, m8i2; char *m8p1, *m8p2, *m8p3, *m8p4;} mess_8;
|
- 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
|
|
|
typedef struct {long m9l1, m9l2, m9l3, m9l4, m9l5;
|
|
|
|
|
short m9s1, m9s2, m9s3, m9s4; } mess_9;
|
2005-04-21 16:53:53 +02:00
|
|
|
|
|
|
|
|
typedef struct {
|
. 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
|
|
|
endpoint_t m_source; /* who sent the message */
|
2005-04-21 16:53:53 +02:00
|
|
|
int m_type; /* what kind of message is it */
|
|
|
|
|
union {
|
|
|
|
|
mess_1 m_m1;
|
|
|
|
|
mess_2 m_m2;
|
|
|
|
|
mess_3 m_m3;
|
|
|
|
|
mess_4 m_m4;
|
|
|
|
|
mess_5 m_m5;
|
|
|
|
|
mess_7 m_m7;
|
2005-06-06 13:40:32 +02:00
|
|
|
mess_8 m_m8;
|
2006-10-25 15:40:36 +02:00
|
|
|
mess_6 m_m6;
|
2007-08-07 13:56:28 +02:00
|
|
|
mess_9 m_m9;
|
2005-04-21 16:53:53 +02:00
|
|
|
} m_u;
|
|
|
|
|
} message;
|
|
|
|
|
|
|
|
|
|
/* The following defines provide names for useful members. */
|
|
|
|
|
#define m1_i1 m_u.m_m1.m1i1
|
|
|
|
|
#define m1_i2 m_u.m_m1.m1i2
|
|
|
|
|
#define m1_i3 m_u.m_m1.m1i3
|
|
|
|
|
#define m1_p1 m_u.m_m1.m1p1
|
|
|
|
|
#define m1_p2 m_u.m_m1.m1p2
|
|
|
|
|
#define m1_p3 m_u.m_m1.m1p3
|
|
|
|
|
|
|
|
|
|
#define m2_i1 m_u.m_m2.m2i1
|
|
|
|
|
#define m2_i2 m_u.m_m2.m2i2
|
|
|
|
|
#define m2_i3 m_u.m_m2.m2i3
|
|
|
|
|
#define m2_l1 m_u.m_m2.m2l1
|
|
|
|
|
#define m2_l2 m_u.m_m2.m2l2
|
|
|
|
|
#define m2_p1 m_u.m_m2.m2p1
|
|
|
|
|
|
2006-10-25 15:40:36 +02:00
|
|
|
#define m2_s1 m_u.m_m2.m2s1
|
|
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
#define m3_i1 m_u.m_m3.m3i1
|
|
|
|
|
#define m3_i2 m_u.m_m3.m3i2
|
|
|
|
|
#define m3_p1 m_u.m_m3.m3p1
|
|
|
|
|
#define m3_ca1 m_u.m_m3.m3ca1
|
|
|
|
|
|
|
|
|
|
#define m4_l1 m_u.m_m4.m4l1
|
|
|
|
|
#define m4_l2 m_u.m_m4.m4l2
|
|
|
|
|
#define m4_l3 m_u.m_m4.m4l3
|
|
|
|
|
#define m4_l4 m_u.m_m4.m4l4
|
|
|
|
|
#define m4_l5 m_u.m_m4.m4l5
|
|
|
|
|
|
2010-01-19 22:19:59 +01:00
|
|
|
#define m5_s1 m_u.m_m5.m5s1
|
|
|
|
|
#define m5_s2 m_u.m_m5.m5s2
|
2005-04-21 16:53:53 +02:00
|
|
|
#define m5_i1 m_u.m_m5.m5i1
|
|
|
|
|
#define m5_i2 m_u.m_m5.m5i2
|
|
|
|
|
#define m5_l1 m_u.m_m5.m5l1
|
|
|
|
|
#define m5_l2 m_u.m_m5.m5l2
|
|
|
|
|
#define m5_l3 m_u.m_m5.m5l3
|
|
|
|
|
|
2006-10-25 15:40:36 +02:00
|
|
|
#define m6_l1 m_u.m_m6.m6l1
|
|
|
|
|
#define m6_l2 m_u.m_m6.m6l2
|
|
|
|
|
#define m6_l3 m_u.m_m6.m6l3
|
|
|
|
|
#define m6_s1 m_u.m_m6.m6s1
|
|
|
|
|
#define m6_s2 m_u.m_m6.m6s2
|
|
|
|
|
#define m6_s3 m_u.m_m6.m6s3
|
|
|
|
|
#define m6_c1 m_u.m_m6.m6c1
|
|
|
|
|
#define m6_c2 m_u.m_m6.m6c2
|
|
|
|
|
#define m6_p1 m_u.m_m6.m6p1
|
|
|
|
|
#define m6_p2 m_u.m_m6.m6p2
|
|
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
#define m7_i1 m_u.m_m7.m7i1
|
|
|
|
|
#define m7_i2 m_u.m_m7.m7i2
|
|
|
|
|
#define m7_i3 m_u.m_m7.m7i3
|
|
|
|
|
#define m7_i4 m_u.m_m7.m7i4
|
|
|
|
|
#define m7_p1 m_u.m_m7.m7p1
|
|
|
|
|
#define m7_p2 m_u.m_m7.m7p2
|
|
|
|
|
|
2005-06-06 13:40:32 +02:00
|
|
|
#define m8_i1 m_u.m_m8.m8i1
|
|
|
|
|
#define m8_i2 m_u.m_m8.m8i2
|
|
|
|
|
#define m8_p1 m_u.m_m8.m8p1
|
|
|
|
|
#define m8_p2 m_u.m_m8.m8p2
|
|
|
|
|
#define m8_p3 m_u.m_m8.m8p3
|
|
|
|
|
#define m8_p4 m_u.m_m8.m8p4
|
|
|
|
|
|
2007-08-07 13:56:28 +02:00
|
|
|
#define m9_l1 m_u.m_m9.m9l1
|
|
|
|
|
#define m9_l2 m_u.m_m9.m9l2
|
|
|
|
|
#define m9_l3 m_u.m_m9.m9l3
|
|
|
|
|
#define m9_l4 m_u.m_m9.m9l4
|
|
|
|
|
#define m9_l5 m_u.m_m9.m9l5
|
|
|
|
|
#define m9_s1 m_u.m_m9.m9s1
|
|
|
|
|
#define m9_s2 m_u.m_m9.m9s2
|
|
|
|
|
#define m9_s3 m_u.m_m9.m9s3
|
- 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 m9_s4 m_u.m_m9.m9s4
|
2007-08-07 13:56:28 +02:00
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
/*==========================================================================*
|
|
|
|
|
* Minix run-time system (IPC). *
|
|
|
|
|
*==========================================================================*/
|
|
|
|
|
|
2007-04-23 13:59:19 +02:00
|
|
|
/* Datastructure for asynchronous sends */
|
|
|
|
|
typedef struct asynmsg
|
|
|
|
|
{
|
|
|
|
|
unsigned flags;
|
|
|
|
|
endpoint_t dst;
|
|
|
|
|
int result;
|
|
|
|
|
message msg;
|
|
|
|
|
} asynmsg_t;
|
|
|
|
|
|
|
|
|
|
/* Defines for flags field */
|
|
|
|
|
#define AMF_EMPTY 0 /* slot is not inuse */
|
|
|
|
|
#define AMF_VALID 1 /* slot contains message */
|
|
|
|
|
#define AMF_DONE 2 /* Kernel has processed the message. The
|
|
|
|
|
* result is stored in 'result'
|
|
|
|
|
*/
|
|
|
|
|
#define AMF_NOTIFY 4 /* Send a notification when AMF_DONE is set */
|
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 AMF_NOREPLY 8 /* Not a reply message for a SENDREC */
|
2007-04-23 13:59:19 +02:00
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
/* Hide names to avoid name space pollution. */
|
2005-05-27 15:57:00 +02:00
|
|
|
#define echo _echo
|
2005-07-29 17:02:27 +02:00
|
|
|
#define notify _notify
|
2005-04-21 16:53:53 +02:00
|
|
|
#define sendrec _sendrec
|
|
|
|
|
#define receive _receive
|
|
|
|
|
#define send _send
|
2008-02-21 16:50:09 +01:00
|
|
|
#define sendnb _sendnb
|
2007-04-23 13:59:19 +02:00
|
|
|
#define senda _senda
|
2005-04-21 16:53:53 +02:00
|
|
|
|
2005-05-27 15:57:00 +02:00
|
|
|
_PROTOTYPE( int echo, (message *m_ptr) );
|
. 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
|
|
|
_PROTOTYPE( int notify, (endpoint_t dest) );
|
|
|
|
|
_PROTOTYPE( int sendrec, (endpoint_t src_dest, message *m_ptr) );
|
2006-10-25 15:40:36 +02:00
|
|
|
_PROTOTYPE( int receive, (endpoint_t src, message *m_ptr) );
|
. 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
|
|
|
_PROTOTYPE( int send, (endpoint_t dest, message *m_ptr) );
|
2008-02-21 16:50:09 +01:00
|
|
|
_PROTOTYPE( int sendnb, (endpoint_t dest, message *m_ptr) );
|
2007-04-23 13:59:19 +02:00
|
|
|
_PROTOTYPE( int senda, (asynmsg_t *table, size_t count) );
|
2006-03-10 17:10:05 +01:00
|
|
|
|
2005-04-21 16:53:53 +02:00
|
|
|
#endif /* _IPC_H */
|
