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.
57 The B<-p> <I<prefix>> option is a synonym for B<-prefix> <I<prefix>>.
59 =item B<-v> <I<version>>
61 Specified the type of output file: valid values are 1 (the default, for C
62 files) or 2, for B<.msf> file generation.
68 The following command generates the files F<pterror.h> and F<pterror.c>,
69 suitable for use with C programs:
71 % afs_compile_et -p path/to/src/ptserver pterror
73 The following command generates K&R style files instead:
75 % afs_compile_et -p path/to/src/ptserver -lang 'k&r-c' pterror
83 Copyright 2009 Steven Jenkins <steven@endpoint.com>
85 This documentation is covered by the IBM Public License Version 1.0. This
86 man page was written by Steven Jenkins for OpenAFS.