1COMPILE_ET(1) General Commands Manual COMPILE_ET(1)
2
3
4
6 compile_et - error table compiler
7
9 compile_et file
10
12 Compile_et converts a table listing error-code names and associated
13 messages into a C source file suitable for use with the com_err(3)
14 library.
15
16 The source file name must end with a suffix of ``.et''; the file con‐
17 sists of a declaration supplying the name (up to four characters long)
18 of the error-code table:
19
20 error_table name
21
22 followed by up to 256 entries of the form:
23
24 error_code name, " string "
25
26 and a final
27
28 end
29
30 to indicate the end of the table.
31
32 The name of the table is used to construct the name of a subroutine
33 initialize_XXXX_error_table which must be called in order for the
34 com_err library to recognize the error table.
35
36 The various error codes defined are assigned sequentially increasing
37 numbers (starting with a large number computed as a hash function of
38 the name of the table); thus for compatibility it is suggested that new
39 codes be added only to the end of an existing table, and that no codes
40 be removed from tables.
41
42 The names defined in the table are placed into a C header file with
43 preprocessor directives defining them as integer constants of up to 32
44 bits in magnitude.
45
46 A C source file is also generated which should be compiled and linked
47 with the object files which reference these error codes; it contains
48 the text of the messages and the initialization subroutine. Both C
49 files have names derived from that of the original source file, with
50 the ``.et'' suffix replaced by ``.c'' and ``.h''.
51
52 A ``#'' in the source file is treated as a comment character, and all
53 remaining text to the end of the source line will be ignored.
54
55
57 Since the original compile_et uses a very simple parser based on
58 yacc(1), and this current version of compile_et uses an awk/sed combi‐
59 nation of scripts, its error recovery leaves much to be desired.
60
61
62
64 com_err (3).
65
66 Ken Raeburn, "A Common Error Description Library for UNIX".
67
68
69
70SIPB 30 Mar 1998 COMPILE_ET(1)