]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - make/configure.pm
Replace the SERVER stub command with something actually useful.
[user/henk/code/inspircd.git] / make / configure.pm
index 3e1a38333b75a5cfcb323a22b4a06915cc2a7fb0..b20639d3480e84e3f78784a41636feac60d59c07 100644 (file)
@@ -1 +1,362 @@
-#\r# Copyright 2002-2007 The ChatSpike Development Team\r# <brain@chatspike.net>\r# <Craig@chatspike.net>\r#\r# Licensed under GPL, please see the COPYING file\r# for more information\r#\r\rpackage make::configure;\ruse Exporter 'import';\ruse POSIX;\ruse make::utilities;\r@EXPORT = qw(promptnumeric dumphash is_dir getmodules getrevision getcompilerflags getlinkerflags getdependencies resolve_directory yesno showhelp promptstring_s);\r\rmy $no_svn = 0;\r\rsub yesno {\r        my ($flag,$prompt) = @_;\r       print "$prompt [\033[1;32m$main::config{$flag}\033[0m] -> ";\r   chomp($tmp = <STDIN>);\r if ($tmp eq "") { $tmp = $main::config{$flag} }\r        if (($tmp eq "") || ($tmp =~ /^y/i))\r   {\r              $main::config{$flag} = "y";\r    }\r      else\r   {\r              $main::config{$flag} = "n";\r    }\r      return;\r}\r\rsub resolve_directory\r{\r     my $ret = $_[0];\r       eval\r   {\r              use File::Spec;\r                $ret = File::Spec->rel2abs($_[0]);\r     };\r     return $ret;\r}\r\rsub getrevision {\r      if ($no_svn)\r   {\r              return "0";\r    }\r      my $data = `svn info`;\r if ($data eq "")\r       {\r              $no_svn = 1;\r           $rev = "0";\r            return $rev;\r   }\r      $data =~ /Revision: (\d+)/;\r    my $rev = $1;\r  if (!defined($rev))\r    {\r              $rev = "0";\r    }\r      return $rev;\r}\r\rsub getcompilerflags {\r my ($file) = @_;\r       open(FLAGS, $file);\r    while (<FLAGS>) {\r              if ($_ =~ /^\/\* \$CompileFlags: (.+) \*\/$/) {\r                        close(FLAGS);\r                  return translate_functions($1,$file);\r          }\r      }\r      close(FLAGS);\r  return undef;\r}\r\rsub getlinkerflags {\r  my ($file) = @_;\r       open(FLAGS, $file);\r    while (<FLAGS>) {\r              if ($_ =~ /^\/\* \$LinkerFlags: (.+) \*\/$/) {\r                 close(FLAGS);\r                  return translate_functions($1,$file);\r          }\r      }\r      close(FLAGS);\r  return undef;\r}\r\rsub getdependencies {\r my ($file) = @_;\r       open(FLAGS, $file);\r    while (<FLAGS>) {\r              if ($_ =~ /^\/\* \$ModDep: (.+) \*\/$/) {\r                      close(FLAGS);\r                  return translate_functions($1,$file);\r          }\r      }\r      close(FLAGS);\r  return undef;\r}\r\r\rsub getmodules\r{\r     my $i = 0;\r     print "Detecting modules ";\r    opendir(DIRHANDLE, "src/modules");\r     foreach $name (sort readdir(DIRHANDLE))\r        {\r              if ($name =~ /^m_(.+)\.cpp$/)\r          {\r                      $mod = $1;\r                     if ($mod !~ /_static$/)\r                        {\r                              $main::modlist[$i++] = $mod;\r                           print ".";\r                     }\r              }\r      }\r      closedir(DIRHANDLE);\r   print "\nOk, $i modules.\n";\r}\r\rsub promptnumeric($$)\r{\r        my $continue = 0;\r      my ($prompt, $configitem) = @_;\r        while (!$continue)\r     {\r              print "Please enter the maximum $prompt?\n";\r           print "[\033[1;32m$main::config{$configitem}\033[0m] -> ";\r             chomp($var = <STDIN>);\r         if ($var eq "")\r                {\r                      $var = $main::config{$configitem};\r             }\r              if ($var =~ /^\d+$/) {\r                 # We don't care what the number is, set it and be on our way.\r                  $main::config{$configitem} = $var;\r                     $continue = 1;\r                 print "\n";\r            } else {\r                       print "You must enter a number in this field. Please try again.\n\n";\r          }\r      }\r}\r\rsub promptstring_s($$)\r{\r  my ($prompt,$default) = @_;\r    my $var;\r       print "$prompt\n";\r     print "[\033[1;32m$default\033[0m] -> ";\r       chomp($var = <STDIN>);\r $var = $default if $var eq "";\r print "\n";\r    return $var;\r}\r\rsub dumphash()\r{\r       print "\n\033[1;32mPre-build configuration is complete!\033[0m\n\n";\r   print "\033[0mBase install path:\033[1;32m\t\t$main::config{BASE_DIR}\033[0m\n";\r       print "\033[0mConfig path:\033[1;32m\t\t\t$main::config{CONFIG_DIR}\033[0m\n";\r print "\033[0mModule path:\033[1;32m\t\t\t$main::config{MODULE_DIR}\033[0m\n";\r print "\033[0mLibrary path:\033[1;32m\t\t\t$main::config{LIBRARY_DIR}\033[0m\n";\r       print "\033[0mMax connections:\033[1;32m\t\t$main::config{MAX_CLIENT}\033[0m\n";\r       print "\033[0mMax nickname length:\033[1;32m\t\t$main::config{NICK_LENGT}\033[0m\n";\r   print "\033[0mMax channel length:\033[1;32m\t\t$main::config{CHAN_LENGT}\033[0m\n";\r    print "\033[0mMax mode length:\033[1;32m\t\t$main::config{MAXI_MODES}\033[0m\n";\r       print "\033[0mMax ident length:\033[1;32m\t\t$main::config{MAX_IDENT}\033[0m\n";\r       print "\033[0mMax quit length:\033[1;32m\t\t$main::config{MAX_QUIT}\033[0m\n";\r print "\033[0mMax topic length:\033[1;32m\t\t$main::config{MAX_TOPIC}\033[0m\n";\r       print "\033[0mMax kick length:\033[1;32m\t\t$main::config{MAX_KICK}\033[0m\n";\r print "\033[0mMax name length:\033[1;32m\t\t$main::config{MAX_GECOS}\033[0m\n";\r        print "\033[0mMax away length:\033[1;32m\t\t$main::config{MAX_AWAY}\033[0m\n";\r print "\033[0mGCC Version Found:\033[1;32m\t\t$main::config{GCCVER}.x\033[0m\n";\r       print "\033[0mCompiler program:\033[1;32m\t\t$main::config{CC}\033[0m\n";\r      print "\033[0mStatic modules:\033[1;32m\t\t\t$main::config{STATIC_LINK}\033[0m\n";\r     print "\033[0mIPv6 Support:\033[1;32m\t\t\t$main::config{IPV6}\033[0m\n";\r      print "\033[0mIPv6 to IPv4 Links:\033[1;32m\t\t$main::config{SUPPORT_IP6LINKS}\033[0m\n";\r      print "\033[0mGnuTLS Support:\033[1;32m\t\t\t$main::config{USE_GNUTLS}\033[0m\n";\r      print "\033[0mOpenSSL Support:\033[1;32m\t\t$main::config{USE_OPENSSL}\033[0m\n\n";\r}\r\rsub is_dir\r{\r    my ($path) = @_;\r       if (chdir($path))\r      {\r              chdir($main::this);\r            return 1;\r      }\r      else\r   {\r              # Just in case..\r               chdir($main::this);\r            return 0;\r      }\r}\r\rsub showhelp\r{\r    chomp($PWD = `pwd`);\r   print "Usage: configure [options]\r\r*** NOTE: NON-INTERACTIVE CONFIGURE IS *NOT* SUPPORTED BY THE ***\r*** INSPIRCD DEVELOPMENT TEAM. DO NOT ASK FOR HELP REGARDING  ***\r***     NON-INTERACTIVE CONFIGURE ON THE FORUMS OR ON IRC!    ***\r\rOptions: [defaults in brackets after descriptions]\r\rWhen no options are specified, interactive\rconfiguration is started and you must specify\rany required values manually. If one or more\roptions are specified, non-interactive configuration\ris started, and any omitted values are defaulted.\r\rArguments with a single \"-\" symbol, as in\rInspIRCd 1.0.x, are also allowed.\r\r  --disable-interactive        Sets no options intself, but\r                               will disable any interactive prompting.\r  --update                     Update makefiles and dependencies\r  --modupdate                  Detect new modules and write makefiles\r  --svnupdate {--rebuild}      Update working copy via subversion\r                                {and optionally rebuild if --rebuild\r                                 is also specified}\r  --clean                      Remove .config.cache file and go interactive\r  --enable-gnutls              Enable GnuTLS module [no]\r  --enable-openssl             Enable OpenSSL module [no]\r  --with-nick-length=[n]       Specify max. nick length [32]\r  --with-channel-length=[n]    Specify max. channel length [64]\r  --with-max-clients=[n]       Specify maximum number of users\r                               which may connect locally\r  --enable-optimization=[n]    Optimize using -O[n] gcc flag\r  --enable-epoll               Enable epoll() where supported [set]\r  --enable-kqueue              Enable kqueue() where supported [set]\r  --disable-epoll              Do not enable epoll(), fall back\r                               to select() [not set]\r  --disable-kqueue             Do not enable kqueue(), fall back\r                               to select() [not set]\r  --enable-ipv6                Build ipv6 native InspIRCd [no]\r  --enable-remote-ipv6         Build with ipv6 support for remote\r                               servers on the network [yes]\r  --disable-remote-ipv6        Do not allow remote ipv6 servers [not set]\r  --with-cc=[filename]         Use an alternative g++ binary to\r                               build InspIRCd [g++]\r  --with-ident-length=[n]      Specify max length of ident [12]\r  --with-quit-length=[n]       Specify max length of quit [200]\r  --with-topic-length=[n]      Specify max length of topic [350]\r  --with-kick-length=[n]       Specify max length of kick [200]\r  --with-gecos-length=[n]      Specify max length of gecos [150]\r  --with-away-length=[n]       Specify max length of away [150]\r  --with-max-modes=[n]         Specify max modes per line which\r                               have parameters [20]\r  --with-maxbuf=[n]            Change the per message buffer size [512]\r                               DO NOT ALTER THIS OPTION WITHOUT GOOD REASON\r                               AS IT *WILL* BREAK CLIENTS!!!\r  --prefix=[directory]         Base directory to install into (if defined,\r                               can automatically define config, module, bin\r                         and library dirs as subdirectories of prefix)\r                               [$PWD]\r  --config-dir=[directory]     Config file directory for config and SSL certs\r                               [$PWD/conf]\r  --module-dir=[directory]     Modules directory for loadable modules\r                               [$PWD/modules]\r  --binary-dir=[directory]     Binaries directory for core binary\r                               [$PWD/bin]\r  --library-dir=[directory]    Library directory for core libraries\r                               [$PWD/lib]\r  --help                       Show this help text and exit\r\r";\r      exit(0);\r}\r\r1;\r\r
\ No newline at end of file
+#
+# InspIRCd -- Internet Relay Chat Daemon
+#
+#   Copyright (C) 2020 Nicole Kleinhoff <ilbelkyr@shalture.org>
+#   Copyright (C) 2013-2020 Sadie Powell <sadie@witchery.services>
+#   Copyright (C) 2012 Robby <robby@chatbelgie.be>
+#   Copyright (C) 2007-2008 Craig Edwards <brain@inspircd.org>
+#   Copyright (C) 2007 Dennis Friis <peavey@inspircd.org>
+#
+# This file is part of InspIRCd.  InspIRCd is free software: you can
+# redistribute it and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, version 2.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
+# details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+
+BEGIN {
+       require 5.10.0;
+}
+
+package make::configure;
+
+use feature ':5.10';
+use strict;
+use warnings FATAL => qw(all);
+
+use Exporter              qw(import);
+use File::Basename        qw(basename dirname);
+use File::Spec::Functions qw(abs2rel catdir catfile);
+
+use make::common;
+use make::console;
+
+use constant CONFIGURE_ROOT          => dirname dirname __FILE__;
+use constant CONFIGURE_DIRECTORY     => catdir(CONFIGURE_ROOT, '.configure');
+use constant CONFIGURE_CACHE_FILE    => catfile(CONFIGURE_DIRECTORY, 'cache.cfg');
+use constant CONFIGURE_CACHE_VERSION => '1';
+use constant CONFIGURE_ERROR_PIPE    => $ENV{INSPIRCD_VERBOSE} ? '' : '1>/dev/null 2>/dev/null';
+
+our @EXPORT = qw(CONFIGURE_CACHE_FILE
+                 CONFIGURE_CACHE_VERSION
+                 CONFIGURE_DIRECTORY
+                 cmd_clean
+                 cmd_help
+                 cmd_update
+                 run_test
+                 test_file
+                 test_header
+                 module_expand
+                 module_shrink
+                 write_configure_cache
+                 get_compiler_info
+                 find_compiler
+                 parse_templates);
+
+sub __get_socketengines {
+       my @socketengines;
+       foreach (<${\CONFIGURE_ROOT}/src/socketengines/socketengine_*.cpp>) {
+               s/src\/socketengines\/socketengine_(\w+)\.cpp/$1/;
+               push @socketengines, $1;
+       }
+       return @socketengines;
+}
+
+# TODO: when buildtool is done this can be mostly removed with
+#       the remainder being merged into parse_templates.
+sub __get_template_settings($$$) {
+
+       # These are actually hash references
+       my ($config, $compiler, $version) = @_;
+
+       # Start off by populating with the config
+       my %settings = %$config;
+
+       # Compiler information
+       while (my ($key, $value) = each %{$compiler}) {
+               $settings{'COMPILER_' . $key} = $value;
+       }
+
+       # Version information
+       while (my ($key, $value) = each %{$version}) {
+               $settings{'VERSION_' . $key} = $value;
+       }
+
+       # Miscellaneous information
+       $settings{CONFIGURE_DIRECTORY} = CONFIGURE_DIRECTORY;
+       $settings{CONFIGURE_CACHE_FILE} = CONFIGURE_CACHE_FILE;
+       $settings{SYSTEM_NAME} = lc $^O;
+
+       return %settings;
+}
+
+sub __test_compiler($) {
+       my $compiler = shift;
+       return 0 unless run_test("`$compiler`", !system "$compiler -v ${\CONFIGURE_ERROR_PIPE}");
+       return 0 unless run_test("`$compiler`", test_file($compiler, 'compiler.cpp', '-fno-rtti'), 'compatible');
+       return 1;
+}
+
+sub cmd_clean {
+       unlink CONFIGURE_CACHE_FILE;
+}
+
+sub cmd_help {
+       my $SELIST = join ', ', __get_socketengines();
+       print <<EOH;
+Usage: $0 [options]
+
+When no options are specified, configure runs in interactive mode and you must
+specify any required values manually. If one or more options are specified,
+non-interactive configuration is started and any omitted values are defaulted.
+
+PATH OPTIONS
+
+  --system                      Automatically set up the installation paths
+                                for system-wide installation.
+  --prefix=[dir]                The root install directory. If this is set then
+                                all subdirectories will be adjusted accordingly.
+                                [${\CONFIGURE_ROOT}/run]
+  --binary-dir=[dir]            The location where the main server binary is
+                                stored.
+                                [${\CONFIGURE_ROOT}/run/bin]
+  --config-dir=[dir]            The location where the configuration files and
+                                SSL certificates are stored.
+                                [${\CONFIGURE_ROOT}/run/conf]
+  --data-dir=[dir]              The location where the data files, such as the
+                                pid file, are stored.
+                                [${\CONFIGURE_ROOT}/run/data]
+  --example-dir=[dir]           The location where the example configuration files
+                                and SQL schemas are stored.
+                                [${\CONFIGURE_ROOT}/run/conf/examples]
+  --log-dir=[dir]               The location where the log files are stored.
+                                [${\CONFIGURE_ROOT}/run/logs]
+  --manual-dir=[dir]            The location where the manual files are stored.
+                                [${\CONFIGURE_ROOT}/run/manuals]
+  --module-dir=[dir]            The location where the loadable modules are
+                                stored.
+                                [${\CONFIGURE_ROOT}/run/modules]
+  --script-dir=[dir]            The location where the scripts, such as the
+                                init scripts, are stored.
+                                [${\CONFIGURE_ROOT}/run]
+
+EXTRA MODULE OPTIONS
+
+  --enable-extras=[extras]      Enables a comma separated list of extra modules.
+  --disable-extras=[extras]     Disables a comma separated list of extra modules.
+  --list-extras                 Shows the availability status of all extra
+                                modules.
+
+MISC OPTIONS
+
+  --clean                       Remove the configuration cache file and start
+                                the interactive configuration wizard.
+  --disable-auto-extras         Disables automatically enabling extra modules
+                                for which the dependencies are available.
+  --disable-interactive         Disables the interactive configuration wizard.
+  --distribution-label=[text]   Sets a distribution specific version label in
+                                the build configuration.
+  --gid=[id|name]               Sets the group to run InspIRCd as.
+  --help                        Show this message and exit.
+  --socketengine=[name]         Sets the socket engine to be used. Possible
+                                values are $SELIST.
+  --uid=[id|name]               Sets the user to run InspIRCd as.
+  --update                      Updates the build environment with the settings
+                                from the cache.
+
+
+FLAGS
+
+  CXX=[name]                    Sets the C++ compiler to use when building the
+                                server. If not specified then the build system
+                                will search for c++, g++, clang++ or icpc.
+
+If you have any problems with configuring InspIRCd then visit our IRC channel
+at irc.inspircd.org #InspIRCd or create a support discussion at
+https://github.com/inspircd/inspircd/discussions.
+
+Packagers: see https://docs.inspircd.org/packaging/ for packaging advice.
+EOH
+       exit 0;
+}
+
+sub cmd_update {
+       print_error "You have not run $0 before. Please do this before trying to update the generated files." unless -f CONFIGURE_CACHE_FILE;
+       say 'Updating...';
+       my %config = read_config_file(CONFIGURE_CACHE_FILE);
+       my %compiler = get_compiler_info($config{CXX});
+       my %version = get_version $config{DISTRIBUTION};
+       parse_templates(\%config, \%compiler, \%version);
+       say 'Update complete!';
+       exit 0;
+}
+
+sub run_test($$;$) {
+       my ($what, $result, $adjective) = @_;
+       $adjective //= 'available';
+       print_format "Checking whether <|GREEN $what|> is $adjective ... ";
+       print_format $result ? "<|GREEN yes|>\n" : "<|RED no|>\n";
+       return $result;
+}
+
+sub test_file($$;$) {
+       my ($compiler, $file, $args) = @_;
+       my $status = 0;
+       $args //= '';
+       $status ||= system "$compiler -o ${\CONFIGURE_ROOT}/__test_$file ${\CONFIGURE_ROOT}/make/test/$file $args ${\CONFIGURE_ERROR_PIPE}";
+       $status ||= system "${\CONFIGURE_ROOT}/__test_$file ${\CONFIGURE_ERROR_PIPE}";
+       unlink "${\CONFIGURE_ROOT}/__test_$file";
+       return !$status;
+}
+
+sub test_header($$;$) {
+       my ($compiler, $header, $args) = @_;
+       $args //= '';
+       open(my $fh, "| $compiler -E - $args ${\CONFIGURE_ERROR_PIPE}") or return 0;
+       print $fh "#include <$header>";
+       close $fh;
+       return !$?;
+}
+
+sub module_expand($) {
+       my $module = shift;
+       $module = "m_$module" unless $module =~ /^(?:m|core)_/;
+       $module = "$module.cpp" unless $module =~ /\.cpp$/;
+       return $module;
+}
+
+sub module_shrink($) {
+       my $module = basename shift;
+       return $module =~ s/(?:^m_|\.cpp$)//gr;
+}
+
+sub write_configure_cache(%) {
+       unless (-e CONFIGURE_DIRECTORY) {
+               print_format "Creating <|GREEN ${\abs2rel CONFIGURE_DIRECTORY, CONFIGURE_ROOT}|> ...\n";
+               create_directory CONFIGURE_DIRECTORY, 0750 or print_error "unable to create ${\CONFIGURE_DIRECTORY}: $!";
+       }
+
+       print_format "Writing <|GREEN ${\abs2rel CONFIGURE_CACHE_FILE, CONFIGURE_ROOT}|> ...\n";
+       my %config = @_;
+       write_config_file CONFIGURE_CACHE_FILE, %config;
+}
+
+sub get_compiler_info($) {
+       my $binary = shift;
+       my %info = (NAME => 'Unknown', VERSION => '0.0');
+       return %info if system "$binary -o __compiler_info ${\CONFIGURE_ROOT}/make/test/compiler_info.cpp ${\CONFIGURE_ERROR_PIPE}";
+       open(my $fh, '-|', './__compiler_info 2>/dev/null');
+       while (my $line = <$fh>) {
+               $info{$1} = $2 if $line =~ /^([A-Z]+)\s(.+)$/;
+       }
+       close $fh;
+       unlink './__compiler_info';
+       return %info;
+}
+
+sub find_compiler {
+       my @compilers = qw(c++ g++ clang++ icpc);
+       foreach my $compiler (shift // @compilers) {
+               return $compiler if __test_compiler $compiler;
+               return "xcrun $compiler" if $^O eq 'darwin' && __test_compiler "xcrun $compiler";
+       }
+}
+
+sub parse_templates($$$) {
+
+       # These are actually hash references
+       my ($config, $compiler, $version) = @_;
+
+       # Collect settings to be used when generating files
+       my %settings = __get_template_settings($config, $compiler, $version);
+
+       # Iterate through files in make/template.
+       foreach my $template (<${\CONFIGURE_ROOT}/make/template/*>) {
+               print_format "Parsing <|GREEN ${\abs2rel $template, CONFIGURE_ROOT}|> ...\n";
+               open(my $fh, $template) or print_error "unable to read $template: $!";
+               my (@lines, $mode, @platforms, @targets);
+
+               # First pass: parse template variables and directives.
+               while (my $line = <$fh>) {
+                       chomp $line;
+
+                       # Does this line match a variable?
+                       while ($line =~ /(@(\w+?)(?:\|(\w*))?@)/) {
+                               my ($variable, $name, $default) = ($1, $2, $3);
+                               if (defined $settings{$name}) {
+                                       $line =~ s/\Q$variable\E/$settings{$name}/;
+                               } elsif (defined $default) {
+                                       $line =~ s/\Q$variable\E/$default/;
+                               } else {
+                                       print_warning "unknown template variable '$name' in $template!";
+                                       last;
+                               }
+                       }
+
+                       # Does this line match a directive?
+                       if ($line =~ /^(\s*)%(\w+)\s+(.+)$/) {
+                               if ($2 eq 'define') {
+                                       if ($settings{$3}) {
+                                               push @lines, "#$1define $3";
+                                       } else {
+                                               push @lines, "#$1undef $3";
+                                       }
+                               } elsif ($2 eq 'mode') {
+                                       $mode = oct $3;
+                               } elsif ($2 eq 'platform') {
+                                       push @platforms, $3;
+                               } elsif ($2 eq 'target') {
+                                       push @targets, catfile CONFIGURE_ROOT, $3;
+                               } else {
+                                       print_warning "unknown template command '$2' in $template!";
+                                       push @lines, $line;
+                               }
+                               next;
+                       }
+                       push @lines, $line;
+               }
+               close $fh;
+
+               # Only proceed if this file should be templated on this platform.
+               if ($#platforms < 0 || grep { $_ eq $^O } @platforms) {
+
+                       # Add a default target if the template has not defined one.
+                       unless (@targets) {
+                               push @targets, catfile(CONFIGURE_DIRECTORY, basename $template);
+                       }
+
+                       # Write the templated files to disk.
+                       for my $target (@targets) {
+
+                               # Create the directory if it doesn't already exist.
+                               my $directory = dirname $target;
+                               unless (-e $directory) {
+                                       print_format "Creating <|GREEN ${\abs2rel $directory, CONFIGURE_ROOT}|> ...\n";
+                                       create_directory $directory, 0750 or print_error "unable to create $directory: $!";
+                               };
+
+                               # Write the template file.
+                               print_format "Writing <|GREEN ${\abs2rel $target, CONFIGURE_ROOT}|> ...\n";
+                               open(my $fh, '>', $target) or print_error "unable to write $target: $!";
+                               foreach (@lines) {
+                                       say $fh $_;
+                               }
+                               close $fh;
+
+                               # Set file permissions.
+                               if (defined $mode) {
+                                       chmod $mode, $target;
+                               }
+                       }
+               }
+       }
+}
+
+1;