Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
ASF(8)                  FreeBSD System Manager's Manual                 ASF(8)

NAME
     asf -- add symbol files

SYNOPSIS
     asf [-afKksVx] [-M core] [-N system] [-o outfile] [-X suffix]
         [modules-path [outfile]]

DESCRIPTION
     By default, asf reads kldstat(8) output from standard input and writes to
     the .asf file 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 allows 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 building in a non-
     standard location (i.e., not /usr/src and /usr/obj).

     If outfile is specified, asf writes to it instead of .asf.  If outfile is
     a single dash (`-'), the standard output is used.

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, use the conventional sys-
             tem interface to get the list of modules currently loaded.

     -k      Instead of reading from standard input, start a kldstat(8) and
             read the information from it.

     -M      Specify the core file for kvm(3).  Impiles -V.

     -N      Specify the system file for kvm(3).  Implies -V.

     -o      Specify the file for asf to write or append its output to.  If
             outfile is a single dash (`-'), the standard output is used.

     -s      Do not prepend a (guessed) subdirectory of the module path.

     -V      Instead of reading from standard input, use the kvm(3) interface
             to get the list of modules.  This interface allows for inspecting
             system crash dumps, as well as the live system.  The -M and -N
             options will be of use if inspecting a crash dump.  Elevated
             privileges, e.g., those of a superuser, may be needed to use this
             option.

     -X      Add suffix to the list of suffixes asf tries to append to KLD
             file names.  The default list consists of .debug, .symbols, and
             the null suffix.  The null suffix always stays at the list tail,
             after the suffix added.  Should it be needed in the middle of the
             list, a blank suffix can be specified to -X instead.

     -x      Clear the list of suffixes asf tries to append to KLD file names.
             Only the null suffix is left in the list.

SEE ALSO
     gdb(1), kvm(3), kld(4), kldstat(8)

HISTORY
     The asf utility first appeared in FreeBSD 5.2.

AUTHORS
     Greg Lehey <grog@FreeBSD.org>

BUGS
     Module paths are guessed in a rather naive way by default.  It is likely
     to lag behind the changes to the build tree layout.  Using -f is recom-
     mended.

FreeBSD 6.2                      June 18, 2006                     FreeBSD 6.2

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | HISTORY | AUTHORS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=asf&sektion=8&manpath=FreeBSD+6.2-RELEASE>

home | help