3 afs_compile_et - Produce error text tables for compilation
10 B<afs_compile_et> [B<-debug>] S<<< [B<-language> <I<lang>>] >>>
11 S<<< [B<-prefix> <I<prefix>>] >>> S<<< [B<-v> <I<version>>] >>> <I<error_table>>
18 The B<afs_compile_et> command builds the error text tables for compilation.
19 This includes both a header file that contains a set of mappings between
20 error names and values and a F<.c> (or F<.msf>) file that provides a text
21 table of descriptions.
23 The <I<error_table>> argument specifies which error table to generate.
24 The error table specification should exist in the current working
25 directory or in the directory specified with B<-prefix> and should be
26 named F<error_table.et>.
30 This command is used internally within the build process for OpenAFS.
31 Most users will access this information via L<translate_et(1)> rather than
32 via B<afs_compile_et>.
34 This command does not use the standard AFS command-line parsing package.
42 Does nothing. It neither adds debugging information to the output nor
43 provides additional information on its operation.
45 =item B<-language> <I<lang>>
47 Specifies the type of output to generate. Currently, only ANSI C and K&R
48 are supported values (via the B<c> and B<k&r-c> values, respectively).
49 The default is ANSI C. There is some support for C++ started, but that is
52 The B<-lang> <I<lang>> option is a synonym for B<-language> <I<lang>>>.
54 =item B<-prefix> <I<prefix>>
56 Specifies the directory to search for the F<error_table.et> file.
58 =item B<-v> <I<version>>
60 Specified the type of output file: valid values are 1 (the default, for C
61 files) or 2, for B<.msf> file generation.
67 The following command generates the files F<pterror.h> and F<pterror.c>,
68 suitable for use with C programs:
70 % afs_compile_et -p path/to/src/ptserver pterror
72 The following command generates K&R style files instead:
74 % afs_compile_et -p path/to/src/ptserver -lang 'k&r-c' pterror
82 Copyright 2009 Steven Jenkins <steven@endpoint.com>
84 This documentation is covered by the IBM Public License Version 1.0. This
85 man page was written by Steven Jenkins for OpenAFS.