1COMPILE_ET(1)               General Commands Manual              COMPILE_ET(1)
2
3
4

NAME

6       compile_et - error table compiler
7

SYNOPSIS

9       compile_et file
10

DESCRIPTION

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

BUGS

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

SEE ALSO

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)
Impressum