2 # InspIRCd -- Internet Relay Chat Daemon
4 # Copyright (C) 2020 Nicole Kleinhoff <ilbelkyr@shalture.org>
5 # Copyright (C) 2013-2021 Sadie Powell <sadie@witchery.services>
6 # Copyright (C) 2012 Robby <robby@chatbelgie.be>
7 # Copyright (C) 2007-2008 Craig Edwards <brain@inspircd.org>
8 # Copyright (C) 2007 Dennis Friis <peavey@inspircd.org>
10 # This file is part of InspIRCd. InspIRCd is free software: you can
11 # redistribute it and/or modify it under the terms of the GNU General Public
12 # License as published by the Free Software Foundation, version 2.
14 # This program is distributed in the hope that it will be useful, but WITHOUT
15 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
16 # FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
19 # You should have received a copy of the GNU General Public License
20 # along with this program. If not, see <http://www.gnu.org/licenses/>.
24 package make::configure;
28 use warnings FATAL => qw(all);
30 use Exporter qw(import);
31 use File::Basename qw(basename dirname);
32 use File::Spec::Functions qw(abs2rel catdir catfile);
37 use constant CONFIGURE_ROOT => dirname dirname __FILE__;
38 use constant CONFIGURE_DIRECTORY => catdir(CONFIGURE_ROOT, '.configure');
39 use constant CONFIGURE_CACHE_FILE => catfile(CONFIGURE_DIRECTORY, 'cache.cfg');
40 use constant CONFIGURE_CACHE_VERSION => '1';
41 use constant CONFIGURE_ERROR_PIPE => $ENV{INSPIRCD_VERBOSE} ? '' : '1>/dev/null 2>/dev/null';
43 our @EXPORT = qw(CONFIGURE_CACHE_FILE
44 CONFIGURE_CACHE_VERSION
59 sub __get_socketengines {
61 for (<${\CONFIGURE_ROOT}/src/socketengines/socketengine_*.cpp>) {
62 s/src\/socketengines\/socketengine_(\w+)\.cpp/$1/;
63 push @socketengines, $1;
65 return @socketengines;
68 sub __get_template_settings($$$) {
70 # These are actually hash references
71 my ($config, $compiler, $version) = @_;
73 # Start off by populating with the config
74 my %settings = %$config;
76 # Compiler information
77 while (my ($key, $value) = each %{$compiler}) {
78 $settings{'COMPILER_' . $key} = $value;
82 while (my ($key, $value) = each %{$version}) {
83 $settings{'VERSION_' . $key} = $value;
86 # Miscellaneous information
87 $settings{CONFIGURE_DIRECTORY} = CONFIGURE_DIRECTORY;
88 $settings{CONFIGURE_CACHE_FILE} = CONFIGURE_CACHE_FILE;
89 $settings{SOURCE_DIR} = CONFIGURE_ROOT;
90 $settings{SYSTEM_NAME} = lc $^O;
95 sub __test_compiler($) {
97 return 0 unless run_test("`$compiler`", !system "$compiler -v ${\CONFIGURE_ERROR_PIPE}");
98 return 0 unless run_test("`$compiler`", test_file($compiler, 'compiler.cpp', '-fno-rtti'), 'compatible');
103 unlink CONFIGURE_CACHE_FILE;
107 my $SELIST = join ', ', __get_socketengines();
108 print console_format <<EOH;
109 <|GREEN Usage:|> <|BOLD $0 [OPTIONS|>]
111 When no options are specified, configure runs in interactive mode and you must
112 specify any required values manually. If one or more options are specified,
113 non-interactive configuration is started and any omitted values are defaulted.
115 <|GREEN PATH OPTIONS|>
117 <|BOLD --portable|> Automatically set up the installation paths for
118 portable installation.
119 <|BOLD --system|> Automatically set up the installation paths for
120 system-wide installation.
121 <|BOLD --prefix <DIR>|> The root install directory. If this is set then
122 all subdirectories will be adjusted accordingly.
123 [${\CONFIGURE_ROOT}/run]
124 <|BOLD --binary-dir <DIR>|> The location where the main server binary is
126 [${\CONFIGURE_ROOT}/run/bin]
127 <|BOLD --config-dir <DIR>|> The location where the configuration files and
128 SSL certificates are stored.
129 [${\CONFIGURE_ROOT}/run/conf]
130 <|BOLD --data-dir <DIR>|> The location where the data files, such as the
131 xline database, are stored.
132 [${\CONFIGURE_ROOT}/run/data]
133 <|BOLD --example-dir <DIR>|> The location where the example configuration
134 files and SQL schemas are stored.
135 [${\CONFIGURE_ROOT}/run/conf/examples]
136 <|BOLD --log-dir <DIR>|> The location where the log files are stored.
137 [${\CONFIGURE_ROOT}/run/logs]
138 <|BOLD --manual-dir <DIR>|> The location where the manual files are stored.
139 [${\CONFIGURE_ROOT}/run/manuals]
140 <|BOLD --module-dir <DIR>|> The location where the loadable modules are
142 [${\CONFIGURE_ROOT}/run/modules]
143 <|BOLD --runtime-dir <DIR>|> The location where the runtime files, such as
144 the pid file, are stored.
145 [${\CONFIGURE_ROOT}/run/data]
146 <|BOLD --script-dir <DIR>|> The location where the scripts, such as the
147 init scripts, are stored.
148 [${\CONFIGURE_ROOT}/run]
150 <|GREEN EXTRA MODULE OPTIONS|>
152 <|BOLD --enable-extras <MODULE>|> Enables a comma separated list of extra modules.
153 <|BOLD --disable-extras <MODULE>|> Disables a comma separated list of extra modules.
154 <|BOLD --list-extras|> Shows the availability status of all extra
157 <|GREEN MISC OPTIONS|>
159 <|BOLD --clean|> Remove the configuration cache file and start
160 the interactive configuration wizard.
161 <|BOLD --disable-auto-extras|> Disables automatically enabling extra modules
162 for which the dependencies are available.
163 <|BOLD --disable-interactive|> Disables the interactive configuration wizard.
164 <|BOLD --disable-ownership|> Disables setting file ownership on install.
165 <|BOLD --distribution-label <TEXT>|> Sets a distribution specific version label in
166 the build configuration.
167 <|BOLD --gid <ID|NAME>|> Sets the group to run InspIRCd as.
168 <|BOLD --help|> Show this message and exit.
169 <|BOLD --socketengine <NAME>|> Sets the socket engine to be used. Possible
171 <|BOLD --uid [ID|NAME]|> Sets the user to run InspIRCd as.
172 <|BOLD --update|> Updates the build environment with the settings
177 <|BOLD CXX=<NAME>|> Sets the C++ compiler to use when building the
178 server. If not specified then the build system
179 will search for c++, g++, clang++ or icpc.
180 <|BOLD INSPIRCD_VERBOSE=<0|1>|> Shows additional information for debugging.
182 If you have any problems with configuring InspIRCd then visit our IRC channel
183 at irc.inspircd.org #InspIRCd or create a support discussion at
184 https://github.com/inspircd/inspircd/discussions.
186 Packagers: see https://docs.inspircd.org/packaging/ for packaging advice.
192 print_error "You have not run $0 before. Please do this before trying to update the generated files." unless -f CONFIGURE_CACHE_FILE;
194 my %config = read_config_file(CONFIGURE_CACHE_FILE);
195 $config{EXAMPLE_DIR} //= catdir $config{CONFIG_DIR}, 'examples';
196 $config{RUNTIME_DIR} //= $config{DATA_DIR};
197 my %compiler = get_compiler_info($config{CXX});
198 my %version = get_version $config{DISTRIBUTION};
199 parse_templates(\%config, \%compiler, \%version);
200 say 'Update complete!';
205 my ($what, $result, $adjective) = @_;
206 $adjective //= 'available';
207 print console_format "Checking whether <|GREEN $what|> is $adjective ... ";
208 say console_format($result ? "<|GREEN yes|>" : "<|RED no|>");
212 sub test_file($$;$) {
213 my ($compiler, $file, $args) = @_;
216 $status ||= system "$compiler -o ${\CONFIGURE_ROOT}/__test_$file ${\CONFIGURE_ROOT}/make/test/$file $args ${\CONFIGURE_ERROR_PIPE}";
217 $status ||= system "${\CONFIGURE_ROOT}/__test_$file ${\CONFIGURE_ERROR_PIPE}";
218 unlink "${\CONFIGURE_ROOT}/__test_$file";
222 sub test_header($$;$) {
223 my ($compiler, $header, $args) = @_;
225 open(my $fh, "| $compiler -E - $args ${\CONFIGURE_ERROR_PIPE}") or return 0;
226 print $fh "#include <$header>";
231 sub module_expand($) {
233 $module = "m_$module" unless $module =~ /^(?:m|core)_/;
234 $module = "$module.cpp" unless $module =~ /\.cpp$/;
238 sub module_shrink($) {
239 my $module = basename shift;
240 $module =~ s/(?:^m_|\.cpp$)//g;
244 sub write_configure_cache(%) {
245 unless (-e CONFIGURE_DIRECTORY) {
246 say console_format "Creating <|GREEN ${\abs2rel CONFIGURE_DIRECTORY, CONFIGURE_ROOT}|> ...";
247 create_directory CONFIGURE_DIRECTORY, 0750 or print_error "unable to create ${\CONFIGURE_DIRECTORY}: $!";
250 say console_format "Writing <|GREEN ${\abs2rel CONFIGURE_CACHE_FILE, CONFIGURE_ROOT}|> ...";
252 write_config_file CONFIGURE_CACHE_FILE, %config;
255 sub get_compiler_info($) {
257 my %info = (NAME => 'Unknown', VERSION => '0.0');
258 return %info if system "$binary -o __compiler_info ${\CONFIGURE_ROOT}/make/test/compiler_info.cpp ${\CONFIGURE_ERROR_PIPE}";
259 open(my $fh, '-|', './__compiler_info 2>/dev/null');
260 while (my $line = <$fh>) {
261 $info{$1} = $2 if $line =~ /^([A-Z]+)\s(.+)$/;
264 unlink './__compiler_info';
269 my @compilers = qw(c++ g++ clang++ icpc);
270 for my $compiler (shift // @compilers) {
271 return $compiler if __test_compiler $compiler;
272 return "xcrun $compiler" if $^O eq 'darwin' && __test_compiler "xcrun $compiler";
276 sub parse_templates($$$) {
278 # These are actually hash references
279 my ($config, $compiler, $version) = @_;
281 # Collect settings to be used when generating files
282 my %settings = __get_template_settings($config, $compiler, $version);
284 # Iterate through files in make/template.
285 for my $template (<${\CONFIGURE_ROOT}/make/template/*>) {
286 say console_format "Parsing <|GREEN ${\abs2rel $template, CONFIGURE_ROOT}|> ...";
287 open(my $fh, $template) or print_error "unable to read $template: $!";
288 my (@lines, $mode, @platforms, @targets);
290 # First pass: parse template variables and directives.
291 while (my $line = <$fh>) {
294 # Does this line match a variable?
295 while ($line =~ /(@(\w+?)(?:\|(\w*))?@)/) {
296 my ($variable, $name, $default) = ($1, $2, $3);
297 if (defined $settings{$name}) {
298 $line =~ s/\Q$variable\E/$settings{$name}/;
299 } elsif (defined $default) {
300 $line =~ s/\Q$variable\E/$default/;
302 print_warning "unknown template variable '$name' in $template!";
307 # Does this line match a directive?
308 if ($line =~ /^(\s*)%(\w+)\s+(.+)$/) {
309 if ($2 eq 'define') {
311 push @lines, "#$1define $3";
313 push @lines, "#$1undef $3";
315 } elsif ($2 eq 'mode') {
317 } elsif ($2 eq 'platform') {
319 } elsif ($2 eq 'target') {
320 push @targets, catfile CONFIGURE_ROOT, $3;
322 print_warning "unknown template command '$2' in $template!";
331 # Only proceed if this file should be templated on this platform.
332 if ($#platforms < 0 || grep { $_ eq $^O } @platforms) {
334 # Add a default target if the template has not defined one.
336 push @targets, catfile(CONFIGURE_DIRECTORY, basename $template);
339 # Write the templated files to disk.
340 for my $target (@targets) {
342 # Create the directory if it doesn't already exist.
343 my $directory = dirname $target;
344 unless (-e $directory) {
345 say console_format "Creating <|GREEN ${\abs2rel $directory, CONFIGURE_ROOT}|> ...";
346 create_directory $directory, 0750 or print_error "unable to create $directory: $!";
349 # Write the template file.
350 say console_format "Writing <|GREEN ${\abs2rel $target, CONFIGURE_ROOT}|> ...";
351 open(my $fh, '>', $target) or print_error "unable to write $target: $!";
357 # Set file permissions.
359 chmod $mode, $target;