manual/modutils/release/man2/create_module.2

   1 .\" Copyright (C) 1996 Free Software Foundation, Inc.
   2 .\" This file is distributed accroding to the GNU General Public License.
   3 .\" See the file COPYING in the top level source directory for details.
   4 .\"
   5 .\" Japanese Version Copyright (c) 1997,1999 HANATAKA Shinya and FUJIWARA Teruyoshi
   6 .\"         all rights reserved.
   7 .\" Translated Sat Aug 30 13:42:42 JST 1997
   8 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
   9 .\" Merged with another translation Sun Aug 15 09:55:42 JST 1999
  10 .\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  11 .\"
  12 .\"WORD:        loadable module         ローダブル・モジュール
  13 .\"
  14 .TH CREATE_MODULE 2 "26 Dec 1996" Linux "Linux Module Support"
  15 .SH 名前
  16 create_module \- ローダブルモジュールのエントリを生成する
  17 .SH 書式
  18 .nf
  19 .B #include <linux/module.h>
  20 .sp
  21 .BI "caddr_t create_module(const char *" name ", size_t " size );
  22 .fi
  23 .SH 説明
  24 .B create_module
  25 はローダブルモジュール(loadable module)のエントリを作成し、そのモジュール
  26 の保持に必要なカーネルメモリを予約しようとする。このシステムコールを使
  27 えるのはスーパーユーザだけである。
  28 .SH 返り値
  29 成功した場合は、モジュールを常駐させるためのカーネルメモリ上のアドレス
  30 が返される。エラーの場合は \-1 が返され、\fIerrno\fP の値が適切に設定
  31 される。
  32 .SH エラー
  33 .TP
  34 .B EPERM
  35 呼び出しを行ったのがスーパーユーザでない。
  36 .TP
  37 .B EEXIST
  38 その名前のモジュールが既に存在している。
  39 .TP
  40 .B EINVAL
  41 要求したサイズが小さすぎて、モジュールのヘッダ情報すら格納できない。
  42 .TP
  43 .B ENOMEM
  44 モジュールを格納するのに必要な大きさの連続したメモリブロックをカーネル
  45 が確保できなかった。
  46 .TP
  47 .B EFAULT
  48 .I name
  49 が、プログラムがアクセスできるアドレス空間の外部にある。
  50 .SH 関連項目
  51 .BR init_module "(2), " delete_module "(2), " query_module "(2)"
  52