compile_et - phpMan

COMPILE_ET(1)                                                    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 messages 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 dec-
       laration supplying the name (up to four characters long) of the error-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 initial-
       ize_XXXX_error_table which must be called in order for the com_err library to  rec-
       ognize 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  ta-
       ble);  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  mes-
       sages 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.


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)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-08 04:17 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)