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
|
|
|
|
#define M3_STRING 14
|
|
|
|
|
|
|
|
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;
|
2005-04-21 16:53:53 +02:00
|
|
|
typedef struct {int m3i1, m3i2; char *m3p1; char m3ca1[M3_STRING];} mess_3;
|
|
|
|
typedef struct {long m4l1, m4l2, m4l3, m4l4, m4l5;} mess_4;
|
|
|
|
typedef struct {short m5c1, m5c2; 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;
|
2007-08-07 13:56:28 +02:00
|
|
|
typedef struct {long m9l1, m9l2, m9l3, m9l4, m9l5; short m9s1, m9s2, m9s3;
|
|
|
|
char m9c1, m9c2; } 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
|
|
|
|
|
|
|
|
#define m5_c1 m_u.m_m5.m5c1
|
|
|
|
#define m5_c2 m_u.m_m5.m5c2
|
|
|
|
#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
|
|
|
|
#define m9_c1 m_u.m_m9.m9c1
|
|
|
|
#define m9_c2 m_u.m_m9.m9c2
|
|
|
|
|
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 */
|