Print this page
11461 should use a native link-editor during the build
11463 SUNWonld has passed its use-by date
11464 cmd/sgs/tools should contain tools, not common code
11465 sgsmsg should be built with the rest of the build tools

Split Close
Expand all
Collapse all
          --- old/usr/src/tools/cw/cw.1onbld.man.txt
          +++ new/usr/src/tools/cw/cw.1onbld.man.txt
   1    1  CW(1ONBLD)                    illumos Build Tools                   CW(1ONBLD)
   2    2  
   3    3  NAME
   4    4       cw - invoke one or more compilers with argument translation
   5    5  
   6    6  SYNOPSIS
   7    7       cw [-C] [--versions] [--noecho] --primary compiler
   8      -        [--shadow compiler ...] -- compiler args ...
        8 +        [--shadow compiler ...] [--linker linker] -- compiler args ...
   9    9  
  10   10  DESCRIPTION
  11   11       cw is a facility for invoking one or more compilers, providing
  12   12       translation from Sun style arguments as appropriate.  This allows the use
  13   13       of arbitrary compilers without the need to alter large numbers of
  14   14       makefiles.  A mode called shadow compilation invokes multiple compilers
  15   15       so that warnings and errors may be obtained from all of them.  See SHADOW
  16   16       COMPILATION for details.  This version of cw supports compilers with both
  17   17       Sun Studio 12 and GCC-style command lines.
  18   18  
↓ open down ↓ 6 lines elided ↑ open up ↑
  25   25  
  26   26       --primary compiler
  27   27               Specify the compiler to be used primarily (that which is used for
  28   28               link-editing and pre-processing, and whos objects we deliver).
  29   29  
  30   30       --shadow compiler
  31   31               Specify a shadow compiler, which builds sources for the sake of
  32   32               checking code quality and compatibility, but has its output
  33   33               discarded.
  34   34  
       35 +     --linker linker
       36 +             Specify a link-editor to use in place of /usr/bin/ld.  ld(1)
       37 +             itself arranges for this to be executed by any subprocesses.
       38 +
  35   39       --noecho
  36   40               Do not echo the actual command line of any compilers invoked.
  37   41  
  38   42       --versions
  39   43               Request from each configured primary and shadow compiler its
  40   44               version information.
  41   45  
  42   46       -C      The sources being compiled are C++.  This is necessary as it
  43   47               affects the translation of compiler arguments.
  44   48  
↓ open down ↓ 63 lines elided ↑ open up ↑
 108  112  EXIT STATUS
 109  113       The following exit status values are returned:
 110  114  
 111  115       0       The primary compiler, and shadow compilers if invoked, all
 112  116               completed successfully.
 113  117  
 114  118       >0      A usage error occurred, or one or more compilers returned a
 115  119               nonzero exit status.
 116  120  
 117  121  SEE ALSO
 118      -     cc(1), CC(1), gcc(1)
      122 +     cc(1), CC(1), gcc(1), ld(1)
 119  123  
 120  124  BUGS
 121  125       The translations provided for gcc are not always exact and in some cases
 122  126       reflect local policy rather than actual equivalence.
 123  127  
 124  128       Additional compiler types should be supported.
 125  129  
 126  130       The translation engine is hacky.
 127  131  
 128  132  illumos                        September 4, 2018                       illumos
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX