Print this page
cw: don't shadow pure pre-processing
cw(1onbld): --shadow not --secondary
   1 CW(1ONBLD)                    illumos Build Tools                   CW(1ONBLD)
   2 
   3 NAME
   4      cw - invoke one or more compilers with argument translation
   5 
   6 SYNOPSIS
   7      cw [-C] [--versions] [--noecho] --primary compiler
   8         [--shadow compiler ...] -- compiler args ...
   9 
  10 DESCRIPTION
  11      cw is a facility for invoking one or more compilers, providing
  12      translation from Sun style arguments as appropriate.  This allows the use
  13      of arbitrary compilers without the need to alter large numbers of
  14      makefiles.  A mode called shadow compilation invokes multiple compilers
  15      so that warnings and errors may be obtained from both.  See SHADOW
  16      COMPILATION for details.  This version of cw supports compilers with both
  17      Sun Studio 12 and GCC-style command lines.
  18 
  19 ARGUMENTS
  20      Both the --primary and --secondary parameters take a compiler
  21      specification.  This is a comma-separated list of the form
  22      name,executable,style Where name is a name for the compiler, executable
  23      is the full path to the compiler executable, and style is the style of
  24      command-line options the compiler expects, either sun or gnu.
  25 
  26      --primary compiler
  27              Specify the compiler to be used primarily (that which is used for
  28              link-editing and pre-processing, and whos objects we deliver).
  29 
  30      --shadow compiler
  31              Specify a shadow compiler, which builds sources for the sake of
  32              checking code quality and compatibility, but has its output
  33              discarded.
  34 
  35      --noecho
  36              Do not echo the actual command line of any compilers invoked.
  37 
  38      --versions
  39              Request from each configured primary and shadow compiler its
  40              version information.
  41 
  42      -C      The sources being compiled are C++.  This is necessary as it
  43              affects the translation of compiler arguments.
  44 


  47 
  48      -_name=
  49 
  50      -_style=
  51              Parameters intended for the compiler be guarded with options of
  52              the form -_name= and -_style= Where name and style are those
  53              passed to --primary and --shadow this allows certain flags to be
  54              passed only to certain classes of compiler.
  55 
  56              For historical reasons, the -_style= option is also translated
  57              such that a style of sun may use the flag -_cc= and a style of
  58              gnu may use the flag -_gcc=, and when the -C option is given and
  59              C++ is in use the style of sun may use the flag -_CC= and the
  60              style of gnu may use the flag -_g++=.
  61 
  62 SHADOW COMPILATION
  63      If --shadow compilers are specified cw will invoke shadow compiler, with
  64      the outputs modified (as well as any translation for compiler style) as
  65      follows:
  66 
  67      1.   If none of -c, -E, -P, or -S appears in the argument list (that is,
  68           linking is attempted), the shadow compilers will not be invoked.
  69           This is because the objects built with that compiler which would be
  70           linked have been previously discarded.
  71 
  72      2.   If the -o filename option was provided, with or without a separating
  73           space, it will be replaced with -o tempfile
  74 
  75      3.   If the option -o was not provided, -o tempfile will be added to the
  76           end of the argument list used to invoke the shadow compilers.
  77      When shadow compilation is in effect, cw writes to standard error each
  78      compiler's standard error output following its argument list.  Messages
  79      from the compilers will not be interleaved.  If cw is used to invoke the
  80      preprocessor and no output location is specified, cw will write to
  81      standard output the primary compiler's standard output, and the secondary
  82      compiler's standard output will be discarded.
  83 
  84      Because the Sun compilers write intermediate objects to fixed filenames
  85      in the current directory when instructed to compile and link multiple
  86      source files via a single command line, it would be unsafe to invoke more
  87      than one compiler in this fashion.  Therefore cw does not accept multiple
  88      source files unless the preprocessor is to be invoked.  An attempt to
  89      invoke cw in this manner will result in an error.
  90 
  91 ARGUMENT TRANSLATION
  92      If the compiler to be invoked is a GNU-style C or C++ compiler, a set of
  93      default flags is added to the beginning of the argument list, and the
  94      remaining arguments are translated to their closest appropriate semantic
  95      equivalents and passed in the same order as their counterparts given to
  96      cw.  See the comments at the head of usr/src/tools/cw/cw.c for a detailed
  97      list of translations.
  98 
  99 ENVIRONMENT
 100      CW_SHADOW_SERIAL
 101              If this variable is set in the environment, invoke the primary
 102              compiler, wait for it to complete, then invoke the shadow


   1 CW(1ONBLD)                    illumos Build Tools                   CW(1ONBLD)
   2 
   3 NAME
   4      cw - invoke one or more compilers with argument translation
   5 
   6 SYNOPSIS
   7      cw [-C] [--versions] [--noecho] --primary compiler
   8         [--shadow compiler ...] -- compiler args ...
   9 
  10 DESCRIPTION
  11      cw is a facility for invoking one or more compilers, providing
  12      translation from Sun style arguments as appropriate.  This allows the use
  13      of arbitrary compilers without the need to alter large numbers of
  14      makefiles.  A mode called shadow compilation invokes multiple compilers
  15      so that warnings and errors may be obtained from both.  See SHADOW
  16      COMPILATION for details.  This version of cw supports compilers with both
  17      Sun Studio 12 and GCC-style command lines.
  18 
  19 ARGUMENTS
  20      Both the --primary and --shadow parameters take a compiler specification.
  21      This is a comma-separated list of the form name,executable,style Where
  22      name is a name for the compiler, executable is the full path to the
  23      compiler executable, and style is the style of command-line options the
  24      compiler expects, either sun or gnu.
  25 
  26      --primary compiler
  27              Specify the compiler to be used primarily (that which is used for
  28              link-editing and pre-processing, and whos objects we deliver).
  29 
  30      --shadow compiler
  31              Specify a shadow compiler, which builds sources for the sake of
  32              checking code quality and compatibility, but has its output
  33              discarded.
  34 
  35      --noecho
  36              Do not echo the actual command line of any compilers invoked.
  37 
  38      --versions
  39              Request from each configured primary and shadow compiler its
  40              version information.
  41 
  42      -C      The sources being compiled are C++.  This is necessary as it
  43              affects the translation of compiler arguments.
  44 


  47 
  48      -_name=
  49 
  50      -_style=
  51              Parameters intended for the compiler be guarded with options of
  52              the form -_name= and -_style= Where name and style are those
  53              passed to --primary and --shadow this allows certain flags to be
  54              passed only to certain classes of compiler.
  55 
  56              For historical reasons, the -_style= option is also translated
  57              such that a style of sun may use the flag -_cc= and a style of
  58              gnu may use the flag -_gcc=, and when the -C option is given and
  59              C++ is in use the style of sun may use the flag -_CC= and the
  60              style of gnu may use the flag -_g++=.
  61 
  62 SHADOW COMPILATION
  63      If --shadow compilers are specified cw will invoke shadow compiler, with
  64      the outputs modified (as well as any translation for compiler style) as
  65      follows:
  66 
  67      1.   If neither of -c, -S appears in the argument list (that is, linking
  68           is attempted or only the pre-processor is invoked), the shadow
  69           compilers will not be invoked.

  70 
  71      2.   If the -o filename option was provided, with or without a separating
  72           space, it will be replaced with -o tempfile
  73 
  74      3.   If the option -o was not provided, -o tempfile will be added to the
  75           end of the argument list used to invoke the shadow compilers.
  76      When shadow compilation is in effect, cw writes to standard error each
  77      compiler's standard error output following its argument list.  Messages
  78      from the compilers will not be interleaved.  If cw is used to invoke the
  79      preprocessor and no output location is specified, cw will write to
  80      standard output the primary compiler's standard output.

  81 
  82      Because the Sun compilers write intermediate objects to fixed filenames
  83      in the current directory when instructed to compile and link multiple
  84      source files via a single command line, it would be unsafe to invoke more
  85      than one compiler in this fashion.  Therefore cw does not accept multiple
  86      source files unless the preprocessor is to be invoked.  An attempt to
  87      invoke cw in this manner will result in an error.
  88 
  89 ARGUMENT TRANSLATION
  90      If the compiler to be invoked is a GNU-style C or C++ compiler, a set of
  91      default flags is added to the beginning of the argument list, and the
  92      remaining arguments are translated to their closest appropriate semantic
  93      equivalents and passed in the same order as their counterparts given to
  94      cw.  See the comments at the head of usr/src/tools/cw/cw.c for a detailed
  95      list of translations.
  96 
  97 ENVIRONMENT
  98      CW_SHADOW_SERIAL
  99              If this variable is set in the environment, invoke the primary
 100              compiler, wait for it to complete, then invoke the shadow