XL C Compiler  Version 1.3.0.4
 
  Usage:
     cc   [ option | file ]...
     xlc  [ option | file ]...
     c89  [ option | file ]...
 
  Description:
     The cc, xlc, and c89 commands compile XL C source files. These
     commands are the same except for the default language level.
     For cc the default language level is "extended". For xlc and
     c89 the default language level is "ansi". These commands also
     process assembler source files and object files. Unless the -c
     option is specified, these commands call the linkage editor to
     produce a single object file. Input files can be any of the following:
       1. file name with .c suffix: C source file
       2. file name with .i suffix: preprocessed C source file
       3. file name with .o suffix: object file for ld command
       4. file name with .s suffix: assembler source file
 
 
  Options:
     Options can be one or  more of the following:
 
       1. flag options:
 
        -#        Display verbose information on the compiler's progress
                  without invoking anything
        -B[<prefix>]
                  Construct alternate compiler/assembler/linkage editor
                  program names. <prefix> is added to the beginning of
                  the standard program names.
        -c        Compile only; do not call ld.
        -C        Write comments to output when doing preprocessing,
                  used with -E and -P.
        -D<name>[=<def>]
                  Define <name> as in #define directive. If <def> is
                  not specified, 1 is assumed.
        -E        Preprocess but do not compile; output to stdout
        -F<x>[:<stanza>]
                  Use alternate configuration file <x> with optional
                  <stanza>. If <stanza> is not specified, xlc is
                  assumed.
        -g        Produce debug information.
        -I<dir>   Search in directory <dir> for include files that
                  do not start with an absolute path.
        -l<key>   Search the specified library file,
                  where <key> selects the file lib<key>.a.
        -L<dir>   Search in directory <dir> for files specified by -l<key>.
        -ma       Substitute inline code for calls to function alloca
                  without specifying the #pragma alloca directive
                  in the source code.
        -M        Create an output file suitable for inclusion in a
                  description file for the UNIX make command.
        -o<name>  When used with -c, names the .o file <name>, otherwise names
                  the executable file <name> instead of a.out. 
        -O        Optimize generated code. 
        -O2       Equivalent level of optimization as -O in the 
                  previous release.
        -O3       Perform some memory and compile time intensive
                  optimizations in addition to those executed with -O2.
                  The -O3 specific optimizations have the potential to 
                  alter the semantics of a user's program.
                  The compiler guards against these optimizations at -O2
                  and the option -qstrict is provided at -O3 to turn off
                  these aggressive optimizations.
        -p        Generate simple profiling support code.
        -pg       Generate profiling support code.  Provides more extensive
                  profiling than -p.
        -P        Preprocess but do not compile; output to .i file
        -Q[<x>]   Inline all appropriate functions where optional <x> can be
                  one of the following:
                    !       Not inline any function
                    =<lc>   Inline if number of source statement in
                            function is less than the number specified
                            in <lc>.
                    -<nm>   Not inline function listed by names in <nm>
                    +<nm>   Attempt to inline function listed by names
                            in <nm>.
        -r        Permit the output file to be produced even if it contains
                  unresolved symbols.
        -S        Produce a .s file for any source file processed by the
                  compiler.
        -t<x>     Apply prefix from the -B option to the specified program <x>,
                  where x can be one or more of the following:
                    p = preprocessor
                    c = compiler
                    a = assembler
                    l = linkage editor.
        -U<name>  Undefine name as in #undef directive.
        -v        Display verbose information on the compiler's progress.
        -w        Suppress informational, language-level, and warning messages.
        -Wprogram,options
                  Pass the listed options to the specified program.
        -y<x>     Specify compile-time rounding of constant floating-point
                  expressions, where <x> can be one of the following:
                    n = round to nearest
                    m = round toward minus infinity
                    p = round toward positive infinity
                    z = round toward zero.
 
       2. other options:
 
          Other options are specified as follows:
 
          -q<option>
 
            where <option> is an on/off switch such that, if x is the
            option, -qx turns the option on, and -qnox turns the
            option off.  For example, -qsource tells the compiler
            to produce a source listing, and -qnosource tells the compiler
            not to produce a source listing.
 
            The following override the initial compiler settings:
 
            ansialias   Specify type-based aliasing to be used during
                        optimization.
            attr        Produce attribute listing (only referenced names).
            check       Produce code that checks for runtime exceptions.
            compact     Reduce code size where possible, at the expense
                        of execution speed.  Code size is reduced by
                        inhibiting optimizations that replicate or expand
                        code inline.
            cpluscmt    Permit "//" to introduce a comment that lasts
                        until the end of the current source line, as in C++.
            dbcs        Same as option -qmbcs.  Use option -qmbcs
                        in your new applications.
            dbxextra    Generate symbol table information for unreferenced
                        variables. By default such information is not generated
                        thus reducing the size of the executable compiled with
                        the "-g" option.
            extchk      Generate information for bind-time type checking.
            idirfirst   Specify the search order for files included with
                        the #include "file_name" directive.  Use -qidirfirst
                        with the -Idirectory option.  If the -qidirfirst option
                        is specified, the directories specified by the 
                        -Idirectory option are searched before the directory
                        where the current file resides.
            inlglue     Generate fast external linkage by inlining the
                        code (pointer glue code) necessary at calls
                        via a function pointer and calls to external 
                        procedures.
            list        Produce object listing.
            listopt     Print settings of all options in listing.
            mbcs        String literal and comments can contain MBCS
                        characters.
            noprint     Direct listing to /dev/null.
            nostdinc    Specify whether directory /usr/include should be
                        searched for include files.  If -qnostdinc is specified,
                        the /usr/include directory is not searched.
            optimize    Same as -O or -O2.
            phsinfo     Display phase information on the screen.
            proto       Assert  that procedure call points agree with their
                        declarations even if the procedure has not been
                        prototyped. This allows the caller to pass floating
                        point arguments in floating point registers instead
                        of general purpose registers. 
            ro          Place string literals in read only area. This option
                        is the default for xlc.
            roconst     Place static external and global identifiers that 
                        are const qualified in the read only area.
            source      Produce source listing.
            spnans      Generate extra instructions to detect signalling NaN
                        on conversion from single precision to double precision.
            srcmsg      Specify that source lines to be displayed with
                        the message with pointers to the column position
                        of the error.
            statsym     Add user defined nonexternal names that have
                        static storage class to the name list
                        (the symbol table of xcoff objects).
            strict      Valid only at -O3.  This option turns off aggressive
                        optimizations which have the potential to alter
                        the semantics of a user's program. This option also
                        sets -qfloat=nofltint:norsqrt.
            xcall       Generate code to static routines within a compilation
                        unit as if they were external routines.
            xref        Produce cross-reference listing (only referenced names).
 
          -q<option>=<suboption>
          -q<option>=<suboption1>:<suboption2>:...:<suboptionN>
 
            where <option> is assigned a specific suboption value or list
            of suboption values as follows:
 
            align=<algnopt>
                        Specify one of the following three alignment rules:
                        - POWER architecture (align=power, default)
                        - two byte alignment (align=twobyte) 
                        - one byte alignment (align=packed)
                        for aligning C structs and unions. <algnopt> can be 
                        one of: power, twobyte, or packed.
            arch=<option>
                        Specifies the architecture on which the executable
                        program will be run.
                        The available options are:
                        com     Produce an object that contains instructions
                                that will run on all the POWER and PowerPC
                                hardware platforms.
                        pwr     Produce an object that contains instructions
                                that will run on the POWER hardware
                                platform.
                        pwr2    Produce an object that contains instructions
                                that will run on the POWER2 hardware
                                platform.
                        pwrx    Same as pwr2.
                        ppc     Produce an object that contains instructions
                                that will run on any of the 32-bit PowerPC
                                hardware platforms.
                        The default is -qarch=com.  If the -qarch option is
                        specified without the -qtune=<option>, the compiler
                        uses -qtune=pwr.
            attr=full   Produce attribute listing
                        (all names, whether referenced or not).
            chars=<sign_type>
                        Specify the sign type of data type char.
                        <sign_type> can be either signed or unsigned.
                        unsigned is the default.
            enum=<enumopt>
                        Specify whether minimum-sized enumerated types will be
                        produced or not. <enumopt> can be either small or int.
                        small denotes that either one, two or four bytes of
                        storage will be allocated for enum variables based on
                        the range of the enum constants.
                        int is the default, and causes enum variables to be
                        treated as though they were of type (signed) int.
            flag=<sev1>:<sev2>
                        Specify severity level of diagnostics to be reported
                        in listing, <sev1>, and on screen, <sev2>.
            float=<opt1>:<opt2>:...:<optN>
                        The available options are:
                        rndsngl  Ensure strict adherence to IEEE standard.
                                 all operations on single-precision values
                                 produce results that remain in single
                                 precision.
                        hssngl   Round single-precision expressions only
                                 when the results are stored into REAL*4 memory
                                 locations.
                        nans     Detect conversion of single-precision NaNS to
                                 double precision call checking. 
                        hsflt    Never round single-precision expressions,
                                 and don't perform range checking for
                                 floating-point to integer conversions.
                        nomaf    Suppress generation of multiply-add
                                 instructions. 
                        nofold   Suppress compile-time evaluation of constant
                                 floating-point expressions.
                        rrm      Specify run-time rounding mode. Compile with
                                 this option if the run-time rounding mode
                                 is round toward minus infinity, round toward
                                 positive infinity, or not known.
                        rsqrt    Specify whether a division by the result of a
                                 square root can be replaced with a multiply
                                 by the reciprocal of the square root.
                                 Default at -O2: -qfloat=norsqrt.
                                 Default at -O3: -qfloat=rsqrt.
                        fltint   Specify whether range checking of floating
                                 point to integer conversions is done.
                                 Default at -O2: -qfloat=nofltint.
                                 Default at -O3: -qfloat=fltint.
            flttrap=<opt1>:<opt2>:...:<optN>
                        Generate instructions to detect and trap floating-point.
                        The available options are:  overflow, underflow,
                        zerodivide, invalid, inexact, enable, imprecise.
            halt=<sev>  Stop compiler after first phase if severity of errors
                        detected equals or exceeds <sev>.
            ignprag=<pragval>
                        Specify the aliasing pragmas to be ignored. Used
                        with #pragma disjoint and #pragma isolated_call.
                        <pragval> can be disjoint, isolated, or all.
            initauto=<hh>
                        Initialize automatic storage to <hh>. <hh> is a
                        hexadecimal value.  This generates extra code and
                        should only be used for error determination.
            isolated_call=<name1>:<name2>: ...
                        Specify that the calls to the functions listed have no
                        side effects. <name1> and <name2> are function names.
                        The user may specify as many function names as
                        necessary.
            langlvl=<langlvl>
                        Specify language level to be used during compilation.
                        <langlvl> can be ansi, saal2, saa, or extended.
            maxmem=<num>
                        Limit the amount of memory used by space intensive
                        optimizations to <num>.  <num> specified in kilobytes.
            optimize=2  Same as -O or -O2.
            optimize=3  Same as -O3.
            pgmsize=<p>
                        Set initial table size used by the compiler. <p>
                        can be s, for small; or l for large.
            proclocal=<name1>:<name2>: ...
                        Specify which functions are local.
                        If no filenames are specified, all invoked functions 
                        are assumed to be defined within the current file.
                        The last explicit specification for a function takes
                        precedence.
            procimported=<name1>:<name2>: ...
                        Specify which functions are imported.  If no filenames
                        are specified, all invoked functions are assumed to be 
                        defined outside the current file.  The last explicit
                        specification for a function takes precedence.
            procunknown=<name1>:<name2>: ...
                        Specify which functions are unknown to be local or
                        imported.  If no filenames are specified, all functions
                        called are assumed to be unknown. This is the default
                        when no user options are specified. The last explicit
                        specification for a function takes precedence.
            spill=<size>
                        Specify the size of the register allocation spill
                        area.
            tune=<option>
                        Specifies the architecture system for which the
                        executable program is optimized.
                        The available options are:
                        601    Produce an object optimized for all the
                               PowerPC601 processors.
                        pwr    Produce an object optimized for the POWER
                               hardware platform.
                        pwr2   Produce an object optimized for the 
                               POWER2 hardware platform.
                        pwrx   Same as pwr2.
                         
            xref=full   Produce cross-reference listing
                        (all names, whether referenced or not).
 
     For a detailed description of each option, please refer to the User's
     Guide.