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 [-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	     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	9.3			 June 8, 2003			   FreeBSD 9.3

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

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

home | help