get_kernel_symsのヘルプ・マニュアル
日本語 英語
get_kernel_syms --help
man get_kernel_syms
GET_KERNEL_SYMS(2) Linux Programmer’s Manual GET_KERNEL_SYMS(2)
名前
get_kernel_syms - 公開されているカーネルやモジュールのシンボルの取得
書式
#include
int get_kernel_syms(struct kernel_sym *table);
説明
get_kernel_syms() は、 table が NULL の場合、問い合わせできるシンボルの
数を返す。 NULL 以外の場合、以下の構造体の列 (table) に値を入れて返す。
struct kernel_sym {
unsigned long value;
char name[60];
};
シ ンボルの中には、 #module-name という形式の、カーネルが空の名前を持っ
ているマジックシンボル (magic symbol) が散在している。この形式のシン ボ
ルに対応する値はモジュールがロードされたアドレスとなる。
個 々のモジュールから公開 (export) されたシンボルは、マジックモジュール
タグの後ろに置かれる。また、モジュールはロードされた順番とは逆順で返 さ
れる。
返り値
成 功すると、 table にコピーされたシンボル数を返す。エラーの場合、-1 を
返し、 errno を適切に設定する。
エラー
返る可能性があるエラーは一つだけである。
ENOSYS get_kernel_syms() がこのバージョンのカーネルではサポートされてい
ない。
バージョン
こ のシステムコールが存在するのはカーネル 2.4 までの Linux だけである。
Linux 2.6 では削除された。
準拠
get_kernel_syms() は Linux 固有である。
バグ
table 用に確保したバッファの大きさを伝える方法がない。プログラムがシ ン
ボ ルテーブルの大きさを問い合わせた後に、カーネルにシンボルが追加される
と、メモリの内容が破壊されることになる。
公開されるシンボル名の長さが 59 文字に制限されている。
これらの制限があるので、このシステムコールを使うよりは query_module(2)
を使うのが望ましい (現在では query_module(2) 自身もそのマニュアルページ
に書かれているように他のインタフェースを使うのが望ましいとされている)。
関連項目
create_module(2), delete_module(2), init_module(2), query_module(2)
Linux 2007-06-03 GET_KERNEL_SYMS(2)
GET_KERNEL_SYMS(2) Linux Programmer’s Manual GET_KERNEL_SYMS(2)
NAME
get_kernel_syms - retrieve exported kernel and module symbols
SYNOPSIS
#include
int get_kernel_syms(struct kernel_sym *table);
DESCRIPTION
If table is NULL, get_kernel_syms() returns the number of symbols
available for query. Otherwise it fills in a table of structures:
struct kernel_sym {
unsigned long value;
char name[60];
};
The symbols are interspersed with magic symbols of the form #module-
name with the kernel having an empty name. The value associated with a
symbol of this form is the address at which the module is loaded.
The symbols exported from each module follow their magic module tag and
the modules are returned in the reverse of the order in which they were
loaded.
RETURN VALUE
On success, returns the number of symbols copied to table. On error,
-1 is returned and errno is set appropriately.
ERRORS
There is only one possible error return:
ENOSYS get_kernel_syms() is not supported in this version of the ker-
nel.
VERSIONS
This system call is only present on Linux up until kernel 2.4; it was
removed in Linux 2.6.
CONFORMING TO
get_kernel_syms() is Linux-specific.
BUGS
There is no way to indicate the size of the buffer allocated for table.
If symbols have been added to the kernel since the program queried for
the symbol table size, memory will be corrupted.
The length of exported symbol names is limited to 59 characters.
Because of these limitations, this system call is deprecated in favor
of query_module(2) (which is itself nowadays deprecated in favor of
other interfaces described on its manual page).
SEE ALSO
create_module(2), delete_module(2), init_module(2), query_module(2)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
Linux 2007-06-03 GET_KERNEL_SYMS(2)