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