1 .\" Copyright (c) 2003 Greg Lehey. All rights reserved.
3 .\" Redistribution and use in source and binary forms, with or without
4 .\" modification, are permitted provided that the following conditions
6 .\" 1. Redistributions of source code must retain the above copyright
7 .\" notice, this list of conditions and the following disclaimer.
8 .\" 2. Redistributions in binary form must reproduce the above copyright
9 .\" notice, this list of conditions and the following disclaimer in the
10 .\" documentation and/or other materials provided with the distribution.
12 .\" This software is provided by Greg Lehey ``as is'' and
13 .\" any express or implied warranties, including, but not limited to, the
14 .\" implied warranties of merchantability and fitness for a particular purpose
15 .\" are disclaimed. in no event shall Greg Lehey be liable
16 .\" for any direct, indirect, incidental, special, exemplary, or consequential
17 .\" damages (including, but not limited to, procurement of substitute goods
18 .\" or services; loss of use, data, or profits; or business interruption)
19 .\" however caused and on any theory of liability, whether in contract, strict
20 .\" liability, or tort (including negligence or otherwise) arising in any way
21 .\" out of the use of this software, even if advised of the possibility of
39 .Op Ar modules-path Op Ar outfile
45 output from standard input and writes to the
49 commands to add symbol files from KLDs in subdirectories of the subdirectory
51 of the current directory, which is intended to be a kernel build directory.
54 to load the symbols into the debugging environment.
60 uses it for the modules directory instead of the default
62 This is useful when building in a non-standard location (i.e., not
71 writes to it instead of
77 the standard output is used.
79 The following options modify the function of
81 .Bl -tag -width indent
83 When writing to an explicit
85 append to the file rather than overwriting it.
87 Instead of trying to simplistically guess the path for each module, perform
88 a traversal in the same way that
90 does to locate an exact path for each module, no matter where in
94 Instead of reading from standard input, use the conventional
95 system interface to get the list of modules currently loaded.
97 Instead of reading from standard input, start a
99 and read the information from it.
101 Specify the core file for
106 Specify the system file for
113 to write or append its output to.
118 the standard output is used.
120 Do not prepend a (guessed) subdirectory of the module path.
122 Instead of reading from standard input, use the
124 interface to get the list of modules.
125 This interface allows for inspecting system crash dumps,
126 as well as the live system.
131 options will be of use if inspecting a crash dump.
132 Elevated privileges, e.g., those of a superuser,
133 may be needed to use this option.
137 to the list of suffixes
139 tries to append to KLD file names.
140 The default list consists of
144 The null suffix always stays at the list tail, after the suffix added.
145 Should it be needed in the middle of the list,
146 a blank suffix can be specified to
150 Clear the list of suffixes
152 tries to append to KLD file names.
153 Only the null suffix is left in the list.
163 utility first appeared in
166 .An Greg Lehey Aq grog@FreeBSD.org
168 Module paths are guessed in a rather naive way by default.
169 It is likely to lag behind the changes to the build tree layout.