ASF(8)

NAME
asf - add symbol files

SYNOPSIS
asf [-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/kernel. 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 module, 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 ALSO
kgdb(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.