source: branches/minix3-book/include/minix/com.h

Last change on this file was 4, checked in by Mattia Monga, 13 years ago

Importazione sorgenti libro

File size: 19.3 KB
Line 
1#ifndef _MINIX_COM_H
2#define _MINIX_COM_H
3
4/*===========================================================================*
5 * Magic process numbers *
6 *===========================================================================*/
7
8#define ANY 0x7ace /* used to indicate 'any process' */
9#define NONE 0x6ace /* used to indicate 'no process at all' */
10#define SELF 0x8ace /* used to indicate 'own process' */
11
12/*===========================================================================*
13 * Process numbers of processes in the system image *
14 *===========================================================================*/
15
16/* The values of several task numbers depend on whether they or other tasks
17 * are enabled. They are defined as (PREVIOUS_TASK - ENABLE_TASK) in general.
18 * ENABLE_TASK is either 0 or 1, so a task either gets a new number, or gets
19 * the same number as the previous task and is further unused. Note that the
20 * order should correspond to the order in the task table defined in table.c.
21 */
22
23/* Kernel tasks. These all run in the same address space. */
24#define IDLE -4 /* runs when no one else can run */
25#define CLOCK -3 /* alarms and other clock functions */
26#define SYSTEM -2 /* request system functionality */
27#define KERNEL -1 /* pseudo-process for IPC and scheduling */
28#define HARDWARE KERNEL /* for hardware interrupt handlers */
29
30/* Number of tasks. Note that NR_PROCS is defined in <minix/config.h>. */
31#define NR_TASKS 4
32
33/* User-space processes, that is, device drivers, servers, and INIT. */
34#define PM_PROC_NR 0 /* process manager */
35#define FS_PROC_NR 1 /* file system */
36#define RS_PROC_NR 2 /* reincarnation server */
37#define MEM_PROC_NR 3 /* memory driver (RAM disk, null, etc.) */
38#define LOG_PROC_NR 4 /* log device driver */
39#define TTY_PROC_NR 5 /* terminal (TTY) driver */
40#define DRVR_PROC_NR 6 /* device driver for boot medium */
41#define INIT_PROC_NR 7 /* init -- goes multiuser */
42
43/* Number of processes contained in the system image. */
44#define NR_BOOT_PROCS (NR_TASKS + INIT_PROC_NR + 1)
45
46/*===========================================================================*
47 * Kernel notification types *
48 *===========================================================================*/
49
50/* Kernel notification types. In principle, these can be sent to any process,
51 * so make sure that these types do not interfere with other message types.
52 * Notifications are prioritized because of the way they are unhold() and
53 * blocking notifications are delivered. The lowest numbers go first. The
54 * offset are used for the per-process notification bit maps.
55 */
56#define NOTIFY_MESSAGE 0x1000
57#define NOTIFY_FROM(p_nr) (NOTIFY_MESSAGE | ((p_nr) + NR_TASKS))
58# define SYN_ALARM NOTIFY_FROM(CLOCK) /* synchronous alarm */
59# define SYS_SIG NOTIFY_FROM(SYSTEM) /* system signal */
60# define HARD_INT NOTIFY_FROM(HARDWARE) /* hardware interrupt */
61# define NEW_KSIG NOTIFY_FROM(HARDWARE) /* new kernel signal */
62# define FKEY_PRESSED NOTIFY_FROM(TTY_PROC_NR)/* function key press */
63
64/* Shorthands for message parameters passed with notifications. */
65#define NOTIFY_SOURCE m_source
66#define NOTIFY_TYPE m_type
67#define NOTIFY_ARG m2_l1
68#define NOTIFY_TIMESTAMP m2_l2
69#define NOTIFY_FLAGS m2_i1
70
71/*===========================================================================*
72 * Messages for BLOCK and CHARACTER device drivers *
73 *===========================================================================*/
74
75/* Message types for device drivers. */
76#define DEV_RQ_BASE 0x400 /* base for device request types */
77#define DEV_RS_BASE 0x500 /* base for device response types */
78
79#define CANCEL (DEV_RQ_BASE + 0) /* general req to force a task to cancel */
80#define DEV_READ (DEV_RQ_BASE + 3) /* read from minor device */
81#define DEV_WRITE (DEV_RQ_BASE + 4) /* write to minor device */
82#define DEV_IOCTL (DEV_RQ_BASE + 5) /* I/O control code */
83#define DEV_OPEN (DEV_RQ_BASE + 6) /* open a minor device */
84#define DEV_CLOSE (DEV_RQ_BASE + 7) /* close a minor device */
85#define DEV_SCATTER (DEV_RQ_BASE + 8) /* write from a vector */
86#define DEV_GATHER (DEV_RQ_BASE + 9) /* read into a vector */
87#define TTY_SETPGRP (DEV_RQ_BASE + 10) /* set process group */
88#define TTY_EXIT (DEV_RQ_BASE + 11) /* process group leader exited */
89#define DEV_SELECT (DEV_RQ_BASE + 12) /* request select() attention */
90#define DEV_STATUS (DEV_RQ_BASE + 13) /* request driver status */
91
92#define DEV_REPLY (DEV_RS_BASE + 0) /* general task reply */
93#define DEV_CLONED (DEV_RS_BASE + 1) /* return cloned minor */
94#define DEV_REVIVE (DEV_RS_BASE + 2) /* driver revives process */
95#define DEV_IO_READY (DEV_RS_BASE + 3) /* selected device ready */
96#define DEV_NO_STATUS (DEV_RS_BASE + 4) /* empty status reply */
97
98/* Field names for messages to block and character device drivers. */
99#define DEVICE m2_i1 /* major-minor device */
100#define PROC_NR m2_i2 /* which (proc) wants I/O? */
101#define COUNT m2_i3 /* how many bytes to transfer */
102#define REQUEST m2_i3 /* ioctl request code */
103#define POSITION m2_l1 /* file offset */
104#define ADDRESS m2_p1 /* core buffer address */
105
106/* Field names for DEV_SELECT messages to device drivers. */
107#define DEV_MINOR m2_i1 /* minor device */
108#define DEV_SEL_OPS m2_i2 /* which select operations are requested */
109#define DEV_SEL_WATCH m2_i3 /* request notify if no operations are ready */
110
111/* Field names used in reply messages from tasks. */
112#define REP_PROC_NR m2_i1 /* # of proc on whose behalf I/O was done */
113#define REP_STATUS m2_i2 /* bytes transferred or error number */
114# define SUSPEND -998 /* status to suspend caller, reply later */
115
116/* Field names for messages to TTY driver. */
117#define TTY_LINE DEVICE /* message parameter: terminal line */
118#define TTY_REQUEST COUNT /* message parameter: ioctl request code */
119#define TTY_SPEK POSITION/* message parameter: ioctl speed, erasing */
120#define TTY_FLAGS m2_l2 /* message parameter: ioctl tty mode */
121#define TTY_PGRP m2_i3 /* message parameter: process group */
122
123/* Field names for the QIC 02 status reply from tape driver */
124#define TAPE_STAT0 m2_l1
125#define TAPE_STAT1 m2_l2
126
127/*===========================================================================*
128 * Messages for networking layer *
129 *===========================================================================*/
130
131/* Message types for network layer requests. This layer acts like a driver. */
132#define NW_OPEN DEV_OPEN
133#define NW_CLOSE DEV_CLOSE
134#define NW_READ DEV_READ
135#define NW_WRITE DEV_WRITE
136#define NW_IOCTL DEV_IOCTL
137#define NW_CANCEL CANCEL
138
139/* Base type for data link layer requests and responses. */
140#define DL_RQ_BASE 0x800
141#define DL_RS_BASE 0x900
142
143/* Message types for data link layer requests. */
144#define DL_WRITE (DL_RQ_BASE + 3)
145#define DL_WRITEV (DL_RQ_BASE + 4)
146#define DL_READ (DL_RQ_BASE + 5)
147#define DL_READV (DL_RQ_BASE + 6)
148#define DL_INIT (DL_RQ_BASE + 7)
149#define DL_STOP (DL_RQ_BASE + 8)
150#define DL_GETSTAT (DL_RQ_BASE + 9)
151
152/* Message type for data link layer replies. */
153#define DL_INIT_REPLY (DL_RS_BASE + 20)
154#define DL_TASK_REPLY (DL_RS_BASE + 21)
155
156/* Field names for data link layer messages. */
157#define DL_PORT m2_i1
158#define DL_PROC m2_i2
159#define DL_COUNT m2_i3
160#define DL_MODE m2_l1
161#define DL_CLCK m2_l2
162#define DL_ADDR m2_p1
163#define DL_STAT m2_l1
164
165/* Bits in 'DL_STAT' field of DL replies. */
166# define DL_PACK_SEND 0x01
167# define DL_PACK_RECV 0x02
168# define DL_READ_IP 0x04
169
170/* Bits in 'DL_MODE' field of DL requests. */
171# define DL_NOMODE 0x0
172# define DL_PROMISC_REQ 0x2
173# define DL_MULTI_REQ 0x4
174# define DL_BROAD_REQ 0x8
175
176/*===========================================================================*
177 * SYSTASK request types and field names *
178 *===========================================================================*/
179
180/* System library calls are dispatched via a call vector, so be careful when
181 * modifying the system call numbers. The numbers here determine which call
182 * is made from the call vector.
183 */
184#define KERNEL_CALL 0x600 /* base for kernel calls to SYSTEM */
185
186# define SYS_FORK (KERNEL_CALL + 0) /* sys_fork() */
187# define SYS_EXEC (KERNEL_CALL + 1) /* sys_exec() */
188# define SYS_EXIT (KERNEL_CALL + 2) /* sys_exit() */
189# define SYS_NICE (KERNEL_CALL + 3) /* sys_nice() */
190# define SYS_PRIVCTL (KERNEL_CALL + 4) /* sys_privctl() */
191# define SYS_TRACE (KERNEL_CALL + 5) /* sys_trace() */
192# define SYS_KILL (KERNEL_CALL + 6) /* sys_kill() */
193
194# define SYS_GETKSIG (KERNEL_CALL + 7) /* sys_getsig() */
195# define SYS_ENDKSIG (KERNEL_CALL + 8) /* sys_endsig() */
196# define SYS_SIGSEND (KERNEL_CALL + 9) /* sys_sigsend() */
197# define SYS_SIGRETURN (KERNEL_CALL + 10) /* sys_sigreturn() */
198
199# define SYS_NEWMAP (KERNEL_CALL + 11) /* sys_newmap() */
200# define SYS_SEGCTL (KERNEL_CALL + 12) /* sys_segctl() */
201# define SYS_MEMSET (KERNEL_CALL + 13) /* sys_memset() */
202
203# define SYS_UMAP (KERNEL_CALL + 14) /* sys_umap() */
204# define SYS_VIRCOPY (KERNEL_CALL + 15) /* sys_vircopy() */
205# define SYS_PHYSCOPY (KERNEL_CALL + 16) /* sys_physcopy() */
206# define SYS_VIRVCOPY (KERNEL_CALL + 17) /* sys_virvcopy() */
207# define SYS_PHYSVCOPY (KERNEL_CALL + 18) /* sys_physvcopy() */
208
209# define SYS_IRQCTL (KERNEL_CALL + 19) /* sys_irqctl() */
210# define SYS_INT86 (KERNEL_CALL + 20) /* sys_int86() */
211# define SYS_DEVIO (KERNEL_CALL + 21) /* sys_devio() */
212# define SYS_SDEVIO (KERNEL_CALL + 22) /* sys_sdevio() */
213# define SYS_VDEVIO (KERNEL_CALL + 23) /* sys_vdevio() */
214
215# define SYS_SETALARM (KERNEL_CALL + 24) /* sys_setalarm() */
216# define SYS_TIMES (KERNEL_CALL + 25) /* sys_times() */
217# define SYS_GETINFO (KERNEL_CALL + 26) /* sys_getinfo() */
218# define SYS_ABORT (KERNEL_CALL + 27) /* sys_abort() */
219
220#define NR_SYS_CALLS 28 /* number of system calls */
221
222/* Field names for SYS_MEMSET, SYS_SEGCTL. */
223#define MEM_PTR m2_p1 /* base */
224#define MEM_COUNT m2_l1 /* count */
225#define MEM_PATTERN m2_l2 /* pattern to write */
226#define MEM_CHUNK_BASE m4_l1 /* physical base address */
227#define MEM_CHUNK_SIZE m4_l2 /* size of mem chunk */
228#define MEM_TOT_SIZE m4_l3 /* total memory size */
229#define MEM_CHUNK_TAG m4_l4 /* tag to identify chunk of mem */
230
231/* Field names for SYS_DEVIO, SYS_VDEVIO, SYS_SDEVIO. */
232#define DIO_REQUEST m2_i3 /* device in or output */
233# define DIO_INPUT 0 /* input */
234# define DIO_OUTPUT 1 /* output */
235#define DIO_TYPE m2_i1 /* flag indicating byte, word, or long */
236# define DIO_BYTE 'b' /* byte type values */
237# define DIO_WORD 'w' /* word type values */
238# define DIO_LONG 'l' /* long type values */
239#define DIO_PORT m2_l1 /* single port address */
240#define DIO_VALUE m2_l2 /* single I/O value */
241#define DIO_VEC_ADDR m2_p1 /* address of buffer or (p,v)-pairs */
242#define DIO_VEC_SIZE m2_l2 /* number of elements in vector */
243#define DIO_VEC_PROC m2_i2 /* number of process where vector is */
244
245/* Field names for SYS_SIGNARLM, SYS_FLAGARLM, SYS_SYNCALRM. */
246#define ALRM_EXP_TIME m2_l1 /* expire time for the alarm call */
247#define ALRM_ABS_TIME m2_i2 /* set to 1 to use absolute alarm time */
248#define ALRM_TIME_LEFT m2_l1 /* how many ticks were remaining */
249#define ALRM_PROC_NR m2_i1 /* which process wants the alarm? */
250#define ALRM_FLAG_PTR m2_p1 /* virtual address of timeout flag */
251
252/* Field names for SYS_IRQCTL. */
253#define IRQ_REQUEST m5_c1 /* what to do? */
254# define IRQ_SETPOLICY 1 /* manage a slot of the IRQ table */
255# define IRQ_RMPOLICY 2 /* remove a slot of the IRQ table */
256# define IRQ_ENABLE 3 /* enable interrupts */
257# define IRQ_DISABLE 4 /* disable interrupts */
258#define IRQ_VECTOR m5_c2 /* irq vector */
259#define IRQ_POLICY m5_i1 /* options for IRQCTL request */
260# define IRQ_REENABLE 0x001 /* reenable IRQ line after interrupt */
261# define IRQ_BYTE 0x100 /* byte values */
262# define IRQ_WORD 0x200 /* word values */
263# define IRQ_LONG 0x400 /* long values */
264#define IRQ_PROC_NR m5_i2 /* process number, SELF, NONE */
265#define IRQ_HOOK_ID m5_l3 /* id of irq hook at kernel */
266
267/* Field names for SYS_SEGCTL. */
268#define SEG_SELECT m4_l1 /* segment selector returned */
269#define SEG_OFFSET m4_l2 /* offset in segment returned */
270#define SEG_PHYS m4_l3 /* physical address of segment */
271#define SEG_SIZE m4_l4 /* segment size */
272#define SEG_INDEX m4_l5 /* segment index in remote map */
273
274/* Field names for SYS_VIDCOPY. */
275#define VID_REQUEST m4_l1 /* what to do? */
276# define VID_VID_COPY 1 /* request vid_vid_copy() */
277# define MEM_VID_COPY 2 /* request mem_vid_copy() */
278#define VID_SRC_ADDR m4_l2 /* virtual address in memory */
279#define VID_SRC_OFFSET m4_l3 /* offset in video memory */
280#define VID_DST_OFFSET m4_l4 /* offset in video memory */
281#define VID_CP_COUNT m4_l5 /* number of words to be copied */
282
283/* Field names for SYS_ABORT. */
284#define ABRT_HOW m1_i1 /* RBT_REBOOT, RBT_HALT, etc. */
285#define ABRT_MON_PROC m1_i2 /* process where monitor params are */
286#define ABRT_MON_LEN m1_i3 /* length of monitor params */
287#define ABRT_MON_ADDR m1_p1 /* virtual address of monitor params */
288
289/* Field names for _UMAP, _VIRCOPY, _PHYSCOPY. */
290#define CP_SRC_SPACE m5_c1 /* T or D space (stack is also D) */
291#define CP_SRC_PROC_NR m5_i1 /* process to copy from */
292#define CP_SRC_ADDR m5_l1 /* address where data come from */
293#define CP_DST_SPACE m5_c2 /* T or D space (stack is also D) */
294#define CP_DST_PROC_NR m5_i2 /* process to copy to */
295#define CP_DST_ADDR m5_l2 /* address where data go to */
296#define CP_NR_BYTES m5_l3 /* number of bytes to copy */
297
298/* Field names for SYS_VCOPY and SYS_VVIRCOPY. */
299#define VCP_NR_OK m1_i2 /* number of successfull copies */
300#define VCP_VEC_SIZE m1_i3 /* size of copy vector */
301#define VCP_VEC_ADDR m1_p1 /* pointer to copy vector */
302
303/* Field names for SYS_GETINFO. */
304#define I_REQUEST m7_i3 /* what info to get */
305# define GET_KINFO 0 /* get kernel information structure */
306# define GET_IMAGE 1 /* get system image table */
307# define GET_PROCTAB 2 /* get kernel process table */
308# define GET_RANDOMNESS 3 /* get randomness buffer */
309# define GET_MONPARAMS 4 /* get monitor parameters */
310# define GET_KENV 5 /* get kernel environment string */
311# define GET_IRQHOOKS 6 /* get the IRQ table */
312# define GET_KMESSAGES 7 /* get kernel messages */
313# define GET_PRIVTAB 8 /* get kernel privileges table */
314# define GET_KADDRESSES 9 /* get various kernel addresses */
315# define GET_SCHEDINFO 10 /* get scheduling queues */
316# define GET_PROC 11 /* get process slot if given process */
317# define GET_MACHINE 12 /* get machine information */
318# define GET_LOCKTIMING 13 /* get lock()/unlock() latency timing */
319# define GET_BIOSBUFFER 14 /* get a buffer for BIOS calls */
320#define I_PROC_NR m7_i4 /* calling process */
321#define I_VAL_PTR m7_p1 /* virtual address at caller */
322#define I_VAL_LEN m7_i1 /* max length of value */
323#define I_VAL_PTR2 m7_p2 /* second virtual address */
324#define I_VAL_LEN2 m7_i2 /* second length, or proc nr */
325
326/* Field names for SYS_TIMES. */
327#define T_PROC_NR m4_l1 /* process to request time info for */
328#define T_USER_TIME m4_l1 /* user time consumed by process */
329#define T_SYSTEM_TIME m4_l2 /* system time consumed by process */
330#define T_CHILD_UTIME m4_l3 /* user time consumed by process' children */
331#define T_CHILD_STIME m4_l4 /* sys time consumed by process' children */
332#define T_BOOT_TICKS m4_l5 /* number of clock ticks since boot time */
333
334/* Field names for SYS_TRACE, SYS_SVRCTL. */
335#define CTL_PROC_NR m2_i1 /* process number of the caller */
336#define CTL_REQUEST m2_i2 /* server control request */
337#define CTL_MM_PRIV m2_i3 /* privilege as seen by PM */
338#define CTL_ARG_PTR m2_p1 /* pointer to argument */
339#define CTL_ADDRESS m2_l1 /* address at traced process' space */
340#define CTL_DATA m2_l2 /* data field for tracing */
341
342/* Field names for SYS_KILL, SYS_SIGCTL */
343#define SIG_REQUEST m2_l2 /* PM signal control request */
344#define S_GETSIG 0 /* get pending kernel signal */
345#define S_ENDSIG 1 /* finish a kernel signal */
346#define S_SENDSIG 2 /* POSIX style signal handling */
347#define S_SIGRETURN 3 /* return from POSIX handling */
348#define S_KILL 4 /* servers kills process with signal */
349#define SIG_PROC m2_i1 /* process number for inform */
350#define SIG_NUMBER m2_i2 /* signal number to send */
351#define SIG_FLAGS m2_i3 /* signal flags field */
352#define SIG_MAP m2_l1 /* used by kernel to pass signal bit map */
353#define SIG_CTXT_PTR m2_p1 /* pointer to info to restore signal context */
354
355/* Field names for SYS_FORK, _EXEC, _EXIT, _NEWMAP. */
356#define PR_PROC_NR m1_i1 /* indicates a (child) process */
357#define PR_PRIORITY m1_i2 /* process priority */
358#define PR_PPROC_NR m1_i2 /* indicates a (parent) process */
359#define PR_PID m1_i3 /* process id at process manager */
360#define PR_STACK_PTR m1_p1 /* used for stack ptr in sys_exec, sys_getsp */
361#define PR_TRACING m1_i3 /* flag to indicate tracing is on/ off */
362#define PR_NAME_PTR m1_p2 /* tells where program name is for dmp */
363#define PR_IP_PTR m1_p3 /* initial value for ip after exec */
364#define PR_MEM_PTR m1_p1 /* tells where memory map is for sys_newmap */
365
366/* Field names for SYS_INT86 */
367#define INT86_REG86 m1_p1 /* pointer to registers */
368
369/* Field names for SELECT (FS). */
370#define SEL_NFDS m8_i1
371#define SEL_READFDS m8_p1
372#define SEL_WRITEFDS m8_p2
373#define SEL_ERRORFDS m8_p3
374#define SEL_TIMEOUT m8_p4
375
376/*===========================================================================*
377 * Messages for system management server *
378 *===========================================================================*/
379
380#define SRV_RQ_BASE 0x700
381
382#define SRV_UP (SRV_RQ_BASE + 0) /* start system service */
383#define SRV_DOWN (SRV_RQ_BASE + 1) /* stop system service */
384#define SRV_STATUS (SRV_RQ_BASE + 2) /* get service status */
385
386# define SRV_PATH_ADDR m1_p1 /* path of binary */
387# define SRV_PATH_LEN m1_i1 /* length of binary */
388# define SRV_ARGS_ADDR m1_p2 /* arguments to be passed */
389# define SRV_ARGS_LEN m1_i2 /* length of arguments */
390# define SRV_DEV_MAJOR m1_i3 /* major device number */
391# define SRV_PRIV_ADDR m1_p3 /* privileges string */
392# define SRV_PRIV_LEN m1_i3 /* length of privileges */
393
394/*===========================================================================*
395 * Miscellaneous messages used by TTY *
396 *===========================================================================*/
397
398/* Miscellaneous request types and field names, e.g. used by IS server. */
399#define PANIC_DUMPS 97 /* debug dumps at the TTY on RBT_PANIC */
400#define FKEY_CONTROL 98 /* control a function key at the TTY */
401# define FKEY_REQUEST m2_i1 /* request to perform at TTY */
402# define FKEY_MAP 10 /* observe function key */
403# define FKEY_UNMAP 11 /* stop observing function key */
404# define FKEY_EVENTS 12 /* request open key presses */
405# define FKEY_FKEYS m2_l1 /* F1-F12 keys pressed */
406# define FKEY_SFKEYS m2_l2 /* Shift-F1-F12 keys pressed */
407#define DIAGNOSTICS 100 /* output a string without FS in between */
408# define DIAG_PRINT_BUF m1_p1
409# define DIAG_BUF_COUNT m1_i1
410# define DIAG_PROC_NR m1_i2
411
412#endif /* _MINIX_COM_H */
Note: See TracBrowser for help on using the repository browser.