Import translated manuals from JM CVS Repository.

[linuxjm/jm.git] / manual / modutils / draft / man2 / get_kernel_syms.2

diff --git a/manual/modutils/draft/man2/get_kernel_syms.2 b/manual/modutils/draft/man2/get_kernel_syms.2
new file mode 100644 (file)
index 0000000..5932614
--- /dev/null
+++ b/manual/modutils/draft/man2/get_kernel_syms.2
@@ -0,0 +1,86 @@
+.\" Copyright (C) 1996 Free Software Foundation, Inc.
+.\" This file is distributed accroding to the GNU General Public License.
+.\" See the file COPYING in the top level source directory for details.
+.\"
+.\" Japanese Version Copyright (c) 1997,1999 HANATAKA Shinya and FUJIWARA Teruyoshi
+.\"         all rights reserved.
+.\" Translated Sat Aug 30 13:20:06 JST 1997
+.\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
+.\" Merged with another translation Sun Aug 15 10:33:03 JST 1999
+.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
+.\"
+.\"WORD:        export          ¥¨¥¯¥¹¥Ý¡¼¥È
+.\"
+.TH GET_KERNEL_SYMS 2 "26 Dec 1996" Linux "Linux Module Support"
+.\"O .SH NAME
+.SH ̾Á°
+.\"O get_kernel_syms \- retrieve exported kernel and module symbols
+get_kernel_syms \- ¥¨¥¯¥¹¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë¥«¡¼¥Í¥ë¤È¥â¥¸¥å¡¼¥ë¤Î¥·¥ó¥Ü¥ë¤ò¼èÆÀ¤¹¤ë
+.\"O .SH SYNOPSIS
+.SH ½ñ¼°
+.nf
+.B #include <linux/module.h>
+.sp
+.BI "int get_kernel_syms(struct kernel_sym *" table );
+.fi
+.\"O .SH DESCRIPTION
+.SH ÀâÌÀ
+.\"O If \fItable\fP is \fBNULL\fP, \fBget_kernel_syms\fP returns the
+.\"O number of symbols available for query.  Otherwise it fills in a
+.\"O table of structures:
+\fItable\fP ¤¬ \fBNULL\fP ¤Ê¤é¤Ð¡¢\fBget_kernel_syms\fP ¤ÏÌ䤤¹ç¤ï¤»¤Ç
+¤­¤ë¥·¥ó¥Ü¥ë¤Î¿ô¤òÊÖ¤¹¡£\fBNULL\fP ¤Ç¤Ê¤±¤ì¤Ð¡¢°Ê²¼¤Î¹½Â¤ÂΤËÃͤòÆþ¤ì
+¤ÆÊÖ¤¹:
+.PP
+.RS
+.nf
+struct kernel_sym
+{
+  unsigned long value;
+  char name[60];
+};
+.fi
+.RE
+.PP
+.\"O The symbols are interspersed with magic symbols of the form
+.\"O .BI # module-name
+.\"O with the kernel having an empty name.
+¥·¥ó¥Ü¥ë¤ÎÃæ¤Ë¤Ï
+.BI # ¥â¥¸¥å¡¼¥ë̾
+¤È¤¤¤¦·Á¼°¤Î¡¢¥«¡¼¥Í¥ë¤¬¶õ¤Î̾Á°¤ò»ý¤Ã¤Æ¤¤¤ë¥Þ¥¸¥Ã¥¯¥·¥ó¥Ü¥ë¤¬»¶ºß¤·¤Æ
+¤¤¤ë¡£
+.\"O The value associated with a symbol of this form is the address at
+.\"O which the module is loaded.
+¤³¤Î·Á¼°¤Î¥·¥ó¥Ü¥ë¤ËÂбþ¤¹¤ëÃͤϡ¢¥â¥¸¥å¡¼¥ë¤¬¥í¡¼¥É¤µ¤ì¤¿°ÌÃ֤Υ¢¥É¥ì
+¥¹¤Ç¤¢¤ë¡£
+.PP
+.\"O The symbols exported from each module follow their magic module tag
+.\"O and the modules are returned in the reverse order they were loaded.
+¤½¤ì¤¾¤ì¤Î¥â¥¸¥å¡¼¥ë¤«¤é¥¨¥¯¥¹¥Ý¡¼¥È¤µ¤ì¤¿¥·¥ó¥Ü¥ë¤Ï¡¢¥Þ¥¸¥Ã¥¯¥â¥¸¥å¡¼¥ë
+¥¿¥°¤Î¸å¤ËÃÖ¤«¤ì¤ë¡£¤Þ¤¿¡¢¥â¥¸¥å¡¼¥ë¤Ï¥í¡¼¥É¤µ¤ì¤¿½çÈ֤ȵսç¤ÇÊÖ¤µ¤ì¤ë¡£
+.\"O .SH "RETURN VALUE"
+.SH ÊÖ¤êÃÍ
+.\"O Returns the number of symbols returned.  There is no possible error return.
+ÊÖ¤êÃͤÏÊÖ¤µ¤ì¤ë¥·¥ó¥Ü¥ë¿ô¤Ç¤¢¤ë¡£¥¨¥é¡¼¤ÇÉüµ¢¤¹¤ë¤³¤È¤Ï¤Ê¤¤¡£
+.\"O .SH "SEE ALSO"
+.SH ´ØÏ¢¹àÌÜ
+.BR create_module "(2), " init_module "(2), " delete_module "(2), "
+.\"O .BR query_module "(2)."
+.BR query_module "(2)"
+.\"O .SH BUGS
+.SH ¥Ð¥°
+.\"O There is no way to indicate the size of the buffer allocated for
+.\"O \fItable\fP.  If symbols have been added to the kernel since the
+.\"O program queried for the symbol table size, memory will be corrupted.
+\fItable\fP ¤Î¤¿¤á¤Ë³ÎÊݤ·¤¿¥Ð¥Ã¥Õ¥¡¤ÎÂ礭¤µ¤òÅÁ¤¨¤ëÊýË¡¤¬¤Ê¤¤¡£
+¥×¥í¥°¥é¥à¤¬¥·¥ó¥Ü¥ë¥Æ¡¼¥Ö¥ë¤ÎÂ礭¤µ¤òÌ䤤¹ç¤ï¤»¤¿¸å¤Ë¥«¡¼¥Í¥ë¤Ë
+¥·¥ó¥Ü¥ë¤¬Äɲ䵤ì¤ë¤È¡¢¥á¥â¥ê¤ÎÆâÍƤ¬Ç˲õ¤µ¤ì¤ë¡£
+.PP
+.\"O The length of exported symbol names is limited to 59.
+¥¨¥¯¥¹¥Ý¡¼¥È¤µ¤ì¤ë¥·¥ó¥Ü¥ë̾¤ÎŤµ¤Ï 59 ʸ»ú¤ËÀ©¸Â¤µ¤ì¤ë¡£
+.PP
+.\"O Because of these limitations, this system call is deprecated in
+.\"O favor of \fBquery_module\fP.
+°Ê¾å¤ÎÀ©¸Â¤Ë¤è¤ê¡¢¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤è¤ê¤Ï \fBquery_module\fP ¤ò»È¤¦Êý
+¤¬Ë¾¤Þ¤·¤¤¡£
+