KMODSYMS(8)

NAME
kmodsyms - creates a statically linked symbol file for remote debugging

SYNOPSIS
kmodsyms [-v] [-k kernelfile] [-d dependencyfile] -o symbolfile modulefile
kmodsyms [-v] -k kernelfile [-d dependencyfile@address] -o symbolfile modulefile@address

DESCRIPTION
The kmodsyms creates a statically linked symbol file for remote debugging using modulefile[@address]. If an address is specified for either the modulefile or dependacyfile they both must have the address tag. If addresses are specified it assumed that the command is being run on a different machine with a potentially different kernel, thus the kernelfile argument is also required. If addresses are not specified they taken from the currently running host machine.

The following options are available:

-v  Be more verbose.

-k kernelfile
    Use alternate file kernelfile instead of default file /mach for linking modulefile.

-d dependacyfile[@address]
    Add symbols from dependacyfile to kernel symbols prior to linking of modulefile. The file dependacyfile must already be loaded.

-o symbolfile
    Creates file named symbolfile that contains statically linked output suitable to use with gdb(1) for remote debugging.

FILES
/System/Library/Extensions
    directory containing loadable kernel modules.

DIAGNOSTICS
The kmodsyms utility exits with a status of 0 on success. A status of 1 indicates a usage error. A status of 2 indicates a indicates a permissions error. A status of 3 indicates a problem with linking the module. A status of 4 indicates a internal or system error.

SEE ALSO
kmodload(8), kmodstat(8), kmodunload(8)

HISTORY
The kmodsyms command is based on the command kldload written by Doug Rabson <dfr@FreeBSD.org>