1CCCONFIG(1) User Contributed Perl Documentation CCCONFIG(1)
2
6 ccconfig - Get Convert::Binary::C configuration for a compiler
7
9 ccconfig options [-- compiler-options]
10 options:
12 -c
14 --cc compiler compiler executable to test
15 default: auto-determined
16 -o
18 --output-file file output filename
19 default: output to stdout
20 -f
22 --output-format format output format
23 default: dumper
24 --basename name basename of the temporary test files
26 default: _t_e_s_t
27 -I
29 --inc-path path manually set compiler include path
30 --preprocess rule compiler rule for preprocessing
32 --compile-obj rule compiler rule for compiling objects
33 --compile-exe rule compiler rule for compiling executables
34 --c-ext ext extension of C source files
36 --pp-ext ext extension of preprocessor output files
37 --obj-ext ext extension of object files
38 --exe-ext ext extension of executable files
39 --nodelete don't delete temporary files
41 --norun don't try to run executables
42 --quiet don't display anything
43 --nostatus don't display status indicator
44 --version print version number
46 --debug debug mode
48 Placeholders allowed in compiler rules:
50 %c C source file
52 %o object file
53 %e executable file
54 %i preprocessor output file
55 | result is written to stdout (only at end of rule)
56
58 "ccconfig" will try to determine a usable configuration for
59 Convert::Binary::C from testing a compiler executable. It is not
60 necessary that the binaries generated by the compiler can be executed,
61 so "ccconfig" can also be used for cross-compilers.
62 This tool is still experimental, and you should neither rely on its
64 output without checking, nor expect it to work in your environment.
65
67 "--cc" compiler
68 This option allows you to explicitly specify a compiler executable.
69 This is especially useful if you don't want to use your system
70 compiler. If this options is not given, "ccconfig" tries to guess a
71 compiler.
72 "--output-file" file
74 Write Convert::Binary::C configuration to the specified file. The
75 default is to write the configuration to "stdout".
76 "--output-format" format
78 Specify the output format of the Convert::Binary::C configuration. The
79 following formats are currently supported:
80 dumper Output a %config hash using Data::Dumper
82 require Output in a format suitable for require
83 The default is "dumper".
85 "--basename" name
87 Allows you to change the base name of the temporary test files. This
88 is used along with the various "-ext" options to build the filenames of
89 C source files, preprocessor output files, object files and
90 executables.
91 "--inc-path" path
93 This option allows you to manually set the include path of the
94 compiler. This is useful if "ccconfig" cannot determine the include
95 path automatically, most probably because it cannot parse the
96 preprocessor output. This option can be specified more than once.
97 "--preprocess" rule
99 Using this option, you can specify a rule that "ccconfig" uses to run
100 the compiler to get preprocessor output. Most compilers write the
101 preprocessor output to standard output when given the "-E" option, i.e.
102 cc -E foo.c
104 will preprocess foo.c to standard output. The corresponding rule for
106 "ccconfig" would be:
107 ccconfig --preprocess='-E %c |'
109 The <%c> will be replaced with the C source filename, and the pipe
111 symbol signals that the result will be written to standard output.
112 The following placeholders can be used in "ccconfig" rules:
114 %c C source file
116 %o object file
117 %e executable file
118 %i preprocessor output file
119 Usually, "ccconfig" tries to figure out the correct rules on its own.
121 "--compile-obj" rule
123 Like "--preprocess", this option allows you to define a rule for how to
124 compile an object file. For most compilers, this rule will be something
125 like
126 ccconfig --compile-obj='-c -o %o %c'
128 "--compile-exe" rule
130 Like "--preprocess", this option allows you to define a rule for how to
131 compile an executable file. For most compilers, this rule will be
132 something like
133 ccconfig --compile-exe='-o %e %c'
135 Note that it is sufficient to specify either "--compile-obj" or
137 "--compile-exe". So if your compiler can only create object files,
138 that's just fine.
139 "--c-ext"
141 This option is used along with "--basename" to build the name of a C
142 source file. This is usually set to ".c".
143 "--pp-ext"
145 This option is used along with "--basename" to build the name of a
146 preprocessor output file.
147 "--obj-ext"
149 This option is used along with "--basename" to build the name of an
150 object file.
151 "--exe-ext"
153 This option is used along with "--basename" to build the name of an
154 executable file.
155 "--nodelete"
157 Don't attempt to delete temporary files that have been created by the
158 compiler. Normally, "ccconfig" will look for all files with the same
159 basename as the temporary test file and delete them.
160 "--norun"
162 You can specify this option if the executables generated by your
163 compiler cannot be run on your machine, i.e. if you have a cross-
164 compiler. However, "ccconfig" will automatically find out that it
165 cannot run the executables.
166 When this option is set, a different set of algorithms is used to
168 determine a couple of configuration settings. These algorithms are all
169 based upon placing a special signature in the object file. They are
170 less reliable that the standard algorithms, so you shouldn't use them
171 unless you have to.
172 "--quiet"
174 Don't display anything except for the final configuration.
175 "--nostatus"
177 Hide the status indicator. Recommended if you want to redirect the
178 script output to a file:
179 ccconfig --nostatus >config.pl 2>ccconfig.log
181 "--version"
183 Writes the program name, version and path to standard output.
184 "--debug"
186 Generate tons of debug output. Don't use unless you know what you're
187 doing.
188
190 Normally, a simple
191 ccconfig
193 without arguments is enough if you want the configuration for your
195 system compiler. While "ccconfig" is running, it will write lots of
196 status information to "stderr". When it's done, it will usually dump a
197 Perl hash table to "stdout" which can be directly used as a
198 configuration for Convert::Binary::C.
199 If you want the configuration for a different compiler, or "ccconfig"
201 cannot determine your system compiler automatically, use
202 ccconfig -c gcc32
204 if your compiler's name is "gcc32".
206 If you want to pass additional options to the compiler, you can do so
208 after a double-dash on the command line:
209 ccconfig -- -g -DDEBUGGING
211 or
213 ccconfig -c gcc32 -- -ansi -fshort-enums
215 If you'd like to interface with the Perl core, you may find a suitable
217 configuration using something like:
218 ccconfig --cc=`perl -MConfig -e 'print $Config{cc}'` \
220 -- `perl -MConfig -e 'print $Config{ccflags}'`
221
223 Copyright (c) 2002-2020 Marcus Holland-Moritz. All rights reserved.
224 This program is free software; you can redistribute it and/or modify it
225 under the same terms as Perl itself.
226
228 See Convert::Binary::C.
229perl v5.38.0 2023-07-20 CCCONFIG(1)