manual/modutils/draft/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 .\"O .SH NAME
  16 .SH 名前
  17 .\"O create_module \- create a loadable module entry
  18 create_module \- ローダブルモジュールのエントリを生成する
  19 .\"O .SH SYNOPSIS
  20 .SH 書式
  21 .nf
  22 .B #include <linux/module.h>
  23 .sp
  24 .BI "caddr_t create_module(const char *" name ", size_t " size );
  25 .fi
  26 .\"O .SH DESCRIPTION
  27 .SH 説明
  28 .\"O .B create_module
  29 .\"O attempts to create a loadable module entry and reserve the kernel memory
  30 .\"O that will be needed to hold the module.  This system call is only open
  31 .\"O to the superuser.
  32 .B create_module
  33 はローダブルモジュール(loadable module)のエントリを作成し、そのモジュール
  34 の保持に必要なカーネルメモリを予約しようとする。このシステムコールを使
  35 えるのはスーパーユーザだけである。
  36 .\"O .SH "RETURN VALUE"
  37 .SH 返り値
  38 .\"O On success, returns the kernel address at which the module will reside.
  39 .\"O On error \-1 is returned and \fIerrno\fP is set appropriately.
  40 成功した場合は、モジュールを常駐させるためのカーネルメモリ上のアドレス
  41 が返される。エラーの場合は \-1 が返され、\fIerrno\fP の値が適切に設定
  42 される。
  43 .\"O .SH ERRORS
  44 .SH エラー
  45 .TP
  46 .B EPERM
  47 .\"O The user is not the superuser.
  48 呼び出しを行ったのがスーパーユーザでない。
  49 .TP
  50 .B EEXIST
  51 .\"O A module by that name already exists.
  52 その名前のモジュールが既に存在している。
  53 .TP
  54 .B EINVAL
  55 .\"O The requested size is too small even for the module header information.
  56 要求したサイズが小さすぎて、モジュールのヘッダ情報すら格納できない。
  57 .TP
  58 .B ENOMEM
  59 .\"O The kernel could not allocate a contiguous block of memory large
  60 .\"O enough for the module.
  61 モジュールを格納するのに必要な大きさの連続したメモリブロックをカーネル
  62 が確保できなかった。
  63 .TP
  64 .B EFAULT
  65 .\"O .I name
  66 .\"O is outside the program's accessible address space.
  67 .I name
  68 が、プログラムがアクセスできるアドレス空間の外部にある。
  69 .\"O .SH "SEE ALSO
  70 .SH 関連項目
  71 .\"O .BR init_module "(2), " delete_module "(2), " query_module "(2)."
  72 .BR init_module "(2), " delete_module "(2), " query_module "(2)"
  73