Home
scc.1 - scc - simple c99 compiler
HTML git clone git://git.simple-cc.org/scc
DIR Log
DIR Files
DIR Refs
DIR Submodules
DIR README
DIR LICENSE
---
scc.1 (2777B)
---
1 .TH SCC 1 scc\-VERSION
2 .SH NAME
3 scc \- simple C compiler with magic
4 .SH SYNOPSIS
5 .B scc
6 .RB [ \-cdgkqQsWw ]
7 .RB [ \-M | \-E | \-S ]
8 .RB [ \-D
9 .IR def[=val] ] ...
10 .RB [ \-I
11 .IR dir ] ...
12 .RB [ \-L
13 .IR dir ] ...
14 .RB [ \-U
15 .IR def ] ...
16 .RB [ \-l
17 .IR lib ]
18 .RB [ \-m
19 .IR arch ]
20 .RB [ \-o
21 .IR outfile ]
22 .RB [ \-O
23 .IR level ]
24 .RB [ \-t
25 .IR sys ]
26 .RB sourcefile ...
27 .SH DESCRIPTION
28 .B scc
29 is a simple C compiler which takes several
30 .I sourcefiles
31 and compiles them to an executable. The default output file is
32 .B a.out,
33 which can be changed by defining some
34 .I outfile.
35 .SH OPTIONS
36 .TP
37 .B \-c
38 Do not run the linker.
39 .TP
40 .B \-d
41 Do output internal tool messages.
42 .TP
43 .BI \-D " define[=value]"
44 Specify a
45 .I define
46 for the preprocessor.
47 .TP
48 .B \-E
49 Stop after the preprocessing stage, do not run the compiler and output the then
50 resulting source.
51 .TP
52 .B \-g
53 Do generate debug information.
54 .TP
55 .BI \-I " directory"
56 Define a include
57 .I directory
58 to get header files from. This directory is searched for before standard
59 include directories.
60 .TP
61 .B \-k
62 Do keep temporary objects.
63 .TP
64 .BI \-l " library"
65 Link against this
66 .I library.
67 .TP
68 .BI \-L " directory"
69 Define a library
70 .I directory
71 to resolve dependencies from. This directory is used before the standard
72 paths.
73 .TP
74 .BI \-m " architecture"
75 Define the
76 .I architecture
77 to compile for (i.e. amd64, i386 ...).
78 .TP
79 .B \-M
80 Output a rule for
81 .B make
82 describing the dependencies of the main source file.
83 .TP
84 .BI \-o " outfile"
85 Define the name of the
86 .I outfile.
87 .TP
88 .BI \-O " level"
89 Define the optimisation
90 .I level
91 to compile with. (This is a stub for compatibility reasons.)
92 .TP
93 .B \-q
94 Do not use
95 .I QBE.
96 .TP
97 .B \-Q
98 Do use the
99 .I QBE.
100 .TP
101 .B \-s
102 Strip all symbol tables and relocation information from the resulting executable.
103 .TP
104 .B \-S
105 Stop after the compilation stage, do not assemble and output the assembler
106 source.
107 .TP
108 .BI \-t " system"
109 Define the
110 .I system
111 to compile for (i.e. linux, openbsd ...).
112 .TP
113 .BI \-U " define"
114 Undefine a previously defined
115 .I define
116 by the -D parameter.
117 .TP
118 .B \-W
119 Show warning messages.
120 .TP
121 .B \-w
122 Do not show warning messages (default).
123 .SH ENVIRONMENT VARIABLES
124 Certain environment variables control the behaviour of scc.
125 .TP
126 .B ARCH
127 defines the
128 .I architecture
129 to compile for (i.e. amd64, i386 ...).
130 .TP
131 .B SYS
132 defines the
133 .I system
134 to compile for (i.e. linux, openbsd ...).
135 .TP
136 .B ABI
137 defines the
138 .I application binary interface
139 to compile for (i.e. sysv ...).
140 .TP
141 .B FORMAT
142 defines the format of the output executable.
143 .TP
144 .B SCCPREFIX
145 defines the path prefix scc will search the scc suite in.
146 .SH AUTHORS
147 See the LICENSE file for the authors.
148 .SH LICENSE
149 See the LICENSE file for the terms of redistribution.
150 .SH SEE ALSO
151 .BR scpp (1),
152 .BR make (1)
153 .SH BUGS
154 See the TODO file in the distribution.