asf(8)

NAME

asf - add symbol files

asf [-afksx] [modules-path [outfile]]

By default, asf reads kldstat(8) output from standard input
and writes to standard output a list of gdb(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 al
lows gdb(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 modules. This is useful when build
ing in a nonstandard location (i.e., not /usr/src and /usr/obj).
If outfile is specified, asf writes to it instead of stan
dard output.

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 kld
stat(8) and: read the information from it.
-s Do not prepend a (guessed) subdirectory of the mod
ule path.
-x Normally asf looks for KLDs with names of the form: <module>.ko.debug. The -x option tells asf to look; for KLDs with
names of the form <module>.ko.

The asf utility first appeared in FreeBSD 5.2.

Greg Lehey <grog@FreeBSD.org>