1 .\" Copyright (C) 1996 Free Software Foundation, Inc.
2 .\" This file is distributed according to the GNU General Public License.
3 .\" See the file COPYING in the top level source directory for details.
5 .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some
6 .\" reformatting and rewordings by mtk
8 .TH GET_KERNEL_SYMS 2 2007-06-03 "Linux" "Linux Programmer's Manual"
10 get_kernel_syms \- retrieve exported kernel and module symbols
13 .B #include <linux/module.h>
15 .BI "int get_kernel_syms(struct kernel_sym *" table );
21 .BR get_kernel_syms ()
22 returns the number of symbols available for query.
23 Otherwise it fills in a table of structures:
34 The symbols are interspersed with magic symbols of the form
36 with the kernel having an empty name.
37 The value associated with a symbol of this form is the address at
38 which the module is loaded.
40 The symbols exported from each module follow their magic module tag
41 and the modules are returned in the reverse of the
42 order in which they were loaded.
44 On success, returns the number of symbols copied to
46 On error, \-1 is returned and
50 There is only one possible error return:
53 .BR get_kernel_syms ()
54 is not supported in this version of the kernel.
56 This system call is only present on Linux up until kernel 2.4;
57 it was removed in Linux 2.6.
58 .\" Removed in Linux 2.5.48
60 .BR get_kernel_syms ()
63 There is no way to indicate the size of the buffer allocated for
65 If symbols have been added to the kernel since the
66 program queried for the symbol table size, memory will be corrupted.
68 The length of exported symbol names is limited to 59 characters.
70 Because of these limitations, this system call is deprecated in
73 (which is itself nowadays deprecated
74 in favor of other interfaces described on its manual page).
76 .BR create_module (2),
77 .BR delete_module (2),