NAME

       afs_compile_et - Produce error text tables for compilation

SYNOPSIS

       afs_compile_et [-debug] [-language <lang>]
           [-prefix <prefix>] [-v <version>]
           [-h <include>] <[-emit <output>]
           error_table>

DESCRIPTION

       The afs_compile_et command builds the error text tables for compilation.  This includes
       both a header file that contains a set of mappings between error names and values and a .c
       (or .msf) file that provides a text table of descriptions.

       The <error_table> argument specifies which error table to generate.  The error table
       specification should exist in the current working directory or in the directory specified
       with -prefix and should be named error_table.et.

       By default, afs_compile_et generates two files in one invocation. This is problematic for
       parallel build systems. The -emit option may be used to generate the output files
       independently with two separate invocations of afs_compile_et for a given error table.
       This allows parallel build systems to generate the source and header files, and the
       targets which depend on the generated source and headers files, in parallel.

CAUTIONS

       This command is used internally within the build process for OpenAFS.  Most users will
       access this information via translate_et(1) rather than via afs_compile_et.

       This command does not use the standard AFS command-line parsing package.

OPTIONS

       -debug
           Does nothing.  It neither adds debugging information to the output nor provides
           additional information on its operation.

       -language <lang>
           Specifies the type of output to generate.  Currently, only ANSI C and K&R are
           supported values (via the c and k&r-c values, respectively).  The default is ANSI C.
           There is some support for C++ started, but that is not yet supported.

           The -lang <lang> option is a synonym for -language <lang>>.

       -prefix <prefix>
           Specifies the directory to search for the error_table.et file. Specifies the directory
           to search for the prolog file when the -h option is given.  The -p <prefix> option is
           a synonym for -prefix <prefix>.

       -h <include>
           Specifies an input file, called a prolog file, and modifies the name of the header
           file generated by afs_compile_et.

           When the -h option is given, afs_compile_et will search for a prolog file named
           <include>.p.h.  afs_compile_et will search the current working directory for the
           prolog file, unless the -p option is given.  If the prolog file is found,
           afs_compile_et will place a verbatim copy of the prolog file contents into the
           generated header file.

           When the -h option is given, the name of the header file generated by afs_compile_et
           is <include>.h, instead of <error_table>.h.

           The -h option does not affect the source file generated by afs_compile_et.

       -v <version>
           Specified the type of output file: valid values are 1 (the default, for C files) or 2,
           for .msf file generation.

       -emit <output>
           Specifies which program file to generate; the header file or the source file.  Specify
           -emit header (or -emit h) to generate the .h header file.  Specify -emit source (or
           -emit c) to generate the .c (or .msf) source file.

EXAMPLES

       The following command generates the files pterror.h and pterror.c, suitable for use with C
       programs:

          % afs_compile_et -p path/to/src/ptserver pterror

       The following command generates K&R style files instead:

          % afs_compile_et -p path/to/src/ptserver -lang 'k&r-c' pterror

       The following command generates the pterror.h file, but not the pterror.c file.

          % afs_compile_et -p path/to/src/ptserver -emit header pterror

       The following command generates the pterror.c file, but not the pterror.h file.

          % afs_compile_et -p path/to/src/ptserver -emit source pterror

SEE ALSO

       translate_et(1)

COPYRIGHT

       Copyright 2009 Steven Jenkins <steven@endpoint.com>

       This documentation is covered by the IBM Public License Version 1.0.  This man page was
       written by Steven Jenkins for OpenAFS.