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)