1997-04-26 17:21:57 +04:00
|
|
|
.\" Copyright (c) 1988 Massachusetts Institute of Technology,
|
|
|
|
.\" Student Information Processing Board. All rights reserved.
|
|
|
|
.\"
|
|
|
|
.\" $Header$
|
|
|
|
.\"
|
ChangeLog, Makefile.in:
Remove libext2fs.info*, not just libext2fs.info*.gz. Add an
uninstall-doc-libs target.
ChangeLog, Makefile.in, compile_et.1, compile_et.sh.in:
Makefile.in: Fix bug where my_dir was set incorrectly. Install the
et_c.awk and et_h.awk files in $(datadir)/et (i.e., /usr/share/et)
directory. Change to use new installation directory variables
convention. Fix uninstall rules to take $(DESTDIR) into account.
compile_et.1: Change man page to reflect the fact that compile_et is
now a awk/sed script, not a yacc script.
compile_et.sh.in: Look in $(datadir)/et for et_c.awk and et_h.awk; if
not found, look in the build directory. Add error checking for
non-existent input file.
ChangeLog, Makefile.in, mk_cmds.sh.in:
Makefile.in: Install the ct_c.awk and ct_c.sed files in $(datadir)/ss
(i.e., /usr/share/ss) directory. Change to use new installation
directory variables convention. Fix uninstall rules to take
$(DESTDIR) into account.
mk_cmds.sh.in: Look in $(datadir)/ss for ct_c.awk and ct_c.sed; if not
found, look in the build directory. Add error checking for
non-existent input file.
ChangeLog, Makefile.in:
Makefile.in: Change to use new installation directory variables
convention. Fix uninstall rules to take $(DESTDIR) into account.
1998-04-01 06:18:45 +04:00
|
|
|
.TH COMPILE_ET 1 "30 Mar 1998" SIPB
|
1997-04-26 17:21:57 +04:00
|
|
|
.SH NAME
|
|
|
|
compile_et \- error table compiler
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B compile_et
|
|
|
|
file
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.B Compile_et
|
|
|
|
converts a table listing error-code names and associated messages into
|
|
|
|
a C source file suitable for use with the
|
|
|
|
.IR 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 error-code table:
|
|
|
|
|
|
|
|
.B error_table
|
|
|
|
.I name
|
|
|
|
|
|
|
|
followed by up to 256 entries of the form:
|
|
|
|
|
|
|
|
.B error_code
|
|
|
|
.I name,
|
|
|
|
"
|
|
|
|
.I string
|
|
|
|
"
|
|
|
|
|
|
|
|
and a final
|
|
|
|
|
|
|
|
.B end
|
|
|
|
|
|
|
|
to indicate the end of the table.
|
|
|
|
|
|
|
|
The name of the table is used to construct the name of a subroutine
|
|
|
|
.I initialize_XXXX_error_table
|
|
|
|
which must be called in order for the
|
|
|
|
.I com_err
|
|
|
|
library to recognize the error table.
|
|
|
|
|
|
|
|
The various error codes defined are assigned sequentially increasing
|
|
|
|
numbers (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
|
|
|
|
preprocessor 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 replaced by ``.c'' and ``.h''.
|
|
|
|
|
|
|
|
A ``#'' in the source file is treated as a comment character, and all
|
|
|
|
remaining text to the end of the source line will be ignored.
|
|
|
|
|
|
|
|
.SH BUGS
|
|
|
|
|
ChangeLog, Makefile.in:
Remove libext2fs.info*, not just libext2fs.info*.gz. Add an
uninstall-doc-libs target.
ChangeLog, Makefile.in, compile_et.1, compile_et.sh.in:
Makefile.in: Fix bug where my_dir was set incorrectly. Install the
et_c.awk and et_h.awk files in $(datadir)/et (i.e., /usr/share/et)
directory. Change to use new installation directory variables
convention. Fix uninstall rules to take $(DESTDIR) into account.
compile_et.1: Change man page to reflect the fact that compile_et is
now a awk/sed script, not a yacc script.
compile_et.sh.in: Look in $(datadir)/et for et_c.awk and et_h.awk; if
not found, look in the build directory. Add error checking for
non-existent input file.
ChangeLog, Makefile.in, mk_cmds.sh.in:
Makefile.in: Install the ct_c.awk and ct_c.sed files in $(datadir)/ss
(i.e., /usr/share/ss) directory. Change to use new installation
directory variables convention. Fix uninstall rules to take
$(DESTDIR) into account.
mk_cmds.sh.in: Look in $(datadir)/ss for ct_c.awk and ct_c.sed; if not
found, look in the build directory. Add error checking for
non-existent input file.
ChangeLog, Makefile.in:
Makefile.in: Change to use new installation directory variables
convention. Fix uninstall rules to take $(DESTDIR) into account.
1998-04-01 06:18:45 +04:00
|
|
|
Since the original
|
1997-04-26 17:21:57 +04:00
|
|
|
.B compile_et
|
|
|
|
uses a very simple parser based on
|
2000-12-05 02:49:07 +03:00
|
|
|
.IR yacc (1),
|
|
|
|
and this current version of
|
ChangeLog, Makefile.in:
Remove libext2fs.info*, not just libext2fs.info*.gz. Add an
uninstall-doc-libs target.
ChangeLog, Makefile.in, compile_et.1, compile_et.sh.in:
Makefile.in: Fix bug where my_dir was set incorrectly. Install the
et_c.awk and et_h.awk files in $(datadir)/et (i.e., /usr/share/et)
directory. Change to use new installation directory variables
convention. Fix uninstall rules to take $(DESTDIR) into account.
compile_et.1: Change man page to reflect the fact that compile_et is
now a awk/sed script, not a yacc script.
compile_et.sh.in: Look in $(datadir)/et for et_c.awk and et_h.awk; if
not found, look in the build directory. Add error checking for
non-existent input file.
ChangeLog, Makefile.in, mk_cmds.sh.in:
Makefile.in: Install the ct_c.awk and ct_c.sed files in $(datadir)/ss
(i.e., /usr/share/ss) directory. Change to use new installation
directory variables convention. Fix uninstall rules to take
$(DESTDIR) into account.
mk_cmds.sh.in: Look in $(datadir)/ss for ct_c.awk and ct_c.sed; if not
found, look in the build directory. Add error checking for
non-existent input file.
ChangeLog, Makefile.in:
Makefile.in: Change to use new installation directory variables
convention. Fix uninstall rules to take $(DESTDIR) into account.
1998-04-01 06:18:45 +04:00
|
|
|
.B compile_et
|
|
|
|
uses an awk/sed combination of scripts,
|
1997-04-26 17:21:57 +04:00
|
|
|
its error recovery leaves much to be desired.
|
|
|
|
|
|
|
|
.\" .IR for manual entries
|
|
|
|
.\" .PP for paragraph breaks
|
|
|
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
com_err (3).
|
|
|
|
|
|
|
|
Ken Raeburn, "A Common Error Description Library for UNIX".
|