RepoMirrors/crash
1
0
Fork 0
mirror of https://github.com/crash-utility/crash synced 2025-01-22 08:32:43 +00:00
Code Issues Packages Projects Releases Wiki Activity
618066f433
crash/help.c
Dave Anderson 81d7896441 Implemented a new "ps -S" option that displays a summary consisting 
of the number of tasks in a task state.
(anderson@redhat.com)
2014-05-19 15:19:43 -04:00

8216 lines
353 KiB
C
Raw Blame History

/* help.c - core analysis suite
*
* Copyright (C) 1999, 2000, 2001, 2002 Mission Critical Linux, Inc.
* Copyright (C) 2002-2014 David Anderson
* Copyright (C) 2002-2014 Red Hat, Inc. All rights reserved.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*/
#include "defs.h"
static void reshuffle_cmdlist(void);
static int sort_command_name(const void *, const void *);
static void display_commands(void);
static void display_copying_info(void);
static void display_warranty_info(void);
static void display_output_info(void);
static void display_input_info(void);
static void display_README(void);
static char *gnu_public_license[];
static char *gnu_public_license_v3[];
static char *version_info[];
static char *output_info[];
static char *input_info[];
static char *README[];
static void dump_registers(void);
#define GPLv2 2
#define GPLv3 3
#if defined(GDB_5_3) || defined(GDB_6_0) || defined(GDB_6_1)
static int GPL_version = GPLv2;
#else
static int GPL_version = GPLv3;
#endif
static
char *program_usage_info[] = {
"",
"USAGE:",
"",
" crash [OPTION]... NAMELIST MEMORY-IMAGE (dumpfile form)",
" crash [OPTION]... [NAMELIST] (live system form)",
"",
"OPTIONS:",
"",
" NAMELIST",
" This is a pathname to an uncompressed kernel image (a vmlinux",
" file), or a Xen hypervisor image (a xen-syms file) which has",
" been compiled with the \"-g\" option. If using the dumpfile form,",
" a vmlinux file may be compressed in either gzip or bzip2 formats.",
"",
" MEMORY-IMAGE",
" A kernel core dump file created by the netdump, diskdump, LKCD",
" kdump, xendump or kvmdump facilities.",
"",
" If a MEMORY-IMAGE argument is not entered, the session will be",
" invoked on the live system, which typically requires root privileges",
" because of the device file used to access system RAM. By default, ",
" /dev/crash will be used if it exists. If it does not exist, then ",
" /dev/mem will be used; but if the kernel has been configured with ",
" CONFIG_STRICT_DEVMEM, then /proc/kcore will be used. It is permissible",
" to explicitly enter /dev/crash, /dev/mem or /proc/kcore.",
"",
" mapfile",
" If the NAMELIST file is not the same kernel that is running",
" (live system form), or the kernel that was running when the system",
" crashed (dumpfile form), then the System.map file of the original ",
" kernel should be entered on the command line.",
"",
" -h [option]",
" --help [option]",
" Without an option argument, display a crash usage help message.",
" If the option argument is a crash command name, the help page",
" for that command is displayed. If it is the string \"input\", a",
" page describing the various crash command line input options is",
" displayed. If it is the string \"output\", a page describing command",
" line output options is displayed. If it is the string \"all\", then",
" all of the possible help messages are displayed. After the help",
" message is displayed, crash exits.",
"",
" -s ",
" Silently proceed directly to the \"crash>\" prompt without displaying",
" any version, GPL, or crash initialization data during startup, and by",
" default, runtime command output is not passed to any scrolling command.",
"",
" -i file",
" Execute the command(s) contained in \"file\" prior to displaying ",
" the \"crash>\" prompt for interactive user input.",
"",
" -d num ",
" Set the internal debug level. The higher the number, the more",
" debugging data will be printed when crash initializes and runs.",
"",
" -S ",
" Use /boot/System.map as the mapfile.",
"",
" -e vi | emacs",
" Set the readline(3) command line editing mode to \"vi\" or \"emacs\". ",
" The default editing mode is \"vi\".",
"",
" -f ",
" Force the usage of a compressed vmlinux file if its original",
" name does not start with \"vmlinux\".",
"",
" -k ",
" Indicate that the NAMELIST file is an LKCD \"Kerntypes\" debuginfo file.",
"",
" -g [namelist]",
" Determine if a vmlinux or xen-syms namelist file contains debugging data.",
"",
" -t ",
" Display the system-crash timestamp and exit.",
"",
" -L ",
" Attempt to lock all of its virtual address space into memory by",
" calling mlockall(MCL_CURRENT|MCL_FUTURE) during initialization.",
" If the system call fails, an error message will be displayed,",
" but the session continues.",
"",
" -c tty-device",
" Open the tty-device as the console used for debug messages.",
"",
" -p page-size",
" If a processor's page size cannot be determined by the dumpfile, ",
" and the processor default cannot be used, use page-size.",
"",
" -m option=value",
" --machdep option=value",
" Pass an option and value pair to machine-dependent code. These",
" architecture-specific option/pairs should only be required in",
" very rare circumstances:",
"",
" X86_64:",
" phys_base=<physical-address>",
" irq_eframe_link=<value>",
" max_physmem_bits=<value>",
" vm=orig (pre-2.6.11 virtual memory address ranges)",
" vm=2.6.11 (2.6.11 and later virtual memory address ranges)",
" vm=xen (Xen kernel virtual memory address ranges)",
" vm=xen-rhel4 (RHEL4 Xen kernel virtual address ranges)",
" PPC64:",
" vm=orig",
" vm=2.6.14 (4-level page tables)",
" IA64:",
" phys_start=<physical-address>",
" init_stack_size=<size>",
" vm=4l (4-level page tables)",
" ARM:",
" phys_base=<physical-address>",
" ARM64:",
" phys_offset=<physical-address>",
"",
" -x ",
" Automatically load extension modules from a particular directory.",
" The directory is determined by the following order of precedence:",
"",
" (1) the directory specified in the CRASH_EXTENSIONS shell ",
" environment variable",
" (2) /usr/lib64/crash/extensions (64-bit architectures)",
" (3) /usr/lib/crash/extensions (32-bit architectures)",
" (4) the ./extensions subdirectory of the current directory",
"",
" --active",
" Track only the active task on each cpu.",
"",
" --buildinfo",
" Display the crash binary's build date, the user ID of the builder,",
" the hostname of the machine where the build was done, the target",
" architecture, the version number, and the compiler version.",
"",
" --memory_module modname",
" Use the modname as an alternative kernel module to the crash.ko",
" module that creates the /dev/crash device.",
"",
" --memory_device device",
" Use device as an alternative device to the /dev/crash, /dev/mem",
" or /proc/kcore devices.",
"",
" --log dumpfile",
" Dump the contents of the kernel log buffer. A kernel namelist",
" argument is not necessary, but the dumpfile must contain the",
" VMCOREINFO data taken from the original /proc/vmcore ELF header.",
"",
" --no_kallsyms",
" Do not use kallsyms-generated symbol information contained within",
" kernel module object files.",
"",
" --no_modules",
" Do not access or display any kernel module related information.",
"",
" --no_ikconfig",
" Do not attempt to read configuration data that was built into",
" kernels configured with CONFIG_IKCONFIG.",
"",
" --no_data_debug",
" Do not verify the validity of all structure member offsets and",
" structure sizes that it uses.",
"",
" --no_kmem_cache",
" Do not initialize the kernel's slab cache infrastructure, and",
" commands that use kmem_cache-related data will not work.",
"",
" --no_elf_notes",
" Do not use the registers from the ELF NT_PRSTATUS notes saved",
" in a compressed kdump header for backtraces.",
"",
" --kmem_cache_delay",
" Delay the initialization of the kernel's slab cache infrastructure",
" until it is required by a run-time command.",
"",
" --readnow",
" Pass this flag to the embedded gdb module, which will override",
" the two-stage strategy that it uses for reading symbol tables",
" from the NAMELIST. If module symbol tables are loaded during",
" runtime with the \"mod\" command, the same override will occur.",
"",
" --smp ",
" Specify that the system being analyzed is an SMP kernel.",
"",
" -v",
" --version",
" Display the version of the crash utility, the version of the",
" embedded gdb module, GPL information, and copyright notices.",
"",
" --cpus number",
" Specify the number of cpus in the SMP system being analyzed.",
"",
" --osrelease dumpfile",
" Display the OSRELEASE vmcoreinfo string from a kdump dumpfile",
" header.",
"",
" --hyper",
" Force the session to be that of a Xen hypervisor.",
"",
" --p2m_mfn pfn",
" When a Xen Hypervisor or its dom0 kernel crashes, the dumpfile",
" is typically analyzed with either the Xen hypervisor or the dom0",
" kernel. It is also possible to analyze any of the guest domU",
" kernels if the pfn_to_mfn_list_list pfn value of the guest kernel",
" is passed on the command line along with its NAMELIST and the ",
" dumpfile.",
"",
" --xen_phys_start physical-address",
" Supply the base physical address of the Xen hypervisor's text",
" and static data for older xendump dumpfiles that did not pass",
" that information in the dumpfile header.",
"",
" --zero_excluded",
" If a kdump dumpfile has been filtered to exclude various types of",
" non-essential pages, any attempt to read them will fail. With",
" this flag, reads from any of those pages will return zero-filled",
" memory.",
"",
" --no_panic",
" Do not attempt to find the task that was running when the kernel",
" crashed. Set the initial context to that of the \"swapper\" task",
" on cpu 0.",
"",
" --more ",
" Use /bin/more as the command output scroller, overriding the",
" default of /usr/bin/less and any settings in either ./.crashrc",
" or $HOME/.crashrc.",
"",
" --less ",
" Use /usr/bin/less as the command output scroller, overriding any",
" settings in either ./.crashrc or $HOME/.crashrc.",
"",
" --CRASHPAGER",
" Use the output paging command defined in the CRASHPAGER shell",
" environment variable, overriding any settings in either ./.crashrc ",
" or $HOME/.crashrc.",
"",
" --no_scroll",
" Do not pass run-time command output to any scrolling command.",
"",
" --no_strip",
" Do not strip cloned kernel text symbol names.",
"",
" --no_crashrc",
" Do not execute the commands in either $HOME/.crashrc or ./.crashrc.",
"",
" --mod directory",
" When loading the debuginfo data of kernel modules with the \"mod -S\"",
" command, search for their object files in directory instead of in ",
" the standard location.",
"",
" --reloc size",
" When analyzing live x86 kernels configured with a CONFIG_PHYSICAL_START ",
" value that is larger than its CONFIG_PHYSICAL_ALIGN value, then it will",
" be necessary to enter a relocation size equal to the difference between",
" the two values.",
"",
" --hash count",
" Set the number of internal hash queue heads used for list gathering",
" and verification. The default count is 32768.",
"",
" --kaslr offset | auto",
" If an x86_64 kernel was configured with CONFIG_RANDOMIZE_BASE, the",
" offset value is equal to the difference between the symbol values ",
" compiled into the vmlinux file and their relocated KASLR value. If",
" set to auto, the KASLR offset value will be automatically calculated.",
"",
" --minimal",
" Bring up a session that is restricted to the log, dis, rd, sym,",
" eval, set and exit commands. This option may provide a way to",
" extract some minimal/quick information from a corrupted or truncated",
" dumpfile, or in situations where one of the several kernel subsystem ",
" initialization routines would abort the crash session.",
"",
" --kvmhost [32|64]",
" When examining an x86 KVM guest dumpfile, this option specifies",
" that the KVM host that created the dumpfile was an x86 (32-bit)",
" or an x86_64 (64-bit) machine, overriding the automatically",
" determined value.",
"",
" --kvmio <size>",
" override the automatically-calculated KVM guest I/O hole size.",
"",
"FILES:",
"",
" .crashrc",
" Initialization commands. The file can be located in the user's",
" HOME directory and/or the current directory. Commands found in",
" the .crashrc file in the HOME directory are executed before",
" those in the current directory's .crashrc file.",
"",
"ENVIRONMENT VARIABLES:",
"",
" EDITOR ",
" Command input is read using readline(3). If EDITOR is set to",
" emacs or vi then suitable keybindings are used. If EDITOR is",
" not set, then vi is used. This can be overridden by \"set vi\" or",
" \"set emacs\" commands located in a .crashrc file, or by entering",
" \"-e emacs\" on the crash command line.",
"",
" CRASHPAGER",
" If CRASHPAGER is set, its value is used as the name of the program",
" to which command output will be sent. If not, then command output",
" output is sent to \"/usr/bin/less -E -X\" by default.",
"",
" CRASH_MODULE_PATH",
" Specifies an alternative directory tree to search for kernel",
" module object files.",
"",
" CRASH_EXTENSIONS",
" Specifies a directory containing extension modules that will be",
" loaded automatically if the -x command line option is used.",
"",
NULL
};
void
program_usage(int form)
{
if (form == SHORT_FORM) {
fprintf(fp, "\nUsage:\n\n");
fprintf(fp, "%s\n%s\n", program_usage_info[3],
program_usage_info[4]);
fprintf(fp, "\nEnter \"%s -h\" for details.\n",
pc->program_name);
clean_exit(1);
} else {
FILE *scroll;
char *scroll_command;
char **p;
if ((scroll_command = setup_scroll_command()) &&
(scroll = popen(scroll_command, "w")))
fp = scroll;
else
scroll = NULL;
for (p = program_usage_info; *p; p++) {
fprintf(fp, *p, pc->program_name);
fprintf(fp, "\n");
}
fflush(fp);
if (scroll)
pclose(scroll);
clean_exit(0);
}
}
/*
* Get an updated count of commands for subsequent help menu display,
* reshuffling the deck if this is the first time or if something's changed.
*/
void
help_init(void)
{
struct command_table_entry *cp;
struct extension_table *ext;
for (pc->ncmds = 0, cp = pc->cmd_table; cp->name; cp++) {
if (!(cp->flags & HIDDEN_COMMAND))
pc->ncmds++;
}
for (ext = extension_table; ext; ext = ext->next) {
for (cp = ext->command_table; cp->name; cp++) {
if (!(cp->flags & (CLEANUP|HIDDEN_COMMAND)))
pc->ncmds++;
}
}
if (!pc->cmdlist) {
pc->cmdlistsz = pc->ncmds;
if ((pc->cmdlist = (char **)
malloc(sizeof(char *) * pc->cmdlistsz)) == NULL)
error(FATAL,
"cannot malloc command list space\n");
} else if (pc->ncmds > pc->cmdlistsz) {
pc->cmdlistsz = pc->ncmds;
if ((pc->cmdlist = (char **)realloc(pc->cmdlist,
sizeof(char *) * pc->cmdlistsz)) == NULL)
error(FATAL,
"cannot realloc command list space\n");
}
reshuffle_cmdlist();
}
/*
* If the command list is modified during runtime, re-shuffle the list
* for proper help menu display.
*/
static void
reshuffle_cmdlist(void)
{
int i, cnt;
struct command_table_entry *cp;
struct extension_table *ext;
for (i = 0; i < pc->cmdlistsz; i++)
pc->cmdlist[i] = NULL;
for (cnt = 0, cp = pc->cmd_table; cp->name; cp++) {
if (!(cp->flags & HIDDEN_COMMAND))
pc->cmdlist[cnt++] = cp->name;
}
for (ext = extension_table; ext; ext = ext->next) {
for (cp = ext->command_table; cp->name; cp++) {
if (!(cp->flags & (CLEANUP|HIDDEN_COMMAND)))
pc->cmdlist[cnt++] = cp->name;
}
}
if (cnt > pc->cmdlistsz)
error(FATAL, "help table malfunction!\n");
qsort((void *)pc->cmdlist, (size_t)cnt,
sizeof(char *), sort_command_name);
}
/*
* The help list is in alphabetical order, with exception of the "q" command,
* which has historically always been the last command in the list.
*/
static int
sort_command_name(const void *name1, const void *name2)
{
char **s1, **s2;
s1 = (char **)name1;
s2 = (char **)name2;
if (STREQ(*s1, "q"))
return 1;
return strcmp(*s1, *s2);
}
/*
* Get help for a command, to dump an internal table, or the GNU public
* license copying/warranty information.
*/
void
cmd_help(void)
{
int c;
int oflag;
oflag = 0;
while ((c = getopt(argcnt, args,
"efNDdmM:ngcaBbHhkKsvVoptTzLxOr")) != EOF) {
switch(c)
{
case 'e':
dump_extension_table(VERBOSE);
return;
case 'f':
dump_filesys_table(VERBOSE);
return;
case 'n':
case 'D':
dumpfile_memory(DUMPFILE_MEM_DUMP);
return;
case 'x':
dump_text_value_cache(VERBOSE);
return;
case 'd':
dump_dev_table();
return;
case 'M':
dump_machdep_table(stol(optarg, FAULT_ON_ERROR, NULL));
return;
case 'm':
dump_machdep_table(0);
return;
case 'g':
dump_gdb_data();
return;
case 'N':
dump_net_table();
return;
case 'a':
dump_alias_data();
return;
case 'b':
dump_shared_bufs();
return;
case 'B':
dump_build_data();
return;
case 'c':
dump_numargs_cache();
return;
case 'H':
dump_hash_table(VERBOSE);
return;
case 'h':
dump_hash_table(!VERBOSE);
return;
case 'k':
dump_kernel_table(!VERBOSE);
return;
case 'K':
dump_kernel_table(VERBOSE);
return;
case 's':
dump_symbol_table();
return;
case 'V':
dump_vm_table(VERBOSE);
return;
case 'v':
dump_vm_table(!VERBOSE);
return;
case 'O':
dump_offset_table(NULL, TRUE);
return;
case 'o':
oflag = TRUE;
break;
case 'T':
dump_task_table(VERBOSE);
return;
case 't':
dump_task_table(!VERBOSE);
return;
case 'p':
dump_program_context();
return;
case 'z':
fprintf(fp, "help options:\n");
fprintf(fp, " -a - alias data\n");
fprintf(fp, " -b - shared buffer data\n");
fprintf(fp, " -B - build data\n");
fprintf(fp, " -c - numargs cache\n");
fprintf(fp, " -d - device table\n");
fprintf(fp, " -D - dumpfile contents/statistics\n");
fprintf(fp, " -e - extension table data\n");
fprintf(fp, " -f - filesys table\n");
fprintf(fp, " -h - hash_table data\n");
fprintf(fp, " -H - hash_table data (verbose)\n");
fprintf(fp, " -k - kernel_table\n");
fprintf(fp, " -K - kernel_table (verbose)\n");
fprintf(fp, " -L - LKCD page cache environment\n");
fprintf(fp, " -M <num> machine specific\n");
fprintf(fp, " -m - machdep_table\n");
fprintf(fp, " -n - dumpfile contents/statistics\n");
fprintf(fp, " -o - offset_table and size_table\n");
fprintf(fp, " -p - program_context\n");
fprintf(fp, " -r - dump registers from dumpfile header\n");
fprintf(fp, " -s - symbol table data\n");
fprintf(fp, " -t - task_table\n");
fprintf(fp, " -T - task_table plus context_array\n");
fprintf(fp, " -v - vm_table\n");
fprintf(fp, " -V - vm_table (verbose)\n");
fprintf(fp, " -x - text cache\n");
return;
case 'L':
dumpfile_memory(DUMPFILE_ENVIRONMENT);
return;
case 'r':
dump_registers();
return;
default:
argerrs++;
break;
}
}
if (argerrs)
cmd_usage(pc->curcmd, COMPLETE_HELP);
if (!args[optind]) {
if (oflag)
dump_offset_table(NULL, FALSE);
else
display_help_screen("");
return;
}
do {
if (oflag)
dump_offset_table(args[optind], FALSE);
else
cmd_usage(args[optind], COMPLETE_HELP|MUST_HELP);
optind++;
} while (args[optind]);
}
static void
dump_registers(void)
{
if (pc->flags2 & QEMU_MEM_DUMP) {
dump_registers_for_qemu_mem_dump();
return;
} else if (DISKDUMP_DUMPFILE()) {
dump_registers_for_compressed_kdump();
return;
} else if (NETDUMP_DUMPFILE() || KDUMP_DUMPFILE()) {
dump_registers_for_elf_dumpfiles();
return;
}
error(FATAL, "-r option not supported on %s\n",
ACTIVE() ? "a live system" : "this dumpfile type");
}
/*
* Format and display the help menu.
*/
void
display_help_screen(char *indent)
{
int i, j, rows;
char **namep;
help_init();
fprintf(fp, "\n%s", indent);
rows = (pc->ncmds + (HELP_COLUMNS-1)) / HELP_COLUMNS;
for (i = 0; i < rows; i++) {
namep = &pc->cmdlist[i];
for (j = 0; j < HELP_COLUMNS; j++) {
fprintf(fp,"%-15s", *namep);
namep += rows;
if ((namep - pc->cmdlist) >= pc->ncmds)
break;
}
fprintf(fp,"\n%s", indent);
}
fprintf(fp, "\n%s%s version: %-6s gdb version: %s\n", indent,
pc->program_name, pc->program_version, pc->gdb_version);
fprintf(fp,
"%sFor help on any command above, enter \"help <command>\".\n",
indent);
fprintf(fp, "%sFor help on input options, enter \"help input\".\n",
indent);
fprintf(fp, "%sFor help on output options, enter \"help output\".\n",
indent);
#ifdef NO_LONGER_TRUE
fprintf(fp, "%sFor the most recent version: "
"http://www.missioncriticallinux.com/download\n\n", indent);
#else
fprintf(fp, "\n");
#endif
}
/*
* Used for generating HTML pages, dump the commands in the order
* they would be seen on the help menu, i.e., from left-to-right, row-by-row.
* Line ends are signaled with a "BREAK" string.
*/
static void
display_commands(void)
{
int i, j, rows;
char **namep;
help_init();
rows = (pc->ncmds + (HELP_COLUMNS-1)) / HELP_COLUMNS;
for (i = 0; i < rows; i++) {
namep = &pc->cmdlist[i];
for (j = 0; j < HELP_COLUMNS; j++) {
fprintf(fp,"%s\n", *namep);
namep += rows;
if ((namep - pc->cmdlist) >= pc->ncmds) {
fprintf(fp, "BREAK\n");
break;
}
}
}
}
/*
* Help data for a command must be formatted using the following template:
"command-name",
"command description line",
"argument-usage line",
"description...",
"description...",
"description...",
NULL,
* The first line is concatenated with the second line, and will follow the
* help command's "NAME" header.
* The first and third lines will also be concatenated, and will follow the
* help command's "SYNOPSIS" header. If the command has no arguments, enter
* a string consisting of a space, i.e., " ".
* The fourth and subsequent lines will follow the help command's "DESCRIPTION"
* header.
*
* The program name can be referenced by using the %%s format. The final
* entry in each command's help data string list must be a NULL.
*/
char *help_foreach[] = {
"foreach",
"display command data for multiple tasks in the system",
"[[pid | taskp | name | state | [kernel | user]] ...]\n"
" command [flag] [argument]",
" This command allows for a an examination of various kernel data associated",
" with any, or all, tasks in the system, without having to set the context",
" to each targeted task.\n",
" pid perform the command(s) on this PID.",
" taskp perform the command(s) on task referenced by this hexadecimal",
" task_struct pointer.",
" name perform the command(s) on all tasks with this name. If the",
" task name can be confused with a foreach command name, then",
" precede the name string with a \"\\\". If the name string is",
" enclosed within \"'\" characters, then the encompassed string",
" must be a POSIX extended regular expression that will be used",
" to match task names.",
" user perform the command(s) on all user (non-kernel) threads.",
" kernel perform the command(s) on all kernel threads.",
" active perform the command(s) on the active thread on each CPU.",
" state perform the command(s) on all tasks in the specified state, which",
" may be one of: RU, IN, UN, ST, ZO, TR, SW or DE.\n",
" If none of the task-identifying arguments above are entered, the command",
" will be performed on all tasks.\n",
" command select one or more of the following commands to be run on the tasks",
" selected, or on all tasks:\n",
" bt run the \"bt\" command (optional flags: -r -t -l -e -R -f -F",
" -o -s -x -d)",
" vm run the \"vm\" command (optional flags: -p -v -m -R -d -x)",
" task run the \"task\" command (optional flags: -R -d -x)",
" files run the \"files\" command (optional flag: -R)",
" net run the \"net\" command (optional flags: -s -S -R -d -x)",
" set run the \"set\" command",
" ps run the \"ps\" command (optional flags: -G -s -p -c -t -l -a",
" -g -r)",
" sig run the \"sig\" command (optional flag: -g)",
" vtop run the \"vtop\" command (optional flags: -c -u -k)\n",
" flag Pass this optional flag to the command selected.",
" argument Pass this argument to the command selected.",
" ",
" A header containing the PID, task address, cpu and command name will be",
" pre-pended before the command output for each selected task. Consult the",
" help page of each of the command types above for details.",
"\nEXAMPLES",
" Display the stack traces for all tasks:\n",
" %s> foreach bt",
" PID: 4752 TASK: c7680000 CPU: 1 COMMAND: \"xterm\"",
" #0 [c7681edc] schedule at c01135f6",
" (void)",
" #1 [c7681f34] schedule_timeout at c01131ff",
" (24)",
" #2 [c7681f64] do_select at c0132838",
" (5, c7681fa4, c7681fa0)",
" #3 [c7681fbc] sys_select at c0132dad",
" (5, 8070300, 8070380, 0, 0)",
" #4 [bffffb0c] system_call at c0109944",
" EAX: 0000008e EBX: 00000005 ECX: 08070300 EDX: 08070380 ",
" DS: 002b ESI: 00000000 ES: 002b EDI: 00000000 ",
" SS: 002b ESP: bffffadc EBP: bffffb0c ",
" CS: 0023 EIP: 402259ee ERR: 0000008e EFLAGS: 00000246 ",
" ",
" PID: 557 TASK: c5600000 CPU: 0 COMMAND: \"nfsd\"",
" #0 [c5601f38] schedule at c01135f6",
" (void)",
" #1 [c5601f90] schedule_timeout at c01131ff",
" (c5600000)",
" #2 [c5601fb8] svc_recv at c805363a",
" (c0096f40, c5602800, 7fffffff, 100, c65c9f1c)",
" #3 [c5601fec] (nfsd module) at c806e303",
" (c5602800, c5602800, c0096f40, 6c6e0002, 50)",
" #4 [c65c9f24] kernel_thread at c010834f",
" (0, 0, ext2_file_inode_operations)",
" ",
" PID: 824 TASK: c7c84000 CPU: 0 COMMAND: \"mingetty\"",
" ...\n",
" Display the task_struct structure for each \"bash\" command:\n",
" %s> foreach bash task",
" ...\n",
" Display the open files for all tasks:\n",
" %s> foreach files",
" ...\n",
" Display the state of tasks whose name contains a match to \"event.*\":\n",
" %s> foreach 'event.*' task -R state",
" PID: 99 TASK: ffff8804750d5500 CPU: 0 COMMAND: \"events/0\"",
" state = 1,",
" ",
" PID: 100 TASK: ffff8804750d4ac0 CPU: 1 COMMAND: \"events/1\"",
" state = 1,",
" ",
" PID: 101 TASK: ffff8804750d4080 CPU: 2 COMMAND: \"events/2\"",
" state = 1,",
" ...\n",
" Display the stack traces for all blocked (TASK_UNINTERRUPTIBLE) tasks:\n",
" %s> foreach UN bt",
" PID: 428 TASK: ffff880036b6c560 CPU: 1 COMMAND: \"jbd2/dm-1-8\"",
" #0 [ffff880035779a70] __schedule at ffffffff815df272",
" #1 [ffff880035779b08] schedule at ffffffff815dfacf",
" #2 [ffff880035779b18] io_schedule at ffffffff815dfb7f",
" #3 [ffff880035779b38] sleep_on_page at ffffffff81119a4e",
" #4 [ffff880035779b48] __wait_on_bit at ffffffff815e039f",
" #5 [ffff880035779b98] wait_on_page_bit at ffffffff81119bb8",
" #6 [ffff880035779be8] filemap_fdatawait_range at ffffffff81119ccc",
" #7 [ffff880035779cd8] filemap_fdatawait at ffffffff81119d8b",
" #8 [ffff880035779ce8] jbd2_journal_commit_transaction at ffffffff8123a99c",
" #9 [ffff880035779e58] kjournald2 at ffffffff8123ee7b",
" #10 [ffff880035779ee8] kthread at ffffffff8108fb9c",
" #11 [ffff880035779f48] kernel_thread_helper at ffffffff815ebaf4",
" ...\n",
NULL
};
char *help_ascii[] = {
"ascii",
"translate a hexadecimal string to ASCII",
"value ...",
" Translates 32-bit or 64-bit hexadecimal values to ASCII. If no argument",
" is entered, an ASCII chart is displayed.",
"\nEXAMPLES",
" Translate the hexadecimal value of 0x62696c2f7273752f to ASCII:",
"\n %s> ascii 62696c2f7273752f",
" 62696c2f7273752f: /usr/lib",
"\n Display an ASCII chart:",
"\n %s> ascii",
" ",
" 0 1 2 3 4 5 6 7",
" +-------------------------------",
" 0 | NUL DLE SP 0 @ P ' p",
" 1 | SOH DC1 ! 1 A Q a q",
" 2 | STX DC2 \" 2 B R b r",
" 3 | ETX DC3 # 3 C S c s",
" 4 | EOT DC4 $ 4 D T d t",
" 5 | ENQ NAK \% 5 E U e u",
" 6 | ACK SYN & 6 F V f v",
" 7 | BEL ETB ` 7 G W g w",
" 8 | BS CAN ( 8 H X h x",
" 9 | HT EM ) 9 I Y i y",
" A | LF SUB * : J Z j z",
" B | VT ESC + ; K [ k {",
" C | FF FS , < L \\ l |",
" D | CR GS _ = M ] m }",
" E | SO RS . > N ^ n ~",
" F | SI US / ? O - o DEL",
NULL
};
char *help_quit[] = {
"quit",
"exit this session",
" ",
" Bail out of the current %s session.",
"\nNOTE",
" This command is equivalent to the \"exit\" command.",
NULL
};
char *help_exit[] = {
"exit",
"exit this session",
" ",
" Bail out of the current %s session.",
"\nNOTE",
" This command is equivalent to the \"q\" command.",
NULL
};
char *help_help[] = {
"help",
"get help",
"[command | all] [-<option>]",
" When entered with no argument, a list of all currently available %s",
" commands is listed. If a name of a %s command is entered, a man-like",
" page for the command is displayed. If \"all\" is entered, help pages",
" for all commands will be displayed. If neither of the above is entered,",
" the argument string will be passed on to the gdb help command.",
" ",
" A number of internal debug, statistical, and other dumpfile related",
" data is available with the following options:",
" ",
" -a - alias data",
" -b - shared buffer data",
" -B - build data",
" -c - numargs cache",
" -d - device table",
" -D - dumpfile contents/statistics",
" -e - extension table data",
" -f - filesys table",
" -h - hash_table data",
" -H - hash_table data (verbose)",
" -k - kernel_table",
" -K - kernel_table (verbose)",
" -L - LKCD page cache environment",
" -M <num> machine specific",
" -m - machdep_table",
" -n - dumpfile contents/statistics",
" -o - offset_table and size_table",
" -p - program_context",
" -r - dump registers from dumpfile header",
" -s - symbol table data",
" -t - task_table",
" -T - task_table plus context_array",
" -v - vm_table",
" -V - vm_table (verbose)",
" -x - text cache",
NULL
};
char *help_set[] = {
"set",
"set a process context or internal %s variable",
"[[-a] [pid | taskp] | [-c cpu] | -p] | [%s_variable [setting]] | -v",
" This command either sets a new context, or gets the current context for",
" display. The context can be set by the use of:\n",
" pid a process PID.",
" taskp a hexadecimal task_struct pointer.",
" -a sets the pid or task as the active task on its cpu (dumpfiles only).",
" -c cpu sets the context to the active task on a cpu (dumpfiles only).",
" -p sets the context to the panic task, or back to the %s task on",
" a live system.",
" -v display the current state of internal %s variables.",
"",
" If no argument is entered, the current context is displayed. The context",
" consists of the PID, the task pointer, the CPU, and task state. The task",
" state shows the bits found in both the task_struct state and exit_state",
" fields.",
" ",
" This command may also be used to set internal %s variables. If no value",
" argument is entered, the current value of the %s variable is shown. These",
" are the %s variables, acceptable arguments, and purpose:\n",
" scroll on | off controls output scrolling.",
" scroll less /usr/bin/less as the output scrolling program.",
" scroll more /bin/more as the output scrolling program.",
" scroll CRASHPAGER use CRASHPAGER environment variable as the",
" output scrolling program.",
" radix 10 | 16 sets output radix to 10 or 16.",
" refresh on | off controls internal task list refresh.",
" print_max number set maximum number of array elements to print.",
" console device-name sets debug console device.",
" debug number sets %s debug level.",
" core on | off if on, drops core when the next error message",
" is displayed.",
" hash on | off controls internal list verification.",
" silent on | off turns off initialization messages; turns off",
" %s prompt during input file execution. ",
" (scrolling is turned off if silent is on)",
" edit vi | emacs set line editing mode (from .%src file only).",
" namelist filename name of kernel (from .%src file only).",
" zero_excluded on | off controls whether excluded pages from a dumpfile",
" should return zero-filled memory.",
" null-stop on | off if on, gdb's printing of character arrays will",
" stop at the first NULL encountered.",
" gdb on | off if on, the %s session will be run in a mode",
" where all commands will be passed directly to",
" gdb, and the command prompt will change to ",
" \"gdb>\"; when running in this mode, native %s",
" commands may be executed by preceding them with",
" the \"crash\" directive.",
" scope text-addr sets the text scope for viewing the definition",
" of data structures; the \"text-addr\" argument",
" must be a kernel or module text address, which",
" may be expressed symbolically or as a hexadecimal",
" value.",
" ",
" Internal variables may be set in four manners:\n",
" 1. entering the set command in $HOME/.%src.",
" 2. entering the set command in .%src in the current directory.",
" 3. executing an input file containing the set command.",
" 4. during runtime with this command.\n",
" During initialization, $HOME/.%src is read first, followed by the",
" .%src file in the current directory. Set commands in the .%src file",
" in the current directory override those in $HOME/.%src. Set commands ",
" entered with this command or by runtime input file override those",
" defined in either .%src file. Multiple set command arguments or argument",
" pairs may be entered in one command line.",
"\nEXAMPLES",
" Set the current context to task c2fe8000:\n",
" %s> set c2fe8000",
" PID: 15917",
" COMMAND: \"bash\"",
" TASK: c2fe8000 ",
" CPU: 0",
" STATE: TASK_INTERRUPTIBLE\n",
" Set the context back to the panicking task:\n",
" %s> set -p",
" PID: 698",
" COMMAND: \"gen12\"",
" TASK: f9d78000",
" CPU: 2",
" STATE: TASK_RUNNING (PANIC)\n",
" Turn off output scrolling:\n",
" %s> set scroll off",
" scroll: off (/usr/bin/less)",
" ",
" Show the current state of %s internal variables:\n",
" %s> set -v",
" scroll: on (/usr/bin/less)",
" radix: 10 (decimal)",
" refresh: on",
" print_max: 256",
" console: /dev/pts/2",
" debug: 0",
" core: off",
" hash: on",
" silent: off",
" edit: vi",
" namelist: vmlinux",
" zero_excluded: off",
" null-stop: on",
" gdb: off",
" scope: (not set)",
" ",
" Show the current context:\n",
" %s> set",
" PID: 1525",
" COMMAND: \"bash\"",
" TASK: c1ede000",
" CPU: 0",
" STATE: TASK_INTERRUPTIBLE\n",
NULL
};
char *help_p[] = {
"p",
"print the value of an expression",
"[-x|-d][-u] [expression | symbol[:cpuspec]]",
" This command passes its arguments on to gdb \"print\" command for evaluation.",
"",
" expression an expression to be evaluated.",
" symbol a kernel symbol.",
" :cpuspec CPU specification for a per-cpu symbol:",
" : CPU of the currently selected task.",
" :a[ll] all CPUs.",
" :#[-#][,...] CPU list(s), e.g. \"1,3,5\", \"1-3\",",
" or \"1,3,5-7,10\".",
" -x override default output format with hexadecimal format.",
" -d override default output format with decimal format.",
" -u the expression evaluates to a user address reference.",
"",
" The default output format is decimal, but that can be changed at any time",
" with the two built-in aliases \"hex\" and \"dec\". Alternatively, there",
" are two other built-in aliases, \"px\" and \"pd\", which force the command",
" output to be displayed in hexadecimal or decimal, without changing the",
" default mode. ",
"\nEXAMPLES",
" Print the contents of jiffies:\n",
" %s> p jiffies",
" jiffies = $6 = 166532620",
" %s> px jiffies",
" jiffies = $7 = 0x9ed174b",
" %s> pd jiffies",
" jiffies = $8 = 166533160",
" ",
" Print the contents of the vm_area_struct \"init_mm\":\n",
" %s> p init_mm",
" init_mm = $5 = {",
" mmap = 0xc022d540, ",
" mmap_avl = 0x0, ",
" mmap_cache = 0x0, ",
" pgd = 0xc0101000, ",
" count = {",
" counter = 0x6",
" }, ",
" map_count = 0x1, ",
" mmap_sem = {",
" count = {",
" counter = 0x1",
" }, ",
" waking = 0x0, ",
" wait = 0x0",
" }, ",
" context = 0x0, ",
" start_code = 0xc0000000, ",
" end_code = 0xc022b4c8, ",
" start_data = 0x0, ",
" end_data = 0xc0250388, ",
" start_brk = 0x0, ",
" brk = 0xc02928d8, ",
" start_stack = 0x0, ",
" arg_start = 0x0, ",
" arg_end = 0x0, ",
" env_start = 0x0, ",
" env_end = 0x0, ",
" rss = 0x0, ",
" total_vm = 0x0, ",
" locked_vm = 0x0, ",
" def_flags = 0x0, ",
" cpu_vm_mask = 0x0, ",
" swap_cnt = 0x0, ",
" swap_address = 0x0, ",
" segments = 0x0",
" }",
"",
" If a per-cpu symbol is entered as a argument, its data type",
" and all of its per-cpu addresses are displayed:",
" ",
" %s> p irq_stat",
" PER-CPU DATA TYPE:",
" irq_cpustat_t irq_stat;",
" PER-CPU ADDRESSES:",
" [0]: ffff88021e211540",
" [1]: ffff88021e251540",
" [2]: ffff88021e291540",
" [3]: ffff88021e2d1540",
" ",
" To display the contents a per-cpu symbol for CPU 1, append",
" a cpu-specifier:",
" ",
" %s> p irq_stat:1",
" per_cpu(irq_stat, 1) = $29 = {",
" __softirq_pending = 0, ",
" __nmi_count = 209034, ",
" apic_timer_irqs = 597509876, ",
" irq_spurious_count = 0, ",
" icr_read_retry_count = 2, ",
" x86_platform_ipis = 0, ",
" apic_perf_irqs = 209034, ",
" apic_irq_work_irqs = 0, ",
" irq_resched_count = 264922233, ",
" irq_call_count = 7036692, ",
" irq_tlb_count = 4750442, ",
" irq_thermal_count = 0, ",
" irq_threshold_count = 0",
" }",
" ",
NULL
};
char *help_ps[] = {
"ps",
"display process status information",
"[-k|-u|-G] [-s] [-p|-c|-t|-[l|m][-C cpu]|-a|-g|-r|-S]\n [pid | task | command] ...",
" This command displays process status for selected, or all, processes" ,
" in the system. If no arguments are entered, the process data is",
" is displayed for all processes. Specific processes may be selected",
" by using the following identifier formats:\n",
" pid a process PID.",
" task a hexadecimal task_struct pointer.",
" command a command name. If a command name is made up of letters that",
" are all numerical values, precede the name string with a \"\\\".",
" If the command string is enclosed within \"'\" characters, then",
" the encompassed string must be a POSIX extended regular expression",
" that will be used to match task names.",
" ",
" The process list may be further restricted by the following options:\n",
" -k restrict the output to only kernel threads.",
" -u restrict the output to only user tasks.",
" -G display only the thread group leader in a thread group.",
" ",
" The process identifier types may be mixed. For each task, the following",
" items are displayed:",
" ",
" 1. the process PID.",
" 2. the parent process PID.",
" 3. the CPU number that the task ran on last.",
" 4. the task_struct address or the kernel stack pointer of the process.",
" (see -s option below)",
" 5. the task state (RU, IN, UN, ZO, ST, TR, DE, SW).",
" 6. the percentage of physical memory being used by this task.",
" 7. the virtual address size of this task in kilobytes.",
" 8. the resident set size of this task in kilobytes.",
" 9. the command name.",
" ",
" The default output shows the task_struct address of each process under a",
" column titled \"TASK\". This can be changed to show the kernel stack ",
" pointer under a column titled \"KSTACKP\".",
" ",
" -s replace the TASK column with the KSTACKP column.",
" ",
" On SMP machines, the active task on each CPU will be highlighted by an",
" angle bracket (\">\") preceding its information.",
" ",
" Alternatively, information regarding parent-child relationships,",
" per-task time usage data, argument/environment data, thread groups,",
" or resource limits may be displayed:",
" ",
" -p display the parental hierarchy of selected, or all, tasks.",
" -c display the children of selected, or all, tasks.",
" -t display the task run time, start time, and cumulative user",
" and system times.",
" -l display the task last_run or timestamp value, whichever applies,",
" of selected, or all, tasks; the list is sorted with the most",
" recently-run task (largest last_run/timestamp) shown first,",
" followed by the task's current state.",
" -m similar to -l, but the timestamp value is translated into days,",
" hours, minutes, seconds, and milliseconds since the task was",
" last run on a cpu.",
" -C cpus only usable with the -l or -m options, dump the timestamp data",
" in per-cpu blocks, where the cpu[s] can be specified as \"1,3,5\",",
" \"1-3\", \"1,3,5-7,10\", \"all\", or \"a\" (shortcut for \"all\").",
" -a display the command line arguments and environment strings of",
" selected, or all, user-mode tasks.",
" -g display tasks by thread group, of selected, or all, tasks.",
" -r display resource limits (rlimits) of selected, or all, tasks.",
" -S display a summary consisting of the number of tasks in a task state.",
"\nEXAMPLES",
" Show the process status of all current tasks:\n",
" %s> ps",
" PID PPID CPU TASK ST %MEM VSZ RSS COMM",
" > 0 0 3 c024c000 RU 0.0 0 0 [swapper]",
" > 0 0 0 c0dce000 RU 0.0 0 0 [swapper]",
" 0 0 1 c0fa8000 RU 0.0 0 0 [swapper]",
" > 0 0 2 c009a000 RU 0.0 0 0 [swapper]",
" 1 0 1 c0098000 IN 0.0 1096 476 init",
" 2 1 1 c0090000 IN 0.0 0 0 [kflushd]",
" 3 1 1 c000e000 IN 0.0 0 0 [kpiod]",
" 4 1 3 c000c000 IN 0.0 0 0 [kswapd]",
" 5 1 1 c0008000 IN 0.0 0 0 [mdrecoveryd]",
" 253 1 2 fbc4c000 IN 0.0 1088 376 portmap",
" 268 1 2 fbc82000 IN 0.1 1232 504 ypbind",
" 274 268 2 fa984000 IN 0.1 1260 556 ypbind",
" 321 1 1 fabf6000 IN 0.1 1264 608 syslogd",
" 332 1 1 fa9be000 RU 0.1 1364 736 klogd",
" 346 1 2 fae88000 IN 0.0 1112 472 atd",
" 360 1 2 faeb2000 IN 0.1 1284 592 crond",
" 378 1 2 fafd6000 IN 0.1 1236 560 inetd",
" 392 1 0 fb710000 IN 0.1 2264 1468 named",
" 406 1 3 fb768000 IN 0.1 1284 560 lpd",
" 423 1 1 fb8ac000 IN 0.1 1128 528 rpc.statd",
" 434 1 2 fb75a000 IN 0.0 1072 376 rpc.rquotad",
" 445 1 2 fb4a4000 IN 0.0 1132 456 rpc.mountd",
" 460 1 1 fa938000 IN 0.0 0 0 [nfsd]",
" 461 1 1 faa86000 IN 0.0 0 0 [nfsd]",
" 462 1 0 fac48000 IN 0.0 0 0 [nfsd]",
" 463 1 0 fb4ca000 IN 0.0 0 0 [nfsd]",
" 464 1 0 fb4c8000 IN 0.0 0 0 [nfsd]",
" 465 1 2 fba6e000 IN 0.0 0 0 [nfsd]",
" 466 1 1 fba6c000 IN 0.0 0 0 [nfsd]",
" 467 1 2 fac04000 IN 0.0 0 0 [nfsd]",
" 468 461 2 fa93a000 IN 0.0 0 0 [lockd]",
" 469 468 2 fa93e000 IN 0.0 0 0 [rpciod]",
" 486 1 0 fab54000 IN 0.1 1596 880 amd",
" 523 1 2 fa84e000 IN 0.1 1884 1128 sendmail",
" 538 1 0 fa82c000 IN 0.0 1112 416 gpm",
" 552 1 3 fa70a000 IN 0.1 2384 1220 httpd",
" 556 552 3 fa776000 IN 0.1 2572 1352 httpd",
" 557 552 2 faba4000 IN 0.1 2572 1352 httpd",
" 558 552 1 fa802000 IN 0.1 2572 1352 httpd",
" 559 552 3 fa6ee000 IN 0.1 2572 1352 httpd",
" 560 552 3 fa700000 IN 0.1 2572 1352 httpd",
" 561 552 0 fa6f0000 IN 0.1 2572 1352 httpd",
" 562 552 3 fa6ea000 IN 0.1 2572 1352 httpd",
" 563 552 0 fa67c000 IN 0.1 2572 1352 httpd",
" 564 552 3 fa674000 IN 0.1 2572 1352 httpd",
" 565 552 3 fa66a000 IN 0.1 2572 1352 httpd",
" 582 1 2 fa402000 IN 0.2 2968 1916 xfs",
" 633 1 2 fa1ec000 IN 0.2 5512 2248 innd",
" 636 1 3 fa088000 IN 0.1 2536 804 actived",
" 676 1 0 fa840000 IN 0.0 1060 384 mingetty",
" 677 1 1 fa590000 IN 0.0 1060 384 mingetty",
" 678 1 2 fa3b8000 IN 0.0 1060 384 mingetty",
" 679 1 0 fa5b8000 IN 0.0 1060 384 mingetty",
" 680 1 1 fa3a4000 IN 0.0 1060 384 mingetty",
" 681 1 2 fa30a000 IN 0.0 1060 384 mingetty",
" 683 1 3 fa5d8000 IN 0.0 1052 280 update",
" 686 378 1 fa3aa000 IN 0.1 2320 1136 in.rlogind",
" 687 686 2 f9e52000 IN 0.1 2136 1000 login",
" 688 687 0 f9dec000 IN 0.1 1732 976 bash",
" > 700 688 1 f9d62000 RU 0.0 1048 256 gen12",
" ",
" Display the parental hierarchy of the \"%s\" process on a live system:\n",
" %s> ps -p 4249",
" PID: 0 TASK: c0252000 CPU: 0 COMMAND: \"swapper\"",
" PID: 1 TASK: c009a000 CPU: 1 COMMAND: \"init\"",
" PID: 632 TASK: c73b6000 CPU: 1 COMMAND: \"prefdm\"",
" PID: 637 TASK: c5a4a000 CPU: 1 COMMAND: \"prefdm\"",
" PID: 649 TASK: c179a000 CPU: 0 COMMAND: \"kwm\"",
" PID: 683 TASK: c1164000 CPU: 0 COMMAND: \"kfm\"",
" PID: 1186 TASK: c165a000 CPU: 0 COMMAND: \"xterm\"",
" PID: 1188 TASK: c705e000 CPU: 1 COMMAND: \"bash\"",
" PID: 4249 TASK: c6b9a000 CPU: 0 COMMAND: \"crash\"",
" ",
" Display all children of the \"kwm\" window manager:\n",
" %s> ps -c kwm",
" PID: 649 TASK: c179a000 CPU: 0 COMMAND: \"kwm\"",
" PID: 682 TASK: c2d58000 CPU: 1 COMMAND: \"kwmsound\"",
" PID: 683 TASK: c1164000 CPU: 1 COMMAND: \"kfm\"",
" PID: 685 TASK: c053c000 CPU: 0 COMMAND: \"krootwm\"",
" PID: 686 TASK: c13fa000 CPU: 0 COMMAND: \"kpanel\"",
" PID: 687 TASK: c13f0000 CPU: 1 COMMAND: \"kbgndwm\"",
" ",
" Display all threads in a firefox session:\n",
" %s> ps firefox",
" PID PPID CPU TASK ST %MEM VSZ RSS COMM",
" 21273 21256 6 ffff81003ec15080 IN 46.3 1138276 484364 firefox",
" 21276 21256 6 ffff81003f49e7e0 IN 46.3 1138276 484364 firefox",
" 21280 21256 0 ffff81003ec1d7e0 IN 46.3 1138276 484364 firefox",
" 21286 21256 6 ffff81000b0d1820 IN 46.3 1138276 484364 firefox",
" 21287 21256 2 ffff81000b0d10c0 IN 46.3 1138276 484364 firefox",
" 26975 21256 5 ffff81003b5c1820 IN 46.3 1138276 484364 firefox",
" 26976 21256 5 ffff810023232820 IN 46.3 1138276 484364 firefox",
" 26977 21256 4 ffff810021a11820 IN 46.3 1138276 484364 firefox",
" 26978 21256 5 ffff810003159040 IN 46.3 1138276 484364 firefox",
" 26979 21256 5 ffff81003a058820 IN 46.3 1138276 484364 firefox",
" ",
" Display only the thread group leader in the firefox session:\n",
" %s> ps -G firefox",
" PID PPID CPU TASK ST %MEM VSZ RSS COMM",
" 21273 21256 0 ffff81003ec15080 IN 46.3 1138276 484364 firefox",
" ",
" Show the time usage data for pid 10318:\n",
" %s> ps -t 10318",
" PID: 10318 TASK: f7b85550 CPU: 5 COMMAND: \"bash\"",
" RUN TIME: 1 days, 01:35:32",
" START TIME: 5209",
" UTIME: 95",
" STIME: 57",
" ",
" Show the process status of PID 1, task f9dec000, and all nfsd tasks:\n",
" %s> ps 1 f9dec000 nfsd",
" PID PPID CPU TASK ST %MEM VSZ RSS COMM",
" 1 0 1 c0098000 IN 0.0 1096 476 init",
" 688 687 0 f9dec000 IN 0.1 1732 976 bash",
" 460 1 1 fa938000 IN 0.0 0 0 [nfsd]",
" 461 1 1 faa86000 IN 0.0 0 0 [nfsd]",
" 462 1 0 fac48000 IN 0.0 0 0 [nfsd]",
" 463 1 0 fb4ca000 IN 0.0 0 0 [nfsd]",
" 464 1 0 fb4c8000 IN 0.0 0 0 [nfsd]",
" 465 1 2 fba6e000 IN 0.0 0 0 [nfsd]",
" 466 1 1 fba6c000 IN 0.0 0 0 [nfsd]",
" 467 1 2 fac04000 IN 0.0 0 0 [nfsd]",
" ",
" Show all kernel threads:\n",
" %s> ps -k",
" PID PPID CPU TASK ST %MEM VSZ RSS COMM",
" 0 0 1 c0fac000 RU 0.0 0 0 [swapper]",
" 0 0 0 c0252000 RU 0.0 0 0 [swapper]",
" 2 1 1 c0fa0000 IN 0.0 0 0 [kflushd]",
" 3 1 1 c03de000 IN 0.0 0 0 [kpiod]",
" 4 1 1 c03dc000 IN 0.0 0 0 [kswapd]",
" 5 1 0 c0092000 IN 0.0 0 0 [mdrecoveryd]",
" 336 1 0 c4a9a000 IN 0.0 0 0 [rpciod]",
" 337 1 0 c4830000 IN 0.0 0 0 [lockd]",
" 487 1 1 c4ba6000 IN 0.0 0 0 [nfsd]",
" 488 1 0 c18c6000 IN 0.0 0 0 [nfsd]",
" 489 1 0 c0cac000 IN 0.0 0 0 [nfsd]",
" 490 1 0 c056a000 IN 0.0 0 0 [nfsd]",
" 491 1 0 c0860000 IN 0.0 0 0 [nfsd]",
" 492 1 1 c0254000 IN 0.0 0 0 [nfsd]",
" 493 1 0 c0a86000 IN 0.0 0 0 [nfsd]",
" 494 1 0 c0968000 IN 0.0 0 0 [nfsd]",
" ",
" Display a summary consisting of the number of tasks in a task state:\n",
" %s> ps -S",
" RU: 5",
" IN: 259",
" UN: 31",
" ZO: 1",
" ",
" Show all tasks sorted by their task_struct's last_run or timestamp value,",
" whichever applies:\n",
" %s> ps -l",
" [20811245123] [IN] PID: 37 TASK: f7153030 CPU: 2 COMMAND: \"events/2\"",
" [20811229959] [IN] PID: 1756 TASK: f2a5a570 CPU: 2 COMMAND: \"ntpd\"",
" [20800696644] [IN] PID: 1456 TASK: f2b1f030 CPU: 4 COMMAND: \"irqbalance\"",
" [20617047229] [IN] PID: 2324 TASK: f57f9570 CPU: 5 COMMAND: \"flush-253:0\"",
" [20617029209] [IN] PID: 49 TASK: f7167030 CPU: 4 COMMAND: \"bdi-default\"",
" [20438025365] [IN] PID: 345 TASK: f55c7ab0 CPU: 3 COMMAND: \"mpt_poll_0\"",
" [20103026046] [IN] PID: 728 TASK: f72ba570 CPU: 3 COMMAND: \"edac-poller\"",
" [20000189409] [IN] PID: 35 TASK: f7153ab0 CPU: 0 COMMAND: \"events/0\"",
" [20000179905] [IN] PID: 48 TASK: f7167570 CPU: 0 COMMAND: \"sync_supers\"",
" [19997120354] [IN] PID: 36 TASK: f7153570 CPU: 1 COMMAND: \"events/1\"",
" [19991059209] [IN] PID: 38 TASK: f715fab0 CPU: 3 COMMAND: \"events/3\"",
" [19988091608] [IN] PID: 39 TASK: f715f570 CPU: 4 COMMAND: \"events/4\"",
" [19985076530] [IN] PID: 40 TASK: f715f030 CPU: 5 COMMAND: \"events/5\"",
" [19982019106] [IN] PID: 41 TASK: f7161ab0 CPU: 6 COMMAND: \"events/6\"",
" [19982016294] [IN] PID: 29 TASK: f7109ab0 CPU: 6 COMMAND: \"ksoftirqd/6\"",
" [19838402345] [RU] PID: 2331 TASK: f297f570 CPU: 7 COMMAND: \"bash\"",
" [19837129436] [IN] PID: 2326 TASK: f2ad5030 CPU: 6 COMMAND: \"sshd\"",
" [19289476417] [IN] PID: 1772 TASK: f5665570 CPU: 5 COMMAND: \"sendmail\"",
" ...\n",
" Show the most-recently run tasks on cpu 0 using both the -l and the -m",
" options:\n",
" %s> ps -m -C0",
" CPU: 0",
" [ 0 00:00:00.003] [RU] PID: 1205 TASK: dee03f20 CPU: 0 COMMAND: \"insmod\"",
" [ 0 00:00:00.006] [RU] PID: 770 TASK: df9e9940 CPU: 0 COMMAND: \"rsyslogd\"",
" [ 0 00:00:00.009] [IN] PID: 603 TASK: df9bcbc0 CPU: 0 COMMAND: \"udevd\"",
" [ 0 00:00:00.010] [IN] PID: 348 TASK: df9ecbc0 CPU: 0 COMMAND: \"udevd\"",
" [ 0 00:00:00.013] [IN] PID: 934 TASK: df9171a0 CPU: 0 COMMAND: \"hald\"",
" [ 0 00:00:00.023] [IN] PID: 6 TASK: df443f20 CPU: 0 COMMAND: \"events/0\"",
" [ 0 00:00:00.029] [IN] PID: 15 TASK: df46b280 CPU: 0 COMMAND: \"kblockd/0\"",
" [ 0 00:00:00.101] [IN] PID: 1168 TASK: dee01940 CPU: 0 COMMAND: \"bash\"",
" [ 0 00:00:01.404] [IN] PID: 272 TASK: dfa48ca0 CPU: 0 COMMAND: \"flush-8:0\"",
" ...",
" ",
" %s> ps -l -C0",
" CPU: 0",
" [137146164748] [RU] PID: 1205 TASK: dee03f20 CPU: 0 COMMAND: \"insmod\"",
" [137142534372] [RU] PID: 770 TASK: df9e9940 CPU: 0 COMMAND: \"rsyslogd\"",
" [137140168469] [IN] PID: 603 TASK: df9bcbc0 CPU: 0 COMMAND: \"udevd\"",
" [137138826427] [IN] PID: 348 TASK: df9ecbc0 CPU: 0 COMMAND: \"udevd\"",
" [137135214599] [IN] PID: 934 TASK: df9171a0 CPU: 0 COMMAND: \"hald\"",
" [137125651275] [IN] PID: 6 TASK: df443f20 CPU: 0 COMMAND: \"events/0\"",
" [137119564815] [IN] PID: 15 TASK: df46b280 CPU: 0 COMMAND: \"kblockd/0\"",
" [137047715027] [IN] PID: 1168 TASK: dee01940 CPU: 0 COMMAND: \"bash\"",
" [135744209052] [IN] PID: 272 TASK: dfa48ca0 CPU: 0 COMMAND: \"flush-8:0\"",
" ... ",
" ",
" Show the kernel stack pointer of each user task:\n",
" %s> ps -us",
" PID PPID CPU KSTACKP ST %MEM VSZ RSS COMM",
" 1 0 0 c009bedc IN 0.0 1096 52 init",
" 239 1 0 c15e7ed8 IN 0.2 1332 224 pump",
" 280 1 1 c7cbdedc IN 0.2 1092 208 portmap",
" 295 1 0 c7481edc IN 0.0 1232 0 ypbind",
" 301 295 0 c7c7bf28 IN 0.1 1260 124 ypbind",
" 376 1 1 c5053f28 IN 0.0 1316 40 automount",
" 381 1 0 c34ddf28 IN 0.2 1316 224 automount",
" 391 1 1 c2777f28 IN 0.2 1316 224 automount",
" ...",
" ",
" Display the argument and environment data for the automount task:\n",
" %s> ps -a automount",
" PID: 3948 TASK: f722ee30 CPU: 0 COMMAND: \"automount\"",
" ARG: /usr/sbin/automount --timeout=60 /net program /etc/auto.net",
" ENV: SELINUX_INIT=YES",
" CONSOLE=/dev/console",
" TERM=linux",
" INIT_VERSION=sysvinit-2.85",
" PATH=/sbin:/usr/sbin:/bin:/usr/bin",
" LC_MESSAGES=en_US",
" RUNLEVEL=3",
" runlevel=3",
" PWD=/",
" LANG=ja_JP.UTF-8",
" PREVLEVEL=N",
" previous=N",
" HOME=/",
" SHLVL=2",
" _=/usr/sbin/automount",
" ",
" Display the tasks in the thread group containing task c20ab0b0:\n",
" %s> ps -g c20ab0b0",
" PID: 6425 TASK: f72f50b0 CPU: 0 COMMAND: \"firefox-bin\"",
" PID: 6516 TASK: f71bf1b0 CPU: 0 COMMAND: \"firefox-bin\"",
" PID: 6518 TASK: d394b930 CPU: 0 COMMAND: \"firefox-bin\"",
" PID: 6520 TASK: c20aa030 CPU: 0 COMMAND: \"firefox-bin\"",
" PID: 6523 TASK: c20ab0b0 CPU: 0 COMMAND: \"firefox-bin\"",
" PID: 6614 TASK: f1f181b0 CPU: 0 COMMAND: \"firefox-bin\"",
" ",
" Display the tasks in the thread group for each instance of the",
" program named \"multi-thread\":\n",
" %s> ps -g multi-thread",
" PID: 2522 TASK: 1003f0dc7f0 CPU: 1 COMMAND: \"multi-thread\"",
" PID: 2523 TASK: 10037b13030 CPU: 1 COMMAND: \"multi-thread\"",
" PID: 2524 TASK: 1003e064030 CPU: 1 COMMAND: \"multi-thread\"",
" PID: 2525 TASK: 1003e13a7f0 CPU: 1 COMMAND: \"multi-thread\"",
" ",
" PID: 2526 TASK: 1002f82b7f0 CPU: 1 COMMAND: \"multi-thread\"",
" PID: 2527 TASK: 1003e1737f0 CPU: 1 COMMAND: \"multi-thread\"",
" PID: 2528 TASK: 10035b4b7f0 CPU: 1 COMMAND: \"multi-thread\"",
" PID: 2529 TASK: 1003f0c37f0 CPU: 1 COMMAND: \"multi-thread\"",
" PID: 2530 TASK: 10035597030 CPU: 1 COMMAND: \"multi-thread\"",
" PID: 2531 TASK: 100184be7f0 CPU: 1 COMMAND: \"multi-thread\"",
" ",
" Display the resource limits of \"bash\" task 13896:\n",
" %s> ps -r 13896",
" PID: 13896 TASK: cf402000 CPU: 0 COMMAND: \"bash\"",
" RLIMIT CURRENT MAXIMUM",
" CPU (unlimited) (unlimited)",
" FSIZE (unlimited) (unlimited)",
" DATA (unlimited) (unlimited)",
" STACK 10485760 (unlimited)",
" CORE (unlimited) (unlimited)",
" RSS (unlimited) (unlimited)",
" NPROC 4091 4091",
" NOFILE 1024 1024",
" MEMLOCK 4096 4096",
" AS (unlimited) (unlimited)",
" LOCKS (unlimited) (unlimited)",
" ",
" Search for task names matching a POSIX regular expression:\n",
" %s> ps 'migration*'",
" PID PPID CPU TASK ST %MEM VSZ RSS COMM",
" 8 2 0 ffff8802128a2e20 IN 0.0 0 0 [migration/0]",
" 10 2 1 ffff880212969710 IN 0.0 0 0 [migration/1]",
" 15 2 2 ffff880212989710 IN 0.0 0 0 [migration/2]",
" 20 2 3 ffff8802129a9710 IN 0.0 0 0 [migration/3]",
NULL
};
char *help_rd[] = {
"rd",
"read memory",
"[-adDsSupxmfN][-8|-16|-32|-64][-o offs][-e addr][-r file][address|symbol]\n"
" [count]",
" This command displays the contents of memory, with the output formatted",
" in several different manners. The starting address may be entered either",
" symbolically or by address. The default output size is the size of a long",
" data type, and the default output format is hexadecimal. When hexadecimal",
" output is used, the output will be accompanied by an ASCII translation.\n",
" -p address argument is a physical address.",
" -u address argument is a user virtual address; only required on",
" processors with common user and kernel virtual address spaces.",
" -m address argument is a xen host machine address.",
" -f address argument is a dumpfile offset.",
" -d display output in signed decimal format (default is hexadecimal).",
" -D display output in unsigned decimal format (default is hexadecimal).",
" -s displays output symbolically when appropriate.",
" -S[S] displays output symbolically when appropriate; if the memory",
" contents reference a slab cache object, the name of the slab cache",
" will be displayed in brackets. If -S is entered twice, and the",
" memory contents reference a slab cache object, both the memory",
" contents and the name of the slab cache will be displayed in",
" brackets.",
" -x do not display ASCII translation at end of each line.",
#ifdef NOTDEF
" -o Shows offset value from the starting address.",
#endif
" -8 display output in 8-bit values.",
" -16 display output in 16-bit values.",
" -32 display output in 32-bit values (default on 32-bit machines).",
" -64 display output in 64-bit values (default on 64-bit machines).",
" -a display output in ASCII characters if the memory contains printable",
" ASCII characters; if no count argument is entered, stop at the first",
" non-printable character.",
" -N display output in network byte order (only valid for 16- and 32-bit",
" values)",
" -o offs offset the starting address by offs.",
" -e addr display memory until reaching specified ending hexadecimal address.",
" -r file dumps raw data to the specified output file; the number of bytes that",
" are copied to the file must be specified either by a count argument",
" or by the -e option.",
" address starting hexadecimal address:",
" 1 the default presumes a kernel virtual address.",
" 2. -p specifies a physical address.",
" 3. -u specifies a user virtual address, but is only necessary on",
" processors with common user and kernel virtual address spaces.",
" symbol symbol of starting address to read.",
" count number of memory locations to display; if entered, it must be the",
" last argument on the command line; if not entered, the count defaults",
" to 1, or unlimited for -a; when used with the -r option, it is the",
" number of bytes to be written to the file.",
"\nEXAMPLES",
" Display the kernel's version string:\n",
" %s> rd -a linux_banner",
" c082a020: Linux version 2.6.32-119.el6.i686 (mockbuild@hs20-bc2-4.buil",
" c082a05c: d.redhat.com) (gcc version 4.4.4 20100726 (Red Hat 4.4.4-13)",
" c082a098: (GCC) ) #1 SMP Tue Mar 1 18:16:57 EST 2011",
"",
" Display the same block of memory, first without symbols, again",
" with symbols, and then with symbols and slab cache references:\n",
" %s> rd f6e31f70 28",
" f6e31f70: f6e31f6c f779c180 c04a4032 00a9dd40 l.....y.2@J.@...",
" f6e31f80: 00000fff c0472da0 f6e31fa4 f779c180 .....-G.......y.",
" f6e31f90: fffffff7 00a9b70f f6e31000 c04731ee .............1G.",
" f6e31fa0: f6e31fa4 00000000 00000000 00000000 ................",
" f6e31fb0: 00000000 00a9dd40 c0404f17 00000000 ....@....O@.....",
" f6e31fc0: 00a9dd40 00000fff 00a9dd40 00a9b70f @.......@.......",
" f6e31fd0: bf9e2718 ffffffda c040007b 0000007b .'......{.@.{...",
" %s> rd -s f6e31f70 28",
" f6e31f70: f6e31f6c f779c180 kmsg_read 00a9dd40 ",
" f6e31f80: 00000fff vfs_read+159 f6e31fa4 f779c180 ",
" f6e31f90: fffffff7 00a9b70f f6e31000 sys_read+60 ",
" f6e31fa0: f6e31fa4 00000000 00000000 00000000 ",
" f6e31fb0: 00000000 00a9dd40 syscall_call+7 00000000 ",
" f6e31fc0: 00a9dd40 00000fff 00a9dd40 00a9b70f ",
" f6e31fd0: bf9e2718 ffffffda startup_32+123 0000007b ",
" %s> rd -S f6e31f70 28",
" f6e31f70: [size-4096] [filp] kmsg_read 00a9dd40 ",
" f6e31f80: 00000fff vfs_read+159 [size-4096] [filp] ",
" f6e31f90: fffffff7 00a9b70f [size-4096] sys_read+60 ",
" f6e31fa0: [size-4096] 00000000 00000000 00000000 ",
" f6e31fb0: 00000000 00a9dd40 syscall_call+7 00000000 ",
" f6e31fc0: 00a9dd40 00000fff 00a9dd40 00a9b70f ",
" f6e31fd0: bf9e2718 ffffffda startup_32+123 0000007b ",
" %s> rd -SS f6e31f70 28",
" f6e31f70: [f6e31f6c:size-4096] [f779c180:filp] kmsg_read 00a9dd40 ",
" f6e31f80: 00000fff vfs_read+159 [f6e31fa4:size-4096] [f779c180:filp] ",
" f6e31f90: fffffff7 00a9b70f [f6e31000:size-4096] sys_read+60 ",
" f6e31fa0: [f6e31fa4:size-4096] 00000000 00000000 00000000 ",
" f6e31fb0: 00000000 00a9dd40 syscall_call+7 00000000 ",
" f6e31fc0: 00a9dd40 00000fff 00a9dd40 00a9b70f ",
" f6e31fd0: bf9e2718 ffffffda startup_32+123 0000007b ",
"",
" Read jiffies in hexadecimal and decimal format:\n",
" %s> rd jiffies",
" c0213ae0: 0008cc3a :...\n",
" %s> rd -d jiffies",
" c0213ae0: 577376\n",
" Access the same memory in different sizes:\n",
" %s> rd -64 kernel_version",
" c0226a6c: 35312d352e322e32 2.2.5-15\n",
" %s> rd -32 kernel_version 2",
" c0226a6c: 2e322e32 35312d35 2.2.5-15\n",
" %s> rd -16 kernel_version 4",
" c0226a6c: 2e32 2e32 2d35 3531 2.2.5-15\n",
" %s> rd -8 kernel_version 8 ",
" c0226a6c: 32 2e 32 2e 35 2d 31 35 2.2.5-15",
"\n Read the range of memory from c009bf2c to c009bf60:\n",
" %s> rd c009bf2c -e c009bf60",
" c009bf2c: c009bf64 c01328c3 c009bf64 c0132838 d....(..d...8(..",
" c009bf3c: 0000002a 00000004 c57d77e8 00000104 *........w}.....",
" c009bf4c: 0000000b c009a000 7fffffff 00000000 ................",
" c009bf5c: 00000000 ....",
NULL
};
char *help_wr[] = {
"wr",
"write memory",
"[-u|-k|-p] [-8|-16|-32|-64] [address|symbol] value",
" This command modifies the contents of memory. The starting address may be",
" entered either symbolically or by address. The default modification size ",
" is the size of a long data type. Write permission must exist on the",
" /dev/mem. When writing to memory on a live system, this command should ",
" obviously be used with great care.\n",
" -u address argument is a user virtual address.",
" -k address argument is a kernel virtual address.",
" -p address argument is a physical address.",
" -8 write data in an 8-bit value.",
" -16 write data in a 16-bit value.",
" -32 write data in a 32-bit values (default on 32-bit machines).",
" -64 write data in a 64-bit values (default on 64-bit machines).",
" address address to write. The address is considered virtual unless the",
" -p option is used. If a virtual address is specified, the",
" -u or -k options are necessary only if the address space cannot",
" be determined from the address value itself. If a user virtual",
" address is specified, the address space of the current context",
" implied. The address must be expressed in hexadecimal format.",
" symbol symbol of starting address to write.",
" value the value of the data to write.",
"\nEXAMPLES",
" Turn on a debug flag:\n",
" %s> wr my_debug_flag 1",
NULL
};
char *help_bt[] = {
"bt",
"backtrace",
"[-a|-c cpu(s)|-g|-r|-t|-T|-l|-e|-E|-f|-F|-o|-O] [-R ref] [-s [-x|d]]"
"\n [-I ip] [-S sp] [pid | task]",
" Display a kernel stack backtrace. If no arguments are given, the stack",
" trace of the current context will be displayed.\n",
" -a displays the stack traces of the active task on each CPU.",
" (only applicable to crash dumps)",
" -c cpu display the stack trace of the active task on one or more CPUs,",
" which can be specified using the format \"3\", \"1,8,9\", \"1-23\",",
" or \"1,8,9-14\". (only applicable to crash dumps)",
#ifdef GDB_5_3
" -g use gdb stack trace code. (alpha only)",
#else
" -g displays the stack traces of all threads in the thread group of",
#endif
" the target task; the thread group leader will be displayed first.",
" -r display raw stack data, consisting of a memory dump of the two",
" pages of memory containing the task_union structure.",
" -t display all text symbols found from the last known stack location",
" to the top of the stack. (helpful if the back trace fails)",
" -T display all text symbols found from just above the task_struct or",
" thread_info to the top of the stack. (helpful if the back trace",
" fails or the -t option starts too high in the process stack).",
" -l show file and line number of each stack trace text location.",
" -e search the stack for possible kernel and user mode exception frames.",
" -E search the IRQ stacks (x86, x86_64 and ppc64), and the exception",
" stacks (x86_64) for possible exception frames; all other arguments",
" will be ignored since this is not a context-sensitive operation.",
" -f display all stack data contained in a frame; this option can be",
" used to determine the arguments passed to each function; on ia64,",
" the argument register contents are dumped.",
" -F[F] similar to -f, except that the stack data is displayed symbolically",
" when appropriate; if the stack data references a slab cache object,",
" the name of the slab cache will be displayed in brackets; on ia64,",
" the substitution is done to the argument register contents. If -F",
" is entered twice, and the stack data references a slab cache object,",
" both the address and the name of the slab cache will be displayed",
" in brackets.",
" -o x86: use old backtrace method, permissible only on kernels that were",
" compiled without the -fomit-frame_pointer.",
" x86_64: use old backtrace method, which dumps potentially stale",
" kernel text return addresses found on the stack.",
" -O x86: use old backtrace method by default, permissible only on kernels",
" that were compiled without the -fomit-frame_pointer; subsequent usage",
" of this option toggles the backtrace method.",
" x86_64: use old backtrace method by default; subsequent usage of this",
" option toggles the backtrace method.",
" -R ref display stack trace only if there is a reference to this symbol",
" or text address.",
" -s display the symbol name plus its offset.",
" -x when displaying a symbol offset with the -s option, override the",
" default output format with hexadecimal format.",
" -d when displaying a symbol offset with the -s option, override the",
" default output format with decimal format.",
" -I ip use ip as the starting text location.",
" -S sp use sp as the starting stack frame address.",
" pid displays the stack trace(s) of this pid.",
" taskp displays the stack trace the the task referenced by this hexadecimal",
" task_struct pointer.\n",
" Multiple pid and taskp arguments may be specified.\n",
" Note that all examples below are for x86 only. The output format will differ",
" for other architectures. x86 backtraces from kernels that were compiled",
" with the --fomit-frame-pointer CFLAG occasionally will drop stack frames,",
" or display a stale frame reference. When in doubt as to the accuracy of a",
" backtrace, the -t or -T options may help fill in the blanks.\n",
"EXAMPLES",
" Display the stack trace of the active task(s) when the kernel panicked:\n",
" %s> bt -a",
" PID: 286 TASK: c0b3a000 CPU: 0 COMMAND: \"in.rlogind\"",
" #0 [c0b3be90] crash_save_current_state at c011aed0",
" #1 [c0b3bea4] panic at c011367c",
" #2 [c0b3bee8] tulip_interrupt at c01bc820",
" #3 [c0b3bf08] handle_IRQ_event at c010a551",
" #4 [c0b3bf2c] do_8259A_IRQ at c010a319",
" #5 [c0b3bf3c] do_IRQ at c010a653",
" #6 [c0b3bfbc] ret_from_intr at c0109634",
" EAX: 00000000 EBX: c0e68280 ECX: 00000000 EDX: 00000004 EBP: c0b3bfbc",
" DS: 0018 ESI: 00000004 ES: 0018 EDI: c0e68284 ",
" CS: 0010 EIP: c012f803 ERR: ffffff09 EFLAGS: 00000246 ",
" #7 [c0b3bfbc] sys_select at c012f803",
" #8 [c0b3bfc0] system_call at c0109598",
" EAX: 0000008e EBX: 00000004 ECX: bfffc9a0 EDX: 00000000 ",
" DS: 002b ESI: bfffc8a0 ES: 002b EDI: 00000000 ",
" SS: 002b ESP: bfffc82c EBP: bfffd224 ",
" CS: 0023 EIP: 400d032e ERR: 0000008e EFLAGS: 00000246 ",
"\n Display the stack trace of the active task on CPU 0 and 1:\n",
" %s> bt -c 0,1",
" PID: 0 TASK: ffffffff81a8d020 CPU: 0 COMMAND: \"swapper\"",
" #0 [ffff880002207e90] crash_nmi_callback at ffffffff8102fee6",
" #1 [ffff880002207ea0] notifier_call_chain at ffffffff8152d525",
" #2 [ffff880002207ee0] atomic_notifier_call_chain at ffffffff8152d58a",
" #3 [ffff880002207ef0] notify_die at ffffffff810a155e",
" #4 [ffff880002207f20] do_nmi at ffffffff8152b1eb",
" #5 [ffff880002207f50] nmi at ffffffff8152aab0",
" [exception RIP: native_safe_halt+0xb]",
" RIP: ffffffff8103eacb RSP: ffffffff81a01ea8 RFLAGS: 00000296",
" RAX: 0000000000000000 RBX: 0000000000000000 RCX: 0000000000000000",
" RDX: 0000000000000000 RSI: 0000000000000001 RDI: ffffffff81de5228",
" RBP: ffffffff81a01ea8 R8: 0000000000000000 R9: 0000000000000000",
" R10: 0012099429a6bea3 R11: 0000000000000000 R12: ffffffff81c066c0",
" R13: 0000000000000000 R14: ffffffffffffffff R15: ffffffff81de1000",
" ORIG_RAX: ffffffffffffffff CS: 0010 SS: 0018",
" --- <NMI exception stack> ---",
" #6 [ffffffff81a01ea8] native_safe_halt at ffffffff8103eacb",
" #7 [ffffffff81a01eb0] default_idle at ffffffff810167bd",
" #8 [ffffffff81a01ed0] cpu_idle at ffffffff81009fc6",
" ",
" PID: 38 TASK: ffff88003eaae040 CPU: 1 COMMAND: \"khungtaskd\"",
" #0 [ffff88003ad97ce8] machine_kexec at ffffffff81038f3b",
" #1 [ffff88003ad97d48] crash_kexec at ffffffff810c5da2",
" #2 [ffff88003ad97e18] panic at ffffffff8152721a",
" #3 [ffff88003ad97e98] watchdog at ffffffff810e6346",
" #4 [ffff88003ad97ee8] kthread at ffffffff8109af06",
" #5 [ffff88003ad97f48] kernel_thread at ffffffff8100c20a",
"\n Display the stack traces of task f2814000 and PID 1592:\n",
" %s> bt f2814000 1592",
" PID: 1018 TASK: f2814000 CPU: 1 COMMAND: \"java\"",
" #0 [f2815db4] schedule at c011af85",
" #1 [f2815de4] __down at c010600f",
" #2 [f2815e14] __down_failed at c01061b3",
" #3 [f2815e24] stext_lock (via drain_cpu_caches) at c025fa55",
" #4 [f2815ec8] kmem_cache_shrink_nr at c013a53e",
" #5 [f2815ed8] do_try_to_free_pages at c013f402",
" #6 [f2815f04] try_to_free_pages at c013f8d2",
" #7 [f2815f1c] _wrapped_alloc_pages at c01406bd",
" #8 [f2815f40] __alloc_pages at c014079d",
" #9 [f2815f60] __get_free_pages at c014083e",
" #10 [f2815f68] do_fork at c011cebb",
" #11 [f2815fa4] sys_clone at c0105ceb",
" #12 [f2815fc0] system_call at c010740c",
" EAX: 00000078 EBX: 00000f21 ECX: bc1ffbd8 EDX: bc1ffbe0",
" DS: 002b ESI: 00000000 ES: 002b EDI: bc1ffd04",
" SS: 002b ESP: 0807316c EBP: 080731bc",
" CS: 0023 EIP: 4012881e ERR: 00000078 EFLAGS: 00000296",
" ",
" PID: 1592 TASK: c0cec000 CPU: 3 COMMAND: \"httpd\"",
" #0 [c0ceded4] schedule at c011af85",
" #1 [c0cedf04] pipe_wait at c0153083",
" #2 [c0cedf58] pipe_read at c015317f",
" #3 [c0cedf7c] sys_read at c0148be6",
" #4 [c0cedfc0] system_call at c010740c",
" EAX: 00000003 EBX: 00000004 ECX: bffed4a3 EDX: 00000001 ",
" DS: 002b ESI: 00000001 ES: 002b EDI: bffed4a3 ",
" SS: 002b ESP: bffed458 EBP: bffed488 ",
" CS: 0023 EIP: 4024f1d4 ERR: 00000003 EFLAGS: 00000286 ",
" ",
" In order to examine each stack frame's contents use the bt -f option.",
" From the extra frame data that is displayed, the arguments passed to each",
" function can be determined. Re-examining the PID 1592 trace above:",
" ",
" %s> bt -f 1592",
" PID: 1592 TASK: c0cec000 CPU: 3 COMMAND: \"httpd\"",
" #0 [c0ceded4] schedule at c011af85",
" [RA: c0153088 SP: c0ceded4 FP: c0cedf04 SIZE: 52]",
" c0ceded4: c0cedf00 c0cec000 ce1a6000 00000003 ",
" c0cedee4: c0cec000 f26152c0 cfafc8c0 c0cec000 ",
" c0cedef4: ef70a0a0 c0cec000 c0cedf28 c0cedf54 ",
" c0cedf04: c0153088 ",
" #1 [c0cedf04] pipe_wait at c0153083",
" [RA: c0153184 SP: c0cedf08 FP: c0cedf58 SIZE: 84]",
" c0cedf08: 00000000 c0cec000 00000000 00000000 ",
" c0cedf18: 00000000 c0a41fa0 c011d38b c0394120 ",
" c0cedf28: 00000000 c0cec000 ceeebf30 ce4adf30 ",
" c0cedf38: 00000000 d4b60ce0 00000000 c0cedf58 ",
" c0cedf48: e204f820 ef70a040 00000001 c0cedf78 ",
" c0cedf58: c0153184 ",
" #2 [c0cedf58] pipe_read at c015317f",
" [RA: c0148be8 SP: c0cedf5c FP: c0cedf7c SIZE: 36]",
" c0cedf5c: ef70a040 c0cec000 00000000 00000000 ",
" c0cedf6c: 00000001 f27ae680 ffffffea c0cedfbc ",
" c0cedf7c: c0148be8 ",
" #3 [c0cedf7c] sys_read at c0148be6",
" [RA: c0107413 SP: c0cedf80 FP: c0cedfc0 SIZE: 68]",
" c0cedf80: f27ae680 bffed4a3 00000001 f27ae6a0 ",
" c0cedf90: 40160370 24000000 4019ba28 00000000 ",
" c0cedfa0: 00000000 fffffffe bffba207 fffffffe ",
" c0cedfb0: c0cec000 00000001 bffed4a3 bffed488 ",
" c0cedfc0: c0107413 ",
" #4 [c0cedfc0] system_call at c010740c",
" EAX: 00000003 EBX: 00000004 ECX: bffed4a3 EDX: 00000001 ",
" DS: 002b ESI: 00000001 ES: 002b EDI: bffed4a3 ",
" SS: 002b ESP: bffed458 EBP: bffed488 ",
" CS: 0023 EIP: 4024f1d4 ERR: 00000003 EFLAGS: 00000286 ",
" [RA: 4024f1d4 SP: c0cedfc4 FP: c0cedffc SIZE: 60]",
" c0cedfc4: 00000004 bffed4a3 00000001 00000001 ",
" c0cedfd4: bffed4a3 bffed488 00000003 0000002b ",
" c0cedfe4: 0000002b 00000003 4024f1d4 00000023 ",
" c0cedff4: 00000286 bffed458 0000002b ",
" ",
" Typically the arguments passed to a function will be the last values",
" that were pushed onto the stack by the next higher-numbered function, i.e.,",
" the lowest stack addresses in the frame above the called function's",
" stack frame. That can be verified by disassembling the calling function.",
" For example, the arguments passed from sys_read() to pipe_read() above",
" are the file pointer, the user buffer address, the count, and a pointer",
" to the file structure's f_pos field. Looking at the frame #3 data for",
" sys_read(), the last four items pushed onto the stack (lowest addresses)",
" are f27ae680, bffed4a3, 00000001, and f27ae6a0 -- which are the 4 arguments",
" above, in that order. Note that the first (highest address) stack content",
" in frame #2 data for pipe_read() is c0148be8, which is the return address",
" back to sys_read(). ",
" ",
" Dump the text symbols found in the current context's stack:\n",
" %s> bt -t",
" PID: 1357 TASK: c1aa0000 CPU: 0 COMMAND: \"lockd\"",
" START: schedule at c01190e0",
" [c1aa1f28] dput at c0157dbc",
" [c1aa1f4c] schedule_timeout at c0124cd4",
" [c1aa1f78] svc_recv at cb22c4d8 [sunrpc]",
" [c1aa1f98] put_files_struct at c011eb21",
" [c1aa1fcc] nlmclnt_proc at cb237bef [lockd]",
" [c1aa1ff0] kernel_thread at c0105826",
" [c1aa1ff8] nlmclnt_proc at cb237a60 [lockd]",
" ",
" Search the current stack for possible exception frames:\n",
" %s> bt -e",
" PID: 286 TASK: c0b3a000 CPU: 0 COMMAND: \"in.rlogind\"",
" ",
" KERNEL-MODE EXCEPTION FRAME AT c0b3bf44:",
" EAX: 00000000 EBX: c0e68280 ECX: 00000000 EDX: 00000004 EBP: c0b3bfbc",
" DS: 0018 ESI: 00000004 ES: 0018 EDI: c0e68284 ",
" CS: 0010 EIP: c012f803 ERR: ffffff09 EFLAGS: 00000246 ",
" ",
" USER-MODE EXCEPTION FRAME AT c0b3bfc4:",
" EAX: 0000008e EBX: 00000004 ECX: bfffc9a0 EDX: 00000000 ",
" DS: 002b ESI: bfffc8a0 ES: 002b EDI: 00000000 ",
" SS: 002b ESP: bfffc82c EBP: bfffd224 ",
" CS: 0023 EIP: 400d032e ERR: 0000008e EFLAGS: 00000246 ",
" ",
" Display the back trace from a dumpfile that resulted from the execution",
" of the %s utility's \"sys -panic\" command:\n",
" %s> bt",
" PID: 12523 TASK: c610c000 CPU: 0 COMMAND: \"crash\"",
" #0 [c610de64] die at c01076ec",
" #1 [c610de74] do_invalid_op at c01079bc",
" #2 [c610df2c] error_code (via invalid_op) at c0107256",
" EAX: 0000001d EBX: c024a4c0 ECX: c02f13c4 EDX: 000026f6 EBP: c610c000",
" DS: 0018 ESI: 401de2e0 ES: 0018 EDI: c610c000",
" CS: 0010 EIP: c011bbb4 ERR: ffffffff EFLAGS: 00010296",
" #3 [c610df68] panic at c011bbb4",
" #4 [c610df78] do_exit at c011f1fe",
" #5 [c610dfc0] system_call at c0107154",
" EAX: 00000001 EBX: 00000000 ECX: 00001000 EDX: 401df154",
" DS: 002b ESI: 401de2e0 ES: 002b EDI: 00000000",
" SS: 002b ESP: bffebf0c EBP: bffebf38",
" CS: 0023 EIP: 40163afd ERR: 00000001 EFLAGS: 00000246",
" ",
" Display the back trace from a dumpfile that resulted from an attempt to",
" insmod the sample \"crash.c\" kernel module that comes as part of the",
" Red Hat netdump package:\n",
" %s> bt",
" PID: 1696 TASK: c74de000 CPU: 0 COMMAND: \"insmod\"",
" #0 [c74dfdcc] die at c01076ec",
" #1 [c74dfddc] do_page_fault at c0117bbc",
" #2 [c74dfee0] error_code (via page_fault) at c0107256",
" EAX: 00000013 EBX: cb297000 ECX: 00000000 EDX: c5962000 EBP: c74dff28",
" DS: 0018 ESI: 00000000 ES: 0018 EDI: 00000000",
" CS: 0010 EIP: cb297076 ERR: ffffffff EFLAGS: 00010282",
" #3 [c74dff1c] crash_init at cb297076 [crash]",
" #4 [c74dff2c] sys_init_module at c011d233",
" #5 [c74dffc0] system_call at c0107154",
" EAX: 00000080 EBX: 08060528 ECX: 08076450 EDX: 0000000a",
" DS: 002b ESI: 0804b305 ES: 002b EDI: 08074ed0",
" SS: 002b ESP: bffe9a90 EBP: bffe9ac8",
" CS: 0023 EIP: 4012066e ERR: 00000080 EFLAGS: 00000246",
" ",
" Display the symbol name plus its offset in each frame, overriding",
" the current output format with hexadecimal:\n",
" %s> bt -sx",
" PID: 1499 TASK: ffff88006af43cc0 CPU: 2 COMMAND: \"su\"",
" #0 [ffff8800664a1c90] machine_kexec+0x167 at ffffffff810327b7",
" #1 [ffff8800664a1ce0] crash_kexec+0x60 at ffffffff810a9ec0",
" #2 [ffff8800664a1db0] oops_end+0xb0 at ffffffff81504160",
" #3 [ffff8800664a1dd0] general_protection+0x25 at ffffffff81503435",
" [exception RIP: kmem_cache_alloc+120]",
" RIP: ffffffff8113cf88 RSP: ffff8800664a1e88 RFLAGS: 00010086",
" RAX: 0000000000000000 RBX: ff88006ef56840ff RCX: ffffffff8114e9e4",
" RDX: 0000000000000000 RSI: 00000000000080d0 RDI: ffffffff81796020",
" RBP: ffffffff81796020 R8: ffff88000a3137a0 R9: 0000000000000000",
" R10: ffff88007ac97300 R11: 0000000000000400 R12: 00000000000080d0",
" R13: 0000000000000292 R14: 00000000000080d0 R15: 00000000000000c0",
" ORIG_RAX: ffffffffffffffff CS: 0010 SS: 0018",
" #4 [ffff8800664a1ed0] get_empty_filp+0x74 at ffffffff8114e9e4",
" #5 [ffff8800664a1ef0] sock_alloc_fd+0x23 at ffffffff8142f553",
" #6 [ffff8800664a1f10] sock_map_fd+0x23 at ffffffff8142f693",
" #7 [ffff8800664a1f50] sys_socket+0x43 at ffffffff814302a3",
" #8 [ffff8800664a1f80] system_call_fastpath+0x16 at ffffffff81013042",
" RIP: 00007f5720b368e7 RSP: 00007fff52b629a8 RFLAGS: 00010206",
" RAX: 0000000000000029 RBX: ffffffff81013042 RCX: 0000000000000000",
" RDX: 0000000000000009 RSI: 0000000000000003 RDI: 0000000000000010",
" RBP: 000000000066f320 R8: 0000000000000001 R9: 0000000000000000",
" R10: 0000000000000000 R11: 0000000000000202 R12: ffff88007ac97300",
" R13: 0000000000000000 R14: 00007f571e104a80 R15: 00007f571e305048",
" ORIG_RAX: 0000000000000029 CS: 0033 SS: 002b",
"",
" The following three examples show the difference in the display of",
" the same stack frame's contents using -f, -F, and -FF:",
" ",
" %s> bf -f",
" ...",
" #4 [ffff810072b47f10] vfs_write at ffffffff800789d8",
" ffff810072b47f18: ffff81007e020380 ffff81007e2c2880 ",
" ffff810072b47f28: 0000000000000002 fffffffffffffff7 ",
" ffff810072b47f38: 00002b141825d000 ffffffff80078f75 ",
" #5 [ffff810072b47f40] sys_write at ffffffff80078f75",
" ...",
" %s> bt -F",
" ...",
" #4 [ffff810072b47f10] vfs_write at ffffffff800789d8",
" ffff810072b47f18: [files_cache] [filp] ",
" ffff810072b47f28: 0000000000000002 fffffffffffffff7 ",
" ffff810072b47f38: 00002b141825d000 sys_write+69 ",
" #5 [ffff810072b47f40] sys_write at ffffffff80078f75",
" ...",
" %s> bf -FF",
" ...",
" #4 [ffff810072b47f10] vfs_write at ffffffff800789d8",
" ffff810072b47f18: [ffff81007e020380:files_cache] [ffff81007e2c2880:filp]",
" ffff810072b47f28: 0000000000000002 fffffffffffffff7 ",
" ffff810072b47f38: 00002b141825d000 sys_write+69 ",
" #5 [ffff810072b47f40] sys_write at ffffffff80078f75",
" ...",
NULL
};
char *help_btop[] = {
"btop",
"bytes to page",
"address ...",
" This command translates a hexadecimal address to its page number.",
"\nEXAMPLES",
" %s> btop 512a000",
" 512a000: 512a",
NULL
};
char *help_extend[] = {
"extend",
"extend the %s command set",
"[shared-object ...] | [-u [shared-object ...]]",
" This command dynamically loads or unloads %s extension shared object",
" libraries:\n",
" shared-object load the specified shared object file; more than one",
" one object file may be entered.",
" -u shared-object unload the specified shared object file; if no file",
" arguments are specified, unload all objects.",
"\n If the shared-object filename is not expressed with a fully-qualified",
" pathname, the following directories will be searched in the order shown,",
" and the first instance of the file that is found will be selected:\n",
" 1. the current working directory",
" 2. the directory specified in the CRASH_EXTENSIONS environment variable",
" 3. /usr/lib64/crash/extensions (64-bit architectures)",
" 4. /usr/lib/crash/extensions",
"\n If no arguments are entered, the current set of shared object files and ",
" a list of their commands will be displayed. The registered commands",
" contained in each shared object file will appear automatically in the ",
" \"help\" command screen.",
"\n An example of a shared object prototype file, and how to compile it",
" into a shared object, is appended below.",
"\nEXAMPLES",
" Load two shared object files:\n",
" %s> extend extlib1.so extlib2.so",
" ./extlib1.so: shared object loaded",
" ./extlib2.so: shared object loaded",
"\n Display the current set of shared object files and their commands:\n",
" %s> extend",
" SHARED OBJECT COMMANDS",
" ./extlib1.so echo util bin",
" ./extlib2.so smp show",
"\n Unload one of the shared object files:\n",
" %s> extend -u extlib1.so",
" ./extlib1.so: shared object unloaded",
"\n Unload all currently-loaded object files:\n",
" %s> extend -u",
" ./extlib2.so: shared object unloaded",
"\nCREATING A SHARED OBJECT",
" The extend command loads shared object files using dlopen(3), which in",
" turn calls the shared object's constructor function. The shared object's",
" constructor function should register its command set by calling ",
" register_extension(), passing it a pointer to an array of one or more",
" structures of the following type:",
" ",
" struct command_table_entry {",
" char *name;",
" cmd_func_t func;",
" char **help_data,",
" ulong flags;",
" };",
" ",
" Each command_table_entry structure contains the ASCII name of a command,",
" the command's function address, a pointer to an array of help data strings,",
" and a flags field. The help_data field is optional; if it is non-NULL, it",
" should point to an array of character strings used by the \"help\"",
" command, and during command failures. The flags field currently has two",
" available bit settings, REFRESH_TASK_TABLE, which should be set if it is ",
" preferable to reload the current set of running processes just prior to ",
" executing the command (on a live system) and MINIMAL, which should be ",
" set if the command should be available in minimal mode. Terminate the array",
" of command_table_entry structures with an entry with a NULL command name. ",
" ",
" Below is an example shared object file consisting of just one command, ",
" called \"echo\", which simply echoes back all arguments passed to it.",
" Note the comments contained within it for further details. Cut and paste",
" the following output into a file, and call it, for example, \"echo.c\".",
" Then compiled in either of two manners. Either manually like so:",
" ",
" gcc -shared -rdynamic -o echo.so echo.c -fPIC -D<machine-type> $(TARGET_CFLAGS)",
" ",
" where <machine-type> must be one of the MACHINE_TYPE #define's in defs.h,",
" and where $(TARGET_CFLAGS) is the same as it is declared in the top-level",
" Makefile after a build is completed. Or alternatively, the \"echo.c\" file",
" can be copied into the \"extensions\" subdirectory, and compiled automatically",
" like so:",
" ",
" make extensions",
" ",
" The echo.so file may be dynamically linked into %s during runtime, or",
" during initialization by putting \"extend echo.so\" into a .%src file",
" located in the current directory, or in the user's $HOME directory.",
" ",
"---------------------------------- cut here ----------------------------------",
" ",
"#include \"defs.h\" /* From the crash source top-level directory */",
"",
"void echo_init(void); /* constructor function */",
"void echo_fini(void); /* destructor function (optional) */",
"",
"void cmd_echo(void); /* Declare the commands and their help data. */",
"char *help_echo[];",
"",
"static struct command_table_entry command_table[] = {",
" { \"echo\", cmd_echo, help_echo, 0}, /* One or more commands, */",
" { NULL }, /* terminated by NULL, */",
"};",
"",
"",
"void __attribute__((constructor))",
"echo_init(void) /* Register the command set. */",
"{ ",
" register_extension(command_table);",
"}",
" ",
"/* ",
" * This function is called if the shared object is unloaded. ",
" * If desired, perform any cleanups here. ",
" */",
"void __attribute__((destructor))",
"echo_fini(void) { }",
"",
"",
"/* ",
" * Arguments are passed to the command functions in the global args[argcnt]",
" * array. See getopt(3) for info on dash arguments. Check out defs.h and",
" * other %s commands for usage of the myriad of utility routines available",
" * to accomplish what your task.",
" */",
"void",
"cmd_echo(void)",
"{",
" int c;",
"",
" while ((c = getopt(argcnt, args, \"\")) != EOF) {",
" switch(c)",
" {",
" default:",
" argerrs++;",
" break;",
" }",
" }",
"",
" if (argerrs)",
" cmd_usage(pc->curcmd, SYNOPSIS);",
"",
" while (args[optind]) ",
" fprintf(fp, \"%%s \", args[optind++]);",
"",
" fprintf(fp, \"\\n\");",
"}",
"",
"/* ",
" * The optional help data is simply an array of strings in a defined format.",
" * For example, the \"help echo\" command will use the help_echo[] string",
" * array below to create a help page that looks like this:",
" * ",
" * NAME",
" * echo - echoes back its arguments",
" *",
" * SYNOPSIS",
" * echo arg ...",
" *",
" * DESCRIPTION",
" * This command simply echoes back its arguments.",
" *",
" * EXAMPLE",
" * Echo back all command arguments:",
" *",
" * crash> echo hello, world",
" * hello, world",
" *",
" */",
" ",
"char *help_echo[] = {",
" \"echo\", /* command name */",
" \"echoes back its arguments\", /* short description */",
" \"arg ...\", /* argument synopsis, or \" \" if none */",
" ",
" \" This command simply echoes back its arguments.\",",
" \"\\nEXAMPLE\",",
" \" Echo back all command arguments:\\n\",",
" \" %s> echo hello, world\",",
" \" hello, world\",",
" NULL",
"};",
"",
NULL
};
char *help_mach[] = {
"mach",
"machine specific data",
"[-m | -c -[xd]]",
" This command displays data specific to a machine type.\n",
" -m Display the physical memory map (x86, x86_64 and ia64 only).",
" -c Display each cpu's cpuinfo structure (x86, x86_64 and ia64 only).",
" Display each cpu's x8664_pda structure (x86_64 only),",
" Display the hwrpb_struct, and each cpu's percpu_struct (alpha only).",
" -x override default output format with hexadecimal format.",
" -d override default output format with decimal format.",
"\nEXAMPLES",
" %s> mach",
" MACHINE TYPE: i686",
" MEMORY SIZE: 512 MB",
" CPUS: 2",
" HYPERVISOR: KVM",
" PROCESSOR SPEED: 1993 Mhz",
" HZ: 100",
" PAGE SIZE: 4096",
// " L1 CACHE SIZE: 32",
" KERNEL VIRTUAL BASE: c0000000",
" KERNEL VMALLOC BASE: e0800000",
" KERNEL STACK SIZE: 8192",
" ",
" Display the system physical memory map:\n",
" %s> mach -m",
" PHYSICAL ADDRESS RANGE TYPE",
" 0000000000000000 - 00000000000a0000 E820_RAM",
" 00000000000f0000 - 0000000000100000 E820_RESERVED",
" 0000000000100000 - 000000001ff75000 E820_RAM",
" 000000001ff75000 - 000000001ff77000 E820_NVS",
" 000000001ff77000 - 000000001ff98000 E820_ACPI",
" 000000001ff98000 - 0000000020000000 E820_RESERVED",
" 00000000fec00000 - 00000000fec90000 E820_RESERVED",
" 00000000fee00000 - 00000000fee10000 E820_RESERVED",
" 00000000ffb00000 - 0000000100000000 E820_RESERVED",
NULL
};
char *help_map[] = {
"map",
"store KVM dumpfile memory map data",
"[-a][-f [filename]]",
" The layout of KVM guest dumpfiles created with \"virsh dump\" does not allow",
" the crash utility to access the system's memory in a random access manner.",
" Therefore, during crash session initialization, a potentially time-consuming",
" dumpfile scan procedure is required to create a physical-memory-to-file-offset",
" map for use during the session.",
" ",
" This command may be used to append the memory map data to the dumpfile or",
" to store it in a permanent file. After this has been done, subsequent crash",
" sessions using the dumpfile will no longer require the scan procedure:",
" ",
" -a Append the memory map to the end of the KVM dumpfile.",
" -f Create a memory map file. If no filename argument is entered, the",
" filename will consist of the dumpfile name with \".map\" appended,",
" and will be located in the same directory as the dumpfile; it will",
" be recognized and used automatically during subsequent %s sessions.",
" However, if a \"filename\" argument is entered, and the default location",
" and naming convention are not used, then the new memory map file will",
" have to be added to the %s command line during invocation.",
"\nEXAMPLES",
" %s> map",
" MAP FILE IN USE: vmcore.map",
" %s> map -a",
" MAP FILE APPENDED TO: vmcore",
" %s> map -f",
" MAP FILE CREATED: vmcore.map",
" %s> map -f /tmp/vmcore.map",
" MAP FILE CREATED: /tmp/vmcore.map",
NULL
};
char *help_timer[] = {
"timer",
"timer queue data",
"[-r]",
" This command displays the timer queue entries, both old- and new-style,",
" in chronological order. In the case of the old-style timers, the",
" timer_table array index is shown; in the case of the new-style timers, ",
" the timer_list address is shown. On later kernels, the timer data is",
" per-cpu.\n",
" -r Display hrtimer timer queue entries, both old- and new-style, in",
" chronological order. In the case of the old-style hrtimers, the",
" expiration time is a single value; in the new-style hrtimers, the",
" expiration time is a range.",
"\nEXAMPLES",
" %s> timer",
" JIFFIES",
" 68102",
" EXPIRES TIMER_LIST/TABLE FUNCTION",
" 68346 c0241934 c01775d4 <tcp_sltimer_handler>",
" 68379 c0241204 c01696d8 <dev_do_watchdog>",
" 68523 c7fcdfc0 c0112d6c <process_timeout>",
" 68718 c7fd8edc c018719c <irlmp_discovery_timer_expired>",
" 68723 timer_table[2] c01c707c <rs_timer>",
" 68742 c20c1f7c c0112d6c <process_timeout>",
" 68742 c20c1f7c c0112d6c <process_timeout>",
" 68742 c20c1f7c c0112d6c <process_timeout>",
" 68752 c7fd1fc4 c0112d6c <process_timeout>",
" 68752 c7fd1fc4 c0112d6c <process_timeout>",
" 68989 c0241d40 c0168060 <neigh_periodic_timer>",
" 69028 c2533f7c c0112d6c <process_timeout>",
" 69134 c22dd868 c0181948 <unix_destroy_timer>",
" 71574 c0241430 c0169ea4 <rt_check_expire>",
" 72179 c7fb1c48 c01cb9a0 <vortex_timer>",
" 73144 c1b17f10 c0112d6c <process_timeout>",
" 73259 c17a5f10 c0112d6c <process_timeout>",
" 112929 c203ff10 c0112d6c <process_timeout>",
" 372010 c2323f7c c0112d6c <process_timeout>",
" 372138 c2191f10 c0112d6c <process_timeout>",
" 8653052 c1f13f10 c0112d6c <process_timeout>",
" ",
" Display the timer queue on a 2-cpu system:\n",
" %s> timer",
" TVEC_BASES[0]: c1299be0",
" JIFFIES",
" 18256298",
" EXPIRES TIMER_LIST FUNCTION",
" 18256406 cd5ddec0 c01232bb <process_timeout>",
" 18256677 ceea93e0 c011e3cc <it_real_fn>",
" 18256850 ceea7f64 c01232bb <process_timeout>",
" 18258751 cd1d4f64 c01232bb <process_timeout>",
" 18258792 cf5782f0 c011e3cc <it_real_fn>",
" 18261266 c03c9f80 c022fad5 <rt_check_expire>",
" 18262196 c02dc2e0 c0233329 <peer_check_expire>",
" 18270518 ceb8bf1c c01232bb <process_timeout>",
" 18271327 c03c9120 c0222074 <flow_cache_new_hashrnd>",
" 18271327 c03ca580 c0233ace <ipfrag_secret_rebuild>",
" 18272532 c02d1e18 c0129946 <delayed_work_timer_fn>",
" 18276518 c03c9fc0 c022fd40 <rt_secret_rebuild>",
" 18332334 ceea9970 c011e3cc <it_real_fn>",
" 18332334 cfb6a840 c011e3cc <it_real_fn>",
" 18665378 cec25ec0 c01232bb <process_timeout>",
" TVEC_BASES[1]: c12a1be0",
" JIFFIES",
" 18256298",
" EXPIRES TIMER_LIST FUNCTION",
" 18256493 c02c7d00 c013dad5 <wb_timer_fn>",
" 18256499 c12a2db8 c0129946 <delayed_work_timer_fn>",
" 18277900 ceebaec0 c01232bb <process_timeout>",
" 18283769 cf739f64 c01232bb <process_timeout>",
" 18331902 cee8af64 c01232bb <process_timeout>",
" ",
" Display a new-style hrtimer queue:\n",
" %s> timer -r",
" CPU: 0 HRTIMER_CPU_BASE: c1e03fc0",
" CLOCK: 0 HRTIMER_CLOCK_BASE: c1e03fc4 [ktime_get_real]",
" (empty)",
" ",
" CLOCK: 1 HRTIMER_CLOCK_BASE: c1e03ff0 [ktime_get]",
" CURRENT",
" 322894000000",
" SOFTEXPIRES EXPIRES HRTIMER FUNCTION",
" 322895000000 322895000000 c1e04080 c04833e0 <tick_sched_timer>",
" 324022213609 324022213609 c1e041c0 c04b17d0 <watchdog_timer_fn>",
" 326766922781 326766972781 f3a45f44 c0477ed0 <hrtimer_wakeup>",
" 364516801997 364516851997 f43bbf44 c0477ed0 <hrtimer_wakeup>",
" ",
" CLOCK: 2 HRTIMER_CLOCK_BASE: c1e0401c [ktime_get_boottime]",
" (empty)",
" ",
" CPU: 1 HRTIMER_CPU_BASE: c1e43fc0",
" CLOCK: 0 HRTIMER_CLOCK_BASE: c1e43fc4 [ktime_get_real]",
" (empty)",
" ",
" CLOCK: 1 HRTIMER_CLOCK_BASE: c1e43ff0 [ktime_get]",
" CURRENT",
" 322894000000",
" SOFTEXPIRES EXPIRES HRTIMER FUNCTION",
" 322895062500 322895062500 c1e44080 c04833e0 <tick_sched_timer>",
" 324087213609 324087213609 c1e441c0 c04b17d0 <watchdog_timer_fn>",
" 381034500892 381034550892 f3a1bea0 c0477ed0 <hrtimer_wakeup>",
" ",
" CLOCK: 2 HRTIMER_CLOCK_BASE: c1e4401c [ktime_get_boottime]",
" (empty)",
" ...",
" ",
" Display an old-style hrtimer queue:\n",
" %s> timer -r",
" CPU: 0",
" CLOCK: 0 HRTIMER_BASE: ca00dae0 [ktime_get_real]",
" (empty)",
" ",
" CLOCK: 1 HRTIMER_BASE: ca00db0c [ktime_get]",
" CURRENT",
" 1480537567000000",
" EXPIRES HRTIMER FUNCTION",
" 1480997557052703 f79c4944 c0427d18 <it_real_fn>",
" 1481009329944302 cdcbaf6c c0436a1e <hrtimer_wakeup>",
" 1481026181758643 ea01cf6c c0436a1e <hrtimer_wakeup>",
" 1481497068511094 f79a6244 c0427d18 <it_real_fn>",
" 1481589831928489 f7af6944 c0427d18 <it_real_fn>",
" 1481592731187337 f64ed784 c0427d18 <it_real_fn>",
" ",
" CPU: 1",
" CLOCK: 0 HRTIMER_BASE: ca0148c4 [ktime_get_real]",
" (empty)",
" ",
" CLOCK: 1 HRTIMER_BASE: ca0148f0 [ktime_get]",
" CURRENT",
" 1480537567000000",
" EXPIRES HRTIMER FUNCTION",
" 1481017523822478 ca3b15c4 c0427d18 <it_real_fn>",
" 1481238077723188 f5f35f6c c0436a1e <hrtimer_wakeup>",
" 1481492107740948 f5dadf6c c0436a1e <hrtimer_wakeup>",
" 1482936527251241 ca1becc4 c0427d18 <it_real_fn>",
" 1482936545249010 f7d42e84 c0427d18 <it_real_fn>",
" 1492850155229325 ea01ef6c c0436a1e <hrtimer_wakeup>",
" ...",
" ",
NULL
};
char *help_runq[] = {
"runq",
"run queue",
"[-t] [-m] [-g]",
" With no argument, this command displays the tasks on the run queues",
" of each cpu.",
" ",
" -t Display the timestamp information of each cpu's runqueue, which is the",
" rq.clock, rq.most_recent_timestamp or rq.timestamp_last_tick value,",
" whichever applies; following each cpu timestamp is the last_run or ",
" timestamp value of the active task on that cpu, whichever applies, ",
" along with the task identification.",
" -m Display the amount of time that the active task on each cpu has been",
" running, expressed in a format consisting of days, hours, minutes, ",
" seconds and milliseconds.",
" -g Display tasks hierarchically by task_group. The task_group line shows",
" the task_group address, the cfs_rq or rt_rq address, the task_group name",
" (if any), and whether the task_group is throttled.",
"\nEXAMPLES",
" Display the tasks on an O(1) scheduler run queue:\n",
" %s> runq",
" CPU 0 RUNQUEUE: ffff880001cdb460",
" CURRENT: PID: 2739 TASK: ffff8800320fa7e0 COMMAND: \"bash\"",
" ACTIVE PRIO_ARRAY: ffff880001cdb4d8",
" [115] PID: 2739 TASK: ffff8800320fa7e0 COMMAND: \"bash\"",
" PID: 1776 TASK: ffff88003217d820 COMMAND: \"syslogd\"",
" EXPIRED PRIO_ARRAY: ffff880001cdbdb8",
" [no tasks queued]",
" ",
" CPU 1 RUNQUEUE: ffff880001ce3460",
" CURRENT: PID: 1779 TASK: ffff88003207a860 COMMAND: \"klogd\"",
" ACTIVE PRIO_ARRAY: ffff880001ce34d8",
" [115] PID: 1779 TASK: ffff88003207a860 COMMAND: \"klogd\"",
" EXPIRED PRIO_ARRAY: ffff880001ce3db8",
" [no tasks queued]",
" ",
" Display the tasks on a CFS run queue:\n",
" %s> runq",
" CPU 0 RUNQUEUE: ffff8800090436c0",
" CURRENT: PID: 588 TASK: ffff88007e4877a0 COMMAND: \"udevd\"",
" RT PRIO_ARRAY: ffff8800090437c8",
" [no tasks queued]",
" CFS RB_ROOT: ffff880009043740",
" [118] PID: 2110 TASK: ffff88007d470860 COMMAND: \"check-cdrom.sh\"",
" [118] PID: 2109 TASK: ffff88007f1247a0 COMMAND: \"check-cdrom.sh\"",
" [118] PID: 2114 TASK: ffff88007f20e080 COMMAND: \"udevd\"",
" ",
" CPU 1 RUNQUEUE: ffff88000905b6c0",
" CURRENT: PID: 2113 TASK: ffff88007e8ac140 COMMAND: \"udevd\"",
" RT PRIO_ARRAY: ffff88000905b7c8",
" [no tasks queued]",
" CFS RB_ROOT: ffff88000905b740",
" [118] PID: 2092 TASK: ffff88007d7a4760 COMMAND: \"MAKEDEV\"",
" [118] PID: 1983 TASK: ffff88007e59f140 COMMAND: \"udevd\"",
" [118] PID: 2064 TASK: ffff88007e40f7a0 COMMAND: \"udevd\"",
" [115] PID: 2111 TASK: ffff88007e4278a0 COMMAND: \"kthreadd\"",
" ",
" Display run queue timestamp data:\n",
" %s> runq -t ",
" CPU 0: 2680990637359",
" 2680986653330 PID: 28228 TASK: ffff880037ca2ac0 COMMAND: \"loop\"",
" CPU 1: 2680940618478",
" 2680940618478 PID: 28167 TASK: ffff880078130040 COMMAND: \"bash\"",
" CPU 2: 2680990763425",
" 2680986785772 PID: 28227 TASK: ffff8800787780c0 COMMAND: \"loop\"",
" CPU 3: 2680990954469",
" 2680986059540 PID: 28226 TASK: ffff880078778b00 COMMAND: \"loop\"",
" ",
" Display the amount of time the active task on each cpu has been running:\n",
" %s> runq -m",
" CPU 0: [0 00:00:00.014] PID: 5275 TASK: f5dbcaa0 COMMAND: \"sh\"",
" CPU 1: [0 00:00:00.002] PID: 5203 TASK: f5c7baa0 COMMAND: \"cat\"",
" CPU 2: [0 00:00:00.014] PID: 7971 TASK: f5c6c550 COMMAND: \"khelper\"",
" CPU 3: [0 00:00:00.002] PID: 0 TASK: f4ccd000 COMMAND: \"swapper\"",
" ",
" Display tasks hierarchically by task_group:\n",
" %s> runq -g ",
" CPU 0",
" CURRENT: PID: 14734 TASK: ffff88010626f500 COMMAND: \"sh\"",
" ROOT_TASK_GROUP: ffffffff81ed93e0 RT_RQ: ffff880028216808",
" [ 0] TASK_GROUP: ffff88022c6bbc00 RT_RQ: ffff880139fc9800 (THROTTLED)",
" [ 0] PID: 14750 TASK: ffff88013a4dd540 COMMAND: \"rtloop99\"",
" [ 1] PID: 14748 TASK: ffff88013bbca040 COMMAND: \"rtloop98\"",
" [ 1] TASK_GROUP: ffff88012b0fb400 RT_RQ: ffff880089029000 ",
" [ 1] PID: 14752 TASK: ffff880088abf500 COMMAND: \"rtloop98\"",
" [ 54] PID: 14749 TASK: ffff880037a4e080 COMMAND: \"rtloop45\"",
" [ 98] PID: 14746 TASK: ffff88012678c080 COMMAND: \"rtloop1\"",
" ROOT_TASK_GROUP: ffffffff81ed93e0 CFS_RQ: ffff8800282166e8",
" [120] PID: 14740 TASK: ffff88013b1e6080 COMMAND: \"sh\"",
" [120] PID: 14738 TASK: ffff88012678d540 COMMAND: \"sh\"",
" [120] PID: 14734 TASK: ffff88010626f500 COMMAND: \"sh\" [CURRENT]",
" TASK_GROUP: ffff884052bc9800 CFS_RQ: ffff8831e4a1b000 (THROTTLED)",
" [120] PID: 14732 TASK: ffff88013bbcb500 COMMAND: \"sh\"",
" [120] PID: 14728 TASK: ffff8800b3496080 COMMAND: \"sh\"",
" [120] PID: 14730 TASK: ffff880037833540 COMMAND: \"sh\"",
" TASK_GROUP: ffff884058f1d000 CFS_RQ: ffff88120a101600 (THROTTLED)",
" [120] PID: 14726 TASK: ffff880138d42aa0 COMMAND: \"sh\"",
" ...",
" ",
" %s> runq -g",
" CPU 0",
" CURRENT: PID: 2948 TASK: ffff88022af2a100 COMMAND: \"bash\"",
" INIT_TASK_GROUP: ffffffff81e1a780 RT_RQ: ffff880028216148",
" [no tasks queued]",
" INIT_TASK_GROUP: ffffffff81e1a780 CFS_RQ: ffff880028216028",
" [120] PID: 2948 TASK: ffff88022af2a100 COMMAND: \"bash\" [CURRENT]",
" TASK_GROUP: ffff88012b880800 CFS_RQ: ffff88012c5d1000 <libvirt>",
" TASK_GROUP: ffff88012c078000 CFS_RQ: ffff88012c663e00 <qemu>",
" TASK_GROUP: ffff88022c7f4c00 CFS_RQ: ffff88012bb56000 <guest2>",
" TASK_GROUP: ffff88022b621400 CFS_RQ: ffff88012b012000 <vcpu0>",
" [120] PID: 3248 TASK: ffff88012a9d4100 COMMAND: \"qemu-kvm\"",
" ...",
NULL
};
char *help_repeat[] = {
"repeat",
"repeat a command",
"[-seconds] command",
" This command repeats a command indefinitely, optionally delaying a given",
" number of seconds between each command execution.\n",
" -seconds The number of seconds to delay between command executions.",
" This option must precede the command name to be executed.",
" ",
" Command execution may be stopped with CTRL-C, or if scrolling is in effect,",
" by entering \"q\". This command is meant for use on a live system; it is",
" hard to conceive of a reason to use it when debugging a crash dump.",
"\nEXAMPLES",
" Display the value of jiffies once per second:\n",
" %s> repeat -1 p jiffies",
" jiffies = $1 = 155551079",
" jiffies = $2 = 155551180",
" jiffies = $3 = 155551281",
" jiffies = $4 = 155551382",
" jiffies = $5 = 155551483",
" jiffies = $6 = 155551584",
" jiffies = $7 = 155551685",
" jiffies = $8 = 155551786",
" jiffies = $9 = 155551887",
" jiffies = $10 = 155551988",
" jiffies = $11 = 155552089",
" jiffies = $12 = 155552190",
" jiffies = $13 = 155552291",
" jiffies = $14 = 155552392",
" jiffies = $15 = 155552493",
" jiffies = $16 = 155552594",
" jiffies = $17 = 155552695",
" jiffies = $18 = 155552796",
" ...",
NULL
};
char *help_pte[] = {
"pte",
"translate a page table entry",
"contents ...",
" This command translates the hexadecimal contents of a PTE into its physical",
" page address and page bit settings. If the PTE references a swap location,",
" the swap device and offset are displayed.",
"\nEXAMPLES\n",
" %s> pte d8e067",
" PTE PHYSICAL FLAGS",
" d8e067 d8e000 (PRESENT|RW|USER|ACCESSED|DIRTY)",
" ",
" %s> pte 13f600",
" PTE SWAP OFFSET",
" 13f600 /dev/hda2 5104",
NULL
};
char *help_swap[] = {
"swap",
"swap device information",
" ",
" This command displays information for each configured swap device.",
"\nEXAMPLE",
" %s> swap",
" SWAP_INFO_STRUCT TYPE SIZE USED PCT PRI FILENAME",
" ffff880153d45f40 PARTITION 7192568k 1200580k 16% -1 /dev/dm-1",
NULL
};
char *help_dev[] = {
"dev",
"device data",
"[-i | -p | -d]",
" If no argument is entered, this command dumps character and block",
" device data.\n",
" -i display I/O port usage; on 2.4 kernels, also display I/O memory usage.",
" -p display PCI device data.",
" -d display disk I/O statistics:",
" TOTAL: total number of allocated in-progress I/O requests",
" SYNC: I/O requests that are synchronous",
" ASYNC: I/O requests that are asynchronous",
" READ: I/O requests that are reads (older kernels)",
" WRITE: I/O requests that are writes (older kernels)",
" DRV: I/O requests that are in-flight in the device driver",
"\nEXAMPLES",
" Display character and block device data:\n",
" %s> dev",
" CHRDEV NAME CDEV OPERATIONS",
" 1 mem f79b83c0 memory_fops",
" 4 /dev/vc/0 c07bc560 console_fops",
" 4 tty f7af5004 tty_fops",
" 4 ttyS f7b02204 tty_fops",
" 5 /dev/tty c07bc440 tty_fops",
" 5 /dev/console c07bc4a0 console_fops",
" 5 /dev/ptmx c07bc500 ptmx_fops",
" 6 lp c5797e40 lp_fops",
" 7 vcs f7b03d40 vcs_fops",
" 10 misc f7f68640 misc_fops",
" 13 input f79b8840 input_fops",
" 21 sg f7f12840 sg_fops",
" 29 fb f7f8c640 fb_fops",
" 128 ptm f7b02604 tty_fops",
" 136 pts f7b02404 tty_fops",
" 162 raw c0693e40 raw_fops",
" 180 usb f79b8bc0 usb_fops",
" 189 usb_device c06a0300 usbfs_device_file_operations",
" 216 rfcomm f5961a04 tty_fops",
" 254 pcmcia f79b82c0 ds_fops",
" ",
" BLKDEV NAME GENDISK OPERATIONS",
" 1 ramdisk f7b23480 rd_bd_op",
" 8 sd f7cab280 sd_fops",
" 9 md f7829b80 md_fops",
" 11 sr f75c24c0 sr_bdops",
" 65 sd (none) ",
" 66 sd (none) ",
" 67 sd (none) ",
" 68 sd (none) ",
" 69 sd (none) ",
" 70 sd (none) ",
" 71 sd (none) ",
" 128 sd (none) ",
" 129 sd (none) ",
" 130 sd (none) ",
" 131 sd (none) ",
" 132 sd (none) ",
" 133 sd (none) ",
" 134 sd (none) ",
" 135 sd (none) ",
" 253 device-mapper c57a0ac0 dm_blk_dops",
" 254 mdp (none) ",
"\n Display PCI data:\n",
" %s> dev -p",
" PCI_DEV BU:SL.FN CLASS: VENDOR-DEVICE",
" c00051c0 00:00.0 Host bridge: Intel 440BX - 82443BX Host",
" c0005250 00:01.0 PCI bridge: Intel 440BX - 82443BX AGP",
" c00052e0 00:07.0 ISA bridge: Intel 82371AB PIIX4 ISA",
" c0005370 00:07.1 IDE interface: Intel 82371AB PIIX4 IDE",
" c0005400 00:07.2 USB Controller: Intel 82371AB PIIX4 USB",
" c0005490 00:07.3 Bridge: Intel 82371AB PIIX4 ACPI",
" c0005520 00:11.0 Ethernet controller: 3Com 3C905B 100bTX",
" c00055b0 00:13.0 PCI bridge: DEC DC21152",
" c0005640 01:00.0 VGA compatible controller: NVidia [PCI_DEVICE 28]",
" c00056d0 02:0a.0 SCSI storage controller: Adaptec AIC-7890/1",
" c0005760 02:0e.0 SCSI storage controller: Adaptec AIC-7880U",
"\n Display I/O port and I/O memory usage:\n",
" %s> dev -i",
" RESOURCE RANGE NAME",
" c03036d4 0000-ffff PCI IO",
" c0302594 0000-001f dma1",
" c03025b0 0020-003f pic1",
" c03025cc 0040-005f timer",
" c03025e8 0060-006f keyboard",
" c0302604 0080-008f dma page reg",
" c0302620 00a0-00bf pic2",
" c030263c 00c0-00df dma2",
" c0302658 00f0-00ff fpu",
" c122ff20 0170-0177 ide1",
" c122f240 0213-0213 isapnp read",
" c122ff40 02f8-02ff serial(auto)",
" c122ff00 0376-0376 ide1",
" c03186e8 03c0-03df vga+",
" c122ff60 03f8-03ff serial(auto)",
" c123851c 0800-083f Intel Corporation 82371AB PIIX4 ACPI",
" c1238538 0840-085f Intel Corporation 82371AB PIIX4 ACPI",
" c122f220 0a79-0a79 isapnp write",
" c122f200 0cf8-0cff PCI conf1",
" c1238858 dc00-dc7f 3Com Corporation 3c905B 100BaseTX [Cyclone]",
" c122fc00 dc00-dc7f 00:11.0",
" c12380c8 dce0-dcff Intel Corporation 82371AB PIIX4 USB",
" c1238d1c e000-efff PCI Bus #02",
" c1237858 e800-e8ff Adaptec AIC-7880U",
" c1237458 ec00-ecff Adaptec AHA-2940U2/W / 7890",
" c1239cc8 ffa0-ffaf Intel Corporation 82371AB PIIX4 IDE",
" ",
" RESOURCE RANGE NAME",
" c03036f0 00000000-ffffffff PCI mem",
" c0004000 00000000-0009ffff System RAM",
" c03026ac 000a0000-000bffff Video RAM area",
" c03026fc 000c0000-000c7fff Video ROM",
" c0302718 000c9800-000cdfff Extension ROM",
" c0302734 000ce000-000ce7ff Extension ROM",
" c0302750 000ce800-000cffff Extension ROM",
" c03026e0 000f0000-000fffff System ROM",
" c0004040 00100000-07ffdfff System RAM",
" c0302674 00100000-0028682b Kernel code",
" c0302690 0028682c-0031c63f Kernel data",
" c0004060 07ffe000-07ffffff reserved",
" c1239058 ec000000-efffffff Intel Corporation 440BX/ZX - 82443BX/ZX Host",
" bridge",
" c1238d54 f1000000-f1ffffff PCI Bus #02",
" c1239554 f2000000-f5ffffff PCI Bus #01",
" c1237074 f4000000-f5ffffff nVidia Corporation Riva TnT2 [NV5]",
" c1238d38 fa000000-fbffffff PCI Bus #02",
" c1237874 faffe000-faffefff Adaptec AIC-7880U",
" c127ec40 faffe000-faffefff aic7xxx",
" c1237474 fafff000-faffffff Adaptec AHA-2940U2/W / 7890",
" c127eec0 fafff000-faffffff aic7xxx",
" c1239538 fc000000-fdffffff PCI Bus #01",
" c1237058 fc000000-fcffffff nVidia Corporation Riva TnT2 [NV5]",
" c1238874 fe000000-fe00007f 3Com Corporation 3c905B 100BaseTX [Cyclone]",
" c0004080 fec00000-fec0ffff reserved",
" c00040a0 fee00000-fee0ffff reserved",
" c00040c0 ffe00000-ffffffff reserved",
"\n Display disk I/O statistics:\n",
" %s> dev -d",
" MAJOR GENDISK NAME REQUEST_QUEUE TOTAL READ WRITE DRV",
" 2 ffff81012d8a5000 fd0 ffff81012dc053c0 12 0 12 0",
" 22 ffff81012dc6b000 hdc ffff81012d8ae340 2 2 0 0",
" 8 ffff81012dd71000 sda ffff81012d8af040 6 0 6 6",
" 8 ffff81012dc77000 sdb ffff81012d8b5740 0 0 0 0",
" 8 ffff81012d8d0c00 sdc ffff81012d8ae9c0 0 0 0 0",
NULL
};
char *help_search[] = {
"search",
"search memory",
"[-s start] [ -[kKV] | -u | -p | -t ] [-e end | -l length] [-m mask]\n"
" [-x count] -[cwh] [value | (expression) | symbol | string] ...",
" This command searches for a given value within a range of user virtual, kernel",
" virtual, or physical memory space. If no end nor length value is entered, ",
" then the search stops at the end of user virtual, kernel virtual, or physical",
" address space, whichever is appropriate.",
" ",
" An optional mask value may be entered to mask off \"don't care\" bits.\n",
" -s start Start the search at this hexadecimal user or kernel virtual ",
" address, physical address, or kernel symbol. The start address",
" must be appropriate for the memory type specified; if no memory",
" type is specified, the default is kernel virtual address space.",
" -k If no start address is specified, start the search at the base",
" of kernel virtual address space. This option is the default.",
" -K Same as -k, except that mapped kernel virtual memory that was",
" allocated by vmalloc(), module memory, or virtual mem_map regions",
" will not be searched.",
" -V Same as -k, except that unity-mapped kernel virtual memory and",
" mapped kernel-text/static-data (x86_64 and ia64) will not be",
" searched.",
" -u If no start address is specified, start the search at the base",
" of the current context's user virtual address space. If a start",
" address is specified, then this option specifies that the start",
" address is a user virtual address.",
" -p If no start address is specified, start the search at the base",
" of physical address space. If a start address is specified,",
" then this option specifies that the start address is a physical ",
" address.",
" -t Search only the kernel stack pages of every task. If one or more",
" matches are found in a task's kernel stack, precede the output",
" with a task-identifying header.",
" -e end Stop the search at this hexadecimal user or kernel virtual",
" address, kernel symbol, or physical address. The end address",
" must be appropriate for the memory type specified.",
" -l length Length in bytes of address range to search.",
" -m mask Ignore the bits that are set in the hexadecimal mask value.",
" -c Search for character string values instead of unsigned longs. If",
" the string contains any space(s), it must be encompassed by double",
" quotes.",
" -w Search for unsigned hexadecimal ints instead of unsigned longs.",
" This is only meaningful on 64-bit systems in order to search both",
" the upper and lower 32-bits of each 64-bit long for the value.",
" -h Search for unsigned hexadecimal shorts instead of unsigned longs.",
" -x count Display the memory contents before and after any found value. The",
" before and after memory context will consist of \"count\" memory",
" items of the same size as the \"value\" argument. This option is",
" not applicable with the -c option.",
" value Search for this hexadecimal long, unless modified by the -c, -w, ",
" or -h options.",
"(expression) Search for the value of this expression; the expression value must",
" not overflow the designated size when -h or -w are used; not",
" applicable when used with the -c option.",
" symbol Search for this symbol value; the symbol value must not overflow",
" the designated size when -h or -w are used; not applicable when ",
" used with the -c option.",
" string Search for character string values; if the string contains any ",
" space(s), it must be encompassed by double quotes; only applicable",
" with the -c option.",
" ",
" If -k, -K, -V, -u, -p or -t are not used, then the search defaults to kernel",
" virtual address space. The starting address must be long-word aligned. ",
" Address ranges that start in user space and end in kernel space are not",
" accepted.",
"\nEXAMPLES",
" Search the current context's address space for all instances of 0xdeadbeef:",
"\n %s> search -u deadbeef",
" 81aba5c: deadbeef",
" 81abaa8: deadbeef",
" bfffc698: deadbeef",
" bffff390: deadbeef",
"\n Search all kernel memory above the kernel text space for all instances",
" of 0xabcd occurring in the lower 16-bits of each 32-bit word: \n",
" %s> search -s _etext -m ffff0000 abcd",
" c071481c: abcd",
" c0c2b0fc: 804abcd",
" c0cf5e74: 7489abcd",
" c17c0b44: c012abcd",
" c1dac730: 3dbeabcd",
" c226d0e8: ffffabcd",
" c23ed5dc: abcd",
" c3022544: 3dbeabcd",
" c3069b58: 3dbeabcd",
" c3e86e84: aabcd",
" c3e88ed0: aabcd",
" c3e8ee5c: aabcd",
" c3e9df50: aabcd",
" c3e9e930: aabcd",
" c440a778: 804abcd",
" c486eb44: 3dbeabcd",
" c578f0fc: 804abcd",
" c6394f90: 8ababcd",
" c65219f0: 3abcd",
" c661399c: abcd",
" c68514ac: 8abcd",
" c7e036bc: 3dbeabcd",
" c7e12568: 5abcd",
" c7e1256c: 5abcd",
"\n Search the 4K page at c532c000 for all instances of 0xffffffff:\n",
" %s> search -s c532c000 -l 4096 ffffffff",
" c532c33c: ffffffff",
" c532c3fc: ffffffff",
"\n Search the static kernel data area for all instances of c2d400eb:\n",
" %s> search -s _etext -e _edata c2d400eb",
" c022b550: c2d400eb",
" c022b590: c2d400eb",
" c022b670: c2d400eb",
" c022b6e0: c2d400eb",
" c022b7b0: c2d400eb",
" c022b7e0: c2d400eb",
" c022b8b0: c2d400eb",
"\n Search physical memory for all instances of 0xbabe occurring in the",
" upper 16 bits of each 32-bit word:\n",
" %s> search -p babe0000 -m ffff",
" 2a1dc4: babe671e",
" 2b6928: babe3de1",
" 2f99ac: babe0d54",
" 31843c: babe70b9",
" 3ba920: babeb5d7",
" 413ce4: babe7540",
" 482747c: babe2600",
" 48579a4: babe2600",
" 4864a68: babe2600",
" ...",
"\n Search physical memory for all instances of 0xbabe occurring in the",
" upper 16 bits of each 32-bit word on a 64-bit system:\n",
" %s> search -p babe0000 -m ffff -w",
" 102e248: babe1174",
" 11d2f90: babe813d",
" 122d3ad70: babe6b27",
" 124d8cd30: babe3dc8",
" 124d8eefc: babef981",
" 124d8f060: babe3dc8",
" 124d8f17c: babefc81",
" ...",
"\n Search kernel memory for all instances of 32-bit value 0xbabe1174",
" on a 64-bit system:\n",
" %s> search -k -w babe1174",
" ffff88000102e248: babe1174",
" ffffffff8102e248: babe1174",
"\n Search kernel memory for two strings:\n",
" %s> search -k -c \"can\'t allocate memory\" \"Failure to\"",
" ffff8800013ddec1: can\'t allocate memory for key lists..<3>%%s %%s: error con",
" ffff8801258be748: Failure to install fence: %%d..<3>[drm:%%s] *ERROR* Failed",
" ffff880125f07ec9: can\'t allocate memory..<3>ACPI: Invalid data..Too many d",
" ffffffff813ddec1: can\'t allocate memory for key lists..<3>%%s %%s: error con",
"\n Search the kernel stacks of all tasks for those that contain the inode",
" address ffff81002c0a3050:\n",
" %s> search -t ffff81002c0a3050",
" PID: 4876 TASK: ffff81003e9f5860 CPU: 7 COMMAND: \"automount\"",
" ffff8100288fbe98: ffff81002c0a3050",
" ",
" PID: 4880 TASK: ffff81003ce967a0 CPU: 0 COMMAND: \"automount\"",
" ffff81002c0fbdd8: ffff81002c0a3050",
" ffff81002c0fbe78: ffff81002c0a3050",
"\n When a kernel symbol or an (expression) is used an argument, both the",
" resultant value and the input string are displayed:\n",
" %s> search anon_inode_inode (__down_interruptible+191)",
" ffff81000222a728: ffffffff80493d60 (anon_inode_inode)",
" ffff810005a1e918: ffffffff800649d6 (__down_interruptible+191)",
" ffff810005a1e9d0: ffffffff800649d6 (__down_interruptible+191)",
" ffff810005a1eb48: ffffffff800649d6 (__down_interruptible+191)",
" ffff81000b409c60: ffffffff80493d60 (anon_inode_inode)",
" ffff81000c155b98: ffffffff80493d60 (anon_inode_inode)",
" ffff8100194fac70: ffffffff80493d60 (anon_inode_inode)",
" ffff81001daa1008: ffffffff80493d60 (anon_inode_inode)",
" ffff810028b95830: ffffffff800649d6 (__down_interruptible+191)",
" ffff81002cea0c70: ffffffff80493d60 (anon_inode_inode)",
" ffff810031327268: ffffffff80493d60 (anon_inode_inode)",
" ffff810031327270: ffffffff800649d6 (__down_interruptible+191)",
" ffff810034b1ccd0: ffffffff800649d6 (__down_interruptible+191)",
" ffff8100399565a8: ffffffff80493d60 (anon_inode_inode)",
" ffff81003a278cd0: ffffffff800649d6 (__down_interruptible+191)",
" ffff81003cc23e08: ffffffff800649d6 (__down_interruptible+191)",
NULL
};
char *help_irq[] = {
"irq",
"IRQ data",
"[[[index ...] | -u ] | -d | -b | -a | -s [-c cpu]]",
" This command collaborates the data in an irq_desc_t, along with its",
" associated hw_interrupt_type and irqaction structure data, into a",
" consolidated per-IRQ display. For kernel versions 2.6.37 and later",
" the display consists of the irq_desc/irq_data address, its irqaction",
" address(es), and the irqaction name strings. Alternatively, the",
" intel interrupt descriptor table, bottom half data, cpu affinity for",
" in-use irqs, or kernel irq stats may be displayed. If no index value",
" argument(s) nor any options are entered, the IRQ data for all IRQs will",
" be displayed.\n",
" index a valid IRQ index.",
" -u dump data for in-use IRQs only.",
" -d dump the intel interrupt descriptor table.",
" -b dump bottom half data.",
" -a dump cpu affinity for in-use IRQs.",
" -s dump the kernel irq stats; if no cpu specified with -c, the",
" irq stats of all cpus will be displayed.",
" -c cpu only usable with the -s option, dump the irq stats of the ",
" specified cpu[s]; cpu can be specified as \"1,3,5\", \"1-3\",",
" \"1,3,5-7,10\", \"all\", or \"a\" (shortcut for \"all\").",
"\nEXAMPLES",
" Display the relevant data for IRQ 18 from a pre-2.6.37 kernel:\n",
" %s> irq 18",
" IRQ: 18",
" STATUS: 0 ",
" HANDLER: c02301e0 <ioapic_level_irq_type>",
" typename: c01f9e0c \"IO-APIC-level\"",
" startup: c0110234 <unmask_IO_APIC_irq>",
" shutdown: c01101cc <mask_IO_APIC_irq>",
" handle: c0110518 <do_level_ioapic_IRQ>",
" enable: c0110234 <unmask_IO_APIC_irq>",
" disable: c01101cc <mask_IO_APIC_irq>",
" ACTION: c009c6b0",
" handler: c01ce818 <do_aic7xxx_isr>",
" flags: 4000000 (SA_SHIRQ)",
" mask: 0",
" name: c0217780 \"aic7xxx\"",
" dev_id: c0090078",
" next: c009c770",
" ACTION: c009c770",
" handler: c01ce818 <do_aic7xxx_isr>",
" flags: 4000000 (SA_SHIRQ)",
" mask: 0",
" name: c0217780 \"aic7xxx\"",
" dev_id: c0091078",
" next: 0",
" DEPTH: 0\n",
" Display the relevant data for IRQ 21 from a 2.6.37 kernel:\n",
" %s> irq 21",
" IRQ IRQ_DESC/_DATA IRQACTION NAME",
" 21 ffff88003787f780 ffff8800379a8b40 \"ehci_hcd:usb2\"",
" ffff8800379cbac0 \"uhci_hcd:usb5\"",
" ffff8800379cb140 \"uhci_hcd:usb7\"",
" ",
" Display the intel interrupt descriptor table entries:\n",
" %s> irq -d",
" [0] divide_error",
" [1] debug",
" [2] nmi",
" [3] int3",
" [4] overflow",
" [5] bounds",
" [6] invalid_op",
" [7] device_not_available",
" [8] double_fault",
" [9] coprocessor_segment_overrun",
" [10] invalid_TSS",
" [11] segment_not_present",
" [12] stack_segment",
" [13] general_protection",
" [14] page_fault",
" [15] spurious_interrupt_bug",
" [16] coprocessor_error",
" [17] alignment_check",
" [18] ignore_int",
" [19] ignore_int",
" [20] ignore_int",
" [21] ignore_int",
" ...\n",
" [250] IRQ0xda_interrupt",
" [251] IRQ0xdb_interrupt",
" [252] IRQ0xdc_interrupt",
" [253] IRQ0xdd_interrupt",
" [254] IRQ0xde_interrupt",
" [255] spurious_interrupt\n",
" Display the bottom half data:\n",
" %s> irq -b",
" SOFTIRQ_VEC ACTION ",
" [0] ffffffff81068f60 <tasklet_hi_action> ",
" [1] ffffffff81071b80 <run_timer_softirq> ",
" [2] ffffffff813e6f30 <net_tx_action> ",
" [3] ffffffff813ee370 <net_rx_action> ",
" [4] ffffffff81211a60 <blk_done_softirq> ",
" [5] ffffffff812122f0 <blk_iopoll_softirq> ",
" [6] ffffffff81069090 <tasklet_action> ",
" [7] ffffffff81058830 <run_rebalance_domains> ",
" [8] ffffffff81087f00 <run_hrtimer_softirq> ",
" [9] ffffffff810ca7a0 <rcu_process_callbacks> \n",
" Display the cpu affinity for in-use IRQs:\n",
" %s> irq -a",
" IRQ NAME AFFINITY",
" 0 timer 0-23",
" 1 i8042 0-23",
" 8 rtc0 0-23",
" 9 acpi 0-23",
" 16 ehci_hcd:usb2,uhci_hcd:usb3,uhci_hcd:usb6 0,6,18",
" 17 uhci_hcd:usb4,uhci_hcd:usb7 0-23",
" 18 ehci_hcd:usb1,uhci_hcd:usb5,uhci_hcd:usb8,ioc0 0,11,23",
" 24 dmar0 0",
" 35 pciehp 0-23",
" 36 pciehp 0-23",
" 37 pciehp 0-23",
" 38 pciehp 0-23",
" 39 megasas 0-5,12-17",
" 40 lpfc:sp 0-5,12-17",
" 41 lpfc:fp 0,6-11,18-23",
" 42 lpfc:sp 0,6-11,18-23",
" 43 lpfc:fp 0,6-11,18-23",
" ...\n",
" 80 ioat-msix 0-23",
" 81 ioat-msix 0-23",
" 82 ioat-msix 0-23",
" 83 ioat-msix 0-23",
" 84 ioat-msix 0-23",
" 85 ioat-msix 0-23",
" 86 ioat-msix 0-23",
" 87 ioat-msix 0-23",
" 88 eth4 0,17\n",
" Display the kernel irq stats:\n",
" %s>irq -c 0,2 -s",
" CPU0 CPU2 ",
" 0: 2068161471 0 IR-IO-APIC-edge timer",
" 1: 9 0 IR-IO-APIC-edge i8042",
" 8: 1 0 IR-IO-APIC-edge rtc0",
" 9: 0 0 IR-IO-APIC-fasteoi acpi",
" 16: 36 0 IR-IO-APIC-fasteoi ehci_hcd:usb2",
" ...\n",
" 85: 3 0 IR-PCI-MSI-edge ioat-msix",
" 86: 3 0 IR-PCI-MSI-edge ioat-msix",
" 87: 3 0 IR-PCI-MSI-edge ioat-msix",
" 88: 24 295 IR-PCI-MSI-edge eth4",
NULL
};
char *help_ipcs[] = {
"ipcs",
"System V IPC facilities",
"[-smMq] [-n pid|task] [id | addr]",
" This command provides information on the System V IPC facilities. With no",
" arguments, the command will display kernel usage of all three factilities.",
" ",
" -s show semaphore arrays.",
" -m show shared memory segments.",
" -M show shared memory segments with additional details.",
" -q show message queues.",
" id show the data associated with this resource ID.",
" addr show the data associated with this virtual address of a",
" shmid_kernel, sem_array or msq_queue.",
"",
" For kernels supporting namespaces, the -n option may be used to",
" display the IPC facilities with respect to the namespace of a",
" specified task:\n",
" -n pid a process PID.",
" -n task a hexadecimal task_struct pointer.",
"\nEXAMPLES",
" Display all IPC facilities:\n",
" %s> ipcs",
" SHMID_KERNEL KEY SHMID UID PERMS BYTES NATTCH STATUS",
" ffff880473a28310 00000000 0 0 666 90000 1 ",
" ffff880473a28490 00000001 32769 0 666 90000 1 ",
" ffff880473a28250 00000002 65538 0 666 90000 1 ",
" ",
" SEM_ARRAY KEY SEMID UID PERMS NSEMS ",
" ffff88047200f9d0 00000000 0 0 600 1 ",
" ffff88046f826910 00000000 32769 0 600 1 ",
" ",
" MSG_QUEUE KEY MSQID UID PERMS USED-BYTES MESSAGES",
" ffff8100036bb8d0 000079d7 0 3369 666 16640 104",
" ffff8100036bb3d0 000079d8 32769 3369 666 12960 81",
" ffff810026d751d0 000079d9 65538 3369 666 10880 68",
" ",
" Display shared memory usage with detailed information:\n",
" %s> ipcs -M",
" SHMID_KERNEL KEY SHMID UID PERMS BYTES NATTCH STATUS",
" ffff880473a28310 00000000 0 0 666 90000 1 ",
" PAGES ALLOCATED/RESIDENT/SWAPPED: 22/1/0",
" INODE: ffff88047239cd98",
" ",
" SHMID_KERNEL KEY SHMID UID PERMS BYTES NATTCH STATUS",
" ffff880473a28490 00000001 32769 0 666 90000 1 ",
" PAGES ALLOCATED/RESIDENT/SWAPPED: 22/1/0",
" INODE: ffff88047239c118",
" ",
" SHMID_KERNEL KEY SHMID UID PERMS BYTES NATTCH STATUS",
" ffff880473a28250 00000002 65538 0 666 90000 1 ",
" PAGES ALLOCATED/RESIDENT/SWAPPED: 22/1/0",
" INODE: ffff880470503758",
" ",
" Display the shared memory data associated with shmid_kernel ffff880473a28250:\n",
" %s> ipcs -M ffff880473a28250",
" SHMID_KERNEL KEY SHMID UID PERMS BYTES NATTCH STATUS",
" ffff880473a28250 00000002 65538 0 666 90000 1 ",
" PAGES ALLOCATED/RESIDENT/SWAPPED: 22/1/0",
" INODE: ffff880470503758",
NULL
};
char *help_cpu[] = {
"cpu",
"set context to the active task on a cpu",
"[cpu]",
" This command sets the current context to the active task on a cpu. If no",
" argument is given, the current context is displayed.\n",
" cpu a valid cpu number\n",
" This command is not allowable on live systems.",
"\nEXAMPLES",
" %s> cpu 1",
" PID: 286",
" COMMAND: \"in.rlogind\"",
" TASK: c0b3a000 ",
" CPU: 1 ",
" STATE: TASK_RUNNING (ACTIVE)",
NULL
};
char *help_sys[] = {
"sys",
"system data",
"[-c [name|number]] config",
" This command displays system-specific data. If no arguments are entered,\n"
" the same system data shown during %s invocation is shown.\n",
" -c [name|number] If no name or number argument is entered, dump all",
" sys_call_table entries. If a name string is entered,",
" search the table for all entries containing the string.",
" If a number is entered, the table entry associated with",
" that number is displayed. If the current output radix",
" has been set to 16, the system call numbers will be ",
" displayed in hexadecimal.",
" config If the kernel was configured with CONFIG_IKCONFIG, then",
" dump the in-kernel configuration data.",
" -panic Panic a live system. Requires write permission to",
" /dev/mem. Results in the %s context causing an",
" \"Attempted to kill the idle task!\" panic. (The dump",
" will indicate that the %s context has a PID of 0).",
"\nEXAMPLES",
" Display essential system information:\n",
" %s> sys",
" KERNEL: vmlinux.4",
" DUMPFILE: lcore.cr.4",
" CPUS: 4",
" DATE: Mon Oct 11 18:48:55 1999",
" UPTIME: 10 days, 14:14:39",
" LOAD AVERAGE: 0.74, 0.23, 0.08",
" TASKS: 77",
" NODENAME: test.mclinux.com",
" RELEASE: 2.2.5-15smp",
" VERSION: #24 SMP Mon Oct 11 17:41:40 CDT 1999",
" MACHINE: i686 (500 MHz)",
" MEMORY: 1 GB",
"\n Dump the system configuration data (if CONFIG_IKCONFIG):\n",
" %s> sys config",
" #",
" # Automatically generated make config: don't edit",
" # Linux kernel version: 2.6.16",
" # Mon Apr 10 07:58:06 2006",
" #",
" CONFIG_X86_64=y",
" CONFIG_64BIT=y",
" CONFIG_X86=y",
" CONFIG_SEMAPHORE_SLEEPERS=y",
" CONFIG_MMU=y",
" CONFIG_RWSEM_GENERIC_SPINLOCK=y",
" CONFIG_GENERIC_CALIBRATE_DELAY=y",
" CONFIG_X86_CMPXCHG=y",
" CONFIG_EARLY_PRINTK=y",
" CONFIG_GENERIC_ISA_DMA=y",
" CONFIG_GENERIC_IOMAP=y",
" CONFIG_ARCH_MAY_HAVE_PC_FDC=y",
" CONFIG_DMI=y",
" ...",
"\n Dump the system call table:\n",
" %s> sys -c",
" NUM SYSTEM CALL FILE AND LINE NUMBER",
" 0 sys_ni_syscall ../kernel/sys.c: 48",
" 1 sys_exit ../kernel/exit.c: 404",
" 2 sys_fork ../arch/i386/kernel/process.c: 771",
" 3 sys_read ../fs/read_write.c: 117",
" 4 sys_write ../fs/read_write.c: 146",
" 5 sys_open ../fs/open.c: 754",
" 6 sys_close ../fs/open.c: 839",
" 7 sys_waitpid ../kernel/exit.c: 503",
" 8 sys_creat ../fs/open.c: 789",
" 9 sys_link ../fs/namei.c: 1213",
" 10 sys_unlink ../fs/namei.c: 1074",
" 11 sys_execve ../arch/i386/kernel/process.c: 806",
" ...",
"\n Find the system call number of the select system call:\n",
" %s> sys -c select",
" NUM SYSTEM CALL FILE AND LINE NUMBER",
" 65 sys_select ../fs/select.c: 259",
" ",
" If the current output radix has been set to 16, the system call numbers",
" will be displayed in hexadecimal.",
NULL
};
char *help_log[] = {
"log",
"dump system message buffer",
"[-tdm]",
" This command dumps the kernel log_buf contents in chronological order. The",
" command supports the older log_buf formats, which may or may not contain a",
" timestamp inserted prior to each message, as well as the newer variable-length",
" record format, where the timestamp is contained in each log entry's header.",
" ",
" -t Display the message text without the timestamp; only applicable to the",
" variable-length record format.",
" -d Display the dictionary of key/value pair properties that are optionally",
" appended to a message by the kernel's dev_printk() function; only",
" applicable to the variable-length record format.",
" -m Display the message log level in brackets preceding each message. For",
" the variable-length record format, the level will be displayed in ",
" hexadecimal, and depending upon the kernel version, also contains the",
" facility or flags bits.",
" ",
"\nEXAMPLES",
" Dump the kernel message buffer:\n",
" %s> log",
" Linux version 2.2.5-15smp (root@mclinux1) (gcc version egcs-2.91.66 19990",
" 314/Linux (egcs-1.1.2 release)) #1 SMP Thu Aug 26 11:04:37 EDT 1999",
" Intel MultiProcessor Specification v1.4",
" Virtual Wire compatibility mode.",
" OEM ID: DELL Product ID: WS 410 APIC at: 0xFEE00000",
" Processor #0 Pentium(tm) Pro APIC version 17",
" Processor #1 Pentium(tm) Pro APIC version 17",
" I/O APIC #2 Version 17 at 0xFEC00000.",
" Processors: 2",
" mapped APIC to ffffe000 (fee00000)",
" mapped IOAPIC to ffffd000 (fec00000)",
" Detected 447696347 Hz processor.",
" Console: colour VGA+ 80x25",
" Calibrating delay loop... 445.64 BogoMIPS",
" ...",
" 8K byte-wide RAM 5:3 Rx:Tx split, autoselect/Autonegotiate interface.",
" MII transceiver found at address 24, status 782d.",
" Enabling bus-master transmits and whole-frame receives.",
" Installing knfsd (copyright (C) 1996 okir@monad.swb.de).",
" nfsd_init: initialized fhcache, entries=256",
" ...",
" ",
" Do the same thing, but also show the log level preceding each message:\n",
" %s> log -m",
" <4>Linux version 2.2.5-15smp (root@mclinux1) (gcc version egcs-2.91.66 19990",
" 314/Linux (egcs-1.1.2 release)) #1 SMP Thu Aug 26 11:04:37 EDT 1999",
" <4>Intel MultiProcessor Specification v1.4",
" <4> Virtual Wire compatibility mode.",
" <4>OEM ID: DELL Product ID: WS 410 APIC at: 0xFEE00000",
" <4>Processor #0 Pentium(tm) Pro APIC version 17",
" <4>Processor #1 Pentium(tm) Pro APIC version 17",
" <4>I/O APIC #2 Version 17 at 0xFEC00000.",
" <4>Processors: 2",
" <4>mapped APIC to ffffe000 (fee00000)",
" <4>mapped IOAPIC to ffffd000 (fec00000)",
" <4>Detected 447696347 Hz processor.",
" <4>Console: colour VGA+ 80x25",
" <4>Calibrating delay loop... 445.64 BogoMIPS",
" ...",
" <6> 8K byte-wide RAM 5:3 Rx:Tx split, autoselect/Autonegotiate interface.",
" <6> MII transceiver found at address 24, status 782d.",
" <6> Enabling bus-master transmits and whole-frame receives.",
" <6>Installing knfsd (copyright (C) 1996 okir@monad.swb.de).",
" <7>nfsd_init: initialized fhcache, entries=256",
" ... ",
" ",
" On a system with the variable-length record format, and whose log_buf has been",
" filled and wrapped around, display the log with timestamp data:\n",
" %s> log",
" [ 0.467730] pci 0000:ff:02.0: [8086:2c10] type 00 class 0x060000",
" [ 0.467749] pci 0000:ff:02.1: [8086:2c11] type 00 class 0x060000",
" [ 0.467769] pci 0000:ff:02.4: [8086:2c14] type 00 class 0x060000",
" [ 0.467788] pci 0000:ff:02.5: [8086:2c15] type 00 class 0x060000",
" [ 0.467809] pci 0000:ff:03.0: [8086:2c18] type 00 class 0x060000",
" [ 0.467828] pci 0000:ff:03.1: [8086:2c19] type 00 class 0x060000",
" ...",
" ",
" Display the same message text as above, without the timestamp data:\n",
" %s> log -t",
" pci 0000:ff:02.0: [8086:2c10] type 00 class 0x060000",
" pci 0000:ff:02.1: [8086:2c11] type 00 class 0x060000",
" pci 0000:ff:02.4: [8086:2c14] type 00 class 0x060000",
" pci 0000:ff:02.5: [8086:2c15] type 00 class 0x060000",
" pci 0000:ff:03.0: [8086:2c18] type 00 class 0x060000",
" pci 0000:ff:03.1: [8086:2c19] type 00 class 0x060000",
" ...",
" ",
" Display the same message text as above, with appended dictionary data:\n",
" %s> log -td",
" pci 0000:ff:02.0: [8086:2c10] type 00 class 0x060000",
" SUBSYSTEM=pci",
" DEVICE=+pci:0000:ff:02.0",
" pci 0000:ff:02.1: [8086:2c11] type 00 class 0x060000",
" SUBSYSTEM=pci",
" DEVICE=+pci:0000:ff:02.1",
" pci 0000:ff:02.4: [8086:2c14] type 00 class 0x060000",
" SUBSYSTEM=pci",
" DEVICE=+pci:0000:ff:02.4",
" pci 0000:ff:02.5: [8086:2c15] type 00 class 0x060000",
" SUBSYSTEM=pci",
" DEVICE=+pci:0000:ff:02.5",
" pci 0000:ff:03.0: [8086:2c18] type 00 class 0x060000",
" SUBSYSTEM=pci",
" DEVICE=+pci:0000:ff:03.0",
" pci 0000:ff:03.1: [8086:2c19] type 00 class 0x060000",
" SUBSYSTEM=pci",
" DEVICE=+pci:0000:ff:03.1",
" ...",
NULL
};
char *help_whatis[] = {
"whatis",
"search symbol table for data or type information",
"[struct | union | typedef | symbol] ",
" This command displays the definition of structures, unions, typedefs or",
" text/data symbols.\n",
" struct a structure name. The output is the same as if the \"struct\"",
" command was used.",
" union a union name. The output is the same as if the \"union\" command",
" was used.",
" typedef a typedef name. If the typedef translates to a structure or union",
" the output is the same as if the \"struct\" or \"union\" command",
" was used. If the typedef is a primitive datatype, the one-line",
" declaration is displayed.",
" symbol a kernel symbol. ",
"\nEXAMPLES",
" Display the definition of a linux_binfmt structure:\n",
" %s> whatis linux_binfmt",
" struct linux_binfmt {",
" struct linux_binfmt *next;",
" struct module *module;",
" int (*load_binary) ();",
" int (*load_shlib) ();",
" int (*core_dump) ();",
" };",
" ",
" Since a kmem_bufctl_t is typedef'd to be a kmem_bufctl_s structure, the",
" output of the following two commands is identical:\n",
" %s> whatis kmem_bufctl_s",
" struct kmem_bufctl_s {",
" union {",
" struct kmem_bufctl_s *buf_nextp;",
" kmem_slab_t *buf_slabp;",
" void *buf_objp;",
" } u;",
" };",
" ",
" %s> whatis kmem_bufctl_t",
" struct kmem_bufctl_s {",
" union {",
" struct kmem_bufctl_s *buf_nextp;",
" kmem_slab_t *buf_slabp;",
" void *buf_objp;",
" } u;",
" };",
" SIZE: 4 (0x4)",
" ",
" Display the type data of sys_read() and jiffies text and data symbols:\n",
" %s> whatis sys_read",
" ssize_t sys_read(unsigned int, char *, size_t);",
" ",
" %s> whatis jiffies",
" long unsigned int jiffies;\n",
" Display definition of a kdev_t typedef:\n",
" %s> whatis kdev_t",
" typedef short unsigned int kdev_t;",
" SIZE: 2 (0x2)",
NULL
};
char *help_mount[] = {
"mount",
"mounted filesystem data",
"[-f][-i] [-n pid|task] [mount|vfsmount|superblock|dev|dir|dentry|inode]",
" This command displays basic information about the currently-mounted",
" filesystems. The per-filesystem dirty inode list or list of open",
" files for the filesystem may also be displayed.\n",
" -f dump dentries and inodes for open files in each filesystem.",
" -i dump all dirty inodes associated with each filesystem; only",
" supported on kernels prior to Linux 2.6.32.\n",
" For kernels supporting namespaces, the -n option may be used to",
" display the mounted filesystems with respect to the namespace of a",
" specified task:\n",
" -n pid a process PID.",
" -n task a hexadecimal task_struct pointer.\n",
" Specific filesystems may be selected using the following forms:\n",
" vfsmount hexadecimal address of a filesystem vfsmount structure.",
" mount hexadecimal address of a filesystem mount structure (Linux 3.3",
" and later).",
" superblock hexadecimal address of a filesystem super_block structure.",
" dev device name of a filesystem.",
" dir directory where a filesystem is mounted.",
" dentry hexadecimal address of an open dentry of a filesystem.",
" inode hexadecimal address of an open inode of a filesystem.",
" ",
" The first column of the command output displays the filesystem's vfsmount",
" structure address for kernels prior to Linux 3.3. For Linux 3.3 and later",
" kernels, the first column displays the filesystem's mount structure address,",
" which contains an embedded vfsmount structure.",
"\nEXAMPLES",
" Display mounted filesystem data:\n",
" %s> mount",
" VFSMOUNT SUPERBLK TYPE DEVNAME DIRNAME",
" c0089ea0 c0088a00 ext2 /dev/root / ",
" c0089cf0 c0088c00 proc /proc /proc",
" c0089e10 c0088800 ext2 /dev/sda5 /boot",
" c0089d80 c0088600 ext2 /dev/sda6 /usr",
" c0089f30 c0088400 devpts none /dev/pts",
" c3f4b010 c0088200 ext2 /dev/sda1 /home",
" ",
" On Linux 3.3 and later kernels, the filesystem's mount structure address",
" is shown:\n",
" %s> mount",
" MOUNT SUPERBLK TYPE DEVNAME DIRNAME",
" ffff880212fb8200 ffff880212fc0800 rootfs rootfs / ",
" ffff88020ffbea00 ffff880212fc2000 proc proc proc",
" ffff880211db7f00 ffff88020e01a800 sysfs sysfs /sys",
" ffff88020ffe1300 ffff880212a40000 devtmpfs devtmpfs /dev",
" ffff88020ff15000 ffff880212bbc800 devpts devpts /dev/pts",
" ffff88020e542800 ffff88020e62b800 tmpfs tmpfs /dev/shm",
" ...",
" ",
" Display the open files associated with each mounted filesystem:\n",
" %s> mount -f",
" VFSMOUNT SUPERBLK TYPE DEVNAME DIRNAME",
" c7fb2b80 c7fb3200 ext2 /dev/root /",
" OPEN FILES:",
" DENTRY INODE TYPE PATH",
" c6d02200 c6d0f7a0 REG usr/X11R6/lib/libX11.so.6.1",
" c6d02100 c6d0f9e0 REG usr/X11R6/lib/libXext.so.6.3",
" c6d02000 c6d0fc20 REG usr/X11R6/lib/libICE.so.6.3",
" c6d02680 c6d0f320 REG usr/X11R6/bin/xfs",
" c7106580 c70c5440 CHR dev/psaux",
" ...",
" ",
" Display the dirty inodes associated with each mounted filesystem:\n",
" %s> mount -i",
" VFSMOUNT SUPERBLK TYPE DEVNAME DIRNAME",
" c0089ea0 c0088a00 ext2 /dev/root /",
" DIRTY INODES",
" c7ad4008",
" c2233438",
" c72c4008",
" c7d6b548",
" c3af1a98",
" c7d6b768",
" c3c4e228",
" ...",
" ",
" Display the mounted filesystem containing inode c5000aa8:\n",
" %s> mount c5000aa8",
" VFSMOUNT SUPERBLK TYPE DEVNAME DIRNAME",
" c0089f30 c0088600 ext2 /dev/sda6 /usr ",
" ",
" Display the mounted filesystem containing inode ffff8801f4245e40:\n",
" %s> mount ffff8801f4245e40",
" MOUNT SUPERBLK TYPE DEVNAME DIRNAME",
" ffff88020ffbea00 ffff880212fc2000 proc proc /proc",
" ",
NULL
};
char *help_alias[] = {
"alias",
"command aliases",
"[alias] [command string]",
" This command creates an alias for a given command string. If no arguments",
" are entered, the current list of aliases are displayed. If one argument is",
" entered, the command string for that alias, if any, is displayed.\n",
" alias the single word to be used as an alias",
" command string the word(s) that will be substituted for the alias\n",
" Aliases may be created in four manners:\n",
" 1. entering the alias in $HOME/.%src.",
" 2. entering the alias in .%src in the current directory.",
" 3. executing an input file containing the alias command.",
" 4. during runtime with this command.\n",
" During initialization, $HOME/.%src is read first, followed by the",
" .%src file in the current directory. Aliases in the .%src file",
" in the current directory override those in $HOME/.%src. Aliases ",
" entered with this command or by runtime input file override those",
" defined in either .%src file. Aliases may be deleted by entering an",
" empty string for the second argument. If redirection characters are to",
" be part of the command string, the command string must be enclosed by",
" quotation marks.\n",
" Note that there are a number of helpful built-in aliases -- see the ",
" first example below.",
"\nEXAMPLES",
" Display the currently-defined aliases, which in this example, only",
" consist of the built-in aliases:\n",
" %s> alias",
" ORIGIN ALIAS COMMAND",
" builtin man help ",
" builtin ? help ",
" builtin quit q",
" builtin sf set scroll off",
" builtin sn set scroll on",
" builtin hex set radix 16",
" builtin dec set radix 10",
" builtin g gdb",
" builtin px p -x",
" builtin pd p -d",
" builtin for foreach",
" builtin size *",
" builtin dmesg log",
" builtin lsmod mod",
" builtin last ps -l",
" ",
" Create a new alias to be added to the list:\n",
" %s> alias kp kmem -p",
" ORIGIN ALIAS COMMAND",
" runtime kp kmem -p\n",
" Create an alias with redirection characters:\n",
" %s> alias ksd \"kmem -p | grep slab | grep DMA\"",
" ORIGIN ALIAS COMMAND",
" runtime ksd kmem -p | grep slab | grep DMA\n",
" Remove an alias:\n",
" %s> alias kp \"\"",
" alias deleted: kp",
NULL
};
char *help_pointer[] = {
"*",
"pointer-to short-cut",
"(struct or union command arguments)",
" This command is a short-cut command that replaces the requirement to enter",
" \"struct\" or \"union\" command names. For details on the arguments to",
" those commands, enter \"help struct\" or \"help union\".",
"\nEXAMPLES",
" Dump the page structure at address c02943c0:",
" ",
" %s> *page c02943c0",
" struct page {",
" next = 0xc0fae740, ",
" prev = 0xc0018fb0, ",
" inode = 0x0, ",
" offset = 0x3f000, ",
" next_hash = 0xc02d6310, ",
" count = {",
" counter = 0x1",
" }, ",
" flags = 0x310, ",
" wait = 0xc02943d8, ",
" pprev_hash = 0x0, ",
" buffers = 0x0",
" }",
NULL
};
char *help_vtop[] = {
"vtop",
"virtual to physical",
"[-c [pid | taskp]] [-u|-k] address ...",
" This command translates a user or kernel virtual address to its physical",
" address. Also displayed is the PTE translation, the vm_area_struct data",
" for user virtual addresses, the mem_map page data associated with the",
" physical page, and the swap location or file location if the page is",
" not mapped. The -u and -k options specify that the address is a user",
" or kernel virtual address; -u and -k are not necessary on processors whose",
" virtual addresses self-define themselves as user or kernel. User addresses",
" are translated with respect to the current context unless the -c option",
" is used. Kernel virtual addresses are translated using the swapper_pg_dir",
" as the base page directory unless the -c option is used.",
" ",
" -u The address is a user virtual address; only required",
" on processors with overlapping user and kernel virtual",
" address spaces.",
" -k The address is a kernel virtual address; only required",
" on processors with overlapping user and kernel virtual",
" address spaces.",
" -c [pid | taskp] Translate the virtual address from the page directory",
" of the specified PID or hexadecimal task_struct pointer.",
" However, if this command is invoked from \"foreach vtop\",",
" the pid or taskp argument should NOT be entered; the",
" address will be translated using the page directory of",
" each task specified by \"foreach\".",
" address A hexadecimal user or kernel virtual address.",
"\nEXAMPLES",
" Translate user virtual address 80b4000:\n",
" %s> vtop 80b4000",
" VIRTUAL PHYSICAL",
" 80b4000 660f000",
" ",
" PAGE DIRECTORY: c37f0000",
" PGD: c37f0080 => e0d067",
" PMD: c37f0080 => e0d067",
" PTE: c0e0d2d0 => 660f067",
" PAGE: 660f000",
" ",
" PTE PHYSICAL FLAGS",
" 660f067 660f000 (PRESENT|RW|USER|ACCESSED|DIRTY)",
" ",
" VMA START END FLAGS FILE",
" c773daa0 80b4000 810c000 77",
" ",
" PAGE PHYSICAL INODE OFFSET CNT FLAGS",
" c0393258 660f000 0 17000 1 uptodate",
" ",
" Translate kernel virtual address c806e000, first using swapper_pg_dir",
" as the page directory base, and secondly, using the page table base",
" of PID 1359:\n",
" %s> vtop c806e000",
" VIRTUAL PHYSICAL",
" c806e000 2216000",
" ",
" PAGE DIRECTORY: c0101000",
" PGD: c0101c80 => 94063",
" PMD: c0101c80 => 94063",
" PTE: c00941b8 => 2216063",
" PAGE: 2216000",
" ",
" PTE PHYSICAL FLAGS",
" 2216063 2216000 (PRESENT|RW|ACCESSED|DIRTY)",
" ",
" PAGE PHYSICAL INODE OFFSET CNT FLAGS",
" c02e9370 2216000 0 0 1 ",
" ",
" %s> vtop -c 1359 c806e000",
" VIRTUAL PHYSICAL",
" c806e000 2216000",
" ",
" PAGE DIRECTORY: c5caf000",
" PGD: c5cafc80 => 94063",
" PMD: c5cafc80 => 94063",
" PTE: c00941b8 => 2216063",
" PAGE: 2216000",
" ",
" PTE PHYSICAL FLAGS",
" 2216063 2216000 (PRESENT|RW|ACCESSED|DIRTY)",
" ",
" PAGE PHYSICAL INODE OFFSET CNT FLAGS",
" c02e9370 2216000 0 0 1 ",
" ",
" Determine swap location of user virtual address 40104000:\n",
" %s> vtop 40104000",
" VIRTUAL PHYSICAL",
" 40104000 (not mapped)",
" ",
" PAGE DIRECTORY: c40d8000",
" PGD: c40d8400 => 6bbe067",
" PMD: c40d8400 => 6bbe067",
" PTE: c6bbe410 => 58bc00 ",
" ",
" PTE SWAP OFFSET",
" 58bc00 /dev/sda8 22716",
" ",
" VMA START END FLAGS FILE",
" c7200ae0 40104000 40b08000 73 ",
" ",
" SWAP: /dev/sda8 OFFSET: 22716",
NULL
};
char *help_vm[] = {
"vm",
"virtual memory",
"[-p | -P vmaddr | -v | -m | -x | -d | [-R reference] | [-f vm_flags]]"
"\n [pid | taskp] ... ",
" This command displays basic virtual memory information of a context,",
" consisting of a pointer to its mm_struct and page dirctory, its RSS and ",
" total virtual memory size; and a list of pointers to each vm_area_struct,",
" its starting and ending address, vm_flags value, and file pathname. If no",
" arguments are entered, the current context is used. Additionally, the -p ",
" option translates each virtual page of each VM area to its physical address.",
" The -R option, typically invoked from \"foreach vm\", searches for references",
" to a supplied number, address, or filename argument, and prints only the",
" essential information leading up to and including the reference. ",
" Alternatively, the -m or -v options may be used to dump the task's mm_struct",
" or all of its vm_area_structs respectively. The -p, -v, -m, -R and -f",
" options are all mutually exclusive.\n",
" -p translate each virtual page to its physical address, or if",
" the page is not mapped, its swap device and offset, or",
" filename and offset.",
" -P vmaddr similar to -p, but only translate the pages belonging to the",
" specified VM area of a context.",
" -R reference search for references to this number or filename.",
" -m dump the mm_struct assocated with the task.",
" -v dump all of the vm_area_structs associated with the task.",
" -x override the default output format for the -m or -v options",
" with hexadecimal format.",
" -d override the default output format for the -m or -v options",
" with decimal format.",
" -f vm_flags translate the bits of a FLAGS (vm_flags) value.",
" pid a process PID.",
" taskp a hexadecimal task_struct pointer.",
"\nEXAMPLES",
" Display the virtual memory data of the current context:\n",
" %s> vm",
" PID: 30986 TASK: c0440000 CPU: 0 COMMAND: \"bash\"",
" MM PGD RSS TOTAL_VM",
" c303fe20 c4789000 88k 1728k",
" VMA START END FLAGS FILE",
" c0d1f540 8048000 80ad000 1875 /bin/bash",
" c0d1f400 80ad000 80b3000 1873 /bin/bash",
" c0d1f880 80b3000 80ec000 77",
" c0d1f0c0 40000000 40012000 875 /lib/ld-2.1.1.so",
" c0d1f700 40012000 40013000 873 /lib/ld-2.1.1.so",
" c0d1fe00 40013000 40014000 77",
" c0d1f580 40014000 40016000 73",
" c0d1f280 4001a000 4004b000 75 /usr/lib/libncurses.so.4.2",
" c0d1f100 4004b000 40054000 73 /usr/lib/libncurses.so.4.2",
" c0d1f600 40054000 40057000 73",
" c0d1f9c0 40057000 40059000 75 /lib/libdl-2.1.1.so",
" c0d1f800 40059000 4005a000 73 /lib/libdl-2.1.1.so",
" c0d1fd00 4005a000 40140000 75 /lib/libc-2.1.1.so",
" c0d1fe40 40140000 40145000 73 /lib/libc-2.1.1.so",
" c0d1f780 40145000 40148000 73",
" c0d1f140 40148000 40150000 75 /lib/libnss_files-2.1.1.so",
" c0d1fa80 40150000 40151000 73 /lib/libnss_files-2.1.1.so",
" c0d1fb00 40151000 4015a000 75 /lib/libnss_nisplus-2.1.1.so",
" c5f754e0 4015a000 4015b000 73 /lib/libnss_nisplus-2.1.1.so",
" c0d1fec0 4015b000 4016d000 75 /lib/libnsl-2.1.1.so",
" c5f75460 4016d000 4016e000 73 /lib/libnsl-2.1.1.so",
" c5f75420 4016e000 40170000 73",
" c5f753e0 40170000 40178000 75 /lib/libnss_nis-2.1.1.so",
" c5f753a0 40178000 40179000 73 /lib/libnss_nis-2.1.1.so",
" c0d1f240 bfffc000 c0000000 177\n",
" Display the virtual memory data along with page translations for PID 386:",
"\n %s> vm -p 386",
" PID: 386 TASK: c11cc000 CPU: 0 COMMAND: \"atd\"",
" MM PGD RSS TOTAL_VM",
" c7e30560 c10e5000 104k 1112k",
" VMA START END FLAGS FILE",
" c0fbe6a0 8048000 804b000 1875 /usr/sbin/atd",
" VIRTUAL PHYSICAL",
" 8048000 20e1000",
" 8049000 17c6000",
" 804a000 1f6f000",
" VMA START END FLAGS FILE",
" c61e0ba0 804b000 804d000 1873 /usr/sbin/atd",
" VIRTUAL PHYSICAL",
" 804b000 254d000",
" 804c000 6a9c000",
" VMA START END FLAGS FILE",
" c61e04e0 804d000 8050000 77 ",
" VIRTUAL PHYSICAL",
" 804d000 219d000",
" 804e000 2617000",
" 804f000 SWAP: /dev/sda8 OFFSET: 24225",
" VMA START END FLAGS FILE",
" c61e0720 40000000 40012000 875 /lib/ld-2.1.1.so",
" VIRTUAL PHYSICAL",
" 40000000 FILE: /lib/ld-2.1.1.so OFFSET: 0",
" 40001000 FILE: /lib/ld-2.1.1.so OFFSET: 1000",
" 40002000 FILE: /lib/ld-2.1.1.so OFFSET: 2000",
" 40003000 FILE: /lib/ld-2.1.1.so OFFSET: 3000",
" 40004000 FILE: /lib/ld-2.1.1.so OFFSET: 4000",
" 40005000 FILE: /lib/ld-2.1.1.so OFFSET: 5000",
" ...",
" ",
" Although the -R option is typically invoked from \"foreach vm\", it can be",
" executed directly. This example displays all VM areas with vm_flags of 75:\n",
" %s> vm -R 75",
" PID: 694 TASK: c0c76000 CPU: 1 COMMAND: \"crash\"",
" MM PGD RSS TOTAL_VM",
" c6c43110 c0fe9000 8932k 10720k ",
" VMA START END FLAGS FILE",
" c322c0d0 40019000 4004a000 75 /usr/lib/libncurses.so.4.2",
" c67537c0 40056000 40071000 75 /lib/libm-2.1.1.so",
" c6753d00 40072000 40074000 75 /lib/libdl-2.1.1.so",
" c6753540 40075000 40081000 75 /usr/lib/libz.so.1.1.3",
" c6753740 40085000 4016b000 75 /lib/libc-2.1.1.so",
" ",
" One reason to use -R directly is to pare down the output associated with",
" the -p option on a task with a huge address space. This example displays",
" the page data associated with virtual address 40121000:\n",
" %s> vm -R 40121000",
" PID: 694 TASK: c0c76000 CPU: 0 COMMAND: \"crash\"",
" MM PGD RSS TOTAL_VM",
" c6c43110 c0fe9000 8928k 10720k ",
" VMA START END FLAGS FILE",
" c6753740 40085000 4016b000 75 /lib/libc-2.1.1.so",
" VIRTUAL PHYSICAL",
" 40121000 FILE: /lib/libc-2.1.1.so OFFSET: 9c000",
" ",
" Display the mm_struct for PID 4777:",
"\n %s> vm -m 4777",
" PID: 4777 TASK: c0896000 CPU: 0 COMMAND: \"bash\"",
" struct mm_struct {",
" mmap = 0xc6caa1c0, ",
" mmap_avl = 0x0, ",
" mmap_cache = 0xc6caabc0, ",
" pgd = 0xc100a000, ",
" count = {",
" counter = 0x1",
" }, ",
" map_count = 0x14, ",
" mmap_sem = {",
" count = {",
" counter = 0x1",
" }, ",
" waking = 0x0, ",
" wait = 0x0",
" }, ",
" context = 0x0, ",
" start_code = 0x8048000, ",
" end_code = 0x809c6f7, ",
" start_data = 0x0, ",
" end_data = 0x80a2090, ",
" start_brk = 0x80a5420, ",
" brk = 0x80b9000, ",
" start_stack = 0xbffff9d0, ",
" arg_start = 0xbffffad1, ",
" arg_end = 0xbffffad7, ",
" env_start = 0xbffffad7, ",
" env_end = 0xbffffff2, ",
" rss = 0xf6, ",
" total_vm = 0x1a3, ",
" locked_vm = 0x0, ",
" def_flags = 0x0, ",
" cpu_vm_mask = 0x0, ",
" swap_cnt = 0x23d,",
" swap_address = 0x0, ",
" segments = 0x0",
" }",
" ",
" Display all of the vm_area_structs for task c47d4000:",
"\n %s> vm -v c47d4000",
" PID: 4971 TASK: c47d4000 CPU: 1 COMMAND: \"login\"",
" struct vm_area_struct {",
" vm_mm = 0xc4b0d200, ",
" vm_start = 0x8048000, ",
" vm_end = 0x804d000, ",
" vm_next = 0xc3e3abd0, ",
" vm_page_prot = {",
" pgprot = 0x25",
" }, ",
" vm_flags = 0x1875, ",
" vm_avl_height = 0x1, ",
" vm_avl_left = 0x0, ",
" vm_avl_right = 0x0, ",
" vm_next_share = 0x0, ",
" vm_pprev_share = 0xc3e3abf0, ",
" vm_ops = 0xc02392a0, ",
" vm_offset = 0x0, ",
" vm_file = 0xc1e23660, ",
" vm_pte = 0x0",
" }",
" struct vm_area_struct {",
" vm_mm = 0xc4b0d200, ",
" vm_start = 0x804d000, ",
" vm_end = 0x804e000, ",
" vm_next = 0xc3e3a010, ",
" vm_page_prot = {",
" pgprot = 0x25",
" }, ",
" vm_flags = 0x1873, ",
" vm_avl_height = 0x2, ",
" vm_avl_left = 0xc3e3a810, ",
" vm_avl_right = 0xc3e3a010, ",
" vm_next_share = 0xc3e3a810, ",
" vm_pprev_share = 0xc3699c14",
" ...",
" ",
" Translate a FLAGS value:\n",
" %s> vm -f 3875",
" 3875: (READ|EXEC|MAYREAD|MAYWRITE|MAYEXEC|DENYWRITE|EXECUTABLE|LOCKED)",
" ",
" Display the page translations of the VM area at address f5604f2c:\n",
" %s> vm -P f5604f2c",
" PID: 5508 TASK: f56a9570 CPU: 0 COMMAND: \"crond\"",
" VMA START END FLAGS FILE",
" f5604f2c f5b000 f67000 8000075 /lib/libnss_files-2.12.so",
" VIRTUAL PHYSICAL",
" f5b000 3fec1000",
" f5c000 3d3a4000",
" f5d000 FILE: /lib/libnss_files-2.12.so OFFSET: 2000",
" f5e000 FILE: /lib/libnss_files-2.12.so OFFSET: 3000",
" f5f000 FILE: /lib/libnss_files-2.12.so OFFSET: 4000",
" f60000 3fd31000",
" f61000 3fd32000",
" f62000 FILE: /lib/libnss_files-2.12.so OFFSET: 7000",
" f63000 FILE: /lib/libnss_files-2.12.so OFFSET: 8000",
" f64000 3ff35000",
" f65000 FILE: /lib/libnss_files-2.12.so OFFSET: a000",
" f66000 FILE: /lib/libnss_files-2.12.so OFFSET: b000",
NULL
};
char *help_task[] = {
"task",
"task_struct and thread_info contents",
"[-R member[,member]] [-dx] [pid | taskp] ...",
" This command dumps a formatted display of the contents of a task's",
" task_struct and thread_info structures. Multiple task or PID numbers",
" may be entered; if no arguments are entered, the task_struct and",
" thread_info structures of the current context are displayed. The -R option,",
" which may also be invoked indirectly via \"foreach task\", pares the output",
" down to one or more structure members.",
" ",
" pid a process PID.",
" taskp a hexadecimal task_struct pointer.",
" -R member a comma-separated list of one or more task_struct and/or",
" thread_info structure members.",
" -x override default output format with hexadecimal format.",
" -d override default output format with decimal format.",
"\nEXAMPLES",
" Dump the task_struct and thread_info structures of the current context",
" in hexadecimal format:\n",
" %s> task -x",
" PID: 3176 TASK: f2451550 CPU: 1 COMMAND: \"memtest\"",
" struct task_struct {",
" state = 0x0, ",
" stack = 0xf05b6000, ",
" usage = {",
" counter = 0x2",
" }, ",
" flags = 0x402040, ",
" ptrace = 0x0, ",
" lock_depth = 0xffffffff, ",
" prio = 0x78, ",
" static_prio = 0x78, ",
" normal_prio = 0x78, ",
" rt_priority = 0x0, ",
" ...",
" perf_event_ctxp = {0x0, 0x0}, ",
" memcg_batch = {",
" do_batch = 0x0, ",
" memcg = 0x0, ",
" bytes = 0x0, ",
" memsw_bytes = 0x0",
" }",
" }",
" ",
" struct thread_info {",
" task = 0xf2451550, ",
" exec_domain = 0xc0a60860, ",
" flags = 0x88, ",
" status = 0x0, ",
" cpu = 0x1, ",
" preempt_count = 0x4010000, ",
" addr_limit = {",
" seg = 0xc0000000",
" }, ",
" restart_block = {",
" ...",
" ",
" Display the ngroups and groups task_struct members for PID 2958:\n",
" %s> task -R ngroups,groups 2958",
" PID: 2958 TASK: c6718000 CPU: 0 COMMAND: \"bash\"",
" ngroups = 6, ",
" groups = {504, 8, 9, 1000, 1007, 1006, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,",
" 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},",
" ",
" NOTE: When this command is invoked directly (i.e., not from \"foreach\"), it",
" is not necessary to include the \"-R\" before the task_struct/thread_info",
" member name(s).",
NULL
};
char *help_sig[] = {
"sig",
"task signal handling",
"[[-l] | [-s sigset]] | [-g] [pid | taskp] ...",
" This command displays signal-handling data of one or more tasks. Multiple",
" task or PID numbers may be entered; if no arguments are entered, the signal",
" handling data of the current context will be displayed. The default display",
" shows:",
" ",
" 1. A formatted dump of the \"sig\" signal_struct structure referenced by",
" the task_struct. For each defined signal, it shows the sigaction",
" structure address, the signal handler, the signal sigset_t mask ",
" (also expressed as a 64-bit hexadecimal value), and the flags.",
" 2. Whether the task has an unblocked signal pending.",
" 3. The contents of the \"blocked\" and \"signal\" sigset_t structures",
" from the task_struct/signal_struct, both of which are represented ",
" as a 64-bit hexadecimal value.",
" 4. For each queued signal, private and/or shared, if any, its signal",
" number and associated siginfo structure address.",
" ",
" The -l option lists the signal numbers and their name(s). The -s option",
" translates a 64-bit hexadecimal value representing the contents of a",
" sigset_t structure into the signal names whose bits are set.",
" ",
" pid a process PID.",
" taskp a hexadecimal task_struct pointer.",
" -g displays signal information for all threads in a task's ",
" thread group.",
" -l displays the defined signal numbers and names.",
" -s sigset translates a 64-bit hexadecimal value representing a sigset_t",
" into a list of signal names associated with the bits set.",
"\nEXAMPLES",
" Dump the signal-handling data of PID 8970:\n",
" %s> sig 8970",
" PID: 8970 TASK: f67d8560 CPU: 1 COMMAND: \"procsig\"",
" SIGNAL_STRUCT: f6018680 COUNT: 1",
" SIG SIGACTION HANDLER MASK FLAGS ",
" [1] f7877684 SIG_DFL 0000000000000000 0 ",
" [2] f7877698 SIG_DFL 0000000000000000 0 ",
" ...",
" [8] f7877710 SIG_DFL 0000000000000000 0 ",
" [9] f7877724 SIG_DFL 0000000000000000 0 ",
" [10] f7877738 804867a 0000000000000000 80000000 (SA_RESETHAND)",
" [11] f787774c SIG_DFL 0000000000000000 0 ",
" [12] f7877760 804867f 0000000000000000 10000004 (SA_SIGINFO|SA_RESTART)",
" [13] f7877774 SIG_DFL 0000000000000000 0 ",
" ...",
" [31] f78778dc SIG_DFL 0000000000000000 0 ",
" [32] f78778f0 SIG_DFL 0000000000000000 0 ",
" [33] f7877904 SIG_DFL 0000000000000000 0 ",
" [34] f7877918 804867f 0000000000000000 10000004 (SA_SIGINFO|SA_RESTART)",
" [35] f787792c SIG_DFL 0000000000000000 0 ",
" [36] f7877940 SIG_DFL 0000000000000000 0 ",
" ...",
" [58] f7877af8 SIG_DFL 0000000000000000 0 ",
" [59] f7877b0c SIG_DFL 0000000000000000 0 ",
" [60] f7877b20 SIG_DFL 0000000000000000 0 ",
" [61] f7877b34 SIG_DFL 0000000000000000 0 ",
" [62] f7877b48 SIG_DFL 0000000000000000 0 ",
" [63] f7877b5c SIG_DFL 0000000000000000 0 ",
" [64] f7877b70 804867f 0000000000000000 10000004 (SA_SIGINFO|SA_RESTART)",
" SIGPENDING: no",
" BLOCKED: 8000000200000800",
" PRIVATE_PENDING",
" SIGNAL: 0000000200000800",
" SIGQUEUE: SIG SIGINFO ",
" 12 f51b9c84",
" 34 f51b9594",
" SHARED_PENDING",
" SIGNAL: 8000000000000800",
" SIGQUEUE: SIG SIGINFO ",
" 12 f51b9188",
" 64 f51b9d18",
" 64 f51b9500",
" ",
" Dump the signal-handling data for all tasks in the thread group containing",
" PID 2578:\n",
" %s> sig -g 2578",
" PID: 2387 TASK: f617d020 CPU: 0 COMMAND: \"slapd\"",
" SIGNAL_STRUCT: f7dede00 COUNT: 6",
" SIG SIGACTION HANDLER MASK FLAGS",
" [1] c1f60c04 a258a7 0000000000000000 10000000 (SA_RESTART)",
" [2] c1f60c18 a258a7 0000000000000000 10000000 (SA_RESTART)",
" [3] c1f60c2c SIG_DFL 0000000000000000 0",
" [4] c1f60c40 SIG_DFL 0000000000000000 0",
" [5] c1f60c54 a258a7 0000000000000000 10000000 (SA_RESTART)",
" [6] c1f60c68 SIG_DFL 0000000000000000 0",
" [7] c1f60c7c SIG_DFL 0000000000000000 0",
" [8] c1f60c90 SIG_DFL 0000000000000000 0",
" [9] c1f60ca4 SIG_DFL 0000000000000000 0",
" [10] c1f60cb8 a25911 0000000000000000 10000000 (SA_RESTART)",
" ...",
" [64] c1f610f0 SIG_DFL 0000000000000000 0",
" SHARED_PENDING",
" SIGNAL: 0000000000000000",
" SIGQUEUE: (empty)",
" ",
" PID: 2387 TASK: f617d020 CPU: 0 COMMAND: \"slapd\"",
" SIGPENDING: no",
" BLOCKED: 0000000000000000",
" PRIVATE_PENDING",
" SIGNAL: 0000000000000000",
" SIGQUEUE: (empty)",
" ",
" PID: 2392 TASK: f6175aa0 CPU: 0 COMMAND: \"slapd\"",
" SIGPENDING: no",
" BLOCKED: 0000000000000000",
" PRIVATE_PENDING",
" SIGNAL: 0000000000000000",
" SIGQUEUE: (empty)",
" ",
" PID: 2523 TASK: f7cd4aa0 CPU: 1 COMMAND: \"slapd\"",
" SIGPENDING: no",
" BLOCKED: 0000000000000000",
" PRIVATE_PENDING",
" SIGNAL: 0000000000000000",
" SIGQUEUE: (empty)",
" ",
" ...",
" ",
" Translate the sigset_t mask value, cut-and-pasted from the signal handling",
" data from signals 1 and 10 above:",
" ",
" %s> sig -s 800A000000000201",
" SIGHUP SIGUSR1 SIGRTMAX-14 SIGRTMAX-12 SIGRTMAX",
" ",
" List the signal numbers and their names:",
" ",
" %s> sig -l",
" [1] SIGHUP",
" [2] SIGINT",
" [3] SIGQUIT",
" [4] SIGILL",
" [5] SIGTRAP",
" [6] SIGABRT/SIGIOT",
" [7] SIGBUS",
" [8] SIGFPE",
" [9] SIGKILL",
" [10] SIGUSR1",
" [11] SIGSEGV",
" [12] SIGUSR2",
" [13] SIGPIPE",
" [14] SIGALRM",
" [15] SIGTERM",
" [16] SIGSTKFLT",
" [17] SIGCHLD/SIGCLD",
" [18] SIGCONT",
" [19] SIGSTOP",
" [20] SIGTSTP",
" [21] SIGTTIN",
" [22] SIGTTOU",
" [23] SIGURG",
" [24] SIGXCPU",
" [25] SIGXFSZ",
" [26] SIGVTALRM",
" [27] SIGPROF",
" [28] SIGWINCH",
" [29] SIGIO/SIGPOLL",
" [30] SIGPWR",
" [31] SIGSYS",
" [32] SIGRTMIN",
" [33] SIGRTMIN+1",
" [34] SIGRTMIN+2",
" [35] SIGRTMIN+3",
" [36] SIGRTMIN+4",
" [37] SIGRTMIN+5",
" [38] SIGRTMIN+6",
" [39] SIGRTMIN+7",
" [40] SIGRTMIN+8",
" [41] SIGRTMIN+9",
" [42] SIGRTMIN+10",
" [43] SIGRTMIN+11",
" [44] SIGRTMIN+12",
" [45] SIGRTMIN+13",
" [46] SIGRTMIN+14",
" [47] SIGRTMIN+15",
" [48] SIGRTMIN+16",
" [49] SIGRTMAX-15",
" [50] SIGRTMAX-14",
" [51] SIGRTMAX-13",
" [52] SIGRTMAX-12",
" [53] SIGRTMAX-11",
" [54] SIGRTMAX-10",
" [55] SIGRTMAX-9",
" [56] SIGRTMAX-8",
" [57] SIGRTMAX-7",
" [58] SIGRTMAX-6",
" [59] SIGRTMAX-5",
" [60] SIGRTMAX-4",
" [61] SIGRTMAX-3",
" [62] SIGRTMAX-2",
" [63] SIGRTMAX-1",
" [64] SIGRTMAX",
NULL
};
char *help_struct[] = {
"struct",
"structure contents",
"struct_name[.member[,member]][-o][-l offset][-rfuxdp]\n"
" [address | symbol][:cpuspec] [count | -c count]",
" This command displays either a structure definition, or a formatted display",
" of the contents of a structure at a specified address. When no address is",
" specified, the structure definition is shown along with the structure size.",
" A structure member may be appended to the structure name in order to limit",
" the scope of the data displayed to that particular member; when no address",
" is specified, the member's offset and definition are shown.\n",
" struct_name name of a C-code structure used by the kernel.",
" .member name of a structure member; to display multiple members of a",
" structure, use a comma-separated list of members.",
" -o show member offsets when displaying structure definitions; ",
" if used with an address or symbol argument, each member will",
" be preceded by its virtual address.",
" -l offset if the address argument is a pointer to a structure member that",
" is contained by the target data structure, typically a pointer",
" to an embedded list_head, the offset to the embedded member may",
" be entered in either of the following manners:",
" 1. in \"structure.member\" format.",
" 2. a number of bytes. ",
" -r raw dump of structure data.",
" -f address argument is a dumpfile offset.",
" -u address argument is a user virtual address in the current",
" context.",
" -x override default output format with hexadecimal format.",
" -d override default output format with decimal format.",
" -p if a structure member is a pointer value, show the member's",
" data type on the output line; and on the subsequent line(s),",
" dereference the pointer, display the pointer target's symbol",
" value in brackets if appropriate, and if possible, display the",
" target data; requires an address argument.",
" address hexadecimal address of a structure; if the address points",
" to an embedded list_head structure contained within the",
" target data structure, then the \"-l\" option must be used.",
" symbol symbolic reference to the address of a structure.",
" :cpuspec CPU specification for a per-cpu address or symbol:",
" : CPU of the currently selected task.",
" :a[ll] all CPUs.",
" :#[-#][,...] CPU list(s), e.g. \"1,3,5\", \"1-3\",",
" or \"1,3,5-7,10\".",
" count count of structures to dump from an array of structures;",
" if used, this must be the last argument entered.",
" -c count \"-c\" is only required if \"count\" is not the last argument",
" entered or if a negative number is entered; if a negative",
" value is entered, the (positive) \"count\" structures that",
" lead up to and include the target structure will be displayed.\n",
" Structure data, sizes, and member offsets are shown in the current output",
" radix unless the -x or -d option is specified.",
" ",
" Please note that in the vast majority of cases, the \"struct\" command",
" name may be dropped; if the structure name does not conflict with any %s",
" or gdb command name, then the \"struct_name[.member]\" argument will be",
" recognized as a structure name, and this command automatically executed.",
" See the NOTE below.",
"\nEXAMPLES",
" Display the vm_area_struct at address c1e44f10:\n",
" %s> struct vm_area_struct c1e44f10",
" struct vm_area_struct {",
" vm_mm = 0xc2857750,",
" vm_start = 0x8048000, ",
" vm_end = 0x80a5000, ",
" vm_next = 0xc1e44a10,",
" vm_page_prot = {",
" pgprot = 0x25 ",
" },",
" vm_flags = 0x1875,",
" vm_avl_height = 0x2, ",
" vm_avl_left = 0xc30fe200,",
" vm_avl_right = 0xc30fed00,",
" vm_next_share = 0x0, ",
" vm_pprev_share = 0xc1e44a30,",
" vm_ops = 0xc0215ca0,",
" vm_offset = 0x0, ",
" vm_file = 0xc0bfdc70,",
" vm_pte = 0 ",
" }\n",
" Display the definition and size of a vm_area_struct structure. This first",
" example below displays just the structure and size. The second example",
" uses the -o option to also display member offsets. Both examples were",
" run with the output radix set to 10 (decimal):\n",
" %s> struct vm_area_struct",
" struct vm_area_struct {",
" struct mm_struct *vm_mm;",
" long unsigned int vm_start;",
" long unsigned int vm_end;",
" struct vm_area_struct *vm_next;",
" pgprot_t vm_page_prot;",
" short unsigned int vm_flags;",
" short int vm_avl_height;",
" struct vm_area_struct *vm_avl_left;",
" struct vm_area_struct *vm_avl_right;",
" struct vm_area_struct *vm_next_share;",
" struct vm_area_struct **vm_pprev_share;",
" struct vm_operations_struct *vm_ops;",
" long unsigned int vm_offset;",
" struct file *vm_file;",
" long unsigned int vm_pte;",
" }",
" SIZE: 56\n",
" %s> struct vm_area_struct -o",
" struct vm_area_struct {",
" [0] struct mm_struct *vm_mm;",
" [4] long unsigned int vm_start;",
" [8] long unsigned int vm_end;",
" [12] struct vm_area_struct *vm_next;",
" [16] pgprot_t vm_page_prot;",
" [20] short unsigned int vm_flags;",
" [22] short int vm_avl_height;",
" [24] struct vm_area_struct *vm_avl_left;",
" [28] struct vm_area_struct *vm_avl_right;",
" [32] struct vm_area_struct *vm_next_share;",
" [36] struct vm_area_struct **vm_pprev_share;",
" [40] struct vm_operations_struct *vm_ops;",
" [44] long unsigned int vm_offset;",
" [48] struct file *vm_file;",
" [52] long unsigned int vm_pte;",
" }",
" SIZE: 56\n",
" Display the definition and offset of the pgd member of an mm_struct:\n",
" %s> struct mm_struct.pgd",
" struct mm_struct {",
" [80] pgd_t *pgd;",
" }\n",
" Display the pgd member of the mm_struct at address ffff810022e7d080:\n",
" %s> struct mm_struct.pgd ffff810022e7d080",
" pgd = 0xffff81000e3ac000\n",
" Display the pgd_t pointed to by the mm_struct.pgd pointer above, forcing",
" the output to be expressed in hexadecimal:\n",
" %s> mm_struct.pgd ffff810022e7d080 -px",
" pgd_t *pgd = 0xffff81000e3ac000",
" -> {",
" pgd = 0x2c0a6067",
" }\n",
" Display the thread_info structure pointed to by the thread_info",
" member of the task_struct at ffff8100181190c0:\n",
" %s> task_struct.thread_info ffff8100181190c0 -p",
" struct thread_info *thread_info = 0xffff810023c06000",
" -> {",
" task = 0xffff8100181190c0,",
" exec_domain = 0xffffffff802f78e0,",
" flags = 128,",
" status = 1,",
" cpu = 3,",
" preempt_count = 0,",
" addr_limit = {",
" seg = 18446604435732824064",
" },",
" restart_block = {",
" fn = 0xffffffff80095a52 <do_no_restart_syscall>,",
" arg0 = 0,",
" arg1 = 0,",
" arg2 = 0,",
" arg3 = 0",
" }",
" }\n",
" Display the flags and virtual members of 4 contigous page structures",
" in the mem_map page structure array:\n",
" %s> page.flags,virtual c101196c 4",
" flags = 0x8000,",
" virtual = 0xc04b0000",
" ",
" flags = 0x8000,",
" virtual = 0xc04b1000",
" ",
" flags = 0x8000,",
" virtual = 0xc04b2000",
" ",
" flags = 0x8000,",
" virtual = 0xc04b3000",
" ",
" Display the array of tcp_sl_timer structures declared by tcp_slt_array[]:\n",
" %s> struct tcp_sl_timer tcp_slt_array 4",
" struct tcp_sl_timer {",
" count = {",
" counter = 0x0 ",
" },",
" period = 0x32, ",
" last = 0x1419e4, ",
" handler = 0xc0164854 <tcp_syn_recv_timer>",
" }",
" struct tcp_sl_timer {",
" count = {",
" counter = 0x2 ",
" },",
" period = 0x753, ",
" last = 0x14a6df, ",
" handler = 0xc01645b0 <tcp_keepalive>",
" }",
" struct tcp_sl_timer {",
" count = {",
" counter = 0x0 ",
" },",
" period = 0x2ee, ",
" last = 0x143134, ",
" handler = 0xc016447c <tcp_twkill>",
" }",
" struct tcp_sl_timer {",
" count = {",
" counter = 0x0 ",
" },",
" period = 0x64, ",
" last = 0x143198, ",
" handler = 0xc0164404 <tcp_bucketgc>",
" }",
" ",
" Without using the \"struct\" command name, display the the \"d_child\" ",
" list_head member from a dentry structure:\n",
" %s> dentry.d_child 0xe813cb4",
" d_child = {",
" next = 0x3661344,",
" prev = 0xdea4bc4",
" },",
" ",
" Display the child dentry structure referenced by the \"next\" pointer above.",
" Since the \"next\" address of 0x3661344 above is a pointer to an embedded",
" list_head structure within the child dentry structure, the -l option",
" is required:\n",
" %s> dentry -l dentry.d_child 0x3661344",
" struct dentry {",
" d_count = {",
" counter = 1",
" }, ",
" d_flags = 0, ",
" d_inode = 0xf9aa604, ",
" d_parent = 0x11152b1c, ",
" d_hash = {",
" next = 0x11fb3fc0, ",
" prev = 0x11fb3fc0",
" }, ",
" d_lru = {",
" next = 0x366133c, ",
" prev = 0x366133c",
" }, ",
" d_child = {",
" next = 0x36613cc, ",
" prev = 0xe813cd4",
" }, ",
" d_subdirs = {",
" next = 0x366134c, ",
" prev = 0x366134c",
" }, ",
" d_alias = {",
" next = 0xf9aa614, ",
" prev = 0xf9aa614",
" }, ",
" d_mounted = 0, ",
" d_name = {",
" name = 0x3661384 \"boot.log\", ",
" len = 8, ",
" hash = 1935169207",
" }, ",
" d_time = 1515870810, ",
" d_op = 0x0, ",
" d_sb = 0x11fc9c00, ",
" d_vfs_flags = 0, ",
" d_fsdata = 0x0, ",
" d_extra_attributes = 0x0, ",
" d_iname = \"boot.log\\000\"",
" }",
" ",
" Display the virtual address of each member of the task_struct at",
" ffff8100145d2080:\n",
" %s> task_struct -o ffff8100145d2080",
" struct task_struct {",
" [ffff8100145d2080] volatile long int state;",
" [ffff8100145d2088] struct thread_info *thread_info;",
" [ffff8100145d2090] atomic_t usage;",
" [ffff8100145d2098] long unsigned int flags;",
" [ffff8100145d20a0] int lock_depth;",
" [ffff8100145d20a4] int load_weight;",
" [ffff8100145d20a8] int prio;",
" [ffff8100145d20ac] int static_prio;",
" [ffff8100145d20b0] int normal_prio;",
" [ffff8100145d20b8] struct list_head run_list;",
" [ffff8100145d20c8] struct prio_array *array;",
" ...",
" ",
" For an example of displaying per-cpu variables, consider the",
" struct hd_struct.dkstats member, which is a percpu pointer to",
" a disk_stats structure:",
"",
" %s> struct hd_struct.dkstats ",
" struct hd_struct {",
" [1232] struct disk_stats *dkstats;",
" }",
"",
" Taking an hd_struct at address ffff8802450e2848, display all",
" of the per-cpu disk_stats structures that it references:",
" ",
" %s> struct hd_struct.dkstats ffff8802450e2848",
" dkstats = 0x60fdb48026c8",
" %s> struct disk_stats 0x60fdb48026c8:a",
" [0]: ffffe8fefe6026c8",
" struct disk_stats {",
" sectors = {451376, 80468}, ",
" ios = {6041, 971}, ",
" merges = {386, 390}, ",
" ticks = {194877, 56131}, ",
" io_ticks = 12371, ",
" time_in_queue = 309163",
" }",
" [1]: ffffe8fefe8026c8",
" struct disk_stats {",
" sectors = {0, 0}, ",
" ios = {0, 0}, ",
" merges = {7, 242}, ",
" ticks = {0, 0}, ",
" io_ticks = 23, ",
" time_in_queue = 581",
" }",
" [2]: ffffe8fefea026c8",
" struct disk_stats {",
" sectors = {0, 0}, ",
" ios = {0, 0}, ",
" merges = {4, 112}, ",
" ticks = {0, 0}, ",
" io_ticks = 11, ",
" time_in_queue = 305",
" }",
" [3]: ffffe8fefec026c8",
" struct disk_stats {",
" sectors = {0, 0}, ",
" ios = {0, 0}, ",
" merges = {5, 54}, ",
" ticks = {0, 0}, ",
" io_ticks = 17, ",
" time_in_queue = 41",
" }",
" ",
"\nNOTE",
" If the structure name does not conflict with any %s command name, the",
" \"struct\" command may be dropped. Accordingly, the examples above could",
" also have been accomplished like so:\n",
" %s> vm_area_struct c1e44f10",
" %s> vm_area_struct",
" %s> vm_area_struct -o",
" %s> mm_struct.pgd ffff810022e7d080",
" %s> mm_struct.pgd",
" %s> tcp_sl_timer tcp_slt_array 4\n",
" Lastly, the short-cut \"*\" pointer-to command may also be used to negate",
" the need to enter the \"struct\" command name (enter \"help *\" for details).",
NULL
};
char *help_union[] = {
"union",
"union contents",
"union_name[.member[,member]] [-o][-l offset][-rfuxdp]\n"
" [address | symbol][:cpuspec] [count | -c count]",
" This command displays either a union definition, or a formatted display",
" of the contents of a union at a specified address. When no address is",
" specified, the union definition is shown along with the union size.",
" A union member may be appended to the structure name in order to limit",
" the scope of the data displayed to that particular member; when no address",
" is specified, the member's offset (always 0) and definition are shown.\n",
" union_name name of a C-code union used by the kernel.",
" .member name of a union member; to display multiple members of a",
" union, use a comma-separated list of members.",
" -o show member offsets when displaying union definitions; the",
" offset is always 0 unless used with an address or symbol",
" argument, in which case each member will be preceded by its",
" virtual address.",
" -l offset if the address argument is a pointer to a list_head structure",
" that is embedded in the target union structure, the offset",
" to the list_head member may be entered in either of the",
" following manners:",
" 1. in \"structure.member\" format.",
" 2. a number of bytes. ",
" -r raw dump of union data.",
" -f address argument is a dumpfile offset.",
" -x override default output format with hexadecimal format.",
" -d override default output format with decimal format.",
" -p if a union member is a pointer value, show the member's",
" data type on the output line; and on the subsequent line(s),",
" dereference the pointer, display the pointer target's symbol",
" value in brackets if appropriate, and if possible, display the",
" target data; requires an address argument.",
" -u address argument is a user virtual address in the current",
" context.",
" address hexadecimal address of a union; if the address points",
" to an embedded list_head structure contained within the",
" target union structure, then the \"-l\" option must be used.",
" symbol symbolic reference to the address of a union.",
" :cpuspec CPU specification for a per-cpu address or symbol:",
" : CPU of the currently selected task.",
" :a[ll] all CPUs.",
" :#[-#][,...] CPU list(s), e.g. \"1,3,5\", \"1-3\",",
" or \"1,3,5-7,10\".",
" count count of unions to dump from an array of unions; if used,",
" this must be the last argument entered.",
" -c count \"-c\" is only required if \"count\" is not the last argument",
" entered or if a negative number is entered; if a negative",
" value is entered, the (positive) \"count\" structures that",
" lead up to and include the target structure will be displayed.\n",
" Union data, sizes, and member offsets are shown in the current output radix",
" unless the -x or -d option is specified.",
" ",
" Please note that in the vast majority of cases, the \"union\" command",
" name may be dropped; if the union name does not conflict with any %s",
" or gdb command name, then the \"union_name[.member]\" argument will be",
" recognized as a union name, and this command automatically executed.",
" See the NOTE below.",
"\nEXAMPLES",
"\n Display the bdflush_param union definition, and then an instance of it:\n",
" %s> union bdflush_param",
" union bdflush_param {",
" struct {",
" int nfract;",
" int ndirty;",
" int nrefill;",
" int nref_dirt;",
" int dummy1;",
" int age_buffer;",
" int age_super;",
" int dummy2;",
" int dummy3;",
" } b_un;",
" unsigned int data[9];",
" }",
" ",
" SIZE: 36 (0x24)",
" ",
" %s> union bdflush_param bdf_prm",
" union bdflush_param {",
" b_un = {",
" nfract = 40, ",
" ndirty = 500, ",
" nrefill = 64, ",
" nref_dirt = 256, ",
" dummy1 = 15, ",
" age_buffer = 3000, ",
" age_super = 500, ",
" dummy2 = 1884, ",
" dummy3 = 2",
" }, ",
" data = {40, 500, 64, 256, 15, 3000, 500, 1884, 2}",
" }",
"\nNOTE",
" If the union name does not conflict with any %s command name, the",
" \"union\" command may be dropped. Accordingly, the examples above could",
" also have been accomplished like so:\n",
" %s> bdflush_param",
" %s> bdflush_param bdf_prm",
" ",
" Lastly, the short-cut \"*\" (pointer-to) command may also be used to negate",
" the need to enter the \"union\" command name (enter \"help *\" for details).",
NULL
};
char *help_ptov[] = {
"ptov",
"physical to virtual\n per-cpu to virtual",
"[address | offset:cpuspec]",
" This command translates a hexadecimal physical address into a kernel",
" virtual address. Alternatively, a hexadecimal per-cpu offset and",
" cpu specifier will be translated into kernel virtual addresses for",
" each cpu specified.\n",
" address a physical address",
" offset:cpuspec a per-cpu offset with a CPU specifier:",
" : CPU of the currently selected task.",
" :a[ll] all CPUs.",
" :#[-#][,...] CPU list(s), e.g. \"1,3,5\", \"1-3\",",
" or \"1,3,5-7,10\".",
"\nEXAMPLES",
" Translate physical address 56e000 into a kernel virtual address:\n",
" %s> ptov 56e000",
" VIRTUAL PHYSICAL",
" ffff88000056e000 56e000",
"",
" Translate per-cpu offset b0c0 into a kernel virtual address for",
" all cpus:\n",
" %s> ptov b0c0:a",
" PER-CPU OFFSET: b0c0",
" CPU VIRTUAL",
" [0] ffff88021e20b0c0",
" [1] ffff88021e24b0c0",
" [2] ffff88021e28b0c0",
" [3] ffff88021e2cb0c0",
NULL
};
char *help_mod[] = {
"mod",
"module information and loading of symbols and debugging data",
"-s module [objfile] | -d module | -S [directory] [-D|-t|-r|-R|-o|-g]",
" With no arguments, this command displays basic information of the currently",
" installed modules, consisting of the module address, name, size, the",
" object file name (if known), and whether the module was compiled with",
" CONFIG_KALLSYMS.",
" ",
" The arguments are concerned with with the loading or deleting of symbolic",
" and debugging data from a module's object file. A modules's object file",
" always contains symbolic data (symbol names and addresses), but contains",
" debugging data only if the module was compiled with the -g CFLAG. In",
" addition, the module may have compiled with CONFIG_KALLSYMS, which means",
" that the module's symbolic data will have been loaded into the kernel's",
" address space when it was installed. If the module was not compiled with",
" CONFIG_KALLSYMS, then only the module's exported symbols will be loaded",
" into the kernel's address space. Therefore, for the purpose of this",
" command, it should noted that a kernel module may have been compiled in",
" one of following manners:\n",
" 1. If the module was built without CONFIG_KALLSYMS and without the -g CFLAG,",
" then the loading of the module's additional non-exported symbols can",
" be accomplished with this command.",
" 2. If the module was built with CONFIG_KALLSYMS, but without the -g CFLAG,",
" then there is no benefit in loading the symbols from the module object",
" file, because all of the module's symbols will have been loaded into the",
" kernel's address space when it was installed.",
" 3. If the module was built with CONFIG_KALLSYMS and with the the -g CFLAG,",
" then the loading of the module's debugging data can be accomplished",
" with this command.",
" 4. If the module was built without CONFIG_KALLSYMS but with the -g CFLAG,",
" then the loading of the both module's symbolic and debugging data can",
" be accomplished with this command.",
" ",
" -s module [objfile] Loads symbolic and debugging data from the object file",
" for the module specified. If no objfile argument is",
" appended, a search will be made for an object file",
" consisting of the module name with a .o or .ko suffix,",
" starting at the /lib/modules/<release> directory on",
" the host system, or if not found there, starting at the",
" directory containing the kernel namelist file. If an",
" objfile argument is appended, then that file will be",
" used.",
" -d module Deletes the symbolic and debugging data of the module",
" specified.",
" -S [directory] Load symbolic and debugging data from the object file",
" for all loaded modules. For each module, a search",
" will be made for an object file consisting of the",
" module name with a .o or .ko suffix, starting at the",
" /lib/modules/<release> directory of the host system,",
" or if not found there, starting at the directory",
" containing the kernel namelist file. If a directory",
" argument is appended, then the search will be restricted",
" to that directory.",
" -D Deletes the symbolic and debugging data of all modules.",
" -t Display the contents of the module's \"taints\" bitmask",
" if it is non-zero. When possible, the \"taints\" bits",
" are translated to symbolic letters of the taint type;",
" otherwise the hexadecimal value is shown. In older",
" kernels, the contents of the \"license_gplok\" field is",
" displayed in hexadecimal; the field may be either a ",
" bitmask or a boolean, depending upon the kernel version.",
" The relevant kernel sources should be consulted for the",
" meaning of the letter(s) or hexadecimal bit value(s). ",
" For modules that have a \"gpgsig_ok\" field that is zero",
" (unsigned), the notation \"(U)\" is shown.",
" -r Passes the -readnow flag to the embedded gdb module,",
" which will override the two-stage strategy that it uses",
" for reading symbol tables from module object files.",
" -R Reinitialize module data. All currently-loaded symbolic",
" and debugging data will be deleted, and the installed",
" module list will be updated (live system only).",
" -g When used with -s or -S, add a module object's section",
" start and end addresses to its symbol list.",
" -o Load module symbols with old mechanism.",
" ",
" If the %s session was invoked with the \"--mod <directory>\" option, or",
" a CRASH_MODULE_PATH environment variable exists, then /lib/modules/<release>",
" will be overridden as the default directory tree that is searched for module",
" object files.",
" ",
" After symbolic and debugging data have been loaded, backtraces and text",
" disassembly will be displayed appropriately. Depending upon the processor",
" architecture, data may also printed symbolically with the \"p\" command;",
" at a minimum, the \"rd\" command may be used with module data symbols.",
" ",
" If %s can recognize that the set of modules has changed while running a",
" session on a live kernel, the module data will be reinitialized the next",
" time this command is run; the -r option forces the reinitialization.",
"\nEXAMPLES",
" Display the currently-installed modules:\n",
" %s> mod",
" MODULE NAME SIZE OBJECT FILE",
" c8019000 soundcore 2788 (not loaded)",
" c801b000 soundlow 336 (not loaded)",
" c801d000 sound 59864 (not loaded)",
" c802d000 ad1848 15728 (not loaded)",
" c8032000 uart401 6000 (not loaded)",
" c8035000 cs4232 2472 (not loaded)",
" c8043000 opl3 11048 (not loaded)",
" c8047000 3c59x 18152 (not loaded)",
" c804d000 sunrpc 53796 (not loaded)",
" c805c000 lockd 31528 (not loaded)",
" c8065000 nfsd 151896 (not loaded)",
" c8092000 nfs 29752 (not loaded)",
" ",
" Display the currently-installed modules on a system where all modules were",
" compiled with CONFIG_KALLSYMS:",
" ",
" %s> mod",
" MODULE NAME SIZE OBJECT FILE",
" e080d000 jbd 57016 (not loaded) [CONFIG_KALLSYMS]",
" e081e000 ext3 92360 (not loaded) [CONFIG_KALLSYMS]",
" e0838000 usbcore 83168 (not loaded) [CONFIG_KALLSYMS]",
" e0850000 usb-uhci 27532 (not loaded) [CONFIG_KALLSYMS]",
" e085a000 ehci-hcd 20904 (not loaded) [CONFIG_KALLSYMS]",
" e0865000 input 6208 (not loaded) [CONFIG_KALLSYMS]",
" e086a000 hid 22404 (not loaded) [CONFIG_KALLSYMS]",
" e0873000 mousedev 5688 (not loaded) [CONFIG_KALLSYMS]",
" e0878000 keybdev 2976 (not loaded) [CONFIG_KALLSYMS]",
" e08fd000 cdrom 34144 (not loaded) [CONFIG_KALLSYMS]",
" e0909000 ide-cd 35776 (not loaded) [CONFIG_KALLSYMS]",
" e0915000 scsi_mod 117928 (not loaded) [CONFIG_KALLSYMS]",
" e0935000 ide-scsi 12752 (not loaded) [CONFIG_KALLSYMS]",
" e093c000 microcode 5248 (not loaded) [CONFIG_KALLSYMS]",
" e0943000 sr_mod 18136 (not loaded) [CONFIG_KALLSYMS]",
" e0956000 floppy 59056 (not loaded) [CONFIG_KALLSYMS]",
" e0966000 sg 38060 (not loaded) [CONFIG_KALLSYMS]",
" e0971000 ip_tables 16544 (not loaded) [CONFIG_KALLSYMS]",
" e097d000 iptable_filter 2412 (not loaded) [CONFIG_KALLSYMS]",
" e097f000 e1000 76096 (not loaded) [CONFIG_KALLSYMS]",
" e09ba000 autofs 13780 (not loaded) [CONFIG_KALLSYMS]",
" e09c1000 parport 39072 (not loaded) [CONFIG_KALLSYMS]",
" e09ce000 lp 9220 (not loaded) [CONFIG_KALLSYMS]",
" e09d4000 parport_pc 19204 (not loaded) [CONFIG_KALLSYMS]",
" e09e2000 agpgart 59128 (not loaded) [CONFIG_KALLSYMS]",
" e0a1a000 radeon 117156 (not loaded) [CONFIG_KALLSYMS]",
" e2dc7000 sunrpc 91996 (not loaded) [CONFIG_KALLSYMS]",
" e2de1000 lockd 60624 (not loaded) [CONFIG_KALLSYMS]",
" e2df3000 nfs 96880 (not loaded) [CONFIG_KALLSYMS]",
" ",
" Load the symbolic and debugging data of all modules:\n",
" %s> mod -S",
" MODULE NAME SIZE OBJECT FILE",
" c8019000 soundcore 2788 /lib/modules/2.2.5-15/misc/soundcore.o",
" c801b000 soundlow 336 /lib/modules/2.2.5-15/misc/soundlow.o",
" c801d000 sound 59864 /lib/modules/2.2.5-15/misc/sound.o",
" c802d000 ad1848 15728 /lib/modules/2.2.5-15/misc/ad1848.o",
" c8032000 uart401 6000 /lib/modules/2.2.5-15/misc/uart401.o",
" c8035000 cs4232 2472 /lib/modules/2.2.5-15/misc/cs4232.o",
" c8043000 opl3 11048 /lib/modules/2.2.5-15/misc/opl3.o",
" c8047000 3c59x 18152 /lib/modules/2.2.5-15/net/3c59x.o",
" c804d000 sunrpc 53796 /lib/modules/2.2.5-15/misc/sunrpc.o",
" c805c000 lockd 31528 /lib/modules/2.2.5-15/fs/lockd.o",
" c8065000 nfsd 151896 /lib/modules/2.2.5-15/fs/nfsd.o",
" c8092000 nfs 29752 /lib/modules/2.2.5-15/fs/nfs.o",
" ",
" Load the symbolic and debugging data of the soundcore module from its",
" known location:",
" ",
" %s> mod -s soundcore",
" MODULE NAME SIZE OBJECT FILE",
" c8019000 soundcore 2788 /lib/modules/2.2.5-15/misc/soundcore.o",
" ",
" Delete the current symbolic and debugging data of the soundcore module, ",
" and then re-load it from a specified object file:",
" ",
" %s> mod -d soundcore",
" %s> mod -s soundcore /tmp/soundcore.o",
" MODULE NAME SIZE OBJECT FILE",
" c8019000 soundcore 2788 /tmp/soundcore.o",
" ",
" After installing a new kernel module on a live system, reinitialize the",
" installed module list:\n",
" %s> !insmod mdacon",
" %s> mod",
" mod: NOTE: modules have changed on this system -- reinitializing",
" MODULE NAME SIZE OBJECT FILE",
" c8019000 soundcore 2788 (not loaded)",
" c801b000 soundlow 336 (not loaded)",
" c801d000 sound 59864 (not loaded)",
" c802d000 ad1848 15728 (not loaded)",
" c8032000 uart401 6000 (not loaded)",
" c8035000 cs4232 2472 (not loaded)",
" c8043000 opl3 11048 (not loaded)",
" c8047000 3c59x 18152 (not loaded)",
" c804d000 sunrpc 53796 (not loaded)",
" c805c000 lockd 31528 (not loaded)",
" c8065000 nfs 29752 (not loaded)",
" c806e000 autofs 9316 (not loaded)",
" c8072000 nfsd 151896 (not loaded)",
" c80a1000 mdacon 3556 (not loaded)",
" ",
" Display modules that are \"tainted\", where in this case",
" where they are proprietary and unsigned:",
" ",
" %s> mod -t",
" NAME TAINT",
" vxspec P(U)",
" vxportal P(U)",
" fdd P(U)",
" vxfs P(U)",
" vxdmp P(U)",
" vxio P(U)",
" vxglm P(U)",
" vxgms P(U)",
" vxodm P(U)",
NULL
};
char *help__list[] = {
"list",
"linked list",
"[[-o] offset][-e end][-s struct[.member[,member]] -[xd]] [-r|-h|-H] start",
" This command dumps the contents of a linked list. The entries in a linked",
" list are typically data structures that are tied together in one of two",
" formats:",
" ",
" 1. A starting address points to a data structure; that structure contains",
" a member that is a pointer to the next structure, and so on. This type",
" of a singly-linked list typically ends when a \"next\" pointer value ",
" contains one of the following:",
"",
" (a) a NULL pointer.",
" (b) a pointer to the start address.",
" (c) a pointer to the first item pointed to by the start address.",
" (d) a pointer to its containing structure.",
" ",
" 2. Most Linux lists of data structures are doubly-linked using \"list_head\"",
" structures that are embedded members of the data structures in the list:",
" ",
" struct list_head {",
" struct list_head *next, *prev;",
" };",
" ",
" The linked list is typically headed by an external, standalone list_head,",
" which is simply initialized to point to itself, signifying that the list",
" is empty:",
" ",
" #define LIST_HEAD_INIT(name) { &(name), &(name) } ",
" #define LIST_HEAD(name) struct list_head name = LIST_HEAD_INIT(name)",
" ",
" In the case of list_head-linked lists, the \"list_head.next\" pointer is",
" the address of a list_head structure that is embedded in the next data",
" structure in the list, and not the address of the next data structure ",
" itself. The starting point of the list may be:",
"",
" (a) an external, standalone, LIST_HEAD().",
" (b) a list_head that is embedded within a data structure of the same",
" type as the whole linked list.",
" (c) a list_head that is embedded within a data structure that is",
" different than the type of structures in the the linked list.",
" ",
" The list typically ends when the embedded \"list_head.next\" pointer of",
" a data structure in the linked list points back to the LIST_HEAD()",
" address. However, some list_head-linked lists have no defined starting",
" point, but just link back onto themselves in a circular manner.",
"",
" This command can handle both types of linked list; in both cases the list",
" of addresses that are dumped are the addresses of the data structures",
" themselves.",
"",
" The arguments are as follows:",
"",
" [-o] offset The offset within the structure to the \"next\" pointer",
" (default is 0). If non-zero, the offset may be entered",
" in either of two manners:",
"",
" 1. In \"structure.member\" format; the \"-o\" is not necessary.",
" 2. A number of bytes; the \"-o\" is only necessary on processors",
" where the offset value could be misconstrued as a kernel",
" virtual address.",
"",
" -e end If the list ends in a manner unlike the typical manners that",
" are described above, an explicit ending address value may be",
" entered.",
" -s struct For each address in list, format and print as this type of",
" structure; use the \"struct.member\" format in order to display",
" a particular member of the structure. To display multiple",
" members of a structure, use a comma-separated list of members.",
" -x Override the default output format with hexadecimal format.",
" -d Override the default output format with decimal format.",
" -r For a list linked with list_head structures, traverse the list",
" in the reverse order by using the \"prev\" pointer instead",
" of \"next\".",
" ",
" The meaning of the \"start\" argument, which can be expressed symbolically,",
" in hexadecimal format, or an expression evaluating to an address, depends",
" upon whether the -h or -H option is pre-pended:",
" ",
" start The address of the first data structure in the list.",
" -H start The address of a list_head structure, typically that of an",
" external, standalone LIST_HEAD(). The list typically ends ",
" when the embedded \"list_head.next\" of a data structure in ",
" the linked list points back to this \"start\" address.",
" -h start The address of a data structure which contains an embedded",
" list_head. The list typically ends when the embedded",
" \"list_head.next\" of a data structure in the linked list ",
" points back to the embedded list_head contained in the data",
" structure whose address is this \"start\" argument.",
"",
"WARNING ",
" When the \"-h start\" option is used, it is possible that the list_head-linked",
" list will:",
" ",
" 1. pass through an external standalone LIST_HEAD(), or",
" 2. pass through a list_head that is the actual starting list_head, but is",
" contained within a data structure that is not the same type as all of",
" the other data structures in the list.",
" ",
" When that occurs, the data structure address displayed for that list_head",
" will be incorrect, because the \"-h start\" option presumes that all",
" list_head structures in the list are contained within the same type of",
" data structure. Furthermore, if the \"-s struct[.member[,member]\" option",
" is used, it will display bogus data for that particular list_head.",
"\nEXAMPLES",
" Note that each task_struct is linked to its parent's task_struct via the",
" p_pptr member:",
" ",
" %s> struct task_struct.p_pptr",
" struct task_struct {",
" [136] struct task_struct *p_pptr;",
" }",
" ",
" That being the case, given a task_struct pointer of c169a000, show its ",
" parental hierarchy back to the \"init_task\" (the \"swapper\" task):\n",
" %s> list task_struct.p_pptr c169a000",
" c169a000",
" c0440000",
" c50d0000",
" c0562000",
" c0d28000",
" c7894000",
" c6a98000",
" c009a000",
" c0252000\n",
" Given that the \"task_struct.p_pptr\" offset is 136 bytes, the same",
" result could be accomplished like so:\n",
" %s> list 136 c169a000",
" c169a000",
" c0440000",
" c50d0000",
" c0562000",
" c0d28000",
" c7894000",
" c6a98000",
" c009a000",
" c0252000",
" ",
" The list of currently-registered file system types are headed up by a",
" struct file_system_type pointer named \"file_systems\", and linked by",
" the \"next\" field in each file_system_type structure. The following",
" sequence displays the structure address followed by the name and ",
" fs_flags members of each registered file system type:",
" ",
" %s> p file_systems",
" file_systems = $1 = (struct file_system_type *) 0xc03adc90",
" %s> list file_system_type.next -s file_system_type.name,fs_flags c03adc90",
" c03adc90",
" name = 0xc02c05c8 \"rootfs\",",
" fs_flags = 0x30,",
" c03abf94",
" name = 0xc02c0319 \"bdev\",",
" fs_flags = 0x10,",
" c03acb40",
" name = 0xc02c07c4 \"proc\",",
" fs_flags = 0x8,",
" c03e9834",
" name = 0xc02cfc83 \"sockfs\",",
" fs_flags = 0x10,",
" c03ab8e4",
" name = 0xc02bf512 \"tmpfs\",",
" fs_flags = 0x20,",
" c03ab8c8",
" name = 0xc02c3d6b \"shm\",",
" fs_flags = 0x20,",
" c03ac394",
" name = 0xc02c03cf \"pipefs\",",
" fs_flags = 0x10,",
" c03ada74",
" name = 0xc02c0e6b \"ext2\",",
" fs_flags = 0x1,",
" c03adc74",
" name = 0xc02c0e70 \"ramfs\",",
" fs_flags = 0x20,",
" c03ade74",
" name = 0xc02c0e76 \"hugetlbfs\",",
" fs_flags = 0x20,",
" c03adf8c",
" name = 0xc02c0f84 \"iso9660\",",
" fs_flags = 0x1,",
" c03aec14",
" name = 0xc02c0ffd \"devpts\",",
" fs_flags = 0x8,",
" c03e93f4",
" name = 0xc02cf1b9 \"pcihpfs\",",
" fs_flags = 0x28,",
" e0831a14",
" name = 0xe082f89f \"ext3\",",
" fs_flags = 0x1,",
" e0846af4",
" name = 0xe0841ac6 \"usbdevfs\",",
" fs_flags = 0x8,",
" e0846b10",
" name = 0xe0841acf \"usbfs\",",
" fs_flags = 0x8,",
" e0992370",
" name = 0xe099176c \"autofs\",",
" fs_flags = 0x0,",
" e2dcc030",
" name = 0xe2dc8849 \"nfs\",",
" fs_flags = 0x48000,",
" ",
" In some kernels, the system run queue is a linked list headed up by the",
" \"runqueue_head\", which is defined like so:",
" ",
" static LIST_HEAD(runqueue_head);",
" ",
" The run queue linking is done with the \"run_list\" member of the task_struct:",
" ",
" %s> struct task_struct.run_list",
" struct task_struct {",
" [60] struct list_head run_list;",
" }",
" ",
" Therefore, to view the list of task_struct addresses in the run queue,",
" either of the following commands will work:\n",
" %s> list task_struct.run_list -H runqueue_head",
" f79ac000",
" f7254000",
" f7004000",
" %s> list 60 -H runqueue_head",
" f79ac000",
" f7254000",
" f7004000",
" ",
" In some kernel versions, the vfsmount structures of the mounted",
" filesystems are linked by the LIST_HEAD \"vfsmntlist\", which uses the",
" mnt_list list_head of each vfsmount structure in the list. To dump each",
" vfsmount structure in the list, append the -s option:\n",
" %s> list -H vfsmntlist vfsmount.mnt_list -s vfsmount",
" c3fc9e60",
" struct vfsmount {",
" mnt_hash = {",
" next = 0xc3fc9e60, ",
" prev = 0xc3fc9e60",
" }, ",
" mnt_parent = 0xc3fc9e60, ",
" mnt_mountpoint = 0xc3fc5dc0, ",
" mnt_root = 0xc3fc5dc0, ",
" mnt_instances = {",
" next = 0xc3f60a74, ",
" prev = 0xc3f60a74",
" }, ",
" mnt_sb = 0xc3f60a00, ",
" mnt_mounts = {",
" next = 0xf7445e08, ",
" prev = 0xf7445f88",
" }, ",
" mnt_child = {",
" next = 0xc3fc9e88, ",
" prev = 0xc3fc9e88",
" }, ",
" mnt_count = {",
" counter = 209",
" }, ",
" mnt_flags = 0, ",
" mnt_devname = 0xc8465b20 \"/dev/root\", ",
" mnt_list = {",
" next = 0xf7445f9c, ",
" prev = 0xc02eb828",
" }, ",
" mnt_owner = 0",
" }",
" f7445f60",
" struct vfsmount {",
" ...",
" ",
" The task_struct of every task in the system is linked into a circular list",
" by its embedded \"tasks\" list_head. Show the task_struct addresses and the",
" pids of all tasks in the system using \"-h\" option, starting with the ",
" task_struct at ffff88012b98e040:\n",
" %s> list task_struct.tasks -s task_struct.pid -h ffff88012b98e040",
" ffff88012b98e040",
" pid = 14187",
" ffff8801277be0c0",
" pid = 14248",
" ffffffff81a2d020",
" pid = 0",
" ffff88012d7dd4c0",
" pid = 1",
" ffff88012d7dca80",
" pid = 2",
" ffff88012d7dc040",
" pid = 3",
" ffff88012d7e9500",
" pid = 4",
" ...",
" ffff88012961a100",
" pid = 14101",
" ffff880129017580",
" pid = 14134",
" ffff8801269ed540",
" pid = 14135",
" ffff880128256080",
" pid = 14138",
" ffff88012b8f4100",
" pid = 14183",
NULL
};
char *help_tree[] = {
"tree",
"display radix tree or red-black tree",
"-t [radix|rbtree] [-r offset] [-s struct[.member[,member]] -[x|d]]\n [-o offset] [-p] [-N] start",
" This command dumps the contents of a radix tree or a red-black tree.",
" The arguments are as follows:\n",
" -t type The type of tree to dump; the type string can be either ",
" \"radix\" or \"rbtree\", although only the first two characters",
" are required.",
" -r offset If the \"start\" argument is the address of a data structure that",
" contains the radix_tree_root or rb_root structure, then this is",
" the offset to that structure member. If the offset is non-zero,",
" then this option is required. The offset may be entered in either",
" of two manners:",
" 1. In \"structure.member\" format.",
" 2. A number of bytes.",
" -o offset For red-black trees only, the offset of the rb_node within its ",
" containing data structure; if the offset is non-zero, then this",
" option is required. The offset may be entered in either of two",
" manners:",
" 1. In \"structure.member\" format.",
" 2. A number of bytes.",
" This option is not applicable to radix trees.",
" -s struct For each entry in a tree, format and print it as this type of data",
" structure; use the \"struct.member\" format in order to display a",
" particular member of the structure. To display multiple members",
" of a structure, use a comma-separated list of members.",
" -x Override default output format with hexadecimal format.",
" -d Override default output format with decimal format.",
" -p Display the node's position information, showing the relationship",
" between it and the root. For red-black trees, a position that",
" indicates \"root/l/r\" means that the node is the right child",
" of the left child of the root node. For radix trees, the height",
" and slot index values are shown with respect to the root.",
" ",
" The meaning of the \"start\" argument, which can be expressed either in",
" hexadecimal format or symbolically, depends upon whether the -N option",
" is prepended:",
" ",
" start The address of a radix_tree_root or rb_root structure, or the",
" address of a structure containing the radix_tree_root or rb_root",
" structure; if the latter, then the \"-r offset\" option must be",
" used if the member offset of the root structure is non-zero.",
" ",
" -N start The address of the structure radix_tree_node or rb_node, bypassing",
" the radix_tree_root or rb_root that points to it.",
"",
"\nEXAMPLES",
" The vmap_area_root is a standalone rb_root structure. Display the ",
" virtual addresses of each vmap_area in its red-black tree:\n",
" %s> whatis vmap_area_root",
" struct rb_root vmap_area_root;",
" %s> tree -t rbtree -o vmap_area.rb_node vmap_area_root",
" ffff880128c508c0",
" ffff88012cb68140",
" ffff88012c9afec0",
" ffff88012d65c440",
" ...",
"",
" Display the vmap_area's va_start and va_end members of each of",
" the entries above expressing the vmap_area.rb_node offset as a",
" number of bytes:\n",
" %s> tree -t rbtree -o 24 vmap_area_root -s vmap_area.va_start,va_end",
" ffff880128c508c0",
" va_start = 0xffffc90014900000",
" va_end = 0xffffc90014921000",
" ffff88012cb68140",
" va_start = 0xffffc900110c0000",
" va_end = 0xffffc900110d1000",
" ffff88012c9afec0",
" va_start = 0xffffc90000640000",
" va_end = 0xffffc90000642000",
" ffff88012d65c440",
" va_start = 0xffffc90000620000",
" va_end = 0xffffc90000622000",
" ...",
"",
" Alternatively, use the -N option with the rb_node address contained",
" in the vmap_area_root structure:\n",
" %s> p vmap_area_root",
" vmap_area_root = $8 = {",
" rb_node = 0xffff880128c508d8",
" }",
" %s> tree -t rbtree -o vmap_area.rb_node -N 0xffff880128c508d8",
" ffff880128c508c0",
" ffff88012cb68140",
" ffff88012c9afec0",
" ffff88012d65c440",
" ",
" Display the virtual address of each vm_area_struct in the red-black",
" tree that has its root inside an mm_struct located at ffff880128b5a300.",
" The vm_area_struct.vm_rb rb_node member has an offset of 0x38 bytes:\n",
" %s> tree -t rbtree -r mm_struct.mm_rb ffff880128b5a300 -o 0x38",
" ffff88012a0de080",
" ffff880123e3ac78",
" ffff880123e3a700",
" ffff88012b2837c8",
" ...",
" ffff880128c02ed0",
" ffff8801292e7958",
" ffff880123e3a318",
" ffff880123e3ad40",
" ",
" Add the -p option to the command above to show position information:\n",
" %s> tree -t rbtree -r mm_struct.mm_rb ffff880128b5a300 -o 0x38 -p",
" ffff88012a0de080",
" position: root",
" ffff880123e3ac78",
" position: root/l",
" ffff880123e3a700",
" position: root/l/l",
" ffff88012b2837c8",
" position: root/l/l/l",
" ...",
" ffff880128c02ed0",
" position: root/r/r/l/r",
" ffff8801292e7958",
" position: root/r/r/l/r/r",
" ffff880123e3a318",
" position: root/r/r/r",
" ffff880123e3ad40",
" position: root/r/r/r/r",
"",
" Display a list of the page structs in the radix tree of an address_space",
" structure located at ffff88012d364de0:\n",
" %s> tree -t radix -r address_space.page_tree ffff88012d364de0",
" ffffea00040d12c0",
" ffffea00040d9a60",
" ffffea00040d9b08",
" ffffea000407eda8",
" ffffea0004084288",
" ...",
" ffffea000407bc70",
" ffffea00040baf48",
" ffffea0004043f48",
" ffffea000407de58",
" ",
" Add the -p option to the command above to show position information:\n",
" %s> tree -t radix -r address_space.page_tree ffff88012d364de0 -p",
" ffffea00040d12c0",
" position: root/0/0",
" ffffea00040d9a60",
" position: root/0/1",
" ffffea00040d9b08",
" position: root/0/2",
" ffffea000407eda8",
" position: root/0/3",
" ffffea0004084288",
" position: root/0/4",
" ...",
" ffffea000407bc70",
" position: root/3/25",
" ffffea00040baf48",
" position: root/3/26",
" ffffea0004043f48",
" position: root/3/27",
" ffffea000407de58",
" position: root/3/28",
"",
" Alternatively, take the address of the radix_tree_node from the",
" radix_tree_root structure in the address_space structure above,",
" and display the tree with the -N option:\n",
" %s> struct address_space.page_tree ffff88012d364de0",
" page_tree = {",
" height = 0x2, ",
" gfp_mask = 0x20, ",
" rnode = 0xffff8801238add71",
" }",
" %s> tree -t radix -N 0xffff8801238add71",
" ffffea00040d12c0",
" ffffea00040d9a60",
" ffffea00040d9b08",
" ffffea000407eda8",
" ffffea0004084288",
" ffffea00040843a0",
" ...",
" ",
" Using the same radix tree as above, display the flags and _count",
" members of each page struct in the list, and force the output format",
" to be hexadecimal:\n",
" %s> tree -t radix -N 0xffff8801238add71 -s page.flags,_count -x",
" ffffea00040d12c0",
" flags = 0x4000000002006c",
" _count = {",
" counter = 0x7",
" }",
" ffffea00040d9a60",
" flags = 0x4000000002006c",
" _count = {",
" counter = 0x7",
" }",
" ffffea00040d9b08",
" flags = 0x4000000002006c",
" _count = {",
" counter = 0x7",
" }",
" ffffea000407eda8",
" flags = 0x4000000002006c",
" _count = {",
" counter = 0x7",
" }",
" ...",
NULL
};
char *help_ptob[] = {
"ptob",
"page to bytes",
"page_number ...",
" This command translates a page frame number to its byte value.",
"\nEXAMPLES",
" %s> ptob 512a",
" 512a: 512a000",
NULL
};
char *help_gdb[] = {
"gdb",
"gdb command",
"command ...",
" This command passes its arguments directly to gdb for processing.",
" This is typically not necessary, but where ambiguities between %s and",
" gdb command names exist, this will force the command to be executed by gdb.",
"",
" Alternatively, if \"set gdb on\" is entered, the session will be run in a",
" mode where all commands are passed directly to gdb. When running in that",
" mode, native %s commands may be executed by preceding them with the",
" \"crash\" directive. To restore native %s mode, enter \"set gdb off\".",
"\nEXAMPLES",
" %s> gdb help",
" List of classes of commands:",
" ",
" aliases -- Aliases of other commands",
" breakpoints -- Making program stop at certain points",
" data -- Examining data",
" files -- Specifying and examining files",
" internals -- Maintenance commands",
" obscure -- Obscure features",
" running -- Running the program",
" stack -- Examining the stack",
" status -- Status inquiries",
" support -- Support facilities",
" tracepoints -- Tracing of program execution without stopping the program",
" user-defined -- User-defined commands",
" ",
" Type \"help\" followed by a class name for a list of commands in that class.",
" Type \"help\" followed by command name for full documentation.",
" Command name abbreviations are allowed if unambiguous.",
NULL
};
char *help_kmem[] = {
"kmem",
"kernel memory",
"[-f|-F|-p|-c|-C|-i|-s|-S|-v|-V|-n|-z|-o|-h] [slab] [[-P] address]\n"
" [-g [flags]] [-I slab[,slab]]",
" This command displays information about the use of kernel memory.\n",
" -f displays the contents of the system free memory headers.",
" also verifies that the page count equals nr_free_pages.",
" -F same as -f, but also dumps all pages linked to that header.",
" -p displays basic information about each page in the system ",
" mem_map[] array.",
" -c walks through the page_hash_table and verifies page_cache_size.",
" -C same as -c, but also dumps all pages in the page_hash_table.",
" -i displays general memory usage information",
" -s displays basic kmalloc() slab data.",
" -S displays all kmalloc() slab data, including all slab objects,",
" and whether each object is in use or is free. If CONFIG_SLUB,",
" slab data for each per-cpu slab is displayed, along with the",
" address of each kmem_cache_node, its count of full and partial",
" slabs, and a list of all tracked slabs.",
" -v displays the mapped virtual memory regions allocated by vmalloc().",
" -V displays the kernel vm_stat table if it exists, the cumulative",
" page_states counter values if they exist, and/or the cumulative",
" vm_event_states counter values if they exist.",
" -n display memory node data (if supported).",
" -z displays per-zone memory statistics.",
" -o displays each cpu's offset value that is added to per-cpu symbol",
" values to translate them into kernel virtual addresses.",
" -g displays the enumerator value of all bits in the page structure's",
" \"flags\" field.",
" -h display the address of hugepage hstate array entries, along with",
" their hugepage size, total and free counts, and name.",
" flags when used with -g, translates all bits in this hexadecimal page",
" structure flags value into its enumerator values.",
" slab when used with -s or -S, limits the command to only the slab cache",
" of name \"slab\". If the slab argument is \"list\", then",
" all slab cache names and addresses are listed.",
" -I slab when used with -s or -S, one or more slab cache names in a",
" comma-separated list may be specified as slab caches to ignore.",
" -P declares that the following address argument is a physical address.",
" address when used without any flag, the address can be a kernel virtual,",
" or physical address; a search is made through the symbol table,",
" the kmalloc() slab subsystem, the free list, the page_hash_table,",
" the vmalloc() region subsystem, the current set of task_structs",
" and kernel stacks, and the mem_map array. If found in any of",
" those areas, the information will be dumped in the same manner as",
" if the location-specific flags were used; if contained within a",
" curent task_struct or kernel stack, that task's context will be",
" displayed.",
" address when used with -s or -S, searches the kmalloc() slab subsystem",
" for the slab containing of this virtual address, showing whether",
" it is in use or free.",
" address when used with -f, the address can be either a page pointer,",
" a physical address, or a kernel virtual address; the free_area",
" header containing the page (if any) is displayed.",
" address when used with -p, the address can be either a page pointer, a",
" physical address, or a kernel virtual address; its basic mem_map",
" page information is displayed.",
" address when used with -c, the address must be a page pointer address;",
" the page_hash_table entry containing the page is displayed.",
" address when used with -l, the address must be a page pointer address;",
" the page address is displayed if it is contained with the list.",
" address when used with -v, the address can be a mapped kernel virtual",
" address or physical address; the mapped region containing the",
" address is displayed.\n",
" All address arguments above must be expressed in hexadecimal format.",
"\nEXAMPLES",
" Display memory usage information:\n",
" %s> kmem -i",
" PAGES TOTAL PERCENTAGE",
" TOTAL MEM 63602 248.4 MB ----",
" FREE 993 3.9 MB 1% of TOTAL MEM",
" USED 62609 244.6 MB 98% of TOTAL MEM",
" SHARED 34035 132.9 MB 53% of TOTAL MEM",
" BUFFERS 10928 42.7 MB 17% of TOTAL MEM",
" CACHED 35249 137.7 MB 55% of TOTAL MEM",
" SLAB 2823 11 MB 4% of TOTAL MEM",
" ",
" TOTAL HIGH 0 0 0% of TOTAL MEM",
" FREE HIGH 0 0 0% of TOTAL HIGH",
" TOTAL LOW 63602 248.4 MB 100% of TOTAL MEM",
" FREE LOW 993 3.9 MB 1% of TOTAL LOW",
" ",
" TOTAL SWAP 129792 507 MB ----",
" SWAP USED 14727 57.5 MB 11% of TOTAL SWAP",
" SWAP FREE 115065 449.5 MB 88% of TOTAL SWAP",
" ",
" ZONE NAME FREE ACTIVE INACTIVE_DIRTY INACTIVE_CLEAN MIN/LOW/HIGH",
" 0 DMA 240 1166 7 161 128/256/384 ",
" 1 Normal 753 17009 27834 0 255/510/765 ",
" 2 HighMem 0 0 0 0 0/0/0 ",
" ",
" Display and verify free memory data:\n",
" %s> kmem -f",
" NODE",
" 0",
" ZONE NAME SIZE FREE MEM_MAP START_PADDR START_MAPNR",
" 0 DMA 4096 3372 c4000040 0 0 ",
" AREA SIZE FREE_AREA_STRUCT BLOCKS PAGES",
" 0 4k c02eb004 2 2",
" 1 8k c02eb010 3 6",
" 2 16k c02eb01c 5 20",
" 3 32k c02eb028 4 32",
" 4 64k c02eb034 5 80",
" 5 128k c02eb040 3 96",
" 6 256k c02eb04c 3 192",
" 7 512k c02eb058 1 128",
" 8 1024k c02eb064 1 256",
" 9 2048k c02eb070 5 2560",
" ",
" ZONE NAME SIZE FREE MEM_MAP START_PADDR START_MAPNR",
" 1 Normal 225280 202269 c4044040 1000000 4096 ",
" AREA SIZE FREE_AREA_STRUCT BLOCKS PAGES",
" 0 4k c02eb0b8 1 1",
" 1 8k c02eb0c4 2 4",
" 2 16k c02eb0d0 0 0",
" 3 32k c02eb0dc 1 8",
" 4 64k c02eb0e8 1 16",
" 5 128k c02eb0f4 0 0",
" 6 256k c02eb100 0 0",
" 7 512k c02eb10c 0 0",
" 8 1024k c02eb118 0 0",
" 9 2048k c02eb124 395 202240",
" ",
" ZONE NAME SIZE FREE MEM_MAP START_PADDR START_MAPNR",
" 2 HighMem 819200 748686 c4ee0040 38000000 229376 ",
" AREA SIZE FREE_AREA_STRUCT BLOCKS PAGES",
" 0 4k c02eb16c 10 10",
" 1 8k c02eb178 2 4",
" 2 16k c02eb184 0 0",
" 3 32k c02eb190 2 16",
" 4 64k c02eb19c 1 16",
" 5 128k c02eb1a8 1 32",
" 6 256k c02eb1b4 1 64",
" 7 512k c02eb1c0 0 0",
" 8 1024k c02eb1cc 0 0",
" 9 2048k c02eb1d8 1462 748544",
" ",
" nr_free_pages: 954327 (verified)",
" ",
" Dump all the base addresses of each free memory area from above:\n",
" %s> kmem -F",
" NODE",
" 0",
" ZONE NAME SIZE FREE MEM_MAP START_PADDR START_MAPNR",
" 0 DMA 4096 3372 c4000040 0 0 ",
" AREA SIZE FREE_AREA_STRUCT",
" 0 4k c02eb004 ",
" c400ded8",
" c4042528",
" AREA SIZE FREE_AREA_STRUCT",
" 1 8k c02eb010 ",
" c400de50",
" c400cee8",
" c40424a0",
" AREA SIZE FREE_AREA_STRUCT",
" 2 16k c02eb01c ",
" c400dd40",
" c400cf70",
" c40425b0",
" c400f7d0",
" c40028a0",
" AREA SIZE FREE_AREA_STRUCT",
" 3 32k c02eb028 ",
" c4042280",
" c400f8e0",
" c4002680",
" c4000260",
" AREA SIZE FREE_AREA_STRUCT",
" 4 64k c02eb034 ",
" c400d080",
" c4041e40",
" ...",
" ",
" Dump the mem_map[] array:\n",
" %s> kmem -p",
" PAGE PHYSICAL MAPPING INDEX CNT FLAGS",
" f5c51200 10000 0 0 1 80 slab",
" f5c51220 11000 0 0 1 80 slab",
" f5c51240 12000 0 0 1 80 slab",
" f5c51260 13000 0 0 1 80 slab",
" f5c51280 14000 0 0 1 80 slab",
" f5c512a0 15000 0 0 1 80 slab",
" f5c512c0 16000 0 0 1 80 slab",
" f5c512e0 17000 0 0 1 80 slab",
" f5c51300 18000 0 0 1 80 slab",
" f5c51320 19000 0 0 1 80 slab",
" f5c51340 1a000 0 0 1 80 slab",
" f5c51360 1b000 0 0 1 80 slab",
" f5c51380 1c000 e6c6a754 13b67 2 868 uptodate,lru,active,private",
" f5c513a0 1d000 0 0 1 80 slab",
" f5c513c0 1e000 0 0 1 80 slab",
" f5c513e0 1f000 0 0 1 80 slab",
" f5c51400 20000 e6c6a754 13bbb 2 868 uptodate,lru,active,private",
" f5c51420 21000 0 0 1 80 slab",
" f5c51440 22000 0 0 1 80 slab",
" ...",
" ",
" Use the commands above with a page pointer or a physical address argument:\n",
" %s> kmem -f c40425b0",
" NODE ",
" 0 ",
" ZONE NAME SIZE FREE MEM_MAP START_PADDR START_MAPNR",
" 0 DMA 4096 3372 c4000040 0 0 ",
" AREA SIZE FREE_AREA_STRUCT ",
" 2 16k c02eb01c ",
" c40425b0 (c40425b0 is 1st of 4 pages) ",
" ",
" %s> kmem -p c25a9c00",
" PAGE PHYSICAL MAPPING INDEX CNT FLAGS",
" c25a9c00 1fe0000 f429d2e4 21fe3eb 2 800828 uptodate,lru,private",
" ",
" %s> kmem -p 1fe0000",
" PAGE PHYSICAL MAPPING INDEX CNT FLAGS",
" c25a9c00 1fe0000 f429d2e4 21fe3eb 2 800828 uptodate,lru,private",
" ",
" Display the mapped memory regions allocated by vmalloc():\n",
" %s> kmem -v",
" VMAP_AREA VM_STRUCT ADDRESS RANGE SIZE",
" f7048e00 f7048e40 f7dfe000 - f7e00000 8192",
" f7048ec0 f7048f00 f7e00000 - f7e05000 20480",
" f7151fc0 f7159540 f7e06000 - f7e08000 8192",
" f704da80 f704dac0 f7e0a000 - f7e0c000 8192",
" f704d980 f704d9c0 f7e0e000 - f7e10000 8192",
" f724f1c0 f724f200 f7e12000 - f7e14000 8192",
" f704d840 f704d880 f7e14000 - f7e17000 12288",
" f704d400 f704d440 f7e18000 - f7e1d000 20480",
" f73f5840 f73f5880 f7e1e000 - f7e2a000 49152",
" f6334480 f63344c0 f7e2c000 - f7e2e000 8192",
" f635d600 f635d640 f7e4a000 - f7e5b000 69632",
" f41b4700 f5771a40 f7e6e000 - f7e70000 8192",
" f622f6c0 f622f700 f7e71000 - f7e79000 32768",
" f63a9f00 f63a9f40 f7e84000 - f7e87000 12288",
" f63a9d00 f63a9d40 f7e8f000 - f7e91000 8192",
" f5546480 f39db800 f7eb8000 - f7ec2000 40960",
" f5ce9640 f5777e80 f7ec6000 - f7ed1000 45056",
" f63a9b00 f63a9b40 f7ed1000 - f7efd000 180224",
" f63a9800 f63a9840 f7f1d000 - f7f26000 36864",
" f63a9640 f63a9880 f7f43000 - f7f52000 61440",
" f5771f00 f4183840 f7f53000 - f7f64000 69632",
" f5ce9a00 f30c4a00 f7fcf000 - f801e000 323584",
" f63a93c0 f63a9400 f805d000 - f8132000 872448",
" f63a91c0 f63a95c0 f814b000 - f8150000 20480",
" f63a9140 f63a9180 f8151000 - f8352000 2101248",
" f624eb00 f624eb40 f8353000 - f8355000 8192",
" f563eb40 f563eb80 f8356000 - f835e000 32768",
" f63d5ec0 f63d5f00 f8360000 - f8371000 69632",
" f63d5cc0 f6287b80 f83c2000 - f84c3000 1052672",
" ...",
" ",
" Dump the vm_table contents:\n",
" %s> kmem -V",
" NR_ANON_PAGES: 38989",
" NR_FILE_MAPPED: 3106",
" NR_FILE_PAGES: 169570",
" NR_SLAB: 32439",
" NR_PAGETABLE: 1181",
" NR_FILE_DIRTY: 4633",
" NR_WRITEBACK: 0",
" NR_UNSTABLE_NFS: 0",
" NR_BOUNCE: 0",
" NUMA_HIT: 63545992",
" NUMA_MISS: 0",
" NUMA_FOREIGN: 0",
" NUMA_INTERLEAVE_HIT: 24002",
" NUMA_LOCAL: 63545992",
" NUMA_OTHER: 0",
" ",
" Display hugepage hstate information: \n",
" %s> kmem -h",
" HSTATE SIZE FREE TOTAL NAME",
" ffffffff81f7a800 2MB 10 64 hugepages-2048kB",
"",
" Determine (and verify) the page cache size:\n",
" %s> kmem -c",
" page_cache_size: 18431 (verified)",
" ",
" Dump all pages in the page_hash_table:\n",
" %s> kmem -C",
" page_hash_table[0]",
" c0325b40",
" c03a0598",
" c03b4070",
" c0364c28",
" c0357690",
" c02ef338",
" c02d7c60",
" c02c11e0",
" c02a3d70",
" page_hash_table[1]",
" c0394ce8",
" c03c4218",
" c03b4048",
" c0364c00",
" c0357668",
" c02d6e50",
" c02d7dc8",
" c02c0cb8",
" c02db630",
" c02ebad0",
" page_hash_table[2]",
" c037e808",
" c034e248",
" c03b4020",
" c02ec868",
" c03baa60",
" ...",
" page_hash_table[2047]",
" c033a798",
" c0390b48",
" c03b4098",
" c0364890",
" c03576b8",
" c02d2c38",
" c02d7c88",
" c02de5d8",
" ",
" page_cache_size: 18437 (verified)",
" ",
" Find the page_hash_table entry containing page c03576b8:\n",
" %s> kmem -c c03576b8",
" page_hash_table[2047]",
" c03576b8",
" ",
" Display kmalloc() slab data:\n",
" %s> kmem -s",
" CACHE NAME OBJSIZE ALLOCATED TOTAL SLABS SSIZE",
" c02eadc0 kmem_cache 232 58 68 4 4k",
" f79c2888 ip_vs_conn 128 0 0 0 4k",
" f79c2970 tcp_tw_bucket 96 0 0 0 4k",
" f79c2a58 tcp_bind_bucket 32 12 565 5 4k",
" f79c2b40 tcp_open_request 64 0 59 1 4k",
" f79c2c28 inet_peer_cache 64 1 59 1 4k",
" f79c2d10 ip_fib_hash 32 11 339 3 4k",
" f79c2df8 ip_dst_cache 160 8 120 5 4k",
" f79c2ee0 arp_cache 128 1 30 1 4k",
" c8402970 blkdev_requests 96 30208 37800 945 4k",
" c8402a58 nfs_read_data 384 0 0 0 4k",
" c8402b40 nfs_write_data 384 0 0 0 4k",
" c8402c28 nfs_page 96 0 0 0 4k",
" c8402d10 dnotify cache 20 0 0 0 4k",
" c8402df8 file lock cache 92 3 336 8 4k",
" c8402ee0 fasync cache 16 0 0 0 4k",
" c84027a0 uid_cache 32 3 339 3 4k",
" c84026b8 skbuff_head_cache 160 320 624 26 4k",
" c84025d0 sock 832 32 180 20 8k",
" c84024e8 sigqueue 132 0 203 7 4k",
" c8402400 cdev_cache 64 19 472 8 4k",
" c8402318 bdev_cache 64 8 236 4 4k",
" c8402230 mnt_cache 96 11 120 3 4k",
" c8402148 inode_cache 480 817 848 106 4k",
" c8402060 dentry_cache 128 1352 1470 49 4k",
" c8403ee0 filp 96 244 440 11 4k",
" c8403df8 names_cache 4096 0 12 12 4k",
" c8403d10 buffer_head 96 14936 16000 400 4k",
" c8403c28 mm_struct 128 25 240 8 4k",
" c8403b40 vm_area_struct 64 393 1298 22 4k",
" c8403a58 fs_cache 64 30 472 8 4k",
" c8403970 files_cache 416 30 135 15 4k",
" c8403888 signal_act 1312 32 99 33 4k",
" c84037a0 size-131072(DMA) 131072 0 0 0 128k",
" c84036b8 size-131072 131072 1 1 1 128k",
" c84035d0 size-65536(DMA) 65536 0 0 0 64k",
" c84034e8 size-65536 65536 0 0 0 64k",
" c8403400 size-32768(DMA) 32768 0 0 0 32k",
" c8403318 size-32768 32768 0 1 1 32k",
" c8403230 size-16384(DMA) 16384 0 0 0 16k",
" c8403148 size-16384 16384 0 0 0 16k",
" c8403060 size-8192(DMA) 8192 0 0 0 8k",
" c8401ee0 size-8192 8192 1 2 2 8k",
" c8401df8 size-4096(DMA) 4096 0 0 0 4k",
" c8401d10 size-4096 4096 30 30 30 4k",
" c8401c28 size-2048(DMA) 2048 0 0 0 4k",
" c8401b40 size-2048 2048 37 132 66 4k",
" c8401a58 size-1024(DMA) 1024 0 0 0 4k",
" c8401970 size-1024 1024 301 328 82 4k",
" c8401888 size-512(DMA) 512 0 0 0 4k",
" c84017a0 size-512 512 141 168 21 4k",
" c84016b8 size-256(DMA) 256 0 0 0 4k",
" c84015d0 size-256 256 80 435 29 4k",
" c84014e8 size-128(DMA) 128 0 0 0 4k",
" c8401400 size-128 128 508 840 28 4k",
" c8401318 size-64(DMA) 64 0 0 0 4k",
" c8401230 size-64 64 978 1357 23 4k",
" c8401148 size-32(DMA) 32 0 0 0 4k",
" c8401060 size-32 32 1244 1808 16 4k",
" ",
" Display all slab data in the \"arp_cache\" cache:\n",
" %s> kmem -S arp_cache",
" CACHE NAME OBJSIZE ALLOCATED TOTAL SLABS SSIZE",
" f79c2ee0 arp_cache 128 1 30 1 4k",
" SLAB MEMORY TOTAL ALLOCATED FREE",
" f729d000 f729d0a0 30 1 29",
" FREE / [ALLOCATED]",
" f729d0a0 (cpu 7 cache)",
" f729d120 (cpu 7 cache)",
" f729d1a0 (cpu 7 cache)",
" f729d220 (cpu 7 cache)",
" f729d2a0 (cpu 7 cache)",
" f729d320 (cpu 7 cache)",
" f729d3a0 (cpu 7 cache)",
" f729d420 (cpu 7 cache)",
" f729d4a0 (cpu 7 cache)",
" f729d520 (cpu 7 cache)",
" f729d5a0 (cpu 7 cache)",
" f729d620 (cpu 7 cache)",
" f729d6a0 (cpu 7 cache)",
" f729d720 (cpu 7 cache)",
" f729d7a0 (cpu 7 cache)",
" f729d820 (cpu 7 cache)",
" f729d8a0 (cpu 7 cache)",
" f729d920 (cpu 7 cache)",
" f729d9a0 (cpu 7 cache)",
" f729da20 (cpu 7 cache)",
" f729daa0 (cpu 7 cache)",
" f729db20 (cpu 7 cache)",
" f729dba0 (cpu 7 cache)",
" f729dc20 (cpu 7 cache)",
" f729dca0 (cpu 7 cache)",
" f729dd20 (cpu 7 cache)",
" f729dda0 (cpu 7 cache)",
" f729de20 (cpu 7 cache)",
" f729dea0 (cpu 3 cache)",
" [f729df20]",
" ",
" Search the kmalloc() slab subsystem for address c3fbdb60:\n",
" %s> kmem -s c3fbdb60",
" CACHE NAME OBJSIZE ALLOCATED TOTAL SLABS SSIZE",
" c8402970 blkdev_requests 96 30208 37800 945 4k",
" SLAB MEMORY TOTAL ALLOCATED FREE",
" c3fbd020 c3fbd0e0 40 40 0",
" FREE / [ALLOCATED]",
" [c3fbdb60]",
" ",
" Make a generic search (no flags) for the same address c3fbdb60:\n",
" %s> kmem c3fbdb60 ",
" CACHE NAME OBJSIZE ALLOCATED TOTAL SLABS SSIZE",
" c8402970 blkdev_requests 96 30208 37800 945 4k",
" SLAB MEMORY TOTAL ALLOCATED FREE",
" c3fbd020 c3fbd0e0 40 40 0 ",
" FREE / [ALLOCATED]",
" [c3fbdb60]",
" ",
" PAGE PHYSICAL MAPPING INDEX CNT FLAGS",
" c410ee74 3fbd000 0 0 1 slab",
"\n Display memory node data (if supported):\n",
" %s> kmem -n",
" NODE SIZE PGLIST_DATA BOOTMEM_DATA NODE_ZONES",
" 0 130933 c0332ee0 c0403a44 c0332ee0",
" c03333e0",
" c03338e0",
" MEM_MAP START_PADDR START_MAPNR",
" c1000030 0 0",
" ",
" ZONE NAME SIZE MEM_MAP START_PADDR START_MAPNR",
" 0 DMA 4096 c1000030 0 0",
" 1 Normal 126837 c1038030 1000000 4096",
" 2 HighMem 0 0 0 0",
"\n Translate a page structure's flags field contents:\n",
" %s> kmem -g 4080",
" FLAGS: 4080",
" PAGE-FLAG BIT VALUE",
" PG_slab 7 0000080",
" PG_head 14 0004000",
" %s>",
NULL
};
char *help_dis[] = {
"dis",
"disassemble",
"[-rludx][-b [num]] [address | symbol | (expression)] [count]",
" This command disassembles source code instructions starting (or ending) at",
" a text address that may be expressed by value, symbol or expression:\n",
" -r (reverse) displays all instructions from the start of the ",
" routine up to and including the designated address.",
" -l displays source code line number data in addition to the ",
" disassembly output.",
" -u address is a user virtual address in the current context;",
" otherwise the address is assumed to be a kernel virtual address.",
" If this option is used, then -r and -l are ignored.",
" -x override default output format with hexadecimal format.",
" -d override default output format with decimal format.",
" -b [num] modify the pre-calculated number of encoded bytes to skip after",
" a kernel BUG (\"ud2a\") instruction; with no argument, displays",
" the current number of bytes being skipped. (x86 and x86_64 only)",
" address starting hexadecimal text address.",
" symbol symbol of starting text address. On ppc64, the symbol",
" preceded by '.' is used.",
" (expression) expression evaluating to a starting text address.",
" count the number of instructions to be disassembled (default is 1).",
" If no count argument is entered, and the starting address",
" is entered as a text symbol, then the whole routine will be",
" disassembled. The count argument is ignored when used with",
" the -r option.",
"\nEXAMPLES",
" Disassemble the sys_signal() routine without, and then with, line numbers:\n",
" %s> dis sys_signal",
" 0xc0112c88 <sys_signal>: push \%ebp",
" 0xc0112c89 <sys_signal+1>: mov \%esp,\%ebp",
" 0xc0112c8b <sys_signal+3>: sub $0x28,\%esp",
" 0xc0112c8e <sys_signal+6>: mov 0xc(\%ebp),\%eax",
" 0xc0112c91 <sys_signal+9>: mov \%eax,0xffffffec(\%ebp)",
" 0xc0112c94 <sys_signal+12>: movl $0xc0000000,0xfffffff0(\%ebp)",
" 0xc0112c9b <sys_signal+19>: lea 0xffffffd8(\%ebp),\%eax",
" 0xc0112c9e <sys_signal+22>: push \%eax",
" 0xc0112c9f <sys_signal+23>: lea 0xffffffec(\%ebp),\%eax",
" 0xc0112ca2 <sys_signal+26>: push \%eax",
" 0xc0112ca3 <sys_signal+27>: pushl 0x8(\%ebp)",
" 0xc0112ca6 <sys_signal+30>: call 0xc01124b8 <do_sigaction>",
" 0xc0112cab <sys_signal+35>: test \%eax,\%eax",
" 0xc0112cad <sys_signal+37>: jne 0xc0112cb2 <sys_signal+42>",
" 0xc0112caf <sys_signal+39>: mov 0xffffffd8(\%ebp),\%eax",
" 0xc0112cb2 <sys_signal+42>: leave",
" 0xc0112cb3 <sys_signal+43>: ret",
" ",
" %s> dis -l sys_signal",
" /usr/src/linux-2.2.5/kernel/signal.c: 1074",
" 0xc0112c88 <sys_signal>: push \%ebp",
" 0xc0112c89 <sys_signal+1>: mov \%esp,\%ebp",
" 0xc0112c8b <sys_signal+3>: sub $0x28,\%esp",
" 0xc0112c8e <sys_signal+6>: mov 0xc(\%ebp),\%eax",
" /usr/src/linux-2.2.5/kernel/signal.c: 1078",
" 0xc0112c91 <sys_signal+9>: mov \%eax,0xffffffec(\%ebp)",
" /usr/src/linux-2.2.5/kernel/signal.c: 1079",
" 0xc0112c94 <sys_signal+12>: movl $0xc0000000,0xfffffff0(\%ebp)",
" /usr/src/linux-2.2.5/kernel/signal.c: 1081",
" 0xc0112c9b <sys_signal+19>: lea 0xffffffd8(\%ebp),\%eax",
" 0xc0112c9e <sys_signal+22>: push \%eax",
" 0xc0112c9f <sys_signal+23>: lea 0xffffffec(\%ebp),\%eax",
" 0xc0112ca2 <sys_signal+26>: push \%eax",
" 0xc0112ca3 <sys_signal+27>: pushl 0x8(\%ebp)",
" 0xc0112ca6 <sys_signal+30>: call 0xc01124b8 <do_sigaction>",
" /usr/src/linux-2.2.5/kernel/signal.c: 1083",
" 0xc0112cab <sys_signal+35>: test \%eax,\%eax",
" 0xc0112cad <sys_signal+37>: jne 0xc0112cb2 <sys_signal+42>",
" 0xc0112caf <sys_signal+39>: mov 0xffffffd8(\%ebp),\%eax",
" /usr/src/linux-2.2.5/kernel/signal.c: 1084",
" 0xc0112cb2 <sys_signal+42>: leave",
" 0xc0112cb3 <sys_signal+43>: ret",
" ",
" Given a return address expression of \"do_no_page+65\", find out the ",
" function that do_no_page() calls by using the reverse flag:\n",
" %s> dis -r (do_no_page+65)",
" 0xc011ea68 <do_no_page>: push \%ebp",
" 0xc011ea69 <do_no_page+1>: mov \%esp,\%ebp",
" 0xc011ea6b <do_no_page+3>: push \%edi",
" 0xc011ea6c <do_no_page+4>: push \%esi",
" 0xc011ea6d <do_no_page+5>: push \%ebx",
" 0xc011ea6e <do_no_page+6>: mov 0xc(\%ebp),\%ebx",
" 0xc011ea71 <do_no_page+9>: mov 0x10(\%ebp),\%edx",
" 0xc011ea74 <do_no_page+12>: mov 0x14(\%ebp),\%edi",
" 0xc011ea77 <do_no_page+15>: mov 0x28(\%ebx),\%eax",
" 0xc011ea7a <do_no_page+18>: test \%eax,\%eax",
" 0xc011ea7c <do_no_page+20>: je 0xc011ea85 <do_no_page+29>",
" 0xc011ea7e <do_no_page+22>: mov 0x18(\%eax),\%ecx",
" 0xc011ea81 <do_no_page+25>: test \%ecx,\%ecx",
" 0xc011ea83 <do_no_page+27>: jne 0xc011eab0 <do_no_page+72>",
" 0xc011ea85 <do_no_page+29>: mov $0xffffe000,\%eax",
" 0xc011ea8a <do_no_page+34>: and \%esp,\%eax",
" 0xc011ea8c <do_no_page+36>: decl 0x30(\%eax)",
" 0xc011ea8f <do_no_page+39>: jns 0xc011ea9a <do_no_page+50>",
" 0xc011ea91 <do_no_page+41>: lock btrl $0x0,0xc022fb60",
" 0xc011ea9a <do_no_page+50>: push \%edi",
" 0xc011ea9b <do_no_page+51>: mov 0x18(\%ebp),\%esi",
" 0xc011ea9e <do_no_page+54>: push \%esi",
" 0xc011ea9f <do_no_page+55>: push \%ebx",
" 0xc011eaa0 <do_no_page+56>: mov 0x8(\%ebp),\%esi",
" 0xc011eaa3 <do_no_page+59>: push \%esi",
" 0xc011eaa4 <do_no_page+60>: call 0xc011e9e4 <do_anonymous_page>",
" 0xc011eaa9 <do_no_page+65>: jmp 0xc011eb47 <do_no_page+223>",
" ",
" Disassemble 10 instructions starting at user virtual address 0x81ec624:\n",
" %s> dis -u 81ec624 10",
" 0x81ec624: push \%ebp",
" 0x81ec625: mov \%esp,\%ebp",
" 0x81ec627: sub $0x18,\%esp",
" 0x81ec62a: movl $0x1,0x8(\%ebp)",
" 0x81ec631: mov 0x82f9040,\%eax",
" 0x81ec636: mov 0x10(\%eax),\%edx",
" 0x81ec639: and $0x100,\%edx",
" 0x81ec63f: mov 0x14(\%eax),\%ecx",
" 0x81ec642: and $0x0,\%ecx",
" 0x81ec645: mov \%ecx,\%eax",
" ",
" Override the current decimal output radix format:\n",
" %s> dis sys_read 10 -x",
" 0xffffffff8001178f <sys_read>: push %r13",
" 0xffffffff80011791 <sys_read+0x2>: mov %rsi,%r13",
" 0xffffffff80011794 <sys_read+0x5>: push %r12",
" 0xffffffff80011796 <sys_read+0x7>: mov $0xfffffffffffffff7,%r12",
" 0xffffffff8001179d <sys_read+0xe>: push %rbp",
" 0xffffffff8001179e <sys_read+0xf>: mov %rdx,%rbp",
" 0xffffffff800117a1 <sys_read+0x12>: push %rbx",
" 0xffffffff800117a2 <sys_read+0x13>: sub $0x18,%rsp",
" 0xffffffff800117a6 <sys_read+0x17>: lea 0x14(%rsp),%rsi",
" 0xffffffff800117ab <sys_read+0x1c>: callq 0xffffffff8000b5b4 <fget_light>",
NULL
};
char *help_eval[] = {
"eval",
"evaluate",
"[-b][-l] (expression) | value",
" This command evaluates an expression or numeric value, and displays its",
" result in hexadecimal, decimal, octal and binary. If the resultant value",
" is an integral number of gigabytes, megabytes, or kilobytes, a short-hand",
" translation of the number will also be shown next to the hexadecimal",
" value. If the most significant bit is set, the decimal display will show",
" both unsigned and signed (negative) values. Expressions must of the format",
" (x operator y), where \"x\" and \"y\" may be either numeric values or",
" symbols. The list of operators are:\n",
" + - & | ^ * \% / << >>\n",
" Enclosing the expression within parentheses is optional except when the",
" \"|\", \"<<\" or \">>\" operators are used. The single \"value\" argument may",
" be a number or symbol. Number arguments must be hexadecimal or decimal.",
" A leading \"0x\" identifies a number as hexadecimal, but is not required",
" when obvious. Numbers may be followed by the letters \"k\" or \"K\", \"m\"",
" or \"M\", and \"g\" or \"G\", which multiplies the value by a factor of 1024,",
" 1 megabyte or 1 gigabyte, respectively. Numeric arguments may be preceded",
" by the one's complement operator ~.",
" ",
" -b Indicate which bit positions in the resultant value are set.",
" -l Numeric arguments are presumed to be 64-bit values, and the result",
" will be expressed as a 64-bit value. (ignored on 64-bit processors)",
" However, if either operand or the resultant value are 64-bit values,",
" then the result will be also be expressed as a 64-bit value.",
" ",
" The -b and -l options must precede the expression or value arguments.",
"\nEXAMPLES",
" %s> eval 128m",
" hexadecimal: 8000000 (128MB)",
" decimal: 134217728 ",
" octal: 1000000000",
" binary: 00001000000000000000000000000000",
" ",
" %s> eval 128 * 1m",
" hexadecimal: 8000000 (128MB)",
" decimal: 134217728 ",
" octal: 1000000000",
" binary: 00001000000000000000000000000000",
" ",
" %s> eval (1 << 27)",
" hexadecimal: 8000000 (128MB)",
" decimal: 134217728 ",
" octal: 1000000000",
" binary: 00001000000000000000000000000000",
" ",
" %s> eval (1 << 32)",
" hexadecimal: 100000000 (4GB)",
" decimal: 4294967296",
" octal: 40000000000",
" binary: 0000000000000000000000000000000100000000000000000000000000000000",
" ",
" %s> eval -b 41dc065",
" hexadecimal: 41dc065",
" decimal: 69058661 ",
" octal: 407340145",
" binary: 00000100000111011100000001100101",
" bits set: 26 20 19 18 16 15 14 6 5 2 0 ",
" ",
" %s> eval -lb 64g",
" hexadecimal: 1000000000 (64GB)",
" decimal: 68719476736",
" octal: 1000000000000",
" binary: 0000000000000000000000000001000000000000000000000000000000000000",
" bits set: 36",
NULL
};
char *help_sym[] = {
"sym",
"translate a symbol to its virtual address, or vice-versa ",
"[-l] | [-M] | [-m module] | [-p|-n] | [-q string] | [symbol | vaddr]",
" This command translates a symbol to its virtual address, or a static ",
" kernel virtual address to its symbol -- or to a symbol-plus-offset value,",
" if appropriate. Additionally, the symbol type is shown in parentheses, ",
" and if the symbol is a known text value, the file and line number are shown.\n",
" -l dumps all symbols and their values.",
" -M dumps the current set of module symbols.",
" -m module dumps the current set of symbols for a specified module.",
" -p display the target symbol and the previous symbol.",
" -n display the target symbol and the next symbol.",
" -q string searches for all symbols containing \"string\".",
" symbol a kernel text or data symbol.",
" vaddr a kernel virtual address.",
" ",
" If the \"symbol\", \"vaddr\" or \"string\" argument resolves to a module",
" symbol, then the module name will be displayed in brackets following the",
" symbol value.",
"\nEXAMPLES",
" Translate data symbol jiffies to its value, and vice-versa:\n",
" %s> sym jiffies",
" c0213ae0 (D) jiffies\n",
" %s> sym c0213ae0",
" c0213ae0 (D) jiffies\n",
" Translate a text address to its symbolic value and source file:\n",
" %s> sym c0109944",
" c0109944 (T) system_call+0x34 ../linux-2.2.5/arch/i386/kernel/signal.c: 723\n",
" Dump the whole symbol table:\n",
" %s> sym -l",
" c0100000 (T) _stext",
" c0100000 (A) _text",
" c0100000 (t) startup_32",
" c0100000 (T) stext",
" c01000a4 (t) checkCPUtype",
" c0100139 (t) is486",
" c0100148 (t) is386",
" c01001b1 (t) L6",
" c01001b3 (t) ready",
" c01001b4 (t) check_x87",
" c01001da (t) setup_idt",
" c01001f7 (t) rp_sidt",
" c0100204 (T) stack_start",
" c010020c (t) int_msg",
" c0100220 (t) ignore_int",
" c0100242 (t) idt_descr",
" c0100244 (T) idt",
" c010024a (t) gdt_descr",
" c010024c (T) gdt",
" c0101000 (T) swapper_pg_dir",
" c0102000 (T) pg0",
" c0103000 (T) empty_bad_page",
" c0104000 (T) empty_bad_page_table",
" c0105000 (T) empty_zero_page",
" ...\n",
" Find all symbols containing the string \"pipe\":\n",
" %s> sym -q pipe",
" c010ec60 (T) sys_pipe ",
" c012f660 (t) pipe_read ",
" c012f7b8 (t) pipe_write ",
" c012f9c0 (t) pipe_lseek ",
" c012f9d0 (t) bad_pipe_r ",
" c012f9dc (t) bad_pipe_w ",
" c012f9e8 (t) pipe_ioctl ",
" c012fa18 (t) pipe_poll ",
" c012fb00 (t) pipe_release ",
" c012fb48 (t) pipe_read_release ",
" c012fb5c (t) pipe_write_release ",
" c012fb70 (t) pipe_rdwr_release ",
" c012fba0 (t) pipe_read_open ",
" c012fbb0 (t) pipe_write_open ",
" c012fbc0 (t) pipe_rdwr_open ",
" c012fbec (t) get_pipe_inode ",
" c012fcc4 (T) do_pipe ",
" c023a920 (D) read_pipe_fops ",
" c023a960 (D) write_pipe_fops ",
" c023a9a0 (D) rdwr_pipe_fops ",
" c023a9e0 (D) pipe_inode_operations ",
"\n Dump the symbols of the uart401 module, both before, and then after,",
" the complete set of symbols are loaded with the \"mod -s\" command:\n",
" %s> sym -m uart401",
" c8032000 MODULE START: uart401",
" c8032138 (?) uart401intr ",
" c803235c (?) attach_uart401 ",
" c8032638 (?) probe_uart401 ",
" c80326d4 (?) unload_uart401 ",
" c8033770 MODULE END: uart401",
" %s> mod -s uart401",
" MODULE NAME SIZE OBJECT FILE",
" c8032000 uart401 6000 /lib/modules/2.2.14/misc/uart401.o",
" %s> sym -m uart401",
" c8032000 MODULE START: uart401",
" c8032050 (t) my_notifier_call ",
" c8032084 (t) uart401_status ",
" c8032098 (t) uart401_cmd ",
" c80320a8 (t) uart401_read ",
" c80320bc (t) uart401_write ",
" c80320cc (t) uart401_input_loop ",
" c8032138 (T) uart401intr ",
" c8032168 (t) uart401_open ",
" c80321c8 (t) uart401_close ",
" c80321f4 (t) uart401_out ",
" c80322ac (t) uart401_start_read ",
" c80322b4 (t) uart401_end_read ",
" c80322bc (t) uart401_kick ",
" c80322c4 (t) uart401_buffer_status ",
" c80322cc (t) enter_uart_mode ",
" c803235c (T) attach_uart401 ",
" c803259c (t) reset_uart401 ",
" c8032638 (T) probe_uart401 ",
" c80326d4 (T) unload_uart401 ",
" c8032760 (T) init_module",
" c80327cc (T) cleanup_module ",
" c8032b00 (d) sound_notifier ",
" c8032b0c (d) detected_devc ",
" c8032b20 (d) std_synth_info ",
" c8032bc0 (d) std_midi_synth ",
" c8033600 (d) uart401_operations ",
" c80336c4 (D) io ",
" c80336c8 (D) irq ",
" c80336e0 (b) hw_info.508 ",
" c8033770 MODULE END: uart401",
"\n Display the value of jiffies, along with the next and previous symbols:\n",
" %s> sym -np jiffies",
" c023027c (D) prof_shift",
" c0230280 (D) jiffies ",
" c02302a0 (D) task",
"\n Translate a symbol value to its name and module:\n",
" crash> sym f88878d1",
" f88878d1 (t) ext3_readdir [ext3]",
" crash>",
NULL
};
char *help_files[] = {
"files",
"open files",
"[-d dentry] | [-R reference] [pid | taskp] ... ",
" This command displays information about open files of a context.",
" It prints the context's current root directory and current working",
" directory, and then for each open file descriptor it prints a pointer",
" to its file struct, a pointer to its dentry struct, a pointer to the",
" inode, the file type, and the pathname. If no arguments are entered,",
" the current context is used. The -R option, typically invoked from",
" \"foreach files\", searches for references to a supplied number, address,",
" or filename argument, and prints only the essential information leading",
" up to and including the reference. The -d option is not context",
" specific, and only shows the data requested.\n",
" -d dentry given a hexadecimal dentry address, display its inode,",
" super block, file type, and full pathname.",
" -R reference search for references to this file descriptor number,",
" filename, or dentry, inode, or file structure address.",
" pid a process PID.",
" taskp a hexadecimal task_struct pointer.",
"\nEXAMPLES",
" Display the open files of the current context:\n",
" %s> files",
" PID: 720 TASK: c67f2000 CPU: 1 COMMAND: \"innd\"",
" ROOT: / CWD: /var/spool/news/articles",
" FD FILE DENTRY INODE TYPE PATH",
" 0 c6b9c740 c7cc45a0 c7c939e0 CHR /dev/null",
" 1 c6b9c800 c537bb20 c54d0000 REG /var/log/news/news",
" 2 c6df9600 c537b420 c5c36360 REG /var/log/news/errlog",
" 3 c74182c0 c6ede260 c6da3d40 PIPE",
" 4 c6df9720 c696c620 c69398c0 SOCK",
" 5 c6b9cc20 c68e7000 c6938d80 SOCK",
" 6 c6b9c920 c7cc45a0 c7c939e0 CHR /dev/null",
" 7 c6b9c680 c58fa5c0 c58a1200 REG /var/lib/news/history",
" 8 c6df9f00 c6ede760 c6da3200 PIPE",
" 9 c6b9c6e0 c58fa140 c5929560 REG /var/lib/news/history.dir",
" 10 c7fa9320 c7fab160 c7fafd40 CHR /dev/console",
" 11 c6b9c7a0 c58fa5c0 c58a1200 REG /var/lib/news/history",
" 12 c377ec60 c58fa5c0 c58a1200 REG /var/lib/news/history",
" 13 c4528aa0 c58fa6c0 c52fbb00 REG /var/lib/news/history.pag",
" 14 c6df9420 c68e7700 c6938360 SOCK",
" 15 c6df9360 c68e7780 c6938120 SOCK",
" 16 c6b9c0e0 c68e7800 c6772000 SOCK",
" 17 c6b9c200 c6b5f9c0 c6b5cea0 REG /var/lib/news/active",
" 21 c6b9c080 c6ede760 c6da3200 PIPE",
" ",
" Display the files opened by the \"crond\" daemon, which is PID 462:\n",
" %s> files 462",
" PID: 462 TASK: f7220000 CPU: 2 COMMAND: \"crond\"",
" ROOT: / CWD: /var/spool",
" FD FILE DENTRY INODE TYPE PATH",
" 0 f7534ae0 f7538de0 f7518dc0 CHR /dev/console",
" 1 f7368f80 f72c7a40 f72f27e0 FIFO pipe:/[1456]",
" 2 f74f3c80 f72c79c0 f72f2600 FIFO pipe:/[1457]",
" 3 f7368b60 f72a5be0 f74300c0 REG /var/run/crond.pid",
" 4 f7534360 f73408c0 f72c2840 REG /var/log/cron",
" 7 f7368ce0 f72c7940 f72f2420 FIFO pipe:/[1458]",
" 8 f7295de0 f72c7940 f72f2420 FIFO pipe:/[1458]",
" 21 f74f36e0 f747cdc0 f747e840 CHR /dev/null",
" ",
" The -R option is typically invoked from \"foreach files\". This example",
" shows all tasks that have \"/dev/pts/4\" open:\n",
" %s> foreach files -R pts/4",
" PID: 18633 TASK: c310a000 CPU: 0 COMMAND: \"crash\"",
" ROOT: / CWD: /home/CVS_pool/crash ",
" FD FILE DENTRY INODE TYPE PATH",
" 0 c1412850 c2cb96d0 c2cad430 CHR /dev/pts/4",
" 1 c1412850 c2cb96d0 c2cad430 CHR /dev/pts/4",
" 2 c1412850 c2cb96d0 c2cad430 CHR /dev/pts/4",
" ",
" PID: 18664 TASK: c2392000 CPU: 1 COMMAND: \"less\"",
" ROOT: / CWD: /home/CVS_pool/crash ",
" FD FILE DENTRY INODE TYPE PATH",
" 1 c1412850 c2cb96d0 c2cad430 CHR /dev/pts/4",
" 2 c1412850 c2cb96d0 c2cad430 CHR /dev/pts/4",
" ",
" PID: 23162 TASK: c5088000 CPU: 1 COMMAND: \"bash\"",
" ROOT: / CWD: /home/CVS_pool/crash ",
" FD FILE DENTRY INODE TYPE PATH",
" 0 c1412850 c2cb96d0 c2cad430 CHR /dev/pts/4",
" 1 c1412850 c2cb96d0 c2cad430 CHR /dev/pts/4",
" 2 c1412850 c2cb96d0 c2cad430 CHR /dev/pts/4",
" 255 c1412850 c2cb96d0 c2cad430 CHR /dev/pts/4",
" ",
" PID: 23159 TASK: c10fc000 CPU: 1 COMMAND: \"xterm\"",
" ROOT: / CWD: /homes/anderson/ ",
" FD FILE DENTRY INODE TYPE PATH",
" 5 c1560da0 c2cb96d0 c2cad430 CHR /dev/pts/4",
" ",
" Display information about the dentry at address f745fd60:\n",
" %s> files -d f745fd60",
" DENTRY INODE SUPERBLK TYPE PATH",
" f745fd60 f7284640 f73a3e00 REG /var/spool/lpd/lpd.lock",
NULL
};
char *help_fuser[] = {
"fuser",
"file users",
"[pathname | inode]",
" This command displays the tasks using specified files or sockets.",
" Tasks will be listed that reference the file as the current working",
" directory, root directory, an open file descriptor, or that mmap the",
" file. If the file is held open in the kernel by the lockd server on",
" behalf of a client discretionary file lock, the client hostname is",
" listed.\n",
" pathname the full pathname of the file.",
" inode the hexadecimal inode address for the file.",
"\nEXAMPLES",
" Display the tasks using file /usr/lib/libkfm.so.2.0.0\n",
" %s> fuser /usr/lib/libkfm.so.2.0.0",
" PID TASK COMM USAGE",
" 779 c5e82000 \"kwm\" mmap",
" 808 c5a8e000 \"krootwm\" mmap",
" 806 c5b42000 \"kfm\" mmap",
" 809 c5dde000 \"kpanel\" mmap",
NULL
};
char *help_net[] = {
"net",
"network command",
"[-a] [[-s | -S [-xd]] [-R ref] [pid | taskp]] [-n addr]",
" Display various network related data:\n",
" -a display the ARP cache.",
" -s display open network socket/sock addresses, their family and type,",
" and for INET and INET6 families, their source and destination",
" addresses and ports.",
" -S displays open network socket/sock addresses followed by a dump",
" of both structures.",
" -x override default output format with hexadecimal format.",
" -d override default output format with decimal format.",
" -n addr translates an IPv4 address expressed as a decimal or hexadecimal",
" value into a standard numbers-and-dots notation.",
" -R ref socket or sock address, or file descriptor.",
" pid a process PID.",
" taskp a hexadecimal task_struct pointer.\n",
" If no arguments are entered, the list of network devices, names and IP",
" addresses are displayed. The -R option, typically invoked from \"foreach net\",",
" and in conjunction with the -s or -S options, searches for references to a",
" socket address, sock address, or a file descriptor; if found, only the",
" referenced fd/socket/sock data will be displayed.",
"\nEXAMPLES",
" Display the network device list:",
"\n %s> net",
" DEVICE NAME IP ADDRESS(ES)",
" c0249f20 lo 127.0.0.1",
" c7fe6d80 eth0 10.1.8.20",
" ",
" Dump the ARP cache:\n",
" %s> net -a",
" NEIGHBOUR IP ADDRESS HW TYPE HW ADDRESS DEVICE STATE",
" f38d1b00 10.16.64.14 ETHER 00:16:3e:4b:a5:4a eth1 STALE",
" f38d1080 0.0.0.0 UNKNOWN 00 00 00 00 00 00 lo NOARP",
" f38d1bc0 10.16.71.254 ETHER 00:00:0c:07:ac:00 eth1 REACHABLE",
" f38d1200 10.16.64.21 ETHER 00:16:3e:51:d8:09 eth1 REACHABLE",
" ",
" Display the sockets for PID 2517, using both -s and -S output formats:\n",
" %s> net -s 2517",
" PID: 2517 TASK: c1598000 CPU: 1 COMMAND: \"rlogin\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 3 c57375dc c1ff1850 INET:STREAM 10.1.8.20-1023 10.1.16.62-513",
" ",
" %s> net -S 2517",
" PID: 2517 TASK: c1598000 CPU: 1 COMMAND: \"rlogin\"",
" FD SOCKET SOCK",
" 3 c57375dc c1ff1850",
" ",
" struct socket {",
" state = SS_CONNECTED,",
" flags = 131072,",
" ops = 0xc023f820,",
" inode = 0xc5737540,",
" fasync_list = 0x0,",
" file = 0xc58892b0,",
" sk = 0xc1ff1850,",
" wait = 0xc14d9ed4,",
" type = 1,",
" passcred = 0 '\\000',",
" tli = 0 '\\000'",
" }",
" struct sock {",
" sklist_next = 0xc1ff12f0,",
" sklist_prev = 0xc216bc00,",
" bind_next = 0x0,",
" bind_pprev = 0xc0918448,",
" daddr = 1041236234,",
" rcv_saddr = 336068874,",
" dport = 258,",
" num = 1023,",
" bound_dev_if = 0,",
" next = 0x0,",
" pprev = 0xc0286dd4,",
" state = 1 '\\001',",
" zapped = 0 '\\000',",
" sport = 65283,",
" family = 2,",
" reuse = 0 '\\000',",
" ...",
" "
" Translate the rcv_saddr from above into dotted-decimal notation:\n",
" %s> net -n 1041236234",
" 10.1.16.62",
" ",
" From \"foreach\", find all tasks with references to socket c08ea3cc:\n",
" %s> foreach net -s -R c08ea3cc",
" PID: 2184 TASK: c7026000 CPU: 1 COMMAND: \"klines.kss\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 2200 TASK: c670a000 CPU: 1 COMMAND: \"kpanel\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 2201 TASK: c648a000 CPU: 1 COMMAND: \"kbgndwm\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 19294 TASK: c250a000 CPU: 0 COMMAND: \"prefdm\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 2194 TASK: c62dc000 CPU: 1 COMMAND: \"kaudioserver\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 2195 TASK: c6684000 CPU: 1 COMMAND: \"maudio\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 2196 TASK: c6b58000 CPU: 1 COMMAND: \"kwmsound\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 2197 TASK: c6696000 CPU: 0 COMMAND: \"kfm\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 2199 TASK: c65ec000 CPU: 0 COMMAND: \"krootwm\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 694 TASK: c1942000 CPU: 0 COMMAND: \"prefdm\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 698 TASK: c6a2c000 CPU: 1 COMMAND: \"X\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
" PID: 2159 TASK: c4a5a000 CPU: 1 COMMAND: \"kwm\"",
" FD SOCKET SOCK FAMILY:TYPE SOURCE-PORT DESTINATION-PORT",
" 5 c08ea3cc c50d3c80 INET:STREAM 0.0.0.0-1026 0.0.0.0-0",
" ",
NULL
};
char *help_waitq[] = {
"waitq",
"list tasks queued on a wait queue",
" [ symbol ] | [ struct.member struct_addr ] | [ address ]",
" This command walks the wait queue list displaying the tasks which ",
" are blocked on the specified wait queue. The command differentiates",
" between the old- and new-style wait queue structures used by the kernel.",
" It can be invoked with the following argument types:",
" ",
" symbol a global symbol of a wait queue.",
" struct.member struct_addr a structure name and wait queue member combination",
" followed by the structure's hexadecimal address.",
" address a hexadecimal wait queue pointer.",
"\nEXAMPLES\n",
" Find out if any tasks are blocked on the \"buffer_wait\" wait queue:\n",
" %s> waitq buffer_wait",
" wait queue \"buffer_wait\" (c02927f0) is empty",
" ",
" See who is blocked on the \"wait_chldexit\" queue of task c5496000:\n",
" %s> waitq task_struct.wait_chldexit c5496000",
" PID: 30879 TASK: c5496000 CPU: 0 COMMAND: \"bash\"",
" ",
" Display the task list waiting on a known task queue:\n",
" %s> waitq c3534098",
" PID: 13691 TASK: c3534000 CPU: 1 COMMAND: \"bash\"",
NULL
};
/*
* Find out what the help request is looking for, accepting aliases as well,
* and print the relevant strings from the appropriate help table.
*/
void
cmd_usage(char *cmd, int helpflag)
{
char **p, *scroll_command;
struct command_table_entry *cp;
char buf[BUFSIZE];
FILE *scroll;
int i;
if (helpflag & PIPE_TO_SCROLL) {
if ((scroll_command = setup_scroll_command()) &&
(scroll = popen(scroll_command, "w")))
fp = scroll;
else
scroll = NULL;
} else {
scroll_command = NULL;
scroll = NULL;
}
if (STREQ(cmd, "copying")) {
display_copying_info();
goto done_usage;
}
if (STREQ(cmd, "warranty")) {
display_warranty_info();
goto done_usage;
}
if (STREQ(cmd, "input")) {
display_input_info();
goto done_usage;
}
if (STREQ(cmd, "output")) {
display_output_info();
goto done_usage;
}
if (STREQ(cmd, "all")) {
display_input_info();
display_output_info();
help_init();
for (i = 0; i < pc->ncmds; i++)
cmd_usage(pc->cmdlist[i], COMPLETE_HELP);
display_warranty_info();
display_copying_info();
goto done_usage;
}
if (STREQ(cmd, "commands")) {
display_commands();
goto done_usage;
}
if (STREQ(cmd, "README")) {
display_README();
goto done_usage;
}
/* look up command, possibly through an alias */
for (;;) {
struct alias_data *ad;
cp = get_command_table_entry(cmd);
if (cp != NULL)
break; /* found command */
/* try for an alias */
ad = is_alias(cmd);
if (ad == NULL)
break; /* neither command nor alias */
cmd = ad->args[0];
cp = get_command_table_entry(cmd);
}
if (cp == NULL || (p = cp->help_data) == NULL) {
if (helpflag & SYNOPSIS) {
fprintf(fp,
"No usage data for the \"%s\" command"
" is available.\n",
cmd);
RESTART();
}
if (helpflag & MUST_HELP) {
if (cp || !(pc->flags & GDB_INIT))
fprintf(fp,
"No help data for the \"%s\" command"
" is available.\n",
cmd);
else if (!gdb_pass_through(concat_args(buf, 0, FALSE),
NULL, GNU_RETURN_ON_ERROR))
fprintf(fp,
"No help data for \"%s\" is available.\n",
cmd);
}
goto done_usage;
}
p++;
if (helpflag & SYNOPSIS) {
p++;
fprintf(fp, "Usage:\n %s ", cmd);
fprintf(fp, *p, pc->program_name, pc->program_name);
fprintf(fp, "\nEnter \"help %s\" for details.\n", cmd);
RESTART();
}
fprintf(fp, "\nNAME\n %s - ", cmd);
fprintf(fp, *p, pc->program_name);
fprintf(fp, "\n\nSYNOPSIS\n");
p++;
fprintf(fp, " %s ", cmd);
fprintf(fp, *p, pc->program_name);
fprintf(fp,"\n\nDESCRIPTION\n");
p++;
do {
if (strstr(*p, "%") && !strstr(*p, "%s"))
print_verbatim(fp, *p);
else
fprintf(fp, *p, pc->program_name, pc->program_name);
fprintf(fp, "\n");
p++;
} while (*p);
fprintf(fp, "\n");
done_usage:
if (scroll) {
fflush(scroll);
pclose(scroll);
}
if (scroll_command)
FREEBUF(scroll_command);
}
static
char *input_info[] = {
"Interactive %s commands are gathered using the GNU readline library,",
"which implements a command line history mechanism, and a command line editing",
"mode.\n",
"The command line history consists of a numbered list of previously run ",
"commands, which can be viewed by entering \"h\" at any time. A previously",
"run command can be re-executed in a number of manners:",
" ",
" 1. To re-execute the last command, enter \"r\" alone, or \"!!\".",
" 2. Enter \"r\" followed by the number identifying the desired command.",
" 3. Enter \"r\" followed by a uniquely-identifying set of characters from",
" the beginning of the desired command string.",
" 4. Recycle back through the command history list by hitting the up-arrow",
" key until the desired command is re-displayed, and then hit <ENTER>.",
" If you go too far back, hit the down-arrow key.",
" ",
"The command line editing mode can be set to emulate either vi or emacs.",
"The mode can be set in the following manners, listed in increasing order of",
"precedence:",
" ",
" 1. The setting of the EDITOR environment variable.",
" 2. An entry in either in a .%src file, which can be located either",
" in the current directory or in your home directory. The entry must",
" be of the form \"set vi\" or \"set emacs\".",
" 3. By use of the %s \"-e\" command line option, as in \"-e vi\" or \"-e emacs\".",
" ",
"To edit a previously entered command:",
" ",
" 1. Recycle back through the command history list until the desired command",
" is re-displayed.",
" 2. Edit the line using vi or emacs editing commands, as appropriate. ",
" 3. Hit <ENTER>.",
" ",
"It should be noted that command line re-cycling may be accomplished by using",
"the CTRL-p and CTRL-n keys instead of the up- and down-arrow keys; in vi mode",
"you can enter <ESC>, then \"k\" to cycle back, or \"j\" to cycle forward.",
" ",
"A set of %s commands may be entered into a regular file that can be used as",
"input, using standard command line syntax:\n",
" %s> < inputfile\n",
"An input file may be also be run from the %s command line using the -i ",
"option:\n",
" $ %s -i inputfile",
"",
"Alternatively, an input file containing command arguments may be created.",
"The arguments in the input file will be passed to the command specified,",
"which will be executed repetetively for each line of arguments in the file:",
"",
" %s> ps -p < inputfile",
"",
"Lastly, if a command is entered that is not recognized, it is checked against",
"the kernel's list of variables, structure, union or typedef names, and if ",
"found, the command is passed to p, struct, union or whatis. That being the ",
"case, as long as a kernel variable/structure/union name is different than any",
"of the current commands, the appropriate command above will be executed. If",
"not, the command will be passed on to the built-in gdb command for execution.",
"If an input line starts with \"#\" or \"//\", then the line will be saved",
"as a comment that is visible when re-cycling through the history list.",
NULL
};
/*
* Display information concerning command input options: history,
* command recall, command-line editing, and input files.
*/
static void
display_input_info(void)
{
int i;
for (i = 0; input_info[i]; i++) {
fprintf(fp, input_info[i],
pc->program_name, pc->program_name);
fprintf(fp, "\n");
}
}
static
char *output_info[] = {
"\nBy default, %s command output is piped to \"/usr/bin/less -E -X\" along",
"with a prompt line. This behavior can be turned off in two ways:\n",
" 1. During runtime, enter \"set scroll off\" or the alias \"sf\".",
" 2. Enter \"set scroll off\" in a .%src file, which can be located either",
" in the current directory or in your home directory.\n",
"To restore the scrolling behavior during runtime, enter \"set scroll on\"",
"or the alias: \"sn\"\n",
"Command output may be piped to an external command using standard command",
"line pipe syntax. For example:\n",
" %s> log | grep eth0\n",
"Command output may be redirected to a file using standard command line syntax.",
"For example:\n",
" %s> foreach bt > bt.all\n",
"Use double brackets to append the output to a pre-existing file:\n",
" %s> ps >> crash.data\n",
"The default output radix for gdb output and certain %s commands is",
"hexadecimal. This can be changed to decimal by entering \"set radix 10\"",
"or the alias \"dec\". It can be reverted back to hexadecimal by entering",
"\"set radix 16\" or the alias \"hex\".\n",
"To execute an external shell command, precede the command with an \"!\".",
"To escape to a shell, enter \"!\" alone.",
" ",
NULL
};
/*
* Display information concerning command output options.
*/
static void
display_output_info(void)
{
int i;
for (i = 0; output_info[i]; i++) {
fprintf(fp, output_info[i],
pc->program_name, pc->program_name);
fprintf(fp, "\n");
}
}
/*
* Display the program name, version, and the GPL-required stuff for
* interactive programs.
*/
void
display_version(void)
{
int i;
if (pc->flags & SILENT)
return;
fprintf(fp, "\n%s %s\n", pc->program_name, pc->program_version);
for (i = 0; version_info[i]; i++)
fprintf(fp, "%s\n", version_info[i]);
}
static
char *version_info[] = {
"Copyright (C) 2002-2014 Red Hat, Inc.",
"Copyright (C) 2004, 2005, 2006, 2010 IBM Corporation",
"Copyright (C) 1999-2006 Hewlett-Packard Co",
"Copyright (C) 2005, 2006, 2011, 2012 Fujitsu Limited",
"Copyright (C) 2006, 2007 VA Linux Systems Japan K.K.",
"Copyright (C) 2005, 2011 NEC Corporation",
"Copyright (C) 1999, 2002, 2007 Silicon Graphics, Inc.",
"Copyright (C) 1999, 2000, 2001, 2002 Mission Critical Linux, Inc.",
"This program is free software, covered by the GNU General Public License,",
"and you are welcome to change it and/or distribute copies of it under",
"certain conditions. Enter \"help copying\" to see the conditions.",
"This program has absolutely no warranty. Enter \"help warranty\" for details.",
" ",
NULL
};
/*
* "help copying" output
*/
static void
display_copying_info(void)
{
int i;
switch (GPL_version)
{
case GPLv2:
for (i = 0; !strstr(gnu_public_license[i], "NO WARRANTY"); i++)
fprintf(fp, "%s\n", gnu_public_license[i]);
break;
case GPLv3:
for (i = 0; !strstr(gnu_public_license_v3[i],
"15. Disclaimer of Warranty."); i++)
fprintf(fp, "%s\n", gnu_public_license_v3[i]);
break;
}
}
/*
* "help warranty" output
*/
static void
display_warranty_info(void)
{
int i;
switch (GPL_version)
{
case GPLv2:
for (i = 0; !strstr(gnu_public_license[i], "NO WARRANTY"); i++)
;
do {
fprintf(fp, "%s\n", gnu_public_license[i]);
} while (!strstr(gnu_public_license[i++], "END OF TERMS"));
break;
case GPLv3:
for (i = 0; !strstr(gnu_public_license_v3[i],
"15. Disclaimer of Warranty."); i++)
;
while (!strstr(gnu_public_license_v3[i], "END OF TERMS"))
fprintf(fp, "%s\n", gnu_public_license_v3[i++]);
break;
}
}
static
char *gnu_public_license[] = {
"",
" GNU GENERAL PUBLIC LICENSE",
" Version 2, June 1991",
"",
" Copyright (C) 1989, 1991 Free Software Foundation, Inc.",
" 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA",
" Everyone is permitted to copy and distribute verbatim copies",
" of this license document, but changing it is not allowed.",
"",
" Preamble",
"",
" The licenses for most software are designed to take away your",
"freedom to share and change it. By contrast, the GNU General Public",
"License is intended to guarantee your freedom to share and change free",
"software--to make sure the software is free for all its users. This",
"General Public License applies to most of the Free Software",
"Foundation's software and to any other program whose authors commit to",
"using it. (Some other Free Software Foundation software is covered by",
"the GNU Library General Public License instead.) You can apply it to",
"your programs, too.",
"",
" When we speak of free software, we are referring to freedom, not",
"price. Our General Public Licenses are designed to make sure that you",
"have the freedom to distribute copies of free software (and charge for",
"this service if you wish), that you receive source code or can get it",
"if you want it, that you can change the software or use pieces of it",
"in new free programs; and that you know you can do these things.",
"",
" To protect your rights, we need to make restrictions that forbid",
"anyone to deny you these rights or to ask you to surrender the rights.",
"These restrictions translate to certain responsibilities for you if you",
"distribute copies of the software, or if you modify it.",
"",
" For example, if you distribute copies of such a program, whether",
"gratis or for a fee, you must give the recipients all the rights that",
"you have. You must make sure that they, too, receive or can get the",
"source code. And you must show them these terms so they know their",
"rights.",
"",
" We protect your rights with two steps: (1) copyright the software, and",
"(2) offer you this license which gives you legal permission to copy,",
"distribute and/or modify the software.",
"",
" Also, for each author's protection and ours, we want to make certain",
"that everyone understands that there is no warranty for this free",
"software. If the software is modified by someone else and passed on, we",
"want its recipients to know that what they have is not the original, so",
"that any problems introduced by others will not reflect on the original",
"authors' reputations.",
"",
" Finally, any free program is threatened constantly by software",
"patents. We wish to avoid the danger that redistributors of a free",
"program will individually obtain patent licenses, in effect making the",
"program proprietary. To prevent this, we have made it clear that any",
"patent must be licensed for everyone's free use or not licensed at all.",
"",
" The precise terms and conditions for copying, distribution and",
"modification follow.",
"",
" GNU GENERAL PUBLIC LICENSE",
" TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION",
"",
" 0. This License applies to any program or other work which contains",
"a notice placed by the copyright holder saying it may be distributed",
"under the terms of this General Public License. The \"Program\", below,",
"refers to any such program or work, and a \"work based on the Program\"",
"means either the Program or any derivative work under copyright law:",
"that is to say, a work containing the Program or a portion of it,",
"either verbatim or with modifications and/or translated into another",
"language. (Hereinafter, translation is included without limitation in",
"the term \"modification\".) Each licensee is addressed as \"you\".",
"",
"Activities other than copying, distribution and modification are not",
"covered by this License; they are outside its scope. The act of",
"running the Program is not restricted, and the output from the Program",
"is covered only if its contents constitute a work based on the",
"Program (independent of having been made by running the Program).",
"Whether that is true depends on what the Program does.",
"",
" 1. You may copy and distribute verbatim copies of the Program's",
"source code as you receive it, in any medium, provided that you",
"conspicuously and appropriately publish on each copy an appropriate",
"copyright notice and disclaimer of warranty; keep intact all the",
"notices that refer to this License and to the absence of any warranty;",
"and give any other recipients of the Program a copy of this License",
"along with the Program.",
"",
"You may charge a fee for the physical act of transferring a copy, and",
"you may at your option offer warranty protection in exchange for a fee.",
"",
" 2. You may modify your copy or copies of the Program or any portion",
"of it, thus forming a work based on the Program, and copy and",
"distribute such modifications or work under the terms of Section 1",
"above, provided that you also meet all of these conditions:",
"",
" a) You must cause the modified files to carry prominent notices",
" stating that you changed the files and the date of any change.",
"",
" b) You must cause any work that you distribute or publish, that in",
" whole or in part contains or is derived from the Program or any",
" part thereof, to be licensed as a whole at no charge to all third",
" parties under the terms of this License.",
"",
" c) If the modified program normally reads commands interactively",
" when run, you must cause it, when started running for such",
" interactive use in the most ordinary way, to print or display an",
" announcement including an appropriate copyright notice and a",
" notice that there is no warranty (or else, saying that you provide",
" a warranty) and that users may redistribute the program under",
" these conditions, and telling the user how to view a copy of this",
" License. (Exception: if the Program itself is interactive but",
" does not normally print such an announcement, your work based on",
" the Program is not required to print an announcement.)",
"",
"These requirements apply to the modified work as a whole. If",
"identifiable sections of that work are not derived from the Program,",
"and can be reasonably considered independent and separate works in",
"themselves, then this License, and its terms, do not apply to those",
"sections when you distribute them as separate works. But when you",
"distribute the same sections as part of a whole which is a work based",
"on the Program, the distribution of the whole must be on the terms of",
"this License, whose permissions for other licensees extend to the",
"entire whole, and thus to each and every part regardless of who wrote it.",
"",
"Thus, it is not the intent of this section to claim rights or contest",
"your rights to work written entirely by you; rather, the intent is to",
"exercise the right to control the distribution of derivative or",
"collective works based on the Program.",
"",
"In addition, mere aggregation of another work not based on the Program",
"with the Program (or with a work based on the Program) on a volume of",
"a storage or distribution medium does not bring the other work under",
"the scope of this License.",
"",
" 3. You may copy and distribute the Program (or a work based on it,",
"under Section 2) in object code or executable form under the terms of",
"Sections 1 and 2 above provided that you also do one of the following:",
"",
" a) Accompany it with the complete corresponding machine-readable",
" source code, which must be distributed under the terms of Sections",
" 1 and 2 above on a medium customarily used for software interchange; or,",
"",
" b) Accompany it with a written offer, valid for at least three",
" years, to give any third party, for a charge no more than your",
" cost of physically performing source distribution, a complete",
" machine-readable copy of the corresponding source code, to be",
" distributed under the terms of Sections 1 and 2 above on a medium",
" customarily used for software interchange; or,",
"",
" c) Accompany it with the information you received as to the offer",
" to distribute corresponding source code. (This alternative is",
" allowed only for noncommercial distribution and only if you",
" received the program in object code or executable form with such",
" an offer, in accord with Subsection b above.)",
"",
"The source code for a work means the preferred form of the work for",
"making modifications to it. For an executable work, complete source",
"code means all the source code for all modules it contains, plus any",
"associated interface definition files, plus the scripts used to",
"control compilation and installation of the executable. However, as a",
"special exception, the source code distributed need not include",
"anything that is normally distributed (in either source or binary",
"form) with the major components (compiler, kernel, and so on) of the",
"operating system on which the executable runs, unless that component",
"itself accompanies the executable.",
"",
"If distribution of executable or object code is made by offering",
"access to copy from a designated place, then offering equivalent",
"access to copy the source code from the same place counts as",
"distribution of the source code, even though third parties are not",
"compelled to copy the source along with the object code.",
"",
" 4. You may not copy, modify, sublicense, or distribute the Program",
"except as expressly provided under this License. Any attempt",
"otherwise to copy, modify, sublicense or distribute the Program is",
"void, and will automatically terminate your rights under this License.",
"However, parties who have received copies, or rights, from you under",
"this License will not have their licenses terminated so long as such",
"parties remain in full compliance.",
"",
" 5. You are not required to accept this License, since you have not",
"signed it. However, nothing else grants you permission to modify or",
"distribute the Program or its derivative works. These actions are",
"prohibited by law if you do not accept this License. Therefore, by",
"modifying or distributing the Program (or any work based on the",
"Program), you indicate your acceptance of this License to do so, and",
"all its terms and conditions for copying, distributing or modifying",
"the Program or works based on it.",
"",
" 6. Each time you redistribute the Program (or any work based on the",
"Program), the recipient automatically receives a license from the",
"original licensor to copy, distribute or modify the Program subject to",
"these terms and conditions. You may not impose any further",
"restrictions on the recipients' exercise of the rights granted herein.",
"You are not responsible for enforcing compliance by third parties to",
"this License.",
"",
" 7. If, as a consequence of a court judgment or allegation of patent",
"infringement or for any other reason (not limited to patent issues),",
"conditions are imposed on you (whether by court order, agreement or",
"otherwise) that contradict the conditions of this License, they do not",
"excuse you from the conditions of this License. If you cannot",
"distribute so as to satisfy simultaneously your obligations under this",
"License and any other pertinent obligations, then as a consequence you",
"may not distribute the Program at all. For example, if a patent",
"license would not permit royalty-free redistribution of the Program by",
"all those who receive copies directly or indirectly through you, then",
"the only way you could satisfy both it and this License would be to",
"refrain entirely from distribution of the Program.",
"",
"If any portion of this section is held invalid or unenforceable under",
"any particular circumstance, the balance of the section is intended to",
"apply and the section as a whole is intended to apply in other",
"circumstances.",
"",
"It is not the purpose of this section to induce you to infringe any",
"patents or other property right claims or to contest validity of any",
"such claims; this section has the sole purpose of protecting the",
"integrity of the free software distribution system, which is",
"implemented by public license practices. Many people have made",
"generous contributions to the wide range of software distributed",
"through that system in reliance on consistent application of that",
"system; it is up to the author/donor to decide if he or she is willing",
"to distribute software through any other system and a licensee cannot",
"impose that choice.",
"",
"This section is intended to make thoroughly clear what is believed to",
"be a consequence of the rest of this License.",
"",
" 8. If the distribution and/or use of the Program is restricted in",
"certain countries either by patents or by copyrighted interfaces, the",
"original copyright holder who places the Program under this License",
"may add an explicit geographical distribution limitation excluding",
"those countries, so that distribution is permitted only in or among",
"countries not thus excluded. In such case, this License incorporates",
"the limitation as if written in the body of this License.",
"",
" 9. The Free Software Foundation may publish revised and/or new versions",
"of the General Public License from time to time. Such new versions will",
"be similar in spirit to the present version, but may differ in detail to",
"address new problems or concerns.",
"",
"Each version is given a distinguishing version number. If the Program",
"specifies a version number of this License which applies to it and \"any",
"later version\", you have the option of following the terms and conditions",
"either of that version or of any later version published by the Free",
"Software Foundation. If the Program does not specify a version number of",
"this License, you may choose any version ever published by the Free Software",
"Foundation.",
"",
" 10. If you wish to incorporate parts of the Program into other free",
"programs whose distribution conditions are different, write to the author",
"to ask for permission. For software which is copyrighted by the Free",
"Software Foundation, write to the Free Software Foundation; we sometimes",
"make exceptions for this. Our decision will be guided by the two goals",
"of preserving the free status of all derivatives of our free software and",
"of promoting the sharing and reuse of software generally.",
"",
"\n NO WARRANTY",
"",
" 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY",
"FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN",
"OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES",
"PROVIDE THE PROGRAM \"AS IS\" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED",
"OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF",
"MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS",
"TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE",
"PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,",
"REPAIR OR CORRECTION.",
"",
" 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING",
"WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR",
"REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,",
"INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING",
"OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED",
"TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY",
"YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER",
"PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE",
"POSSIBILITY OF SUCH DAMAGES.",
"",
" END OF TERMS AND CONDITIONS\n",
};
static
char *gnu_public_license_v3[] = {
" GNU GENERAL PUBLIC LICENSE",
" Version 3, 29 June 2007",
"",
" Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>",
" Everyone is permitted to copy and distribute verbatim copies",
" of this license document, but changing it is not allowed.",
"",
" Preamble",
"",
" The GNU General Public License is a free, copyleft license for",
"software and other kinds of works.",
"",
" The licenses for most software and other practical works are designed",
"to take away your freedom to share and change the works. By contrast,",
"the GNU General Public License is intended to guarantee your freedom to",
"share and change all versions of a program--to make sure it remains free",
"software for all its users. We, the Free Software Foundation, use the",
"GNU General Public License for most of our software; it applies also to",
"any other work released this way by its authors. You can apply it to",
"your programs, too.",
"",
" When we speak of free software, we are referring to freedom, not",
"price. Our General Public Licenses are designed to make sure that you",
"have the freedom to distribute copies of free software (and charge for",
"them if you wish), that you receive source code or can get it if you",
"want it, that you can change the software or use pieces of it in new",
"free programs, and that you know you can do these things.",
"",
" To protect your rights, we need to prevent others from denying you",
"these rights or asking you to surrender the rights. Therefore, you have",
"certain responsibilities if you distribute copies of the software, or if",
"you modify it: responsibilities to respect the freedom of others.",
"",
" For example, if you distribute copies of such a program, whether",
"gratis or for a fee, you must pass on to the recipients the same",
"freedoms that you received. You must make sure that they, too, receive",
"or can get the source code. And you must show them these terms so they",
"know their rights.",
"",
" Developers that use the GNU GPL protect your rights with two steps:",
"(1) assert copyright on the software, and (2) offer you this License",
"giving you legal permission to copy, distribute and/or modify it.",
"",
" For the developers' and authors' protection, the GPL clearly explains",
"that there is no warranty for this free software. For both users' and",
"authors' sake, the GPL requires that modified versions be marked as",
"changed, so that their problems will not be attributed erroneously to",
"authors of previous versions.",
"",
" Some devices are designed to deny users access to install or run",
"modified versions of the software inside them, although the manufacturer",
"can do so. This is fundamentally incompatible with the aim of",
"protecting users' freedom to change the software. The systematic",
"pattern of such abuse occurs in the area of products for individuals to",
"use, which is precisely where it is most unacceptable. Therefore, we",
"have designed this version of the GPL to prohibit the practice for those",
"products. If such problems arise substantially in other domains, we",
"stand ready to extend this provision to those domains in future versions",
"of the GPL, as needed to protect the freedom of users.",
"",
" Finally, every program is threatened constantly by software patents.",
"States should not allow patents to restrict development and use of",
"software on general-purpose computers, but in those that do, we wish to",
"avoid the special danger that patents applied to a free program could",
"make it effectively proprietary. To prevent this, the GPL assures that",
"patents cannot be used to render the program non-free.",
"",
" The precise terms and conditions for copying, distribution and",
"modification follow.",
"",
" TERMS AND CONDITIONS",
"",
" 0. Definitions.",
"",
" \"This License\" refers to version 3 of the GNU General Public License.",
"",
" \"Copyright\" also means copyright-like laws that apply to other kinds of",
"works, such as semiconductor masks.",
"",
" \"The Program\" refers to any copyrightable work licensed under this",
"License. Each licensee is addressed as \"you\". \"Licensees\" and",
"\"recipients\" may be individuals or organizations.",
"",
" To \"modify\" a work means to copy from or adapt all or part of the work",
"in a fashion requiring copyright permission, other than the making of an",
"exact copy. The resulting work is called a \"modified version\" of the",
"earlier work or a work \"based on\" the earlier work.",
"",
" A \"covered work\" means either the unmodified Program or a work based",
"on the Program.",
"",
" To \"propagate\" a work means to do anything with it that, without",
"permission, would make you directly or secondarily liable for",
"infringement under applicable copyright law, except executing it on a",
"computer or modifying a private copy. Propagation includes copying,",
"distribution (with or without modification), making available to the",
"public, and in some countries other activities as well.",
"",
" To \"convey\" a work means any kind of propagation that enables other",
"parties to make or receive copies. Mere interaction with a user through",
"a computer network, with no transfer of a copy, is not conveying.",
"",
" An interactive user interface displays \"Appropriate Legal Notices\"",
"to the extent that it includes a convenient and prominently visible",
"feature that (1) displays an appropriate copyright notice, and (2)",
"tells the user that there is no warranty for the work (except to the",
"extent that warranties are provided), that licensees may convey the",
"work under this License, and how to view a copy of this License. If",
"the interface presents a list of user commands or options, such as a",
"menu, a prominent item in the list meets this criterion.",
"",
" 1. Source Code.",
"",
" The \"source code\" for a work means the preferred form of the work",
"for making modifications to it. \"Object code\" means any non-source",
"form of a work.",
"",
" A \"Standard Interface\" means an interface that either is an official",
"standard defined by a recognized standards body, or, in the case of",
"interfaces specified for a particular programming language, one that",
"is widely used among developers working in that language.",
"",
" The \"System Libraries\" of an executable work include anything, other",
"than the work as a whole, that (a) is included in the normal form of",
"packaging a Major Component, but which is not part of that Major",
"Component, and (b) serves only to enable use of the work with that",
"Major Component, or to implement a Standard Interface for which an",
"implementation is available to the public in source code form. A",
"\"Major Component\", in this context, means a major essential component",
"(kernel, window system, and so on) of the specific operating system",
"(if any) on which the executable work runs, or a compiler used to",
"produce the work, or an object code interpreter used to run it.",
"",
" The \"Corresponding Source\" for a work in object code form means all",
"the source code needed to generate, install, and (for an executable",
"work) run the object code and to modify the work, including scripts to",
"control those activities. However, it does not include the work's",
"System Libraries, or general-purpose tools or generally available free",
"programs which are used unmodified in performing those activities but",
"which are not part of the work. For example, Corresponding Source",
"includes interface definition files associated with source files for",
"the work, and the source code for shared libraries and dynamically",
"linked subprograms that the work is specifically designed to require,",
"such as by intimate data communication or control flow between those",
"subprograms and other parts of the work.",
"",
" The Corresponding Source need not include anything that users",
"can regenerate automatically from other parts of the Corresponding",
"Source.",
"",
" The Corresponding Source for a work in source code form is that",
"same work.",
"",
" 2. Basic Permissions.",
"",
" All rights granted under this License are granted for the term of",
"copyright on the Program, and are irrevocable provided the stated",
"conditions are met. This License explicitly affirms your unlimited",
"permission to run the unmodified Program. The output from running a",
"covered work is covered by this License only if the output, given its",
"content, constitutes a covered work. This License acknowledges your",
"rights of fair use or other equivalent, as provided by copyright law.",
"",
" You may make, run and propagate covered works that you do not",
"convey, without conditions so long as your license otherwise remains",
"in force. You may convey covered works to others for the sole purpose",
"of having them make modifications exclusively for you, or provide you",
"with facilities for running those works, provided that you comply with",
"the terms of this License in conveying all material for which you do",
"not control copyright. Those thus making or running the covered works",
"for you must do so exclusively on your behalf, under your direction",
"and control, on terms that prohibit them from making any copies of",
"your copyrighted material outside their relationship with you.",
"",
" Conveying under any other circumstances is permitted solely under",
"the conditions stated below. Sublicensing is not allowed; section 10",
"makes it unnecessary.",
"",
" 3. Protecting Users' Legal Rights From Anti-Circumvention Law.",
"",
" No covered work shall be deemed part of an effective technological",
"measure under any applicable law fulfilling obligations under article",
"11 of the WIPO copyright treaty adopted on 20 December 1996, or",
"similar laws prohibiting or restricting circumvention of such",
"measures.",
"",
" When you convey a covered work, you waive any legal power to forbid",
"circumvention of technological measures to the extent such circumvention",
"is effected by exercising rights under this License with respect to",
"the covered work, and you disclaim any intention to limit operation or",
"modification of the work as a means of enforcing, against the work's",
"users, your or third parties' legal rights to forbid circumvention of",
"technological measures.",
"",
" 4. Conveying Verbatim Copies.",
"",
" You may convey verbatim copies of the Program's source code as you",
"receive it, in any medium, provided that you conspicuously and",
"appropriately publish on each copy an appropriate copyright notice;",
"keep intact all notices stating that this License and any",
"non-permissive terms added in accord with section 7 apply to the code;",
"keep intact all notices of the absence of any warranty; and give all",
"recipients a copy of this License along with the Program.",
"",
" You may charge any price or no price for each copy that you convey,",
"and you may offer support or warranty protection for a fee.",
"",
" 5. Conveying Modified Source Versions.",
"",
" You may convey a work based on the Program, or the modifications to",
"produce it from the Program, in the form of source code under the",
"terms of section 4, provided that you also meet all of these conditions:",
"",
" a) The work must carry prominent notices stating that you modified",
" it, and giving a relevant date.",
"",
" b) The work must carry prominent notices stating that it is",
" released under this License and any conditions added under section",
" 7. This requirement modifies the requirement in section 4 to",
" \"keep intact all notices\".",
"",
" c) You must license the entire work, as a whole, under this",
" License to anyone who comes into possession of a copy. This",
" License will therefore apply, along with any applicable section 7",
" additional terms, to the whole of the work, and all its parts,",
" regardless of how they are packaged. This License gives no",
" permission to license the work in any other way, but it does not",
" invalidate such permission if you have separately received it.",
"",
" d) If the work has interactive user interfaces, each must display",
" Appropriate Legal Notices; however, if the Program has interactive",
" interfaces that do not display Appropriate Legal Notices, your",
" work need not make them do so.",
"",
" A compilation of a covered work with other separate and independent",
"works, which are not by their nature extensions of the covered work,",
"and which are not combined with it such as to form a larger program,",
"in or on a volume of a storage or distribution medium, is called an",
"\"aggregate\" if the compilation and its resulting copyright are not",
"used to limit the access or legal rights of the compilation's users",
"beyond what the individual works permit. Inclusion of a covered work",
"in an aggregate does not cause this License to apply to the other",
"parts of the aggregate.",
"",
" 6. Conveying Non-Source Forms.",
"",
" You may convey a covered work in object code form under the terms",
"of sections 4 and 5, provided that you also convey the",
"machine-readable Corresponding Source under the terms of this License,",
"in one of these ways:",
"",
" a) Convey the object code in, or embodied in, a physical product",
" (including a physical distribution medium), accompanied by the",
" Corresponding Source fixed on a durable physical medium",
" customarily used for software interchange.",
"",
" b) Convey the object code in, or embodied in, a physical product",
" (including a physical distribution medium), accompanied by a",
" written offer, valid for at least three years and valid for as",
" long as you offer spare parts or customer support for that product",
" model, to give anyone who possesses the object code either (1) a",
" copy of the Corresponding Source for all the software in the",
" product that is covered by this License, on a durable physical",
" medium customarily used for software interchange, for a price no",
" more than your reasonable cost of physically performing this",
" conveying of source, or (2) access to copy the",
" Corresponding Source from a network server at no charge.",
"",
" c) Convey individual copies of the object code with a copy of the",
" written offer to provide the Corresponding Source. This",
" alternative is allowed only occasionally and noncommercially, and",
" only if you received the object code with such an offer, in accord",
" with subsection 6b.",
"",
" d) Convey the object code by offering access from a designated",
" place (gratis or for a charge), and offer equivalent access to the",
" Corresponding Source in the same way through the same place at no",
" further charge. You need not require recipients to copy the",
" Corresponding Source along with the object code. If the place to",
" copy the object code is a network server, the Corresponding Source",
" may be on a different server (operated by you or a third party)",
" that supports equivalent copying facilities, provided you maintain",
" clear directions next to the object code saying where to find the",
" Corresponding Source. Regardless of what server hosts the",
" Corresponding Source, you remain obligated to ensure that it is",
" available for as long as needed to satisfy these requirements.",
"",
" e) Convey the object code using peer-to-peer transmission, provided",
" you inform other peers where the object code and Corresponding",
" Source of the work are being offered to the general public at no",
" charge under subsection 6d.",
"",
" A separable portion of the object code, whose source code is excluded",
"from the Corresponding Source as a System Library, need not be",
"included in conveying the object code work.",
"",
" A \"User Product\" is either (1) a \"consumer product\", which means any",
"tangible personal property which is normally used for personal, family,",
"or household purposes, or (2) anything designed or sold for incorporation",
"into a dwelling. In determining whether a product is a consumer product,",
"doubtful cases shall be resolved in favor of coverage. For a particular",
"product received by a particular user, \"normally used\" refers to a",
"typical or common use of that class of product, regardless of the status",
"of the particular user or of the way in which the particular user",
"actually uses, or expects or is expected to use, the product. A product",
"is a consumer product regardless of whether the product has substantial",
"commercial, industrial or non-consumer uses, unless such uses represent",
"the only significant mode of use of the product.",
"",
" \"Installation Information\" for a User Product means any methods,",
"procedures, authorization keys, or other information required to install",
"and execute modified versions of a covered work in that User Product from",
"a modified version of its Corresponding Source. The information must",
"suffice to ensure that the continued functioning of the modified object",
"code is in no case prevented or interfered with solely because",
"modification has been made.",
"",
" If you convey an object code work under this section in, or with, or",
"specifically for use in, a User Product, and the conveying occurs as",
"part of a transaction in which the right of possession and use of the",
"User Product is transferred to the recipient in perpetuity or for a",
"fixed term (regardless of how the transaction is characterized), the",
"Corresponding Source conveyed under this section must be accompanied",
"by the Installation Information. But this requirement does not apply",
"if neither you nor any third party retains the ability to install",
"modified object code on the User Product (for example, the work has",
"been installed in ROM).",
"",
" The requirement to provide Installation Information does not include a",
"requirement to continue to provide support service, warranty, or updates",
"for a work that has been modified or installed by the recipient, or for",
"the User Product in which it has been modified or installed. Access to a",
"network may be denied when the modification itself materially and",
"adversely affects the operation of the network or violates the rules and",
"protocols for communication across the network.",
"",
" Corresponding Source conveyed, and Installation Information provided,",
"in accord with this section must be in a format that is publicly",
"documented (and with an implementation available to the public in",
"source code form), and must require no special password or key for",
"unpacking, reading or copying.",
"",
" 7. Additional Terms.",
"",
" \"Additional permissions\" are terms that supplement the terms of this",
"License by making exceptions from one or more of its conditions.",
"Additional permissions that are applicable to the entire Program shall",
"be treated as though they were included in this License, to the extent",
"that they are valid under applicable law. If additional permissions",
"apply only to part of the Program, that part may be used separately",
"under those permissions, but the entire Program remains governed by",
"this License without regard to the additional permissions.",
"",
" When you convey a copy of a covered work, you may at your option",
"remove any additional permissions from that copy, or from any part of",
"it. (Additional permissions may be written to require their own",
"removal in certain cases when you modify the work.) You may place",
"additional permissions on material, added by you to a covered work,",
"for which you have or can give appropriate copyright permission.",
"",
" Notwithstanding any other provision of this License, for material you",
"add to a covered work, you may (if authorized by the copyright holders of",
"that material) supplement the terms of this License with terms:",
"",
" a) Disclaiming warranty or limiting liability differently from the",
" terms of sections 15 and 16 of this License; or",
"",
" b) Requiring preservation of specified reasonable legal notices or",
" author attributions in that material or in the Appropriate Legal",
" Notices displayed by works containing it; or",
"",
" c) Prohibiting misrepresentation of the origin of that material, or",
" requiring that modified versions of such material be marked in",
" reasonable ways as different from the original version; or",
"",
" d) Limiting the use for publicity purposes of names of licensors or",
" authors of the material; or",
"",
" e) Declining to grant rights under trademark law for use of some",
" trade names, trademarks, or service marks; or",
"",
" f) Requiring indemnification of licensors and authors of that",
" material by anyone who conveys the material (or modified versions of",
" it) with contractual assumptions of liability to the recipient, for",
" any liability that these contractual assumptions directly impose on",
" those licensors and authors.",
"",
" All other non-permissive additional terms are considered \"further",
"restrictions\" within the meaning of section 10. If the Program as you",
"received it, or any part of it, contains a notice stating that it is",
"governed by this License along with a term that is a further",
"restriction, you may remove that term. If a license document contains",
"a further restriction but permits relicensing or conveying under this",
"License, you may add to a covered work material governed by the terms",
"of that license document, provided that the further restriction does",
"not survive such relicensing or conveying.",
"",
" If you add terms to a covered work in accord with this section, you",
"must place, in the relevant source files, a statement of the",
"additional terms that apply to those files, or a notice indicating",
"where to find the applicable terms.",
"",
" Additional terms, permissive or non-permissive, may be stated in the",
"form of a separately written license, or stated as exceptions;",
"the above requirements apply either way.",
"",
" 8. Termination.",
"",
" You may not propagate or modify a covered work except as expressly",
"provided under this License. Any attempt otherwise to propagate or",
"modify it is void, and will automatically terminate your rights under",
"this License (including any patent licenses granted under the third",
"paragraph of section 11).",
"",
" However, if you cease all violation of this License, then your",
"license from a particular copyright holder is reinstated (a)",
"provisionally, unless and until the copyright holder explicitly and",
"finally terminates your license, and (b) permanently, if the copyright",
"holder fails to notify you of the violation by some reasonable means",
"prior to 60 days after the cessation.",
"",
" Moreover, your license from a particular copyright holder is",
"reinstated permanently if the copyright holder notifies you of the",
"violation by some reasonable means, this is the first time you have",
"received notice of violation of this License (for any work) from that",
"copyright holder, and you cure the violation prior to 30 days after",
"your receipt of the notice.",
"",
" Termination of your rights under this section does not terminate the",
"licenses of parties who have received copies or rights from you under",
"this License. If your rights have been terminated and not permanently",
"reinstated, you do not qualify to receive new licenses for the same",
"material under section 10.",
"",
" 9. Acceptance Not Required for Having Copies.",
"",
" You are not required to accept this License in order to receive or",
"run a copy of the Program. Ancillary propagation of a covered work",
"occurring solely as a consequence of using peer-to-peer transmission",
"to receive a copy likewise does not require acceptance. However,",
"nothing other than this License grants you permission to propagate or",
"modify any covered work. These actions infringe copyright if you do",
"not accept this License. Therefore, by modifying or propagating a",
"covered work, you indicate your acceptance of this License to do so.",
"",
" 10. Automatic Licensing of Downstream Recipients.",
"",
" Each time you convey a covered work, the recipient automatically",
"receives a license from the original licensors, to run, modify and",
"propagate that work, subject to this License. You are not responsible",
"for enforcing compliance by third parties with this License.",
"",
" An \"entity transaction\" is a transaction transferring control of an",
"organization, or substantially all assets of one, or subdividing an",
"organization, or merging organizations. If propagation of a covered",
"work results from an entity transaction, each party to that",
"transaction who receives a copy of the work also receives whatever",
"licenses to the work the party's predecessor in interest had or could",
"give under the previous paragraph, plus a right to possession of the",
"Corresponding Source of the work from the predecessor in interest, if",
"the predecessor has it or can get it with reasonable efforts.",
"",
" You may not impose any further restrictions on the exercise of the",
"rights granted or affirmed under this License. For example, you may",
"not impose a license fee, royalty, or other charge for exercise of",
"rights granted under this License, and you may not initiate litigation",
"(including a cross-claim or counterclaim in a lawsuit) alleging that",
"any patent claim is infringed by making, using, selling, offering for",
"sale, or importing the Program or any portion of it.",
"",
" 11. Patents.",
"",
" A \"contributor\" is a copyright holder who authorizes use under this",
"License of the Program or a work on which the Program is based. The",
"work thus licensed is called the contributor's \"contributor version\".",
"",
" A contributor's \"essential patent claims\" are all patent claims",
"owned or controlled by the contributor, whether already acquired or",
"hereafter acquired, that would be infringed by some manner, permitted",
"by this License, of making, using, or selling its contributor version,",
"but do not include claims that would be infringed only as a",
"consequence of further modification of the contributor version. For",
"purposes of this definition, \"control\" includes the right to grant",
"patent sublicenses in a manner consistent with the requirements of",
"this License.",
"",
" Each contributor grants you a non-exclusive, worldwide, royalty-free",
"patent license under the contributor's essential patent claims, to",
"make, use, sell, offer for sale, import and otherwise run, modify and",
"propagate the contents of its contributor version.",
"",
" In the following three paragraphs, a \"patent license\" is any express",
"agreement or commitment, however denominated, not to enforce a patent",
"(such as an express permission to practice a patent or covenant not to",
"sue for patent infringement). To \"grant\" such a patent license to a",
"party means to make such an agreement or commitment not to enforce a",
"patent against the party.",
"",
" If you convey a covered work, knowingly relying on a patent license,",
"and the Corresponding Source of the work is not available for anyone",
"to copy, free of charge and under the terms of this License, through a",
"publicly available network server or other readily accessible means,",
"then you must either (1) cause the Corresponding Source to be so",
"available, or (2) arrange to deprive yourself of the benefit of the",
"patent license for this particular work, or (3) arrange, in a manner",
"consistent with the requirements of this License, to extend the patent",
"license to downstream recipients. \"Knowingly relying\" means you have",
"actual knowledge that, but for the patent license, your conveying the",
"covered work in a country, or your recipient's use of the covered work",
"in a country, would infringe one or more identifiable patents in that",
"country that you have reason to believe are valid.",
"",
" If, pursuant to or in connection with a single transaction or",
"arrangement, you convey, or propagate by procuring conveyance of, a",
"covered work, and grant a patent license to some of the parties",
"receiving the covered work authorizing them to use, propagate, modify",
"or convey a specific copy of the covered work, then the patent license",
"you grant is automatically extended to all recipients of the covered",
"work and works based on it.",
"",
" A patent license is \"discriminatory\" if it does not include within",
"the scope of its coverage, prohibits the exercise of, or is",
"conditioned on the non-exercise of one or more of the rights that are",
"specifically granted under this License. You may not convey a covered",
"work if you are a party to an arrangement with a third party that is",
"in the business of distributing software, under which you make payment",
"to the third party based on the extent of your activity of conveying",
"the work, and under which the third party grants, to any of the",
"parties who would receive the covered work from you, a discriminatory",
"patent license (a) in connection with copies of the covered work",
"conveyed by you (or copies made from those copies), or (b) primarily",
"for and in connection with specific products or compilations that",
"contain the covered work, unless you entered into that arrangement,",
"or that patent license was granted, prior to 28 March 2007.",
"",
" Nothing in this License shall be construed as excluding or limiting",
"any implied license or other defenses to infringement that may",
"otherwise be available to you under applicable patent law.",
"",
" 12. No Surrender of Others' Freedom.",
"",
" If conditions are imposed on you (whether by court order, agreement or",
"otherwise) that contradict the conditions of this License, they do not",
"excuse you from the conditions of this License. If you cannot convey a",
"covered work so as to satisfy simultaneously your obligations under this",
"License and any other pertinent obligations, then as a consequence you may",
"not convey it at all. For example, if you agree to terms that obligate you",
"to collect a royalty for further conveying from those to whom you convey",
"the Program, the only way you could satisfy both those terms and this",
"License would be to refrain entirely from conveying the Program.",
"",
" 13. Use with the GNU Affero General Public License.",
"",
" Notwithstanding any other provision of this License, you have",
"permission to link or combine any covered work with a work licensed",
"under version 3 of the GNU Affero General Public License into a single",
"combined work, and to convey the resulting work. The terms of this",
"License will continue to apply to the part which is the covered work,",
"but the special requirements of the GNU Affero General Public License,",
"section 13, concerning interaction through a network will apply to the",
"combination as such.",
"",
" 14. Revised Versions of this License.",
"",
" The Free Software Foundation may publish revised and/or new versions of",
"the GNU General Public License from time to time. Such new versions will",
"be similar in spirit to the present version, but may differ in detail to",
"address new problems or concerns.",
"",
" Each version is given a distinguishing version number. If the",
"Program specifies that a certain numbered version of the GNU General",
"Public License \"or any later version\" applies to it, you have the",
"option of following the terms and conditions either of that numbered",
"version or of any later version published by the Free Software",
"Foundation. If the Program does not specify a version number of the",
"GNU General Public License, you may choose any version ever published",
"by the Free Software Foundation.",
"",
" If the Program specifies that a proxy can decide which future",
"versions of the GNU General Public License can be used, that proxy's",
"public statement of acceptance of a version permanently authorizes you",
"to choose that version for the Program.",
"",
" Later license versions may give you additional or different",
"permissions. However, no additional obligations are imposed on any",
"author or copyright holder as a result of your choosing to follow a",
"later version.",
"",
" 15. Disclaimer of Warranty.",
"",
" THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY",
"APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT",
"HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM \"AS IS\" WITHOUT WARRANTY",
"OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,",
"THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR",
"PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM",
"IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF",
"ALL NECESSARY SERVICING, REPAIR OR CORRECTION.",
"",
" 16. Limitation of Liability.",
"",
" IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING",
"WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS",
"THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY",
"GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE",
"USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF",
"DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD",
"PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),",
"EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF",
"SUCH DAMAGES.",
"",
" 17. Interpretation of Sections 15 and 16.",
"",
" If the disclaimer of warranty and limitation of liability provided",
"above cannot be given local legal effect according to their terms,",
"reviewing courts shall apply local law that most closely approximates",
"an absolute waiver of all civil liability in connection with the",
"Program, unless a warranty or assumption of liability accompanies a",
"copy of the Program in return for a fee.",
"",
" END OF TERMS AND CONDITIONS",
};
#define README_CRASH_VERSION "README_CRASH_VERSION"
#define README_GNU_GDB_VERSION "README_GNU_GDB_VERSION"
#define README_DATE "README_DATE"
#define README_GPL_INFO "README_GPL_INFO"
#define README_HELP_MENU "README_HELP_MENU"
#define README_ENTER_DIRECTORY "README_ENTER_DIRECTORY"
#define README_MEMORY_DRIVER "README_MEMORY_DRIVER"
static void
display_README(void)
{
int i, j;
time_t time_now;
for (i = 0; README[i]; i++) {
if (STREQ(README[i], README_CRASH_VERSION)) {
fprintf(fp, " crash %s\n", pc->program_version);
} else if (STREQ(README[i], README_GNU_GDB_VERSION)) {
fprintf(fp, " GNU gdb %s\n", pc->gdb_version);
} else if (STREQ(README[i], README_DATE)) {
time(&time_now);
fprintf(fp, " DATE: %s\n",
strip_linefeeds(ctime(&time_now)));
} else if (STREQ(README[i], README_HELP_MENU)) {
display_help_screen(" ");
} else if (STREQ(README[i], README_GPL_INFO)) {
for (j = 0; version_info[j]; j++)
fprintf(fp, " %s\n", version_info[j]);
} else if (STREQ(README[i], README_ENTER_DIRECTORY)) {
fprintf(fp,
" $ tar -xf crash-%s.tar.gz\n",
pc->program_version);
fprintf(fp,
" $ cd crash-%s\n", pc->program_version);
} else if (STREQ(README[i], README_MEMORY_DRIVER)) {
fprintf(fp,
" is included in the crash-%s/memory_driver subdirectory.\n",
pc->program_version);
} else
fprintf(fp, "%s\n", README[i]);
}
}
static
char *README[] = {
"",
"",
" CORE ANALYSIS SUITE",
"",
" The core analysis suite is a self-contained tool that can be used to",
" investigate either live systems, kernel core dumps created from dump",
" creation facilities such as kdump, kvmdump, xendump, the netdump and",
" diskdump packages offered by Red Hat, the LKCD kernel patch, the mcore",
" kernel patch created by Mission Critical Linux, as well as other formats",
" created by manufacturer-specific firmware.",
"",
" o The tool is loosely based on the SVR4 crash command, but has been",
" completely integrated with gdb in order to be able to display ",
" formatted kernel data structures, disassemble source code, etc.",
" ",
" o The current set of available commands consist of common kernel core",
" analysis tools such as a context-specific stack traces, source code",
" disassembly, kernel variable displays, memory display, dumps of ",
" linked-lists, etc. In addition, any gdb command may be entered,",
" which in turn will be passed onto the gdb module for execution. ",
"",
" o There are several commands that delve deeper into specific kernel",
" subsystems, which also serve as templates for kernel developers",
" to create new commands for analysis of a specific area of interest.",
" Adding a new command is a simple affair, and a quick recompile",
" adds it to the command menu.",
"",
" o The intent is to make the tool independent of Linux version dependencies,",
" building in recognition of major kernel code changes so as to adapt to ",
" new kernel versions, while maintaining backwards compatibility.",
"",
" A whitepaper with complete documentation concerning the use of this utility",
" can be found here:",
" ",
" http://people.redhat.com/anderson/crash_whitepaper",
" ",
" These are the current prerequisites: ",
"",
" o At this point, x86, ia64, x86_64, ppc64, ppc, arm, arm64, alpha, s390",
" and s390x-based kernels are supported. Other architectures may be",
" addressed in the future.",
"",
" o One size fits all -- the utility can be run on any Linux kernel version",
" version dating back to 2.2.5-15. A primary design goal is to always",
" maintain backwards-compatibility.",
"",
" o In order to contain debugging data, the top-level kernel Makefile's CFLAGS",
" definition must contain the -g flag. Typically distributions will contain",
" a package containing a vmlinux file with full debuginfo data. If not, the",
" kernel must be rebuilt:",
"",
" For 2.2 kernels that are not built with -g, change the following line:",
"",
" CFLAGS = -Wall -Wstrict-prototypes -O2 -fomit-frame-pointer",
"",
" to:",
"",
" CFLAGS = -g -Wall -Wstrict-prototypes -O2 -fomit-frame-pointer",
"",
" For 2.4 kernels that are not built with -g, change the following line:",
"",
" CFLAGS := $(CPPFLAGS) -Wall -Wstrict-prototypes -O2 -fomit-frame-pointer -fno-strict-aliasing",
"",
" to:",
"",
" CFLAGS := -g $(CPPFLAGS) -Wall -Wstrict-prototypes -O2 -fomit-frame-pointer -fno-strict-aliasing",
"",
" For 2.6 and later kernels that are not built with -g, the kernel should",
" be configured with CONFIG_DEBUG_INFO enabled, which in turn will add",
" the -g flag to the CFLAGS setting in the kernel Makefile.",
" ",
" After the kernel is re-compiled, the uncompressed \"vmlinux\" kernel",
" that is created in the top-level kernel build directory must be saved.",
"",
" To build the crash utility: ",
"",
README_ENTER_DIRECTORY,
" $ make",
"",
" The initial build will take several minutes because the embedded gdb module",
" must be configured and and built. Alternatively, the crash source RPM file",
" may be installed and built, and the resultant crash binary RPM file installed.",
"",
" The crash binary can only be used on systems of the same architecture as",
" the host build system. There are a few optional manners of building the",
" crash binary:",
"",
" o On an x86_64 host, a 32-bit x86 binary that can be used to analyze",
" 32-bit x86 dumpfiles may be built by typing \"make target=X86\".",
" o On an x86 or x86_64 host, a 32-bit x86 binary that can be used to analyze",
" 32-bit arm dumpfiles may be built by typing \"make target=ARM\".",
" o On an ppc64 host, a 32-bit ppc binary that can be used to analyze",
" 32-bit ppc dumpfiles may be built by typing \"make target=PPC\".",
" o On an x86_64 host, an x86_64 binary that can be used to analyze",
" arm64 dumpfiles may be built by typing \"make target=ARM64\".",
"",
" Traditionally when vmcores are compressed via the makedumpfile(8) facility",
" the libz compression library is used, and by default the crash utility",
" only supports libz. Recently makedumpfile has been enhanced to optionally",
" use either the LZO or snappy compression libraries. To build crash with",
" either or both of those libraries, type \"make lzo\" or \"make snappy\".",
"",
" All of the alternate build commands above are \"sticky\" in that the",
" special \"make\" targets only have to be entered one time; all subsequent",
" builds will follow suit.",
"",
" If the tool is run against a kernel dumpfile, two arguments are required, the",
" uncompressed kernel name and the kernel dumpfile name. ",
"",
" If run on a live system, only the kernel name is required, because /dev/mem ",
" will be used as the \"dumpfile\". On Red Hat or Fedora kernels where the",
" /dev/mem device is restricted, the /dev/crash memory driver will be used.",
" If neither /dev/mem or /dev/crash are available, then /proc/kcore will be",
" be used as the live memory source. If /proc/kcore is also restricted, then",
" the Red Hat /dev/crash driver may be compiled and installed; its source",
README_MEMORY_DRIVER,
"",
" If the kernel file is stored in /boot, /, /boot/efi, or in any /usr/src",
" or /usr/lib/debug/lib/modules subdirectory, then no command line arguments",
" are required -- the first kernel found that matches /proc/version will be",
" used as the namelist.",
" ",
" For example, invoking crash on a live system would look like this:",
"",
" $ crash",
" ",
README_CRASH_VERSION,
README_GPL_INFO,
README_GNU_GDB_VERSION,
" Copyright 2013 Free Software Foundation, Inc.",
" License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>",
" This is free software: you are free to change and redistribute it.",
" There is NO WARRANTY, to the extent permitted by law. Type \"show copying\"",
" and \"show warranty\" for details.",
" This GDB was configured as \"i686-pc-linux-gnu\"...",
" ",
" KERNEL: /boot/vmlinux",
" DUMPFILE: /dev/mem",
" CPUS: 1",
README_DATE,
" UPTIME: 10 days, 22:55:18",
" LOAD AVERAGE: 0.08, 0.03, 0.01",
" TASKS: 42",
" NODENAME: ha2.mclinux.com",
" RELEASE: 2.4.0-test10",
" VERSION: #11 SMP Thu Nov 4 15:09:25 EST 2000",
" MACHINE: i686 (447 MHz)",
" MEMORY: 128 MB",
" PID: 3621 ",
" COMMAND: \"crash\"",
" TASK: c463c000 ",
" CPU: 0",
" STATE: TASK_RUNNING (ACTIVE)",
"",
" crash> help",
README_HELP_MENU,
" crash> ",
" ",
" When run on a dumpfile, both the kernel namelist and dumpfile must be ",
" entered on the command line. For example, when run on a core dump created",
" by the Red Hat netdump or diskdump facilities:",
"",
" $ crash vmlinux vmcore",
" ",
README_CRASH_VERSION,
README_GPL_INFO,
README_GNU_GDB_VERSION,
" Copyright 2013 Free Software Foundation, Inc.",
" License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>",
" This is free software: you are free to change and redistribute it.",
" There is NO WARRANTY, to the extent permitted by law. Type \"show copying\"",
" and \"show warranty\" for details.",
" This GDB was configured as \"i686-pc-linux-gnu\"...",
" ",
" KERNEL: vmlinux",
" DUMPFILE: vmcore",
" CPUS: 4",
" DATE: Tue Mar 2 13:57:09 2004",
" UPTIME: 00:02:40",
" LOAD AVERAGE: 2.24, 0.96, 0.37",
" TASKS: 70",
" NODENAME: pro1.lab.boston.redhat.com",
" RELEASE: 2.6.3-2.1.214.11smp",
" VERSION: #1 SMP Tue Mar 2 10:58:27 EST 2004",
" MACHINE: i686 (2785 Mhz)",
" MEMORY: 512 MB",
" PANIC: \"Oops: 0002 [#1]\" (check log for details)",
" PID: 0",
" COMMAND: \"swapper\"",
" TASK: 22fa200 (1 of 4) [THREAD_INFO: 2356000]",
" CPU: 0",
" STATE: TASK_RUNNING (PANIC)",
" ",
" crash> ",
"",
" The tool's environment is context-specific. On a live system, the default",
" context is the command itself; on a dump the default context will be the",
" task that panicked. The most commonly-used commands are:",
"",
" set - set a new task context by pid, task address, or cpu.",
" bt - backtrace of the current context, or as specified with arguments.",
" p - print the contents of a kernel variable.",
" rd - read memory, which may be either kernel virtual, user virtual, or",
" physical.",
" ps - simple process listing.",
" log - dump the kernel log_buf.",
" struct - print the contents of a structure at a specified address.",
" foreach - execute a command on all tasks, or those specified, in the system.",
" ",
" Detailed help concerning the use of each of the commands in the menu above ",
" may be displayed by entering \"help command\", where \"command\" is one of those ",
" listed above. Rather than getting bogged down in details here, simply",
" run the help command on each of the commands above. Note that many commands",
" have multiple options so as to avoid the proliferation of command names.",
"",
" Command output may be piped to external commands or redirected to files.",
" Enter \"help output\" for details.",
"",
" The command line history mechanism allows for command-line recall and ",
" command-line editing. Input files containing a set of crash commands may ",
" be substituted for command-line input. Enter \"help input\" for details.",
"",
" Note that a .crashrc file (or .<your-command-name>rc if the name has been ",
" changed), may contain any number of \"set\" or \"alias\" commands -- see the",
" help pages on those two commands for details.",
" ",
" Lastly, if a command is entered that is not recognized, it is checked",
" against the kernel's list of variables, structure, union or typedef names, ",
" and if found, the command is passed to \"p\", \"struct\", \"union\" or \"whatis\".",
" That being the case, as long as a kernel variable/structure/union name is ",
" different than any of the current commands.",
"",
" (1) A kernel variable can be dumped by simply entering its name:",
" ",
" crash> init_mm",
" init_mm = $2 = {",
" mmap = 0xc022d540, ",
" mmap_avl = 0x0, ",
" mmap_cache = 0x0, ",
" pgd = 0xc0101000, ",
" count = {",
" counter = 0x6",
" }, ",
" map_count = 0x1, ",
" mmap_sem = {",
" count = {",
" counter = 0x1",
" }, ",
" waking = 0x0, ",
" wait = 0x0",
" }, ",
" context = 0x0, ",
" start_code = 0xc0000000, ",
" end_code = 0xc022b4c8,",
" end_data = c0250388,",
" ...",
" ",
" (2) A structure or can be dumped simply by entering its name and address: ",
"",
" crash> vm_area_struct c5ba3910",
" struct vm_area_struct {",
" vm_mm = 0xc3ae3210, ",
" vm_start = 0x821b000, ",
" vm_end = 0x8692000, ",
" vm_next = 0xc5ba3890, ",
" vm_page_prot = {",
" pgprot = 0x25",
" }, ",
" vm_flags = 0x77, ",
" vm_avl_height = 0x4, ",
" vm_avl_left = 0xc0499540, ",
" vm_avl_right = 0xc0499f40, ",
" vm_next_share = 0xc04993c0, ",
" vm_pprev_share = 0xc0499060, ",
" vm_ops = 0x0, ",
" vm_offset = 0x0, ",
" vm_file = 0x0, ",
" vm_pte = 0x0",
" }",
"",
"",
" The crash utility has been designed to facilitate the task of adding new ",
" commands. New commands may be permanently compiled into the crash executable,",
" or dynamically added during runtime using shared object files.",
" ",
" To permanently add a new command to the crash executable's menu:",
"",
" 1. For a command named \"xxx\", put a reference to cmd_xxx() in defs.h.",
" ",
" 2. Add cmd_xxx into the base_command_table[] array in global_data.c. ",
"",
" 3. Write cmd_xxx(), putting it in one of the appropriate files. Look at ",
" the other commands for guidance on getting symbolic data, reading",
" memory, displaying data, etc...",
"",
" 4. Recompile and run.",
"",
" Note that while the initial compile of crash, which configures and compiles",
" the gdb module, takes several minutes, subsequent re-compiles to do such",
" things as add new commands or fix bugs just takes a few seconds.",
"",
" Alternatively, you can create shared object library files consisting of",
" crash command extensions, that can be dynamically linked into the crash",
" executable during runtime or during initialization. This will allow the",
" the same shared object to be used with subsequent crash releases without",
" having to re-merge the command's code into each new set of crash sources.",
" The dynamically linked-in commands will automatically show up in the crash",
" help menu. For details, enter \"help extend\" during runtime, or enter",
" \"crash -h extend\" from the shell command line.",
" ",
"",
"",
"",
"",
0
};
Reference in New Issue View Git Blame Copy Permalink