b423d7b477
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
86 lines
3.2 KiB
C
86 lines
3.2 KiB
C
#ifndef _MINIX_SYSUTIL_H
|
|
#define _MINIX_SYSUTIL_H 1
|
|
|
|
#include <minix/ipc.h>
|
|
|
|
/* Extra system library definitions to support device drivers and servers.
|
|
*
|
|
* Created:
|
|
* Mar 15, 2004 by Jorrit N. Herder
|
|
*
|
|
* Changes:
|
|
* May 31, 2005: added printf, kputc (relocated from syslib)
|
|
* May 31, 2005: added getuptime
|
|
* Mar 18, 2005: added tickdelay
|
|
* Oct 01, 2004: added env_parse, env_prefix, env_panic
|
|
* Jul 13, 2004: added fkey_ctl
|
|
* Apr 28, 2004: added report, panic
|
|
* Mar 31, 2004: setup like other libraries, such as syslib
|
|
*/
|
|
|
|
/*==========================================================================*
|
|
* Miscellaneous helper functions.
|
|
*==========================================================================*/
|
|
|
|
/* Environment parsing return values. */
|
|
#define EP_BUF_SIZE 128 /* local buffer for env value */
|
|
#define EP_UNSET 0 /* variable not set */
|
|
#define EP_OFF 1 /* var = off */
|
|
#define EP_ON 2 /* var = on (or field left blank) */
|
|
#define EP_SET 3 /* var = 1:2:3 (nonblank field) */
|
|
#define EP_EGETKENV 4 /* sys_getkenv() failed ... */
|
|
|
|
_PROTOTYPE( void env_setargs, (int argc, char *argv[]) );
|
|
_PROTOTYPE( int env_get_param, (char *key, char *value, int max_size) );
|
|
_PROTOTYPE( int env_prefix, (char *env, char *prefix) );
|
|
_PROTOTYPE( void env_panic, (char *key) );
|
|
_PROTOTYPE( int env_parse, (char *env, char *fmt, int field, long *param,
|
|
long min, long max) );
|
|
|
|
#define fkey_map(fkeys, sfkeys) fkey_ctl(FKEY_MAP, (fkeys), (sfkeys))
|
|
#define fkey_unmap(fkeys, sfkeys) fkey_ctl(FKEY_UNMAP, (fkeys), (sfkeys))
|
|
#define fkey_events(fkeys, sfkeys) fkey_ctl(FKEY_EVENTS, (fkeys), (sfkeys))
|
|
_PROTOTYPE( int fkey_ctl, (int req, int *fkeys, int *sfkeys) );
|
|
|
|
_PROTOTYPE( int printf, (const char *fmt, ...));
|
|
_PROTOTYPE( void kputc, (int c));
|
|
_PROTOTYPE( void report, (char *who, char *mess, int num));
|
|
_PROTOTYPE( void panic, (char *who, char *mess, int num));
|
|
_PROTOTYPE( int getuptime, (clock_t *ticks));
|
|
_PROTOTYPE( int getuptime2, (clock_t *ticks, time_t *boottime));
|
|
_PROTOTYPE( int tickdelay, (clock_t ticks));
|
|
_PROTOTYPE( int micro_delay_calibrate, (void));
|
|
_PROTOTYPE( u32_t sys_hz, (void));
|
|
_PROTOTYPE( void util_stacktrace, (void));
|
|
_PROTOTYPE( void util_nstrcat, (char *str, unsigned long n) );
|
|
_PROTOTYPE( void util_stacktrace_strcat, (char *));
|
|
_PROTOTYPE( int micro_delay, (u32_t micros));
|
|
_PROTOTYPE( u32_t micros_to_ticks, (u32_t micros));
|
|
_PROTOTYPE( void ser_putc, (char c));
|
|
_PROTOTYPE( void get_randomness, (struct k_randomness *, int));
|
|
|
|
#define asynsend(ep, msg) asynsend3(ep, msg, 0)
|
|
_PROTOTYPE( int asynsend3, (endpoint_t ep, message *msg, int flags));
|
|
|
|
#define ASSERT(c) if(!(c)) { panic(__FILE__, "assert " #c " failed at line", __LINE__); }
|
|
|
|
/* timing library */
|
|
#define TIMING_CATEGORIES 20
|
|
|
|
#define TIMING_POINTS 20 /* timing resolution */
|
|
#define TIMING_CATEGORIES 20
|
|
#define TIMING_NAME 10
|
|
|
|
struct util_timingdata {
|
|
char names[TIMING_NAME];
|
|
unsigned long lock_timings[TIMING_POINTS];
|
|
unsigned long lock_timings_range[2];
|
|
unsigned long binsize, resets, misses, measurements;
|
|
unsigned long starttimes[2]; /* nonzero if running */
|
|
};
|
|
|
|
typedef struct util_timingdata util_timingdata_t;
|
|
|
|
#endif /* _MINIX_SYSUTIL_H */
|
|
|