ASF(8) BSD System Manager's Manual ASF(8)NAMEasf — add symbol files
SYNOPSISasf [-afk] [modules-path [outfile]]
DESCRIPTION
By default, asf reads kldstat(8) output from standard input and writes to
the .asf file a list of kgdb(1) commands to add symbol files from KLDs in
subdirectories of the subdirectory modules of the current directory,
which is intended to be a kernel build directory. This allows kgdb(1) to
load the symbols into the debugging environment.
If modules-path is specified, asf uses it for the modules directory
instead of the default /boot/modules. This is useful when building in a
non-standard location (i.e., not /usr/src and /usr/obj).
If outfile is specified, asf writes to it instead of standard output.
OPTIONS
The following options modify the function of asf:
-a When writing to an explicit outfile, append to the file rather
than overwriting it.
-f Instead of trying to simplistically guess the path for each mod‐
ule, perform a traversal in the same way that find(1) does to
locate an exact path for each module, no matter where in
modules-path it is located.
-k Instead of reading from standard input, start a kldstat(8) and
read the information from it.
EXAMPLES
The common usage on a DragonFly system is sourcing the output of asf-k
into kgdb(1):
# asf-k
# [start kgdb...]
(kgdb) source .asf
SEE ALSOkgdb(1), kldstat(8)HISTORY
The asf utility first appeared in FreeBSD 5.2.
AUTHORS
Greg Lehey ⟨grog@FreeBSD.org⟩
BUGS
It should be possible to write to an outfile without specifying a module
path.
BSD February 21, 2009 BSD
