draft/man2/create_module.2

   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.
   4 .\"
   5 .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some
   6 .\" reformatting and rewordings by mtk
   7 .\"
   8 .\" Japanese Version Copyright (c) 2006 Akihiro MOTOKI all rights reserved.
   9 .\" Translated 2006-07-29, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  10 .\"
  11 .TH CREATE_MODULE 2 2007-06-03 "Linux" "Linux Programmer's Manual"
  12 .\"O .SH NAME
  13 .SH 名前
  14 .\"O create_module \- create a loadable module entry
  15 create_module \- ローダブルモジュールのエントリを作成する
  16 .\"O .SH SYNOPSIS
  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 .\"O .SH DESCRIPTION
  24 .SH 説明
  25 .\"O .BR create_module ()
  26 .\"O attempts to create a loadable module entry and reserve the kernel memory
  27 .\"O that will be needed to hold the module.
  28 .\"O This system call requires privilege.
  29 .BR create_module ()
  30 は、ローダブルモジュールのエントリを作成し、そのモジュールの保持に必要な
  31 カーネルメモリを予約しようとする。
  32 このシステムコールを使うには特権が必要である。
  33 .\"O .SH "RETURN VALUE"
  34 .SH 返り値
  35 .\"O On success, returns the kernel address at which the module will reside.
  36 .\"O On error \-1 is returned and
  37 .\"O .I errno
  38 .\"O is set appropriately.
  39 成功すると、モジュールが配置されるカーネル空間のアドレスを返す。
  40 エラーの場合 \-1 を返し、
  41 .I errno
  42 を適切に設定する。
  43 .\"O .SH ERRORS
  44 .SH エラー
  45 .TP
  46 .B EEXIST
  47 .\"O A module by that name already exists.
  48 その名前のモジュールがすでに存在する。
  49 .TP
  50 .B EFAULT
  51 .\"O .I name
  52 .\"O is outside the program's accessible address space.
  53 .I name
  54 がプログラムがアクセスできるアドレス空間の外部にある。
  55 .TP
  56 .B EINVAL
  57 .\"O The requested size is too small even for the module header information.
  58 要求したサイズが小さすぎて、モジュールのヘッダ情報すら格納できない。
  59 .TP
  60 .B ENOMEM
  61 .\"O The kernel could not allocate a contiguous block of memory large
  62 .\"O enough for the module.
  63 モジュールを格納するのに必要な大きさの連続したメモリブロックを
  64 カーネルが確保できなかった。
  65 .TP
  66 .B ENOSYS
  67 .\"O .BR create_module ()
  68 .\"O is not supported in this version of the kernel.
  69 .BR create_module ()
  70 がこのバージョンのカーネルではサポートされていない。
  71 .TP
  72 .B EPERM
  73 .\"O The caller was not privileged
  74 .\"O (did not have the
  75 .\"O .B CAP_SYS_MODULE
  76 .\"O capability).
  77 呼び出し元が特権
  78 .RB ( CAP_SYS_MODULE
  79 ケーパビリティ) を持っていなかった。
  80 .\"O .SH VERSIONS
  81 .SH バージョン
  82 .\"O This system call is only present on Linux up until kernel 2.4;
  83 .\"O it was removed in Linux 2.6.
  84 このシステムコールが存在するのはカーネル 2.4 までの Linux だけである。
  85 Linux 2.6 では削除された。
  86 .\" Removed in Linux 2.5.48
  87 .\"O .SH "CONFORMING TO"
  88 .SH 準拠
  89 .\"O .BR create_module ()
  90 .\"O is Linux-specific.
  91 .BR create_module ()
  92 は Linux 固有である。
  93 .\"O .SH "SEE ALSO"
  94 .SH 関連項目
  95 .BR delete_module (2),
  96 .BR init_module (2),
  97 .BR query_module (2)