Name

ic − compiler for language support database

Syntax

ic [ −D name=def ] [ −U name ] [ −I dir ] [ −v ] [ −o output ] [ source ]

Description

The command ic generates a binary international database from a database language source file. The command either accepts its input from the file source or from the standard input, if you do not specify source . 

The name of the output file is the name of the codeset in the source file or the name you specify using the −o option.

For information on creating a database language source file, see the Guide to Developing International Software. 

Options

−DDefines name to the C preprocessor.  This option has the same effect as including the #define name directive at the head of your source file. The default name definition is 1. 

−URemoves any initial preprocessor definition of name . 

−ICauses the ic compiler to search the named directory for files you name in an #include directive.

−oSpecifies the name you want ic to use for the output file.  By default, the compiler uses the name of the codeset in the source file to name the output file.

−vRequests statistics on the number of simple and double letters in the source file, the number of tables in the source file, and the size of the output binary file. 

Restrictions

The length of the table name modifier is limited to 44 characters. 

Examples

The following command causes the ic compiler to compile the GER_CH.8859.in source file:

% ic −v GER_CH.8859.in
INTLINFO database GER_CH.8859:
257 code table entries (256 simple/1 multi-byte).
   1 property table(s).
   1 collation table(s).
   1 string table(s).
   3 conversion tables: toascii, tolower, toupper.
5051 bytes total length.

The ic compiler searches for the GER_CH.8859.in file in the current working directory. The compiler writes compilation statistics to stderr, as requested by the −v option.  The compiler creates a binary file, named GER_CH.8859, in the current working directory.

Return Values

The ic compiler returns zero exit status for successful compilation; it returns nonzero status if it encounters errors that inhibit generation of a binary file.

Diagnostics

The ic compiler issues four types of messages.  The following list describes each of the four types:

warning The compiler has detected syntax that may be in error, but does not adversely effect the binary file. 

error nn The compiler has detected an error severe enough to inhibit the generation of a correct binary file. 

fatal error The compiler has detected an error that makes it impossible to proceed with the compilation.  This error most often occurs during compilation of the code table. 

fatal bug This occurs when there are internal errors in the compiler.  For example, this is generally produced when an incompatible source file is given as an input to ic.

Files

/tmp/icXXXXXX Temporary files

/lib/cpp C preprocessor

See Also

intro(3int), setlocale (3), environ (5int), lang (5int), nl_langinfo(5int)
Guide to Developing International Software