create_moduleのヘルプ・マニュアル
日本語 英語
create_module --help
man create_module
CREATE_MODULE(2) Linux Programmer’s Manual CREATE_MODULE(2)
名前
create_module - ローダブルモジュールのエントリを作成する
書式
#include
caddr_t create_module(const char *name, size_t size);
説明
create_module() は、ローダブルモジュールのエントリを作成し、そのモジュ
ールの保持に必要なカーネルメモリを予約しようとする。このシステムコー ル
を使うには特権が必要である。
返り値
成 功すると、モジュールが配置されるカーネル空間のアドレスを返す。エラー
の場合 -1 を返し、 errno を適切に設定する。
エラー
EEXIST その名前のモジュールがすでに存在する。
EFAULT name がプログラムがアクセスできるアドレス空間の外部にある。
EINVAL 要求したサイズが小さすぎて、モジュールのヘッダ情報すら格納できな
い。
ENOMEM モジュールを格納するのに必要な大きさの連続したメモリブロックをカ
ーネルが確保できなかった。
ENOSYS create_module() がこのバージョンのカーネルではサポートされていな
い。
EPERM 呼び出し元が特権 (CAP_SYS_MODULE ケーパビリティ) を持っていなか
った。
バージョン
このシステムコールが存在するのはカーネル 2.4 までの Linux だけである 。
Linux 2.6 では削除された。
準拠
create_module() は Linux 固有である。
関連項目
delete_module(2), init_module(2), query_module(2)
Linux 2007-06-03 CREATE_MODULE(2)
CREATE_MODULE(2) Linux Programmer’s Manual CREATE_MODULE(2)
NAME
create_module - create a loadable module entry
SYNOPSIS
#include
caddr_t create_module(const char *name, size_t size);
DESCRIPTION
create_module() attempts to create a loadable module entry and reserve
the kernel memory that will be needed to hold the module. This system
call requires privilege.
RETURN VALUE
On success, returns the kernel address at which the module will reside.
On error -1 is returned and errno is set appropriately.
ERRORS
EEXIST A module by that name already exists.
EFAULT name is outside the program’s accessible address space.
EINVAL The requested size is too small even for the module header
information.
ENOMEM The kernel could not allocate a contiguous block of memory large
enough for the module.
ENOSYS create_module() is not supported in this version of the kernel.
EPERM The caller was not privileged (did not have the CAP_SYS_MODULE
capability).
VERSIONS
This system call is only present on Linux up until kernel 2.4; it was
removed in Linux 2.6.
CONFORMING TO
create_module() is Linux-specific.
SEE ALSO
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 CREATE_MODULE(2)