home | help
UNTITLED()			      LOCAL			      UNTITLED()

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 lo-
     cation (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.

     -s      Don't 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 <grog@FreeBSD.org>

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

SEE ALSO
     gdb(1), kldstat(8)

FreeBSD 5.2.1			  June 8, 2003				  ASF(8)

home | help