# empcc

    EMPCC(1)                                                              EMPCC(1)

    NAME
           empcc - compile C programs invoking the EMPRESS Libraries

    SYNOPSIS
           empcc [empcc_options] [cc_options] file ...

    DESCRIPTION
           This   command   invokes   cc   and  searches  the  EMPRESS  libraries.
           Empcc_options are:

           -ansi_c                       Use Strict Ansi C compiler (the Version 8
                                         default will use Ansi C but not necessary
                                         Strict Ansi C)

           -c_compiler compiler_name     Invokes a C compiler different  than  the
                                         default  one specified in MSSYS_CCOMPILER
                                         of $EMPRESSPATH/config/options file.

           -echoline                     Print out the contents of the  executable
                                         without generating an output file.

           -footprint=small              Use  small  size  Empress libraries to do
                                         linking. Generated executable cannot  use
                                         certain   Empress   features   such   as:
                                         database  roles,   PSM,   DDL   commands,
                                         unique/distinct,   expressions,  database
                                         logging and audit  trail,  shared  memory
                                         global  buffers, replication, views, dis-
                                         tributed server and complex retrievals.

           -listlines                    Print out the contents of the  executable
                                         in  multiple  lines without generating an
                                         output file.

           -linker filename              Use the given filename to do linking  and
                                         do not compile.

           -noglobmain                   Use  this  option  if msmain is not used.
                                         Some compiler complains if this option is
                                         not used.

           -noshlib  [-loadpsmapi]        Do  not  use  Empress shared library. If
                                         additional  option  loadpsmapi  is  used,
                                         load those extra Empress static libraries
                                         needed  for  Persistant  Stored   Modules
                                         (PSM).

           -sptrash                      Trash the memory space when the memory is
                                         free. This option can be used as  a  tool
                                         to  debug  memory problem. Empress shared
                                         libraries will not be used if this option
                                         is specified.

           -pthread                      Generates  thread-safe  code for  program
                                         that  is  written  for     the     multi-
                                         threaded  application.  This  means  that
                                         Empress  routines   can   be invoked   in
                                         a  multi-threaded  application.  This  is
                                         done by multiple  threads  in paral- lel;
                                         however  their execution is   serialized.
                                         The   net effect is the same  as  running
                                         in  a  single threaded environment.   The
                                         multi-threaded   application   has    the
                                         responsibility    for   using these  rou-
                                         tines  in   a   safe  manner   regardless
                                         whether these routines are safe.

           -spmalloc                     Use  malloc  to allocate space instead of
                                         Empress' memory  manager.  It  is  useful
                                         when  a  third-party  memory  debugger is
                                         used.   Usually,  it   is   slower   than
                                         Empress' memory manager.

    FILES
           EMPRESS libraries

    SEE ALSO
           cc(1)

           Empress Host Language: Command Language Interface

           Empress Host Language: C Interface - mx Routines

           Empress Host Language: C Kernel Level Interface - mr Routines

    DIAGNOSTICS
           See cc(1).

    HISTORY
           Written  by  Empress  Software  Inc..   All material is copyrighted and
           licensed.  Use on non-licensed CPUs is prohibited.

    Empress 8.62                 Empress Software Inc.                    EMPCC(1)