kldconfig(8) [freebsd man page]

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

NAME

     kldconfig -- display or modify the kernel module search path

SYNOPSIS

     kldconfig [-dfimnUv] [-S sysctlname] [path ...]
     kldconfig -r

DESCRIPTION

     The kldconfig utility displays or modifies the search path used by the kernel when loading modules using the kldload(8) utility or the
     kldload(2) syscall.

     The following options are available:

     -d      Remove the specified paths from the module search path.

     -f      Do not display a diagnostic message if a path specified for adding is already present in the search path, or if a path specified for
	     removing is not present in the search path.  This may be useful in startup/shutdown scripts for adding a path to a file system which
	     is still not mounted, or in shutdown scripts for unconditionally removing a path that may have been added during startup.

     -i      Add the specified paths to the beginning of the search path, not to the end.  This option can only be used when adding paths.

     -m      Instead of replacing the module search path with the set of paths specified, ``merge'' in the new entries.

     -n      Do not actually change the module search path.

     -r      Display the current search path.  This option cannot be used if any paths are also specified.

     -S sysctlname
	     Specify the sysctl name to use instead of the default kern.module_path.

     -U      ``Unique-ify'' the current search path - if any of the directories is repeated one or more times, only the first occurrence remains.
	     This option implies -m.

     -v      Verbose output: display the new module search path.  If the path has been changed, and the -v flag is specified more than once, the
	     old path is displayed as well.

FILES

     /boot/kernel, /boot/modules, /modules
	     The default module search path used by the kernel.

EXIT STATUS

     The kldconfig utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

     kldload(2), kldload(8), sysctl(8)

HISTORY

     The kldconfig utility first appeared in FreeBSD 4.4.

AUTHORS

     Peter Pentchev <roam@FreeBSD.org>

BSD
								   June 15, 2001							       BSD

ASF(8)							    BSD 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.

     An optional modules-path argument can specify a semicolon-separated list of directory pathnames similar to the kern.module_path sysctl.  Each
     directory in the list will be searched in turn for modules.  The default list consists of just one element, modules, which is suitable if the
     current directory is a kernel build directory.

     If outfile is specified, asf writes to it instead of .asf.  If outfile is a single dash ('-'), 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 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, use the conventional system 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).	Implies -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 ('-'), 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 privi-
	     leges, 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.

EXAMPLES

     To add symbol files from the system search path specified by the kern.module_path sysctl, the following command can be used:

	   asf -s `sysctl -n kern.module_path`

SEE ALSO

     gdb(1), kvm(3), kld(4), kldstat(8), sysctl(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
     recommended.

BSD
								 December 20, 2006							       BSD