scc

simple c99 compiler
git clone git://git.simple-cc.org/scc
Log | Files | Refs | Submodules | README | LICENSE

scc.man (2693B)

      1 .TH SCC 1 scc\-VERSION
      2 .SH NAME
      3 scc \- wrapper to dispatch scc suite tools
      4 .SH SYNOPSIS
      5 .B scc
      6 .RI [ tool ]
      7 .RI [ arguments ...]
      8 .SH DESCRIPTION
      9 .B scc
     10 is a shell wrapper that dispatches to the appropriate tool in the scc suite.
     11 The first argument selects which tool to invoke. The remaining arguments are
     12 passed unchanged to the selected tool.
     13 If no
     14 .I tool
     15 argument is given, or if the first argument does not match any known tool name,
     16 .B scc
     17 defaults to invoking
     18 .BR scc\-cc (1)
     19 with all provided arguments.
     20 .PP
     21 The tool is resolved under the directory pointed to by
     22 .BR SCCPREFIX .
     23 .SH TOOLS
     24 The following tool names are recognized as the first argument:
     25 .TP
     26 .B cc
     27 Invoke
     28 .BR scc\-cc (1),
     29 the C compiler driver.
     30 .TP
     31 .B cpp
     32 Invoke
     33 .BR scc\-cpp (1),
     34 the C preprocessor wrapper.
     35 .TP
     36 .B as
     37 Invoke
     38 .BR scc\-as (1),
     39 the assembler.
     40 .TP
     41 .B ar
     42 Invoke
     43 .BR scc\-ar (1),
     44 the archive utility.
     45 .TP
     46 .B addr2line
     47 Invoke
     48 .BR scc\-addr2line (1),
     49 the address to source line mapper.
     50 .TP
     51 .B ld
     52 Invoke
     53 .BR scc\-ld (1),
     54 the linker.
     55 .TP
     56 .B make
     57 Invoke
     58 .BR scc\-make (1),
     59 the POSIX make implementation.
     60 .TP
     61 .B nm
     62 Invoke
     63 .BR scc\-nm (1),
     64 the symbol table lister.
     65 .TP
     66 .B objcopy
     67 Invoke
     68 .BR scc\-objcopy (1),
     69 the object file copy and translate utility.
     70 .TP
     71 .B objdump
     72 Invoke
     73 .BR scc\-objdump (1),
     74 the object file dump utility.
     75 .TP
     76 .B size
     77 Invoke
     78 .BR scc\-size (1),
     79 the section size lister.
     80 .TP
     81 .B strip
     82 Invoke
     83 .BR scc\-strip (1),
     84 the symbol stripper.
     85 .PP
     86 If the first argument is not one of the above tool names, it is treated as an
     87 argument to
     88 .B scc\-cc
     89 and all arguments (including the first) are forwarded to it.
     90 .SH ENVIRONMENT VARIABLES
     91 .TP
     92 .B SCCPREFIX
     93 Defines the path prefix under which the scc suite is installed.
     94 All tools are looked up as
     95 .IB $SCCPREFIX /bin/scc\- tool\fR.
     96 If not set,
     97 .B scc
     98 sets it to the parent directory of its own location,
     99 which is supposed to be $SCCPREFIX/bin.
    100 .TP
    101 .B SCCLIBPREFIX
    102 Defines the path prefix for scc libraries.
    103 If not set,
    104 .B scc
    105 sets it to the parent directory of its own location,
    106 which is supposed to be $SCCPREFIX/lib.
    107 .SH EXAMPLES
    108 Compile a C source file (default, invokes
    109 .BR scc\-cc ):
    110 .IP
    111 .EX
    112 scc hello.c
    113 .EE
    114 .PP
    115 Explicitly invoke the compiler driver:
    116 .IP
    117 .EX
    118 scc cc \-o hello hello.c
    119 .EE
    120 .PP
    121 Invoke the assembler:
    122 .IP
    123 .EX
    124 scc as \-o hello.o hello.s
    125 .EE
    126 .PP
    127 Invoke the archiver:
    128 .IP
    129 .EX
    130 scc ar \-r libfoo.a foo.o bar.o
    131 .EE
    132 .PP
    133 Use a custom installation prefix:
    134 .IP
    135 .EX
    136 SCCPREFIX=/opt/scc scc cc \-o hello hello.c
    137 .EE
    138 .SH SEE ALSO
    139 .BR scc\-cc (1),
    140 .BR scc\-cpp (1),
    141 .BR scc\-as (1),
    142 .BR scc\-ar (1),
    143 .BR scc\-ld (1),
    144 .BR scc\-make (1),
    145 .BR scc\-nm (1),
    146 .BR scc\-size (1),
    147 .BR scc\-strip (1),
    148 .BR scc\-objcopy (1),
    149 .BR scc\-objdump (1),
    150 .BR scc\-addr2line (1)