Next: , Up: IDL-to-Ada compiler


6.3.1 Usage of iac

iac is PolyORB's new IDL-to-Ada compiler. It supports many command line parameters to control code generation optimizations such as use of static hashing for deterministic request dispatching, and optimized GIOP marshalling for CORBA applications.

     
     
     
     NAME
            iac - PolyORB's IDL-to-Ada compiler
     
     SYNOPSIS
            iac [options] file [-cppargs args...]
     
     DESCRIPTION
            iac is an IDL-to-Ada compiler, compliant with version 1.2 of the
            ``Ada Language Mapping Specification'' produced by the OMG.
     
     OPTIONS
            iac accepts the following options:
     
     
     
     
       -h       Print this help message, and do nothing else
     
       file is the name of the .idl file (.idl suffix optional)
     
       -E       Preprocess only
       -k       Keep temporary files
       -o DIR   Output directory (DIR must exist)
       -p       Produce source on standard output
       -q       Quiet mode
     
       -dm      Generate debug messages when analyzing scopes
     
       -df      Dump the frontend tree (the IDL tree)
     
       -cppargs Pass arguments to the C++ preprocessor
       -I <dir> Shortcut -cppargs -I directory. Use this flag
                for the imported entities
       -nocpp   Do not preprocess input
     
       -gnatW8  Use UTF-8 character encoding in Ada output.
                (Default is Latin-1.)
     
       -<lang>  Generate code for one of the following languages:
     
        types   Generate a list of all types present in the IDL file
                -p       Print the list generated
     
        ada     (default) Generate Ada source code
                -i       Generate implementation packages
                -c       Generate code for client side only
                -s       Generate code for server side only
                -d       Generate delegation package (defunct)
                -ir      Generate code for interface repository
                -noir    Do not generate code for interface repository (default)
                -hc      Minimize CPU time in perfect hash tables in skels
                -hm      Minimize memory use in perfect hash tables in skels
                         This is the default.
                -rs      Use the SII/SSI to handle requests
                -rd      Use the DII/DSI to handle requests (default)
                -da      Dump the Ada tree
                -db      Generate only the package bodies
                -ds      Generate only the package specs
                -dw      Output the withed entities
                -dt      Output tree warnings
                -di      Generate code for imported entities
     
        idl     Dump parsed IDL file
                -b n     Base to output integer literals
                         As a default (zero) use base from input
                -e       Expand IDL Tree
                -df      Dump IDL Tree (may be used in conjunction with -e
                         to dump the expanded IDL tree)
                -di      Output IDL code of imported entities  (may be
                         used in conjunction with -e to output the
                         expanded IDL code)
     
     EXIT STATUS
            iac returns one of the following values upon exit:
     
            0      Successful completion
     
            1      Usage error
     
            2      Illegal IDL specification
     

iac creates several files :