73aa393d73
pipes in the shell, though the semantics is a little different: The
second command is invoked whenever the first command has written a
complete line. The line is passed as last argument to the second
command. The new command flag B_KDEBUG_PIPE_FINAL_RERUN causes the
second command to be invoked again (with NULL argument) after the
first command is done.
* Added kprintf_unfiltered() and kputs_unfiltered() which bypass the
pipe mechanism and directly print to the bluescreen/serial output.
* Moved most commands from debug.cpp to the new
debug_builtin_commands.cpp.
* B_KDEBUG_DONT_PARSE_ARGUMENTS commands don't get an argument anymore,
if it would consist of white space only.
* Added new debugger command return value B_KDEBUG_ERROR, which
indicates that executing the command failed. This return code will
abort a complete pipe.
* Since debugger commands can nest (i.e. one command can invoke another
one) the setjmp()/longjmp() mechanism to restore the stack after a
page fault in a command needs more than one jump buffer.
* Added abort_debugger_command(), which longjmp()s out of the currently
executed command. This will also abort the current pipe.
* When pagination is enabled pressing "a" will abort the running command
(as opposed to "q" which only disables the blue screen output, but
lets the command continue).
* Added debugger commands:
- "grep" which can be used to filter output by pattern. Removed the
"filter" command and the underlying mechanism that did that before.
- "head" which prints only the first lines of output of another
command.
- "wc" counts lines, words, and characters of another command's
output.
git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@25744 a95241bf-73f2-0310-859d-f6bbb57e9c96
113 lines
3.2 KiB
C
113 lines
3.2 KiB
C
/*
|
|
* Copyright 2002-2008, Axel Dörfler, axeld@pinc-software.de
|
|
* Distributed under the terms of the Haiku License.
|
|
*
|
|
* Copyright 2001-2002, Travis Geiselbrecht. All rights reserved.
|
|
* Distributed under the terms of the NewOS License.
|
|
*/
|
|
#ifndef _KERNEL_DEBUG_H
|
|
#define _KERNEL_DEBUG_H
|
|
|
|
|
|
#include <KernelExport.h>
|
|
#include <module.h>
|
|
|
|
|
|
#define KDEBUG 1
|
|
|
|
#if DEBUG
|
|
/*
|
|
* The kernel debug level.
|
|
* Level 1 is usual asserts, > 1 should be used for very expensive runtime checks
|
|
*/
|
|
# define KDEBUG 1
|
|
#endif
|
|
|
|
#define ASSERT_ALWAYS(x) \
|
|
do { if (!(x)) { panic("ASSERT FAILED (%s:%d): %s\n", __FILE__, __LINE__, #x); } } while (0)
|
|
|
|
#define ASSERT_ALWAYS_PRINT(x, format...) \
|
|
do { \
|
|
if (!(x)) { \
|
|
dprintf_no_syslog(format); \
|
|
panic("ASSERT FAILED (%s:%d): %s\n", __FILE__, __LINE__, #x); \
|
|
} \
|
|
} while (0)
|
|
|
|
#if KDEBUG
|
|
# define ASSERT(x) ASSERT_ALWAYS(x)
|
|
# define ASSERT_PRINT(x, format...) ASSERT_ALWAYS_PRINT(x, format)
|
|
#else
|
|
# define ASSERT(x) do { } while(0)
|
|
# define ASSERT_PRINT(x, format...) do { } while(0)
|
|
#endif
|
|
|
|
// command return value
|
|
#define B_KDEBUG_ERROR 4
|
|
|
|
// command flags
|
|
#define B_KDEBUG_DONT_PARSE_ARGUMENTS (0x01)
|
|
#define B_KDEBUG_PIPE_FINAL_RERUN (0x02)
|
|
|
|
struct debugger_module_info {
|
|
module_info info;
|
|
|
|
void (*enter_debugger)(void);
|
|
void (*exit_debugger)(void);
|
|
|
|
// io hooks
|
|
int (*debugger_puts)(const char *str, int32 length);
|
|
int (*debugger_getchar)(void);
|
|
// TODO: add hooks for tunnelling gdb ?
|
|
};
|
|
|
|
extern int dbg_register_file[B_MAX_CPU_COUNT][14];
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct kernel_args;
|
|
|
|
extern status_t debug_init(struct kernel_args *args);
|
|
extern status_t debug_init_post_vm(struct kernel_args *args);
|
|
extern status_t debug_init_post_modules(struct kernel_args *args);
|
|
extern void debug_early_boot_message(const char *string);
|
|
extern void debug_puts(const char *s, int32 length);
|
|
extern bool debug_debugger_running(void);
|
|
extern bool debug_screen_output_enabled(void);
|
|
extern void debug_stop_screen_debug_output(void);
|
|
|
|
extern void kputs(const char *string);
|
|
extern void kputs_unfiltered(const char *string);
|
|
extern void kprintf_unfiltered(const char *format, ...)
|
|
__attribute__ ((format (__printf__, 1, 2)));
|
|
extern void dprintf_no_syslog(const char *format, ...)
|
|
__attribute__ ((format (__printf__, 1, 2)));
|
|
|
|
extern bool is_debug_variable_defined(const char* variableName);
|
|
extern bool set_debug_variable(const char* variableName, uint64 value);
|
|
extern uint64 get_debug_variable(const char* variableName,
|
|
uint64 defaultValue);
|
|
extern bool unset_debug_variable(const char* variableName);
|
|
extern void unset_all_debug_variables();
|
|
|
|
extern bool evaluate_debug_expression(const char* expression,
|
|
uint64* result, bool silent);
|
|
extern int evaluate_debug_command(const char* command);
|
|
|
|
extern status_t add_debugger_command_etc(const char* name,
|
|
debugger_command_hook func, const char* description,
|
|
const char* usage, uint32 flags);
|
|
extern status_t add_debugger_command_alias(const char* newName,
|
|
const char* oldName, const char* description);
|
|
extern bool print_debugger_command_usage(const char* command);
|
|
|
|
extern void _user_debug_output(const char *userString);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _KERNEL_DEBUG_H */
|