* Cleaned up KernelExport.h completely, removed deprecated and non implemented
API, uses the _PRINTFLIKE macro where appropriate. * Got rid of the "qent" structure, struct timer now contains everything we need. This makes the affected code in sem.cpp, signal.cpp, and timer.c much cleaner, and resolves a few TODOs. * Minor cleanup in vfs.cpp. git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@24871 a95241bf-73f2-0310-859d-f6bbb57e9c96
This commit is contained in:
Axel Dörfler
@@ -1,6 +1,5 @@
|
||||
/* Kernel only exports for kernel add-ons
|
||||
*
|
||||
* Copyright 2005, Haiku Inc. All Rights Reserved.
|
||||
/*
|
||||
* Copyright 2005-2008, Haiku Inc. All Rights Reserved.
|
||||
* Distributed under the terms of the MIT License.
|
||||
*/
|
||||
#ifndef _KERNEL_EXPORT_H
|
||||
@@ -11,31 +10,11 @@
|
||||
#include <OS.h>
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/*-------------------------------------------------------------*/
|
||||
/* interrupts and spinlocks */
|
||||
|
||||
/* disable/restore interrupts on the current CPU */
|
||||
|
||||
typedef ulong cpu_status;
|
||||
|
||||
extern cpu_status disable_interrupts(void);
|
||||
extern void restore_interrupts(cpu_status status);
|
||||
|
||||
|
||||
/* spinlocks. Note that acquire/release should be called with
|
||||
* interrupts disabled.
|
||||
*/
|
||||
|
||||
typedef vint32 spinlock;
|
||||
|
||||
extern void acquire_spinlock(spinlock *lock);
|
||||
extern void release_spinlock(spinlock *lock);
|
||||
|
||||
|
||||
/* interrupt handling support for device drivers */
|
||||
|
||||
typedef int32 (*interrupt_handler)(void *data);
|
||||
@@ -49,36 +28,16 @@ typedef int32 (*interrupt_handler)(void *data);
|
||||
#define B_NO_ENABLE_COUNTER 1
|
||||
#define B_NO_LOCK_VECTOR 2
|
||||
|
||||
extern status_t install_io_interrupt_handler(long interrupt_number,
|
||||
interrupt_handler handler, void *data, ulong flags);
|
||||
extern status_t remove_io_interrupt_handler(long interrupt_number,
|
||||
interrupt_handler handler, void *data);
|
||||
|
||||
|
||||
/*-------------------------------------------------------------*/
|
||||
/* timer interrupts services */
|
||||
|
||||
/* The BeOS qent structure is probably part of a general double linked list
|
||||
* interface used all over the kernel; a struct is required to have a qent
|
||||
* entry struct as first element, so it can be linked to other elements
|
||||
* easily. The key field is probably just an id, eventually used to order
|
||||
* the list.
|
||||
* Since we don't use this kind of interface, but we have to provide it
|
||||
* to keep compatibility, we can use the qent struct for other purposes...
|
||||
*
|
||||
* ToDo: don't do this! Drop source compatibility, but don't overdefine those values!
|
||||
*/
|
||||
typedef struct qent {
|
||||
int64 key; /* We use this as the sched time */
|
||||
struct qent *next; /* This is used as a pointer to next timer */
|
||||
struct qent *prev; /* This can be used for callback args */
|
||||
} qent;
|
||||
|
||||
typedef struct timer timer;
|
||||
typedef int32 (*timer_hook)(timer *);
|
||||
|
||||
struct timer {
|
||||
qent entry;
|
||||
struct timer *next;
|
||||
int64 schedule_time;
|
||||
void *user_data;
|
||||
uint16 flags;
|
||||
uint16 cpu;
|
||||
timer_hook hook;
|
||||
@@ -89,24 +48,7 @@ struct timer {
|
||||
#define B_ONE_SHOT_RELATIVE_TIMER 2
|
||||
#define B_PERIODIC_TIMER 3
|
||||
|
||||
extern status_t add_timer(timer *t, timer_hook hook, bigtime_t period, int32 flags);
|
||||
extern bool cancel_timer(timer *t);
|
||||
|
||||
|
||||
/*-------------------------------------------------------------*/
|
||||
/* kernel threads */
|
||||
|
||||
extern thread_id spawn_kernel_thread(thread_func function, const char *threadName,
|
||||
int32 priority, void *arg);
|
||||
|
||||
|
||||
/*-------------------------------------------------------------*/
|
||||
/* signal functions */
|
||||
|
||||
extern int send_signal_etc(pid_t thread, uint sig, uint32 flags);
|
||||
|
||||
|
||||
/*-------------------------------------------------------------*/
|
||||
/* virtual memory buffer functions */
|
||||
|
||||
#define B_DMA_IO 0x00000001
|
||||
@@ -117,11 +59,6 @@ typedef struct {
|
||||
ulong size; /* size of block */
|
||||
} physical_entry;
|
||||
|
||||
extern long lock_memory(void *buffer, ulong numBytes, ulong flags);
|
||||
extern long unlock_memory(void *buffer, ulong numBytes, ulong flags);
|
||||
extern long get_memory_map(const void *buffer, ulong size,
|
||||
physical_entry *table, long numEntries);
|
||||
|
||||
/* address specifications for mapping physical memory */
|
||||
#define B_ANY_KERNEL_BLOCK_ADDRESS (B_ANY_KERNEL_ADDRESS + 1)
|
||||
|
||||
@@ -130,14 +67,8 @@ extern long get_memory_map(const void *buffer, ulong size,
|
||||
#define B_KERNEL_WRITE_AREA 32
|
||||
#define B_USER_CLONEABLE_AREA 256
|
||||
|
||||
/* call to map physical memory - typically used for memory-mapped i/o */
|
||||
|
||||
extern area_id map_physical_memory(const char *areaName, void *physicalAddress,
|
||||
size_t size, uint32 flags, uint32 protection, void **mappedAddress);
|
||||
|
||||
|
||||
/* MTR attributes for mapping physical memory (Intel Architecture only) */
|
||||
// ToDo: what have those to do here?
|
||||
// TODO: rename those to something more meaningful
|
||||
#define B_MTR_UC 0x10000000
|
||||
#define B_MTR_WC 0x20000000
|
||||
#define B_MTR_WT 0x30000000
|
||||
@@ -146,52 +77,12 @@ extern area_id map_physical_memory(const char *areaName, void *physicalAddress,
|
||||
#define B_MTR_MASK 0xf0000000
|
||||
|
||||
|
||||
/*-------------------------------------------------------------*/
|
||||
/* hardware inquiry */
|
||||
/* kernel daemon service */
|
||||
|
||||
/* platform_type return value is defined in OS.h */
|
||||
typedef void (*daemon_hook)(void *arg, int iteration);
|
||||
|
||||
extern platform_type platform();
|
||||
|
||||
#if __POWERPC__
|
||||
extern long motherboard_version(void);
|
||||
extern long io_card_version(void);
|
||||
#endif
|
||||
|
||||
/*-------------------------------------------------------------*/
|
||||
/* primitive kernel debugging facilities */
|
||||
|
||||
/* Standard debug output is on...
|
||||
* mac: modem port
|
||||
* pc: com1
|
||||
* ...at 19.2 kbaud, no parity, 8 bit, 1 stop bit.
|
||||
*
|
||||
* Note: the kernel settings file can override these defaults
|
||||
*/
|
||||
|
||||
#if __GNUC__
|
||||
extern void dprintf(const char *format, ...) /* just like printf */
|
||||
__attribute__ ((format (__printf__, 1, 2)));
|
||||
extern void kprintf(const char *fmt, ...) /* only for debugger cmds */
|
||||
__attribute__ ((format (__printf__, 1, 2)));
|
||||
#else
|
||||
extern void dprintf(const char *format, ...); /* just like printf */
|
||||
extern void kprintf(const char *fmt, ...); /* only for debugger cmds */
|
||||
#endif
|
||||
|
||||
extern void dump_block(const char *buffer, int size, const char *prefix);
|
||||
/* hexdumps given buffer */
|
||||
|
||||
extern bool set_dprintf_enabled(bool new_state); /* returns old state */
|
||||
|
||||
#if __GNUC__
|
||||
extern void panic(const char *format, ...) __attribute__ ((format (__printf__, 1, 2)));
|
||||
#else
|
||||
extern void panic(const char *format, ...);
|
||||
#endif
|
||||
|
||||
extern void kernel_debugger(const char *message); /* enter kernel debugger */
|
||||
extern uint64 parse_expression(const char *string); /* utility for debugger cmds */
|
||||
/* kernel debugging facilities */
|
||||
|
||||
/* special return codes for kernel debugger */
|
||||
#define B_KDEBUG_CONT 2
|
||||
@@ -199,25 +90,70 @@ extern uint64 parse_expression(const char *string); /* utility for debugger cmd
|
||||
|
||||
typedef int (*debugger_command_hook)(int argc, char **argv);
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/* interrupts, spinlock, and timers */
|
||||
extern cpu_status disable_interrupts(void);
|
||||
extern void restore_interrupts(cpu_status status);
|
||||
|
||||
extern void acquire_spinlock(spinlock *lock);
|
||||
extern void release_spinlock(spinlock *lock);
|
||||
|
||||
extern status_t install_io_interrupt_handler(long interrupt_number,
|
||||
interrupt_handler handler, void *data, ulong flags);
|
||||
extern status_t remove_io_interrupt_handler(long interrupt_number,
|
||||
interrupt_handler handler, void *data);
|
||||
|
||||
extern status_t add_timer(timer *t, timer_hook hook, bigtime_t period,
|
||||
int32 flags);
|
||||
extern bool cancel_timer(timer *t);
|
||||
|
||||
/* kernel threads */
|
||||
extern thread_id spawn_kernel_thread(thread_func function,
|
||||
const char *name, int32 priority, void *arg);
|
||||
|
||||
/* signal functions */
|
||||
extern int send_signal_etc(pid_t thread, uint signal, uint32 flags);
|
||||
|
||||
/* virtual memory */
|
||||
extern long lock_memory(void *buffer, ulong numBytes, ulong flags);
|
||||
extern long unlock_memory(void *buffer, ulong numBytes, ulong flags);
|
||||
extern long get_memory_map(const void *buffer, ulong size,
|
||||
physical_entry *table, long numEntries);
|
||||
extern area_id map_physical_memory(const char *areaName,
|
||||
void *physicalAddress, size_t size, uint32 flags,
|
||||
uint32 protection, void **_mappedAddress);
|
||||
|
||||
/* kernel debugging facilities */
|
||||
extern void dprintf(const char *format, ...) _PRINTFLIKE(1, 2);
|
||||
extern void kprintf(const char *fmt, ...) _PRINTFLIKE(1, 2);
|
||||
|
||||
extern void dump_block(const char *buffer, int size, const char *prefix);
|
||||
/* TODO: temporary API: hexdumps given buffer */
|
||||
|
||||
extern bool set_dprintf_enabled(bool new_state);
|
||||
|
||||
extern void panic(const char *format, ...) _PRINTFLIKE(1, 2);
|
||||
|
||||
extern void kernel_debugger(const char *message);
|
||||
extern uint64 parse_expression(const char *string);
|
||||
|
||||
extern int add_debugger_command(char *name, debugger_command_hook hook, char *help);
|
||||
extern int remove_debugger_command(char *name, debugger_command_hook hook);
|
||||
|
||||
extern status_t load_driver_symbols(const char *driverName);
|
||||
|
||||
|
||||
/*-------------------------------------------------------------*/
|
||||
/* misc */
|
||||
extern int remove_debugger_command(char *name,
|
||||
debugger_command_hook hook);
|
||||
|
||||
/* Miscellaneous */
|
||||
extern void spin(bigtime_t microseconds);
|
||||
/* does a busy delay loop for at least "microseconds" */
|
||||
|
||||
typedef void (*daemon_hook)(void *arg, int iteration);
|
||||
|
||||
extern status_t register_kernel_daemon(daemon_hook hook, void *arg, int frequency);
|
||||
extern status_t register_kernel_daemon(daemon_hook hook, void *arg,
|
||||
int frequency);
|
||||
extern status_t unregister_kernel_daemon(daemon_hook hook, void *arg);
|
||||
|
||||
extern void call_all_cpus(void (*f)(void *, int), void *cookie);
|
||||
extern void call_all_cpus_sync(void (*f)(void *, int), void *cookie);
|
||||
extern void call_all_cpus(void (*func)(void *, int), void *cookie);
|
||||
extern void call_all_cpus_sync(void (*func)(void *, int), void *cookie);
|
||||
|
||||
/* safe methods to access user memory without having to lock it */
|
||||
extern status_t user_memcpy(void *to, const void *from, size_t size);
|
||||
|
||||
Reference in New Issue
Block a user