Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
COMPILE_ET(1)		     General Commands Manual		   COMPILE_ET(1)

NAME
     compile_et - error table compiler

SYNOPSIS
     compile_et file

DESCRIPTION
     Compile_et  converts  a  table listing error-code names and associated mes-
     sages into a C source file suitable for use with the com_err(3) library.

     The source file name must end with a suffix of ``.et''; the  file	consists
     of a declaration supplying the name (up to four characters long) of the er-
     ror-code table:

     error_table name

     followed by up to 256 entries of the form:

     error_code name, " string "

     and a final

     end

     to indicate the end of the table.

     The  name	of  the table is used to construct the name of a subroutine ini-
     tialize_XXXX_error_table which must be called in order for the com_err  li-
     brary to recognize the error table.

     The  various  error codes defined are assigned sequentially increasing num-
     bers (starting with a large number computed as a hash function of the  name
     of  the  table);  thus  for compatibility it is suggested that new codes be
     added only to the end of an existing table, and that no  codes  be  removed
     from tables.

     The  names  defined  in the table are placed into a C header file with pre-
     processor directives defining them as integer constants of up to 32 bits in
     magnitude.

     A C source file is also generated which should be compiled and linked  with
     the object files which reference these error codes; it contains the text of
     the  messages  and  the initialization subroutine.  Both C files have names
     derived from that of the original source file, with the ``.et'' suffix  re-
     placed by ``.c'' and ``.h''.

     A	``#''  in the source file is treated as a comment character, and all re-
     maining text to the end of the source line will be ignored.

BUGS
     Since the original compile_et uses a very simple parser based  on	yacc(1),
     and  this	current  version  of  compile_et  uses an awk/sed combination of
     scripts, its error recovery leaves much to be desired.

SEE ALSO
     com_err (3).

     Ken Raeburn, "A Common Error Description Library for UNIX".

SIPB				   30 Mar 1998			   COMPILE_ET(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=e2fsprogs-compile_et&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help