scc

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