manual/e2fsprogs/draft/man1/compile_et.1

   1 .\" Copyright (c) 1988 Massachusetts Institute of Technology,
   2 .\" Student Information Processing Board.  All rights reserved.
   3 .\"
   4 .\" Japanese Version Copyright (c) 2000 NAKANO Takeo all rights reserved.
   5 .\" Translated Thu 13 2000 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
   6 .\"
   7 .\" $Header$
   8 .\"
   9 .TH COMPILE_ET 1 "30 Mar 1998" SIPB
  10 .\"O .SH NAME
  11 .\"O compile_et \- error table compiler
  12 .SH Ì¾Á°
  13 compile_et \- ¥¨¥é¡¼É½¤Î¥³¥ó¥Ñ¥¤¥é¡¼
  14 .\"O .SH SYNOPSIS
  15 .SH ½ñ¼°
  16 .B compile_et
  17 file
  18 .\"O .SH DESCRIPTION
  19 .SH ÀâÌÀ
  20 .\"O .B Compile_et
  21 .\"O converts a table listing error-code names and associated messages into
  22 .\"O a C source file suitable for use with the
  23 .\"O .IR com_err (3)
  24 .\"O library.
  25 .B compile_et
  26 ¤Ï¡¢¥¨¥é¡¼¥³¡¼¥É¤ÎÌ¾Á°¤ÈÂÐ±þ¤¹¤ë¥á¥Ã¥»¡¼¥¸¤ò¥ê¥¹¥È¤·¤¿É½¤ò¡¢
  27 .IR com_err (3)
  28 ¥é¥¤¥Ö¥é¥ê¤Ç°·¤¤¤ä¤¹¤¤ C ¥½¡¼¥¹·Á¼°¤ËÊÑ´¹¤¹¤ë¡£
  29
  30 .\"O The source file name must end with a suffix of ``.et''; the file
  31 .\"O consists of a declaration supplying the name (up to four characters
  32 .\"O long) of the error-code table:
  33 ¥½¡¼¥¹¥Õ¥¡¥¤¥ë¤ÎÌ¾Á°¤Ï ``.et'' ¤È¤¤¤¦³ÈÄ¥»Ò¤Ç½ª¤ï¤Ã¤Æ¤¤¤ëÉ¬Í×¤¬¤¢¤ë¡£
  34 ¥Õ¥¡¥¤¥ë¤ÎÀèÆ¬¤Ç¡¢¤Þ¤º¥¨¥é¡¼¥³¡¼¥ÉÉ½¤ÎÌ¾Á°
  35 (Ì¾Á°¤Ï 4 Ê¸»ú¤Þ¤Ç)¡£
  36 ¤òÍ¿¤¨¤ëÀë¸À¤ò¹Ô¤¦¡£
  37 .RS
  38 .sp
  39 .B error_table
  40 .I name
  41 .sp
  42 .RE
  43 .\"O followed by up to 256 entries of the form:
  44 Â³¤¤¤Æ¡¢¥¨¥ó¥È¥ê¤ò¼¡¤Î·Á¼°¤ÇÍ¿¤¨¤ë (256 ¥¨¥ó¥È¥ê¤Þ¤Ç)¡£
  45 .RS
  46 .sp
  47 .B error_code
  48 .I name,
  49 .\"O "
  50 .\"O .I string
  51 .\"O "
  52 .RI \" string \"
  53 .sp
  54 .RE
  55
  56 .\"O and a final
  57 ¤½¤·¤ÆºÇ¸å¤ËÉ½¤ÎËöÈø¤ò
  58 .RS
  59 .sp
  60 .B end
  61 .sp
  62 .RE
  63 .\"O to indicate the end of the table.
  64 ¤Ë¤è¤Ã¤Æ¼¨¤¹¡£
  65
  66 .\"O The name of the table is used to construct the name of a subroutine
  67 .\"O .I initialize_XXXX_error_table
  68 .\"O which must be called in order for the
  69 .\"O .I com_err
  70 .\"O library to recognize the error table.
  71 É½¤ÎÌ¾Á°¤Ï¡¢¥µ¥Ö¥ë¡¼¥Á¥ó¤ÎÌ¾Á°¤ò¤Ä¤¯¤ë¤È¤¤Ë
  72 .I initialize_XXXX_error_table
  73 ¤ÎÍÍ¤ËÍÑ¤¤¤é¤ì¤ë¡£
  74 .I com_err
  75 ¥é¥¤¥Ö¥é¥ê¤Ë¤³¤Î¥¨¥é¡¼É½¤òÇ§¼±¤µ¤»¤ë¤Ë¤Ï¡¢
  76 ¤³¤Î¥µ¥Ö¥ë¡¼¥Á¥ó¤ò¸Æ¤Ó½Ð¤¹É¬Í×¤¬¤¢¤ë¡£
  77
  78 .\"O The various error codes defined are assigned sequentially increasing
  79 .\"O numbers (starting with a large number computed as a hash function of
  80 .\"O the name of the table); thus for compatibility it is suggested that
  81 .\"O new codes be added only to the end of an existing table, and that no
  82 .\"O codes be removed from tables.
  83 ³Æ¼ï¥¨¥é¡¼¥³¡¼¥É¤ÎÄêµÁ¤Ï¡¢¤Ò¤È¤Ä¤º¤ÄÁý¤¨¤ë¿ôÃÍ¤Ë³ä¤êÅö¤Æ¤é¤ì¤ë
  84 (ÀèÆ¬¤Î¿ôÃÍ¤Ï¡¢É½¤ÎÌ¾Á°¤ò¥Ï¥Ã¥·¥å´Ø¿ô¤ËÍ¿¤¨¤Æ·×»»¤µ¤ì¤¿ÃÍ¤Ë¤Ê¤ë)¡£
  85 ¤·¤¿¤¬¤Ã¤Æ¸ß´¹À¤òÊÝ¤Ä¤¿¤á¤Ë¤Ï¡¢
  86 ¿·¤·¤¤¥³¡¼¥É¤ÎÄÉ²Ã¤Ï´ûÂ¸¤ÎÉ½¤ÎËöÈø¤Ë¹Ô¤¤¡¢
  87 É½¤«¤é¥³¡¼¥É¤Îºï½ü¤ò¹Ô¤ï¤Ê¤¤¤³¤È¤Ç¤¢¤ë¡£
  88
  89 .\"O The names defined in the table are placed into a C header file with
  90 .\"O preprocessor directives defining them as integer constants of up to
  91 .\"O 32 bits in magnitude.
  92 É½¤ÇÄêµÁ¤µ¤ì¤Æ¤¤¤ëÌ¾Á°¤Ï¡¢ C ¤Î¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤Ë¤ª¤¤¤Æ¡¢
  93 ¤½¤ì¤é¤ÎÌ¾Á°¤ò 32 ¥Ó¥Ã¥È¤Þ¤Ç¤ÎÀ°¿ôÄê¿ô¤È¤·¤ÆÄêµÁ¤¹¤ë
  94 ¥×¥ê¥×¥í¥»¥Ã¥µ»ØÄê¤Ë¤Ê¤ë¡£
  95
  96 .\"O A C source file is also generated which should be compiled and linked
  97 .\"O with the object files which reference these error codes; it contains
  98 .\"O the text of the messages and the initialization subroutine.  Both C
  99 .\"O files have names derived from that of the original source file, with
 100 .\"O the ``.et'' suffix replaced by ``.c'' and ``.h''.
 101 C ¥½¡¼¥¹¥Õ¥¡¥¤¥ë¤âÀ¸À®¤µ¤ì¤ë¤Î¤Ç¡¢¤³¤ì¤ò¥³¥ó¥Ñ¥¤¥ë¤·¤Æ¡¢
 102 ¥¨¥é¡¼¥³¡¼¥É¤ò»²¾È¤¹¤ë¥ª¥Ö¥¸¥§¥¯¥È¥Õ¥¡¥¤¥ë¤Ë¥ê¥ó¥¯¤¹¤ë¡£
 103 C ¥½¡¼¥¹¥Õ¥¡¥¤¥ë¤Ë¤Ï¡¢¥á¥Ã¥»¡¼¥¸¤Î¥Æ¥¥¹¥È¤È½é´ü²½¥µ¥Ö¥ë¡¼¥Á¥ó¤È¤¬´Þ¤Þ¤ì¤ë¡£
 104 C ¤Î¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¡¦¥½¡¼¥¹¥Õ¥¡¥¤¥ëÎ¾¼Ô¤ÎÌ¾Á°¤Ï¡¢
 105 ¥ª¥ê¥¸¥Ê¥ë¤Î¥½¡¼¥¹¥Õ¥¡¥¤¥ë¤ÎÌ¾Á°¤Î ``.et'' ³ÈÄ¥»Ò¤ò¡¢
 106 ¤½¤ì¤¾¤ì ``.h'', ``.c'' ¤ËÃÖ¤´¹¤¨¤¿¤â¤Î¤Ë¤Ê¤ë¡£
 107
 108 .\"O A ``#'' in the source file is treated as a comment character, and all
 109 .\"O remaining text to the end of the source line will be ignored.
 110 ¥½¡¼¥¹¥Õ¥¡¥¤¥ëÃæ¤Î ``#'' ¤Ï¥³¥á¥ó¥ÈÊ¸»ú¤È¤·¤Æ°·¤ï¤ì¡¢
 111 ¤½¤Î¹Ô¤ÎËöÈø¤Þ¤Ç¤Î»Ä¤ê¤Î¥Æ¥¥¹¥È¤ÏÌµ»ë¤µ¤ì¤ë¡£
 112 .\"O
 113 .\"O .SH BUGS
 114 .\"O
 115 .SH ¥Ð¥°
 116 .\"O Since the original
 117 .\"O .B compile_et
 118 .\"O uses a very simple parser based on
 119 .\"O .IR yacc (1),
 120 .\"O and this current version of
 121 .\"O .B compile_et
 122 .\"O uses an awk/sed combination of scripts,
 123 .\"O its error recovery leaves much to be desired.
 124 ¥ª¥ê¥¸¥Ê¥ë¤Î
 125 .B compile_et
 126 ¤Ï
 127 .IR yacc (1)
 128 ¤òÍÑ¤¤¤¿Èó¾ï¤Ë´ÊÃ±¤Ê¥Ñ¡¼¥µ¡¼¤ò»È¤Ã¤Æ¤¤¤¿¤·¡¢
 129 ¸½ºß¤Î¥Ð¡¼¥¸¥ç¥ó¤Î
 130 .B compile_et
 131 ¤Ï awk ¤È sed ¥¹¥¯¥ê¥×¥È¤òÁÈ¤ß¹ç¤ï¤»¤ÆÍÑ¤¤¤Æ¤¤¤ë¤Î¤Ç¡¢
 132 ¥¨¥é¡¼¥ê¥«¥Ð¥ê¤ÏË¾¤Þ¤·¤¤¿å½à¤«¤é¤Ï¤Û¤É±ó¤¤¡£
 133 .\"O
 134 .\" .IR for manual entries
 135 .\" .PP for paragraph breaks
 136 .\"O
 137 .\"O .SH "SEE ALSO"
 138 .SH ´ØÏ¢¹àÌÜ
 139 .\"O com_err (3).
 140 com_err (3)
 141
 142 Ken Raeburn, "A Common Error Description Library for UNIX".