Import translated manuals from JM CVS Repository.

[linuxjm/jm.git] / manual / modutils / draft / man8 / genksyms.8

diff --git a/manual/modutils/draft/man8/genksyms.8 b/manual/modutils/draft/man8/genksyms.8
new file mode 100644 (file)
index 0000000..951bac6
--- /dev/null
+++ b/manual/modutils/draft/man8/genksyms.8
@@ -0,0 +1,160 @@
+.\" Copyright (c) 1994 Bjorn Ekwall <bj0rn@blox.se>
+.\" Copyright (c) 1997 Linux International
+.\" This program is distributed according to the Gnu General Public License.
+.\" See the file COPYING in the kernel source directory /linux
+.\"
+.\" Translated Sun Aug 15 10:58:55 JST 1999
+.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
+.\" Updated Mon Mar 18 JST 2002 by Kentaro Shirakata <argrath@ub32.org>
+.\"
+.TH GENKSYMS 8 "January 30, 2002" Linux "Linux Module Support"
+.\"O .SH NAME
+.SH ̾Á°
+.\"O genksyms \- generate symbol version information
+genksyms \- ¥·¥ó¥Ü¥ë¤Î¥Ð¡¼¥¸¥ç¥ó¾ðÊó¤òÀ¸À®¤¹¤ë
+.\"O .SH SYNOPSIS
+.SH ½ñ¼°
+.B genksyms
+[\-wq] [\-dD] [\-V] [\-k\ \fIversion\fR] [\-p string]
+[\fIoutput\ directory\fR]
+.\"O .SH DESCRIPTION
+.SH ÀâÌÀ
+.\"O .B Genksyms
+.\"O reads (on standard input) the output from "\fBgcc -E source.c\fR" and
+.\"O generates a file containing version information.
+.B genksyms
+¤Ï (ɸ½àÆþÎϤ«¤é) "\fBgcc -E source.c\fR" ¤Î½ÐÎϤòÆɤ߹þ¤ß¡¢
+¥Ð¡¼¥¸¥ç¥ó¾ðÊó¤ò´Þ¤à¥Õ¥¡¥¤¥ë¤òÀ¸À®¤¹¤ë¡£
+.PP
+.\"O Depending on the output format indicated by the \fB\-k\fR\ option,
+.\"O the output will either be written to a \fB.ver\fR file in the named
+.\"O output directory, or to the standard output.
+\fB\-k\fR\ ¥ª¥×¥·¥ç¥ó¤Ç»ØÄꤵ¤ì¤ë½ÐÎÏ¥Õ¥©¡¼¥Þ¥Ã¥È¤Ë¤·¤¿¤¬¤Ã¤Æ¡¢
+½ÐÎϤϻØÄꤵ¤ì¤¿½ÐÎϥǥ£¥ì¥¯¥È¥ê¤Î \fB.ver\fR ¥Õ¥¡¥¤¥ë¤Þ¤¿¤Ïɸ½à½ÐÎϤË
+½ñ¤­½Ð¤µ¤ì¤ë¡£
+.PP
+.\"O .B Genksyms
+.\"O normally looks for explicit symbol table definitions in the source
+.\"O file.  All definitions and declarations of
+.\"O .BR typedef ,\  struct ,\  union "\ and\ " enum
+.\"O will be saved for later expansion.
+.B genksyms
+¤ÏÉáÄÌ¥½¡¼¥¹¥Õ¥¡¥¤¥ëÃæ¤ÎÌÀ¼¨Åª¤Ê¥·¥ó¥Ü¥ë¥Æ¡¼¥Ö¥ëÄêµÁ¤òõ¤¹¡£
+.BR typedef ,\  struct ,\  union ,\  enum
+¤ÎÁ´¤Æ¤ÎÄêµÁ¤ÈÀë¸À¤Ï¸å¤ÇŸ³«¤¹¤ë¤¿¤á¤ËÊݸ¤µ¤ì¤ë¡£
+.\"O Every global symbol will also be saved, together with pointers
+.\"O that will enable a full expansion later on.
+Á´¤Æ¤Î¥°¥í¡¼¥Ð¥ë¤Ê¥·¥ó¥Ü¥ë¤â¡¢¸å¤ÇÁ´¤ÆŸ³«¤Ç¤­¤ë¤è¤¦¤Ë¤¹¤ë¥Ý¥¤¥ó¥¿¤È¶¦¤Ë
+Êݸ¤µ¤ì¤ë¡£
+.PP
+.\"O When a symbol table is found in the source, the symbol will be
+.\"O expanded to its full definition, where all structs, unions, enums
+.\"O and typedefs will be expanded down to their basic part, recursively.
+¥·¥ó¥Ü¥ë¥Æ¡¼¥Ö¥ë¤¬¥½¡¼¥¹Ãæ¤Ç¸«¤Ä¤«¤ë¤È¡¢¥·¥ó¥Ü¥ë¤Ï´°Á´¤ÊÄêµÁ¤ËŸ³«¤µ¤ì¤ë¡£
+¤³¤ÎºÝ¤Ë¤ÏÁ´¤Æ¤Î¹½Â¤ÂΡ¢¶¦ÍÑÂΡ¢Îóµó»ØÄê»Ò¡¢·¿Àë¸À¤Ï´ðËÜÉôʬ¤Þ¤ÇºÆµ¢Åª¤Ë
+Ÿ³«¤µ¤ì¤ë¡£
+.\"O This final string will then be used as input to a CRC algorithm
+.\"O that will give an integer that will change as soon as any of the
+.\"O included definitions changes, for this symbol.
+¤³¤¦¤·¤ÆÆÀ¤é¤ì¤¿ºÇ½ªÅª¤Êʸ»úÎ󤬡¢CRC ¥¢¥ë¥´¥ê¥º¥à¤Ø¤ÎÆþÎϤȤ·¤Æ»È¤ï¤ì¤ë¡£
+¤³¤Î¥¢¥ë¥´¥ê¥º¥à¤Ï¡¢¤³¤Î¥·¥ó¥Ü¥ë¤Ë¤Ä¤¤¤Æ´Þ¤Þ¤ì¤Æ¤¤¤ëÄêµÁ¤¬Êѹ¹¤µ¤ì¤ë¤È
+¤¹¤°¤ËÃͤ¬ÊѤï¤ëÀ°¿ô¤òÍ¿¤¨¤ë¡£
+.PP
+.\"O The version information in the kernel normally looks like:
+.\"O .BR symbol_R12345678 ,
+¥«¡¼¥Í¥ë¤¬»ý¤Ã¤Æ¤¤¤ë¥Ð¡¼¥¸¥ç¥ó¾ðÊó¤ÏÉáÄÌ¡¢
+.B symbol_R12345678
+¤Î¤è¤¦¤Ë¤Ê¤Ã¤Æ¤¤¤ë¡£
+.\"O where 12345678 is the hexadecimal representation of the CRC.
+¤³¤³¤Ç 12345678 ¤Ï CRC ¤òɽ¤¹ 16 ¿ÊÃͤǤ¢¤ë¡£
+.\"O .SH OPTIONS
+.SH ¥ª¥×¥·¥ç¥ó
+.TP
+.BR \-d ", " \-\-debug
+.\"O Output debugging information; repeating this option increases the
+.\"O verbosity.  Debug level 1 generates moderate information about the
+.\"O actions being taken; debug level 2 enables parser recognition
+.\"O output; debug level 3 enables lexical analysis output.
+¥Ç¥Ð¥Ã¥°¾ðÊó¤ò½ÐÎϤ¹¤ë¡£¤³¤Î¥ª¥×¥·¥ç¥ó¤ò·«¤êÊÖ¤·¤Æ»ØÄꤹ¤ë¤È¡¢
+½ÐÎϤξܤ·¤µ¤Î¥ì¥Ù¥ë¤¬Â礭¤¯¤Ê¤ë¡£¥Ç¥Ð¥Ã¥°¥ì¥Ù¥ë 1 ¤Ç¤Ï¹Ô¤Ã¤¿Æ°ºî¤Ë´Ø¤¹¤ë
+ÉáÄ̤ξðÊó¤¬É½¼¨¤µ¤ì¤ë¡£¥Ç¥Ð¥Ã¥°¥ì¥Ù¥ë 2 ¤Ç¤Ï¥Ñ¡¼¥¶¤Îǧ¼±¤·¤¿¾ðÊó¤Î½ÐÎϤ¬
+Í­¸ú¤Ë¤Ê¤ë¡£¥Ç¥Ð¥Ã¥°¥ì¥Ù¥ë 3 ¤Ç¤Ï¹½Ê¸²òÀϤξðÊ󤬽ÐÎϤµ¤ì¤ë¤è¤¦¤Ë¤Ê¤ë¡£
+.TP
+.BR \-D ", " \-\-dump
+.\"O Dump expanded symbol definitions to stderr.  For debugging use only.
+Ÿ³«¤·¤¿¥·¥ó¥Ü¥ëÄêµÁ¤òɸ½à¥¨¥é¡¼½ÐÎϤ˥À¥ó¥×¤¹¤ë¡£¥Ç¥Ð¥Ã¥°ÀìÍѤÎ
+¥ª¥×¥·¥ç¥ó¤Ç¤¢¤ë¡£
+.TP
+.BR \-h ", " \-\-help
+.\"O Display a summary of options and immediately exit.
+¥ª¥×¥·¥ç¥ó¤Î°ìÍ÷¤òɽ¼¨¤·¤Æľ¤Á¤Ë½ªÎ»¤¹¤ë¡£
+.TP
+\fB\-k\fR\ \fIversion\fR,\ \fB\-\-kernel\fR\ \fIversion\fR
+.\"O Select the version of the kernel for which to generate output.  Omitting
+.\"O this option assumes a version below 2.1.0.  Versions below 2.1.18 
+.\"O use checksum version 1, and produce their output in the directory given
+.\"O on the command line.  Versions 2.1.18 and above use checksum version 2
+.\"O and produce their output on stdout.
+½ÐÎϤòÀ¸À®¤¹¤ëÂоݤȤʤ륫¡¼¥Í¥ë¤Î¥Ð¡¼¥¸¥ç¥ó¤òÁªÂò¤¹¤ë¡£¤³¤Î¥ª¥×¥·¥ç¥ó¤ò
+¾Êά¤¹¤ë¤È¡¢¥Ð¡¼¥¸¥ç¥ó¤Ï 2.1.0 ¤è¤êÁ°¤È¤·¤Æ°·¤ï¤ì¤ë¡£2.1.18 ¤è¤êÁ°¤Ç¤Ï
+¥Ð¡¼¥¸¥ç¥ó 1 ¤Î¥Á¥§¥Ã¥¯¥µ¥à¤ò»È¤Ã¤Æ¤ª¤ê¡¢½ÐÎϤÏľÀÜ¥³¥Þ¥ó¥É¥é¥¤¥ó¾å¤Ë
+À¸À®¤µ¤ì¤ë¡£¥Ð¡¼¥¸¥ç¥ó 2.1.18 °Ê¹ß¤Ç¤Ï¥Ð¡¼¥¸¥ç¥ó 2 ¤Î¥Á¥§¥Ã¥¯¥µ¥à¤ò
+»È¤Ã¤Æ¤ª¤ê¡¢½ÐÎϤÏɸ½à½ÐÎϤËÀ¸À®¤µ¤ì¤ë¡£
+.TP
+\fB\-p\fR\ \fIstring\fR,\ \fB\-\-prefix\fR\ \fIstring\fR
+.\"O Prepend the given string to the CRCs generated for all symbols.  This is
+.\"O intended for use with, e.g., SMP kernels, wherein the modules are not
+.\"O compatible at a level below that described by the data types.  This is
+.\"O primarily caused by inline function expansions in the module code itself.
+Á´¤Æ¤Î¥·¥ó¥Ü¥ë¤Ë¤Ä¤¤¤Æ¡¢À¸À®¤·¤¿ CRC ¤ÎÁ°¤ËÍ¿¤¨¤é¤ì¤¿Ê¸»úÎó¤òÉÕ¤±¤ë¡£
+¤³¤ì¤Ï SMP Âбþ¥«¡¼¥Í¥ëÅù¤Ç»È¤¦¤¿¤á¤Î¥ª¥×¥·¥ç¥ó¤Ç¤¢¤ë¡£¤³¤Î¤è¤¦¤Ê¾ì¹ç¤Ë¤Ï¡¢
+¥Ç¡¼¥¿¤Î·¿¤Çµ­½Ò¤¹¤ë¤è¤ê¤âÄ㤤¥ì¥Ù¥ë¤Ë¤ª¤¤¤Æ¥â¥¸¥å¡¼¥ë¤Î¸ß´¹À­¤¬¤Ê¤¤¡£
+Èó¸ß´¹À­¤Î¼ç¤Ê¸¶°ø¤Ï¡¢¥â¥¸¥å¡¼¥ë¤Î¥³¡¼¥É¼«ÂΤˤª¤±¤ë¥¤¥ó¥é¥¤¥ó´Ø¿ô¤Î
+Ÿ³«¤Ç¤¢¤ë¡£
+.TP
+.BR \-q ", " \-\-quiet
+.\"O Quiet warnings, i.e. reverse the \fB\-w\fR option.
+·Ù¹ð¤ò½Ð¤µ¤Ê¤¤¤è¤¦¤Ë¤¹¤ë¡£¤Ä¤Þ¤ê¡¢\-w ¥ª¥×¥·¥ç¥ó¤ÎµÕ¤Ç¤¢¤ë¡£
+.TP
+.BR \-V ", " \-\-version
+.\"O Display the version of \fBgenksyms\fR.
+\fBgenksyms\fR ¤Î¥Ð¡¼¥¸¥ç¥ó¤òɽ¼¨¤¹¤ë¡£
+.TP
+.BR \-w ", " \-\-warnings
+.\"O Enable warnings due to unrecognized syntax and declared but undefined
+.\"O structures.  These warnings are normally suppressed.
+ǧ¼±¤Ç¤­¤Ê¤¤¹½Ê¸¤ä¡¢Àë¸À¤µ¤ì¤Æ¤¤¤ë¤Ë¤â´Ø¤ï¤é¤ºÄêµÁ¤µ¤ì¤Æ¤¤¤Ê¤¤¹½Â¤ÂΤË
+ÂФ¹¤ë·Ù¹ð¤òɽ¼¨¤¹¤ë¤è¤¦¤Ë¤¹¤ë¡£Ä̾ï¤Ï¤³¤Î¤è¤¦¤Ê·Ù¹ð¤Ï¹Ô¤ï¤ì¤Ê¤¤¡£
+.\"O .SH SEE ALSO
+.SH ´ØÏ¢¹àÌÜ
+.BR insmod "(8), " modprobe "(8) "
+.\"O .SH BUGS
+.SH ¥Ð¥°
+.\"O The \fB\-h\fR\ option is broken; \fB\-\-help\fR\ is fine.
+\fB\-h\fR\ ¥ª¥×¥·¥ç¥ó¤Ï²õ¤ì¤Æ¤¤¤ë¡£\fB\-\-help\fR\ ¤ÏÀµ¤·¤¯Æ°¤¯¡£
+.br
+.\"O \fBgenksyms\fR [\fB\-V\fR\ |\ \fB\-\-version\fR] should display version
+.\"O information and then exit immediately.  Instead, it prints the version
+.\"O information and behaves as if no options were given.
+\fBgenksyms\fR [\fB\-V\fR\ |\ \fB\-\-version\fR] ¤Ï¥Ð¡¼¥¸¥ç¥ó¾ðÊó¤ò
+ɽ¼¨¤·¤Æľ¤Á¤Ë½ªÎ»¤¹¤ë¤Ù¤­¤Ç¤¢¤ë¡£
+¤·¤«¤·¤Ê¤¬¤é¡¢¸½ºß¤Ï¥Ð¡¼¥¸¥ç¥ó¾ðÊó¤òɽ¼¨¤·¤¿¸å¡¢
+²¿¤â¥ª¥×¥·¥ç¥ó¤¬»ØÄꤵ¤ì¤Ê¤«¤Ã¤¿¤«¤Î¤è¤¦¤Ë¿¶Éñ¤¦¡£
+.\"O .SH HISTORY
+.SH ÍúÎò
+.\"O This versioning concept is a result from discussions, not at least
+.\"O on the KERNEL-channel, with a lot of people.
+¤³¤Î¥Ð¡¼¥¸¥ç¥óÉÕ¤±¤Î³µÇ°¤ÏµÄÏÀ¤Î·ë²ÌÆÀ¤é¤ì¤¿¤â¤Î¤Ç¤¢¤ë¡£
+µÄÏÀ¤â KERNEL-channel ¤À¤±¤Ç¤Ê¤¯¡¢Â¿¤¯¤Î¿Í¡¹¤Ë¤è¤Ã¤Æ¹Ô¤ï¤ì¤¿¡£
+.PP
+.\"O The genksyms utility was created in 1994 by Bjorn Ekwall <bj0rn@blox.se>
+.\"O being mostly inspired by Jacques Gelinas <jack@solucorp.ca>
+.\"O and Jeremy Fitzhardinge <jeremy@suite.sw.oz.au>
+genksyms ¥æ¡¼¥Æ¥£¥ê¥Æ¥£¤Ï 1994 ǯ¤Ë Bjorn Ekwall <bj0rn@blox.se> ¤¬ºîÀ®¤·¤¿¡£
+¤½¤Î¿¤¯¤Î¥¢¥¤¥Ç¥£¥¢¤Ï Jacques Gelinas <jack@solucorp.ca> ¤È
+Jeremy Fitzhardinge <jeremy@suite.sw.oz.au> ¤Ë¤è¤ë¤â¤Î¤Ç¤¢¤ë¡£
+.PP
+.\"O It was rewritten in 1996 by Richard Henderson to use a proper lexer
+.\"O and parser.
+¤³¤Î¥æ¡¼¥Æ¥£¥ê¥Æ¥£¤Ï 1996 ǯ¤Ë Richard Hendersnon ¤¬½ñ¤­Ä¾¤·¡¢¤è¤êŬÀÚ¤Ê
+»ú¶ç²òÀÏ´ï¤È¥Ñ¡¼¥¶¤ò»È¤¦¤è¤¦¤Ë¤·¤¿¡£