MAN page from Other libext2fs2-devel-1.34-2sls.i586.rpm

COMPILE_ET

Section: User Commands (1)
Updated: 30 Mar 1998
Index

NAME

compile_et - error table compiler

SYNOPSIS

compile_etfile

DESCRIPTION

Compile_etconverts a table listing error-code names and associated messages intoa C source file suitable for use with thecom_err(3)library.

The source file name must end with a suffix of ``.et''; the fileconsists of a declaration supplying the name (up to four characterslong) of the error-code table:

error_tablename

followed by up to 256 entries of the form:

error_codename,"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 subroutineinitialize_XXXX_error_tablewhich must be called in order for thecom_errlibrary to recognize the error table.

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

The names defined in the table are placed into a C header file withpreprocessor directives defining them as integer constants of up to32 bits in magnitude.

A C source file is also generated which should be compiled and linkedwith the object files which reference these error codes; it containsthe text of the messages and the initialization subroutine. Both Cfiles have names derived from that of the original source file, withthe ``.et'' suffix replaced by ``.c'' and ``.h''.

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

BUGS

Since the originalcompile_etuses a very simple parser based onyacc(1),and this current version of compile_etuses an awk/sed combination of scripts, its error recovery leaves much to be desired.