unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (FreeBSD-5.4-RELEASE)
Page:
Section:
Apropos / Subsearch:
optional field

ASF(8)                    BSD System Manager's Manual                   ASF(8)

NAME
     asf -- add symbol files

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

DESCRIPTION
     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 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 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.

     -s      Do not prepend a (guessed) subdirectory of the module 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.

HISTORY
     The asf utility first appeared in FreeBSD 5.2.

AUTHORS
     Greg Lehey <grogATFreeBSD.org>

BUGS
     It should be possible to write to an outfile without specifying a module
     path.

SEE ALSO
     gdb(1), kldstat(8)

BSD                              June 8, 2003                              BSD