Configure: unify clang's -Qunused-arguments option treatment.
[openssl.git] / Configurations / descrip.mms.tmpl
1 ## descrip.mms to build OpenSSL on OpenVMS
2 ##
3 ## {- join("\n## ", @autowarntext) -}
4 {-
5   use File::Spec::Functions qw/:DEFAULT abs2rel rel2abs/;
6
7   # Our prefix, claimed when speaking with the VSI folks Tuesday
8   # January 26th 2016
9   our $osslprefix = 'OSSL$';
10   (our $osslprefix_q = $osslprefix) =~ s/\$/\\\$/;
11
12   our $sover_dirname = sprintf "%02d%02d", split(/\./, $config{shlib_version_number});
13   our $osslver = sprintf "%02d%02d", split(/\./, $config{version});
14
15   our $sourcedir = $config{sourcedir};
16   our $builddir = $config{builddir};
17   sub sourcefile {
18       catfile($sourcedir, @_);
19   }
20   sub buildfile {
21       catfile($builddir, @_);
22   }
23   sub sourcedir {
24       catdir($sourcedir, @_);
25   }
26   sub builddir {
27       catdir($builddir, @_);
28   }
29   sub tree {
30       (my $x = shift) =~ s|\]$|...]|;
31       $x
32   }
33   sub move {
34       my $f = catdir(@_);
35       my $b = abs2rel(rel2abs("."),rel2abs($f));
36       $sourcedir = catdir($b,$sourcedir)
37           if !file_name_is_absolute($sourcedir);
38       $builddir = catdir($b,$builddir)
39           if !file_name_is_absolute($builddir);
40       "";
41   }
42
43   # Because we need to make two computations of these data,
44   # we store them in arrays for reuse
45   our @libs =
46       map { (my $x = $_) =~ s/\.a$//; $x }
47       @{$unified_info{libraries}};
48   our @shlibs =
49       map { $unified_info{sharednames}->{$_} || () }
50       grep(!/\.a$/, @{$unified_info{libraries}});
51   our @install_libs =
52       map { (my $x = $_) =~ s/\.a$//; $x }
53       @{$unified_info{install}->{libraries}};
54   our @install_shlibs =
55       map { $unified_info{sharednames}->{$_} || () }
56       grep(!/\.a$/, @{$unified_info{install}->{libraries}});
57   our @generated = ( ( map { (my $x = $_) =~ s|\.S$|\.s|; $x }
58                        grep { defined $unified_info{generate}->{$_} }
59                        map { @{$unified_info{sources}->{$_}} }
60                        grep { /\.o$/ } keys %{$unified_info{sources}} ),
61                      ( grep { /\.h$/ } keys %{$unified_info{generate}} ) );
62
63   # This is a horrible hack, but is needed because recursive inclusion of files
64   # in different directories does not work well with HP C.
65   my $sd = sourcedir("crypto", "async", "arch");
66   foreach (grep /\[\.crypto\.async\.arch\].*\.o$/, keys %{$unified_info{sources}}) {
67       (my $x = $_) =~ s|\.o$|.OBJ|;
68       $unified_info{before}->{$x}
69           = qq(arch_include = F\$PARSE("$sd","A.;",,,"SYNTAX_ONLY") - "A.;"
70         define arch 'arch_include');
71       $unified_info{after}->{$x}
72           = qq(deassign arch);
73   }
74   my $sd1 = sourcedir("ssl","record");
75   my $sd2 = sourcedir("ssl","statem");
76   my @ssl_locl_users = grep(/^\[\.(?:ssl\.(?:record|statem)|test)\].*\.o$/,
77                             keys %{$unified_info{sources}});
78   foreach (@ssl_locl_users) {
79       (my $x = $_) =~ s|\.o$|.OBJ|;
80       $unified_info{before}->{$x}
81           = qq(record_include = F\$PARSE("$sd1","A.;",,,"SYNTAX_ONLY") - "A.;"
82         define record 'record_include'
83         statem_include = F\$PARSE("$sd2","A.;",,,"SYNTAX_ONLY") - "A.;"
84         define statem 'statem_include');
85       $unified_info{after}->{$x}
86           = qq(deassign statem
87         deassign record);
88   }
89   # This makes sure things get built in the order they need
90   # to. You're welcome.
91   sub dependmagic {
92       my $target = shift;
93
94       return "$target : build_generated\n\t\pipe \$(MMS) \$(MMSQUALIFIERS) depend && \$(MMS) \$(MMSQUALIFIERS) _$target\n_$target";
95   }
96   #use Data::Dumper;
97   #print STDERR "DEBUG: before:\n", Dumper($unified_info{before});
98   #print STDERR "DEBUG: after:\n", Dumper($unified_info{after});
99   "";
100 -}
101 PLATFORM={- $config{target} -}
102 OPTIONS={- $config{options} -}
103 CONFIGURE_ARGS=({- join(", ",quotify_l(@{$config{perlargv}})) -})
104 SRCDIR={- $config{sourcedir} -}
105 BLDDIR={- $config{builddir} -}
106
107 # Allow both V and VERBOSE to indicate verbosity.  This only applies
108 # to testing.
109 VERBOSE=$(V)
110
111 VERSION={- $config{version} -}
112 MAJOR={- $config{major} -}
113 MINOR={- $config{minor} -}
114 SHLIB_VERSION_NUMBER={- $config{shlib_version_number} -}
115 SHLIB_VERSION_HISTORY={- $config{shlib_version_history} -}
116 SHLIB_MAJOR={- $config{shlib_major} -}
117 SHLIB_MINOR={- $config{shlib_minor} -}
118 SHLIB_TARGET={- $target{shared_target} -}
119
120 EXE_EXT=.EXE
121 LIB_EXT=.OLB
122 SHLIB_EXT=.EXE
123 OBJ_EXT=.OBJ
124 DEP_EXT=.D
125
126 LIBS={- join(", ", map { "-\n\t".$_.".OLB" } @libs) -}
127 SHLIBS={- join(", ", map { "-\n\t".$_.".EXE" } @shlibs) -}
128 ENGINES={- join(", ", map { "-\n\t".$_.".EXE" } @{$unified_info{engines}}) -}
129 PROGRAMS={- join(", ", map { "-\n\t".$_.".EXE" } @{$unified_info{programs}}) -}
130 SCRIPTS={- join(", ", map { "-\n\t".$_ } @{$unified_info{scripts}}) -}
131 {- output_off() if $disabled{makedepend}; "" -}
132 DEPS={- our @deps = map { (my $x = $_) =~ s|\.o$|\$(DEP_EXT)|; $x; }
133                     grep { $unified_info{sources}->{$_}->[0] =~ /\.c$/ }
134                     keys %{$unified_info{sources}};
135         join(", ", map { "-\n\t".$_ } @deps); -}
136 {- output_on() if $disabled{makedepend}; "" -}
137 GENERATED_MANDATORY={- join(", ", map { "-\n\t".$_ } @{$unified_info{depends}->{""}} ) -}
138 GENERATED={- join(", ", map { "-\n\t".$_ } @generated) -}
139
140 INSTALL_LIBS={- join(", ", map { "-\n\t".$_.".OLB" } @install_libs) -}
141 INSTALL_SHLIBS={- join(", ", map { "-\n\t".$_.".EXE" } @install_shlibs) -}
142 INSTALL_ENGINES={- join(", ", map { "-\n\t".$_.".EXE" } @{$unified_info{install}->{engines}}) -}
143 INSTALL_PROGRAMS={- join(", ", map { "-\n\t".$_.".EXE" } @{$unified_info{install}->{programs}}) -}
144 {- output_off() if $disabled{apps}; "" -}
145 BIN_SCRIPTS=[.tools]c_rehash.pl
146 MISC_SCRIPTS=[.apps]CA.pl, [.apps]tsget.pl
147 {- output_on() if $disabled{apps}; "" -}
148
149 APPS_OPENSSL={- use File::Spec::Functions;
150                 catfile("apps","openssl") -}
151
152 # DESTDIR is for package builders so that they can configure for, say,
153 # SYS$COMMON:[OPENSSL] and yet have everything installed in STAGING:[USER].
154 # In that case, configure with --prefix=SYS$COMMON:[OPENSSL] and then run
155 # MMS with /MACROS=(DESTDIR=STAGING:[USER]).  The result will end up in
156 # STAGING:[USER.OPENSSL].
157 # Normally it is left empty.
158 DESTDIR=
159
160 # Do not edit this manually. Use Configure --prefix=DIR to change this!
161 INSTALLTOP={- our $installtop =
162                   catdir($config{prefix}) || "SYS\$COMMON:[OPENSSL]";
163               $installtop -}
164 SYSTARTUP={- catdir($installtop, '[.SYS$STARTUP]'); -}
165 # This is the standard central area to store certificates, private keys...
166 OPENSSLDIR={- catdir($config{openssldir}) or
167               $config{prefix} ? catdir($config{prefix},"COMMON")
168                               : "SYS\$COMMON:[OPENSSL-COMMON]" -}
169 # The same, but for C
170 OPENSSLDIR_C={- $osslprefix -}DATAROOT:[000000]
171 # Where installed engines reside, for C
172 ENGINESDIR_C={- $osslprefix -}ENGINES{- $sover_dirname.$target{pointer_size} -}:
173
174 CC= {- $target{cc} -}
175 CFLAGS= /DEFINE=({- join(",", @{$target{defines}}, @{$config{defines}},"OPENSSLDIR=\"\"\"\$(OPENSSLDIR_C)\"\"\"","ENGINESDIR=\"\"\"\$(ENGINESDIR_C)\"\"\"") -}) {- $target{cflags} -} {- $config{cflags} -}
176 CFLAGS_Q=$(CFLAGS)
177 DEPFLAG= /DEFINE=({- join(",", @{$config{depdefines}}) -})
178 LDFLAGS= {- $target{lflags} -}
179 EX_LIBS= {- $target{ex_libs} ? ",".$target{ex_libs} : "" -}{- $config{ex_libs} ? ",".$config{ex_libs} : "" -}
180 LIB_CFLAGS={- $target{lib_cflags} // "" -}
181 DSO_CFLAGS={- $target{dso_cflags} // "" -}
182 BIN_CFLAGS={- $target{bin_cflags} // "" -}
183 NO_INST_LIB_CFLAGS={- $target{no_inst_lib_cflags} // '$(LIB_CFLAGS)' -}
184 NO_INST_DSO_CFLAGS={- $target{no_inst_dso_cflags} // '$(DSO_CFLAGS)' -}
185 NO_INST_BIN_CFLAGS={- $target{no_inst_bin_cflags} // '$(BIN_CFLAGS)' -}
186
187 PERL={- $config{perl} -}
188
189 # We let the C compiler driver to take care of .s files. This is done in
190 # order to be excused from maintaining a separate set of architecture
191 # dependent assembler flags. E.g. if you throw -mcpu=ultrasparc at SPARC
192 # gcc, then the driver will automatically translate it to -xarch=v8plus
193 # and pass it down to assembler.
194 AS={- $target{as} -}
195 ASFLAG={- $target{asflags} -}
196
197 # .FIRST and .LAST are special targets with MMS and MMK.
198 # The defines in there are for C.  includes that look like
199 # this:
200 #
201 #    #include <openssl/foo.h>
202 #    #include "internal/bar.h"
203 #
204 # will use the logical names to find the files.  Expecting
205 # DECompHP C to find files in subdirectories of whatever was
206 # given with /INCLUDE is a fantasy, unfortunately.
207 NODEBUG=@
208 .FIRST :
209         $(NODEBUG) openssl_inc1 = F$PARSE("[.include.openssl]","A.;",,,"syntax_only") - "A.;"
210         $(NODEBUG) openssl_inc2 = F$PARSE("{- catdir($config{sourcedir},"[.include.openssl]") -}","A.;",,,"SYNTAX_ONLY") - "A.;"
211         $(NODEBUG) internal_inc1 = F$PARSE("[.crypto.include.internal]","A.;",,,"SYNTAX_ONLY") - "A.;"
212         $(NODEBUG) internal_inc2 = F$PARSE("{- catdir($config{sourcedir},"[.include.internal]") -}","A.;",,,"SYNTAX_ONLY") - "A.;"
213         $(NODEBUG) internal_inc3 = F$PARSE("{- catdir($config{sourcedir},"[.crypto.include.internal]") -}","A.;",,,"SYNTAX_ONLY") - "A.;"
214         $(NODEBUG) DEFINE openssl 'openssl_inc1','openssl_inc2'
215         $(NODEBUG) DEFINE internal 'internal_inc1','internal_inc2','internal_inc3'
216         $(NODEBUG) staging_dir = "$(DESTDIR)"
217         $(NODEBUG) staging_instdir = ""
218         $(NODEBUG) staging_datadir = ""
219         $(NODEBUG) IF staging_dir .NES. "" THEN -
220                 staging_instdir = F$PARSE("A.;",staging_dir,"[]",,"SYNTAX_ONLY")
221         $(NODEBUG) IF staging_instdir - "]A.;" .NES. staging_instdir THEN -
222                 staging_instdir = staging_instdir - "]A.;" + ".OPENSSL-INSTALL]"
223         $(NODEBUG) IF staging_instdir - "A.;" .NES. staging_instdir THEN -
224                 staging_instdir = staging_instdir - "A.;" + "[OPENSSL-INSTALL]"
225         $(NODEBUG) IF staging_dir .NES. "" THEN -
226                 staging_datadir = F$PARSE("A.;",staging_dir,"[]",,"SYNTAX_ONLY")
227         $(NODEBUG) IF staging_datadir - "]A.;" .NES. staging_datadir THEN -
228                 staging_datadir = staging_datadir - "]A.;" + ".OPENSSL-COMMON]"
229         $(NODEBUG) IF staging_datadir - "A.;" .NES. staging_datadir THEN -
230                 staging_datadir = staging_datadir - "A.;" + "[OPENSSL-COMMON]"
231         $(NODEBUG) !
232         $(NODEBUG) ! Installation logical names
233         $(NODEBUG) !
234         $(NODEBUG) installtop = F$PARSE(staging_instdir,"$(INSTALLTOP)","[]A.;",,"SYNTAX_ONLY,NO_CONCEAL") - ".][000000" - "[000000." - "][" - "]A.;" + ".]"
235         $(NODEBUG) datatop = F$PARSE(staging_datadir,"$(OPENSSLDIR)","[]A.;",,"SYNTAX_ONLY,NO_CONCEAL") - ".][000000" - "[000000." - "][" - "]A.;" + ".]"
236         $(NODEBUG) DEFINE ossl_installroot 'installtop'
237         $(NODEBUG) DEFINE ossl_dataroot 'datatop'
238         $(NODEBUG) !
239         $(NODEBUG) ! Figure out the architecture
240         $(NODEBUG) !
241         $(NODEBUG) arch = f$edit( f$getsyi( "arch_name"), "upcase")
242         $(NODEBUG) !
243         $(NODEBUG) ! Set up logical names for the libraries, so LINK and
244         $(NODEBUG) ! running programs can use them.
245         $(NODEBUG) !
246         $(NODEBUG) {- join("\n\t\$(NODEBUG) ", map { "DEFINE ".uc($_)." 'F\$ENV(\"DEFAULT\")'".uc($_)."\$(SHLIB_EXT)" } @shlibs) || "!" -}
247
248 .LAST :
249         $(NODEBUG) {- join("\n\t\$(NODEBUG) ", map { "DEASSIGN ".uc($_) } @shlibs) || "!" -}
250         $(NODEBUG) DEASSIGN ossl_dataroot
251         $(NODEBUG) DEASSIGN ossl_installroot
252         $(NODEBUG) DEASSIGN internal
253         $(NODEBUG) DEASSIGN openssl
254 .DEFAULT :
255         @ ! MMS cannot handle no actions...
256
257 # The main targets ###################################################
258
259 {- dependmagic('all'); -} : build_libs_nodep, build_engines_nodep, build_programs_nodep
260 {- dependmagic('build_libs'); -} : build_libs_nodep
261 {- dependmagic('build_engines'); -} : build_engines_nodep
262 {- dependmagic('build_programs'); -} : build_programs_nodep
263
264 build_generated : $(GENERATED_MANDATORY)
265 build_libs_nodep : $(LIBS), $(SHLIBS)
266 build_engines_nodep : $(ENGINES)
267 build_programs_nodep : $(PROGRAMS), $(SCRIPTS)
268
269 # Kept around for backward compatibility
270 build_apps build_tests : build_programs
271
272 # Convenience target to prebuild all generated files, not just the mandatory
273 # ones
274 build_all_generated : $(GENERATED_MANDATORY) $(GENERATED)
275
276 test : tests
277 {- dependmagic('tests'); -} : build_programs_nodep, build_engines_nodep
278         @ ! {- output_off() if $disabled{tests}; "" -}
279         SET DEFAULT [.test]{- move("test") -}
280         DEFINE SRCTOP {- sourcedir() -}
281         DEFINE BLDTOP {- builddir() -}
282         DEFINE OPENSSL_ENGINES {- builddir("engines") -}
283         DEFINE OPENSSL_DEBUG_MEMORY "on"
284         IF "$(VERBOSE)" .NES. "" THEN DEFINE VERBOSE "$(VERBOSE)"
285         $(PERL) {- sourcefile("test", "run_tests.pl") -} $(TESTS)
286         DEASSIGN OPENSSL_DEBUG_MEMORY
287         DEASSIGN OPENSSL_ENGINES
288         DEASSIGN BLDTOP
289         DEASSIGN SRCTOP
290         SET DEFAULT [-]{- move("..") -}
291         @ ! {- if ($disabled{tests}) { output_on(); } else { output_off(); } "" -}
292         @ WRITE SYS$OUTPUT "Tests are not supported with your chosen Configure options"
293         @ ! {- output_on() if !$disabled{tests}; "" -}
294
295 list-tests :
296         @ ! {- output_off() if $disabled{tests}; "" -}
297         @ DEFINE SRCTOP {- sourcedir() -}
298         @ $(PERL) {- sourcefile("test", "run_tests.pl") -} list
299         @ DEASSIGN SRCTOP
300         @ ! {- if ($disabled{tests}) { output_on(); } else { output_off(); } "" -}
301         @ WRITE SYS$OUTPUT "Tests are not supported with your chosen Configure options"
302         @ ! {- output_on() if !$disabled{tests}; "" -}
303
304 install : install_sw install_ssldirs install_docs
305         @ WRITE SYS$OUTPUT ""
306         @ WRITE SYS$OUTPUT "######################################################################"
307         @ WRITE SYS$OUTPUT ""
308         @ IF "$(DESTDIR)" .EQS. "" THEN -
309              PIPE ( WRITE SYS$OUTPUT "Installation complete" ; -
310                     WRITE SYS$OUTPUT "" ; -
311                     WRITE SYS$OUTPUT "Run @$(SYSTARTUP)openssl_startup{- $osslver -} to set up logical names" ; -
312                     WRITE SYS$OUTPUT "then run @$(SYSTARTUP)openssl_utils{- $osslver -} to define commands" ; -
313                     WRITE SYS$OUTPUT "" )
314         @ IF "$(DESTDIR)" .NES. "" THEN -
315              PIPE ( WRITE SYS$OUTPUT "Staging installation complete" ; -
316                     WRITE SYS$OUTPUT "" ; -
317                     WRITE SYS$OUTPUT "Finish or package in such a way that the contents of the directory tree" ; -
318                     WRITE SYS$OUTPUT staging_instdir ; -
319                     WRITE SYS$OUTPUT "ends up in $(INSTALLTOP)," ; -
320                     WRITE SYS$OUTPUT "and that the contents of the contents of the directory tree" ; -
321                     WRITE SYS$OUTPUT staging_datadir ; -
322                     WRITE SYS$OUTPUT "ends up in $(OPENSSLDIR)" ; -
323                     WRITE SYS$OUTPUT "" ; -
324                     WRITE SYS$OUTPUT "When in its final destination," ; -
325                     WRITE SYS$OUTPUT "Run @$(SYSTARTUP)openssl_startup{- $osslver -} to set up logical names" ; -
326                     WRITE SYS$OUTPUT "then run @$(SYSTARTUP)openssl_utils{- $osslver -} to define commands" ; -
327                     WRITE SYS$OUTPUT "" )
328
329 check_install :
330         spawn/nolog @ossl_installroot:[SYSTEST]openssl_ivp{- $osslver -}.com
331
332 uninstall : uninstall_docs uninstall_sw
333
334 # Because VMS wants the generation number (or *) to delete files, we can't
335 # use $(LIBS), $(PROGRAMS), $(GENERATED) and $(ENGINES)directly.
336 libclean :
337         {- join("\n\t", map { "- DELETE $_.OLB;*" } @libs) || "@ !" -}
338         {- join("\n\t", map { "- DELETE $_.EXE;*,$_.MAP;*,$_.OPT;*" } @shlibs) || "@ !" -}
339
340 clean : libclean
341         {- join("\n\t", map { "- DELETE $_.EXE;*,$_.OPT;*" } @{$unified_info{programs}}) || "@ !" -}
342         {- join("\n\t", map { "- DELETE $_.EXE;*,$_.OPT;*" } @{$unified_info{engines}}) || "@ !" -}
343         {- join("\n\t", map { "- DELETE $_;*" } @{$unified_info{scripts}}) || "@ !" -}
344         {- join("\n\t", map { "- DELETE $_;*" } @generated) || "@ !" -}
345         - DELETE [...]*.MAP;*
346         - DELETE [...]*.D;*
347         - DELETE [...]*.OBJ;*,*.LIS;*
348         - DELETE []CXX$DEMANGLER_DB.;*
349         - DELETE [.VMS]openssl_startup.com;*
350         - DELETE [.VMS]openssl_shutdown.com;*
351         - DELETE []vmsconfig.pm;*
352
353 distclean : clean
354         - DELETE configdata.pm;*
355         - DELETE descrip.mms;*
356
357 depend : descrip.mms
358 descrip.mms : FORCE
359         @ ! {- output_off() if $disabled{makedepend}; "" -}
360         @ $(PERL) -pe "if (/^# DO NOT DELETE.*/) { exit(0); }" -
361                 < descrip.mms > descrip.mms-new
362         @ OPEN/APPEND DESCRIP descrip.mms-new
363         @ WRITE DESCRIP "# DO NOT DELETE THIS LINE -- make depend depends on it."
364         {- join("\n\t", map { "\@ IF F\$SEARCH(\"$_\") .NES. \"\" THEN TYPE $_ /OUTPUT=DESCRIP:" } @deps); -}
365         @ CLOSE DESCRIP
366         @ PIPE ( $(PERL) -e "use File::Compare qw/compare_text/; my $x = compare_text(""descrip.mms"",""descrip.mms-new""); exit(0x10000000 + ($x == 0));" || -
367                  RENAME descrip.mms-new descrip.mms )
368         @ IF F$SEARCH("descrip.mms-new") .NES. "" THEN DELETE descrip.mms-new;*
369         -@ SPAWN/OUTPUT=NLA0: PURGE/NOLOG descrip.mms
370         @ ! {- output_on() if $disabled{makedepend}; "" -}
371
372 # Install helper targets #############################################
373
374 install_sw : all install_shared _install_dev_ns -
375              install_engines _install_runtime_ns -
376              install_startup install_ivp
377
378 uninstall_sw : uninstall_shared _uninstall_dev_ns -
379                uninstall_engines _uninstall_runtime_ns -
380                uninstall_startup uninstall_ivp
381
382 install_docs : install_html_docs
383
384 uninstall_docs : uninstall_html_docs
385
386 install_ssldirs : check_INSTALLTOP
387         - CREATE/DIR/PROT=(S:RWED,O:RWE,G:RE,W:RE) OSSL_DATAROOT:[000000]
388         IF F$SEARCH("OSSL_DATAROOT:[000000]CERTS.DIR;1") .EQS. "" THEN -
389                 CREATE/DIR/PROT=(S:RWED,O:RWE,G:RE,W:RE) OSSL_DATAROOT:[CERTS]
390         IF F$SEARCH("OSSL_DATAROOT:[000000]PRIVATE.DIR;1") .EQS. "" THEN -
391                 CREATE/DIR/PROT=(S:RWED,O:RWE,G,W) OSSL_DATAROOT:[PRIVATE]
392         IF F$SEARCH("OSSL_DATAROOT:[000000]MISC.DIR;1") .EQS. "" THEN -
393                 CREATE/DIR/PROT=(S:RWED,O:RWE,G,W) OSSL_DATAROOT:[MISC]
394         COPY/PROT=W:RE $(MISC_SCRIPTS) OSSL_DATAROOT:[MISC]
395         @ ! Install configuration file
396         COPY/PROT=W:R {- sourcefile("apps", "openssl-vms.cnf") -} -
397                 ossl_dataroot:[000000]openssl.cnf-dist
398         IF F$SEARCH("OSSL_DATAROOT:[000000]openssl.cnf") .EQS. "" THEN -
399                 COPY/PROT=W:R {- sourcefile("apps", "openssl-vms.cnf") -} -
400                         ossl_dataroot:[000000]openssl.cnf
401         @ ! Install CTLOG configuration file
402         COPY/PROT=W:R {- sourcefile("apps", "ct_log_list.cnf") -} -
403                 ossl_dataroot:[000000]ct_log_list.cnf-dist
404         IF F$SEARCH("OSSL_DATAROOT:[000000]ct_log_list.cnf") .EQS. "" THEN -
405                 COPY/PROT=W:R {- sourcefile("apps", "ct_log_list.cnf") -} -
406                         ossl_dataroot:[000000]ct_log_list.cnf
407
408 install_shared : check_INSTALLTOP
409         @ {- output_off() if $disabled{shared}; "" -} !
410         @ WRITE SYS$OUTPUT "*** Installing shareable images"
411         @ ! Install shared (runtime) libraries
412         - CREATE/DIR ossl_installroot:[LIB.'arch']
413         {- join("\n        ",
414                 map { "COPY/PROT=W:R $_.EXE ossl_installroot:[LIB.'arch']" }
415                 @install_shlibs) -}
416         @ {- output_on() if $disabled{shared}; "" -} !
417
418 _install_dev_ns : check_INSTALLTOP
419         @ WRITE SYS$OUTPUT "*** Installing development files"
420         @ ! Install header files
421         - CREATE/DIR ossl_installroot:[include.openssl]
422         COPY/PROT=W:R openssl:*.h ossl_installroot:[include.openssl]
423         @ ! Install static (development) libraries
424         - CREATE/DIR ossl_installroot:[LIB.'arch']
425         {- join("\n        ",
426                 map { "COPY/PROT=W:R $_.OLB ossl_installroot:[LIB.'arch']" }
427                 @install_libs) -}
428
429 install_dev : install_shared _install_dev_ns
430
431 _install_runtime_ns : check_INSTALLTOP
432         @ ! Install the main program
433         - CREATE/DIR ossl_installroot:[EXE.'arch']
434         COPY/PROT=W:RE [.APPS]openssl.EXE -
435                 ossl_installroot:[EXE.'arch']openssl{- $osslver -}.EXE
436         @ ! Install scripts
437         COPY/PROT=W:RE $(BIN_SCRIPTS) ossl_installroot:[EXE]
438         @ ! {- output_on() if $disabled{apps}; "" -}
439
440 install_runtime : install_shared _install_runtime_ns
441
442 install_engines : check_INSTALLTOP
443         @ {- output_off() unless scalar @{$unified_info{engines}}; "" -} !
444         @ WRITE SYS$OUTPUT "*** Installing engines"
445         - CREATE/DIR ossl_installroot:[ENGINES{- $sover_dirname.$target{pointer_size} -}.'arch']
446         {- join("\n        ",
447                 map { "COPY/PROT=W:RE $_.EXE ossl_installroot:[ENGINES$sover_dirname$target{pointer_size}.'arch']" }
448                 @{$unified_info{install}->{engines}}) -}
449         @ {- output_on() unless scalar @{$unified_info{engines}}; "" -} !
450
451 install_startup : [.VMS]openssl_startup.com [.VMS]openssl_shutdown.com -
452                  [.VMS]openssl_utils.com, check_INSTALLTOP
453         - CREATE/DIR ossl_installroot:[SYS$STARTUP]
454         COPY/PROT=W:RE [.VMS]openssl_startup.com -
455                 ossl_installroot:[SYS$STARTUP]openssl_startup{- $osslver -}.com
456         COPY/PROT=W:RE [.VMS]openssl_shutdown.com -
457                 ossl_installroot:[SYS$STARTUP]openssl_shutdown{- $osslver -}.com
458         COPY/PROT=W:RE [.VMS]openssl_utils.com -
459                 ossl_installroot:[SYS$STARTUP]openssl_utils{- $osslver -}.com
460
461 install_ivp : [.VMS]openssl_ivp.com check_INSTALLTOP
462         - CREATE/DIR ossl_installroot:[SYSTEST]
463         COPY/PROT=W:RE [.VMS]openssl_ivp.com -
464                 ossl_installroot:[SYSTEST]openssl_ivp{- $osslver -}.com
465
466 [.VMS]openssl_startup.com : vmsconfig.pm {- sourcefile("VMS", "openssl_startup.com.in") -}
467         - CREATE/DIR [.VMS]
468         $(PERL) "-I." "-Mvmsconfig" {- sourcefile("util", "dofile.pl") -} -
469                 {- sourcefile("VMS", "openssl_startup.com.in") -} -
470                 > [.VMS]openssl_startup.com
471
472 [.VMS]openssl_utils.com : vmsconfig.pm {- sourcefile("VMS", "openssl_utils.com.in") -}
473         - CREATE/DIR [.VMS]
474         $(PERL) "-I." "-Mvmsconfig" {- sourcefile("util", "dofile.pl") -} -
475                 {- sourcefile("VMS", "openssl_utils.com.in") -} -
476                 > [.VMS]openssl_utils.com
477
478 [.VMS]openssl_shutdown.com : vmsconfig.pm {- sourcefile("VMS", "openssl_shutdown.com.in") -}
479         - CREATE/DIR [.VMS]
480         $(PERL) "-I." "-Mvmsconfig" {- sourcefile("util", "dofile.pl") -} -
481                 {- sourcefile("VMS", "openssl_shutdown.com.in") -} -
482                 > [.VMS]openssl_shutdown.com
483
484 [.VMS]openssl_ivp.com : vmsconfig.pm {- sourcefile("VMS", "openssl_ivp.com.in") -}
485         - CREATE/DIR [.VMS]
486         $(PERL) "-I." "-Mvmsconfig" {- sourcefile("util", "dofile.pl") -} -
487                 {- sourcefile("VMS", "openssl_ivp.com.in") -} -
488                 > [.VMS]openssl_ivp.com
489
490 vmsconfig.pm : configdata.pm
491         OPEN/WRITE/SHARE=READ CONFIG []vmsconfig.pm
492         WRITE CONFIG "package vmsconfig;"
493         WRITE CONFIG "use strict; use warnings;"
494         WRITE CONFIG "use Exporter;"
495         WRITE CONFIG "our @ISA = qw(Exporter);"
496         WRITE CONFIG "our @EXPORT = qw(%config %target %withargs %unified_info %disabled);"
497         WRITE CONFIG "our %config = ("
498         WRITE CONFIG "  target => '","{- $config{target} -}","',"
499         WRITE CONFIG "  version => '","{- $config{version} -}","',"
500         WRITE CONFIG "  shlib_version_number => '","{- $config{shlib_version_number} -}","',"
501         WRITE CONFIG "  shlib_major => '","{- $config{shlib_major} -}","',"
502         WRITE CONFIG "  shlib_minor => '","{- $config{shlib_minor} -}","',"
503         WRITE CONFIG "  no_shared => '","{- $disabled{shared} -}","',"
504         WRITE CONFIG "  INSTALLTOP => '$(INSTALLTOP)',"
505         WRITE CONFIG "  OPENSSLDIR => '$(OPENSSLDIR)',"
506         WRITE CONFIG "  pointer_size => '","{- $target{pointer_size} -}","',"
507         WRITE CONFIG ");"
508         WRITE CONFIG "our %target = ();"
509         WRITE CONFIG "our %disabled = ();"
510         WRITE CONFIG "our %withargs = ();"
511         WRITE CONFIG "our %unified_info = ();"
512         WRITE CONFIG "1;"
513         CLOSE CONFIG
514
515 install_html_docs : check_INSTALLTOP
516         sourcedir = F$PARSE("{- $sourcedir -}A.;","[]") - "]A.;" + ".DOC]"
517         $(PERL) {- sourcefile("util", "process_docs.pl") -} -
518                 --sourcedir='sourcedir' --destdir=ossl_installroot:[HTML] -
519                 --type=html
520
521 check_INSTALLTOP :
522         @ IF "$(INSTALLTOP)" .EQS. "" THEN -
523                 WRITE SYS$ERROR "INSTALLTOP should not be empty"
524         @ IF "$(INSTALLTOP)" .EQS. "" THEN -
525                 EXIT %x10000002
526
527 # Helper targets #####################################################
528
529 # Developer targets ##################################################
530
531 debug_logicals :
532         SH LOGICAL/PROC openssl,internal,ossl_installroot,ossl_dataroot
533
534 # Building targets ###################################################
535
536 configdata.pm : $(SRCDIR)Configure $(SRCDIR)config.com {- join(" ", @{$config{build_file_templates}}, @{$config{build_infos}}, @{$config{conf_files}}) -}
537         @ WRITE SYS$OUTPUT "Reconfiguring..."
538         perl $(SRCDIR)Configure reconf
539         @ WRITE SYS$OUTPUT "*************************************************"
540         @ WRITE SYS$OUTPUT "***                                           ***"
541         @ WRITE SYS$OUTPUT "***   Please run the same mms command again   ***"
542         @ WRITE SYS$OUTPUT "***                                           ***"
543         @ WRITE SYS$OUTPUT "*************************************************"
544         @ PIPE ( EXIT %X10000000 )
545
546 {-
547   use File::Basename;
548   use File::Spec::Functions qw/abs2rel rel2abs catfile catdir/;
549
550   # Helper function to figure out dependencies on libraries
551   # It takes a list of library names and outputs a list of dependencies
552   sub compute_lib_depends {
553       if ($disabled{shared}) {
554           return map { $_ =~ /\.a$/ ? $`.".OLB" : $_.".OLB" } @_;
555       }
556       return map { $_ =~ /\.a$/
557                    ? $`.".OLB"
558                    : $unified_info{sharednames}->{$_}.".EXE" } @_;
559   }
560
561   sub generatesrc {
562       my %args = @_;
563       my $generator = join(" ", @{$args{generator}});
564       my $generator_incs = join("", map { ' "-I'.$_.'"' } @{$args{generator_incs}});
565       my $deps = join(", -\n\t\t", @{$args{generator_deps}}, @{$args{deps}});
566
567       if ($args{src} !~ /\.[sS]$/) {
568           if ($args{generator}->[0] =~ m|^.*\.in$|) {
569               my $dofile = abs2rel(rel2abs(catfile($config{sourcedir},
570                                                    "util", "dofile.pl")),
571                                    rel2abs($config{builddir}));
572               return <<"EOF";
573 $args{src} : $args{generator}->[0] $deps
574         \$(PERL) "-I\$(BLDDIR)" "-Mconfigdata" $dofile \\
575             "-o$target{build_file}" $generator > \$@
576 EOF
577           } else {
578               return <<"EOF";
579 $args{src} : $args{generator}->[0] $deps
580         \$(PERL)$generator_incs $generator > \$@
581 EOF
582           }
583       } else {
584           die "No method to generate assembler source present.\n";
585       }
586   }
587
588   sub src2obj {
589       my %args = @_;
590       my $obj = $args{obj};
591       my $deps = join(", -\n\t\t", @{$args{srcs}}, @{$args{deps}});
592
593       # Because VMS C isn't very good at combining a /INCLUDE path with
594       # #includes having a relative directory (like '#include "../foo.h"),
595       # the best choice is to move to the first source file's intended
596       # directory before compiling, and make sure to write the object file
597       # in the correct position (important when the object tree is other
598       # than the source tree).
599       my $forward = dirname($args{srcs}->[0]);
600       my $backward = abs2rel(rel2abs("."), rel2abs($forward));
601       my $objd = abs2rel(rel2abs(dirname($obj)), rel2abs($forward));
602       my $objn = basename($obj);
603       my $srcs =
604           join(", ",
605                map { abs2rel(rel2abs($_), rel2abs($forward)) } @{$args{srcs}});
606       my $ecflags;
607       if ($args{installed}) {
608           $ecflags = { lib => '$(LIB_CFLAGS)',
609                        dso => '$(DSO_CFLAGS)',
610                        bin => '$(BIN_CFLAGS)' } -> {$args{intent}};
611       } else {
612           $ecflags = { lib => '$(NO_INST_LIB_CFLAGS)',
613                        dso => '$(NO_INST_DSO_CFLAGS)',
614                        bin => '$(NO_INST_BIN_CFLAGS)' } -> {$args{intent}};
615       }
616       my $incs_on = "\@ !";
617       my $incs_off = "\@ !";
618       my $incs = "";
619       my @incs = ();
620       push @incs, @{$args{incs}} if @{$args{incs}};
621       unless ($disabled{zlib}) {
622           # GNV$ZLIB_INCLUDE is the standard logical name for later zlib
623           # incarnations.
624           push @incs, ($withargs{zlib_include} || 'GNV$ZLIB_INCLUDE:');
625       }
626       if (@incs) {
627           $incs_on =
628               "DEFINE tmp_includes "
629               .join(",-\n\t\t\t", map {
630                                       file_name_is_absolute($_)
631                                       ? $_ : catdir($backward,$_)
632                                   } @incs);
633           $incs_off = "DEASSIGN tmp_includes";
634           $incs = " /INCLUDE=(tmp_includes:)";
635       }
636       my $before = $unified_info{before}->{$obj.".OBJ"} || "\@ !";
637       my $after = $unified_info{after}->{$obj.".OBJ"} || "\@ !";
638       my $depbuild = $disabled{makedepend} ? ""
639           : " /MMS=(FILE=${objd}${objn}.tmp-D,TARGET=$obj.OBJ)";
640
641       return <<"EOF";
642 $obj.OBJ : $deps
643         ${before}
644         SET DEFAULT $forward
645         $incs_on
646         \$(CC) \$(CFLAGS)${ecflags}${incs}${depbuild} /OBJECT=${objd}${objn}.OBJ /REPOSITORY=$backward $srcs
647         $incs_off
648         SET DEFAULT $backward
649         ${after}
650         \@ PIPE ( \$(PERL) -e "use File::Compare qw/compare_text/; my \$x = compare_text(""$obj.D"",""$obj.tmp-D""); exit(0x10000000 + (\$x == 0));" || -
651                  RENAME $obj.tmp-D $obj.d )
652         \@ IF F\$SEARCH("$obj.tmp-D") .NES. "" THEN DELETE $obj.tmp-D;*
653         - PURGE $obj.OBJ
654 EOF
655   }
656   sub libobj2shlib {
657       my %args = @_;
658       my $lib = $args{lib};
659       my $shlib = $args{shlib};
660       my $libd = dirname($lib);
661       my $libn = basename($lib);
662       (my $mkdef_key = $libn) =~ s/^${osslprefix_q}lib([^0-9]*)\d*/$1/i;
663       my @deps = compute_lib_depends(@{$args{deps}});
664       my $deps = join(", -\n\t\t", @deps);
665       my $shlib_target = $disabled{shared} ? "" : $target{shared_target};
666       my $ordinalsfile = defined($args{ordinals}) ? $args{ordinals}->[1] : "";
667       my $engine_opt = abs2rel(rel2abs(catfile($config{sourcedir},
668                                                "VMS", "engine.opt")),
669                                rel2abs($config{builddir}));
670       my $mkdef_pl = abs2rel(rel2abs(catfile($config{sourcedir},
671                                              "util", "mkdef.pl")),
672                              rel2abs($config{builddir}));
673       my $translatesyms_pl = abs2rel(rel2abs(catfile($config{sourcedir},
674                                                      "VMS", "translatesyms.pl")),
675                                      rel2abs($config{builddir}));
676       # The "[]" hack is because in .OPT files, each line inherits the
677       # previous line's file spec as default, so if no directory spec
678       # is present in the current line and the previous line has one that
679       # doesn't apply, you're in for a surprise.
680       my $write_opt =
681           join("\n\t", map { my $x = $_ =~ /\[/ ? $_ : "[]".$_;
682                              $x =~ s|(\.EXE)|$1/SHARE|;
683                              $x =~ s|(\.OLB)|$1/LIB|;
684                              "WRITE OPT_FILE \"$x\"" } @deps)
685           || "\@ !";
686       return <<"EOF"
687 $shlib.EXE : $lib.OLB $deps $ordinalsfile
688         \$(PERL) $mkdef_pl "$mkdef_key" "VMS" > $shlib.SYMVEC-tmp
689         \$(PERL) $translatesyms_pl \$(BLDDIR)CXX\$DEMANGLER_DB. < $shlib.SYMVEC-tmp > $shlib.SYMVEC
690         DELETE $shlib.SYMVEC-tmp;*
691         OPEN/WRITE/SHARE=READ OPT_FILE $shlib.OPT
692         WRITE OPT_FILE "IDENTIFICATION=""V$config{version}"""
693         TYPE $shlib.SYMVEC /OUTPUT=OPT_FILE:
694         WRITE OPT_FILE "$lib.OLB/LIBRARY"
695         $write_opt
696         CLOSE OPT_FILE
697         LINK \$(LDFLAGS)/SHARE=\$\@ $shlib.OPT/OPT \$(EX_LIBS)
698         DELETE $shlib.SYMVEC;*
699         PURGE $shlib.EXE,$shlib.OPT,$shlib.MAP
700 EOF
701         . ($config{target} =~ m|alpha| ? "" : <<"EOF"
702         SET IMAGE/FLAGS=(NOCALL_DEBUG) \$\@
703 EOF
704         );
705   }
706   sub obj2dso {
707       my %args = @_;
708       my $lib = $args{lib};
709       my $libd = dirname($lib);
710       my $libn = basename($lib);
711       (my $libn_nolib = $libn) =~ s/^lib//;
712       my @objs = map { "$_.OBJ" } @{$args{objs}};
713       my @deps = compute_lib_depends(@{$args{deps}});
714       my $deps = join(", -\n\t\t", @objs, @deps);
715       my $shlib_target = $disabled{shared} ? "" : $target{shared_target};
716       my $engine_opt = abs2rel(rel2abs(catfile($config{sourcedir},
717                                                "VMS", "engine.opt")),
718                                rel2abs($config{builddir}));
719       # The "[]" hack is because in .OPT files, each line inherits the
720       # previous line's file spec as default, so if no directory spec
721       # is present in the current line and the previous line has one that
722       # doesn't apply, you're in for a surprise.
723       my $write_opt1 =
724           join(",-\"\n\t", map { my $x = $_ =~ /\[/ ? $_ : "[]".$_;
725                                  "WRITE OPT_FILE \"$x" } @objs).
726           "\"";
727       my $write_opt2 =
728           join("\n\t", map { my $x = $_ =~ /\[/ ? $_ : "[]".$_;
729                              $x =~ s|(\.EXE)|$1/SHARE|;
730                              $x =~ s|(\.OLB)|$1/LIB|;
731                              "WRITE OPT_FILE \"$x\"" } @deps)
732           || "\@ !";
733       return <<"EOF"
734 $lib.EXE : $deps
735         OPEN/WRITE/SHARE=READ OPT_FILE $lib.OPT
736         TYPE $engine_opt /OUTPUT=OPT_FILE:
737         $write_opt1
738         $write_opt2
739         CLOSE OPT_FILE
740         LINK \$(LDFLAGS)/SHARE=\$\@ $lib.OPT/OPT \$(EX_LIBS)
741         - PURGE $lib.EXE,$lib.OPT,$lib.MAP
742 EOF
743         . ($config{target} =~ m|alpha| ? "" : <<"EOF"
744         SET IMAGE/FLAGS=(NOCALL_DEBUG) \$\@
745 EOF
746         );
747   }
748   sub obj2lib {
749       my %args = @_;
750       (my $lib = $args{lib}) =~ s/\.a$//;
751       my $objs = join(", -\n\t\t", map { $_.".OBJ" } (@{$args{objs}}));
752       my $fill_lib = join("\n\t", (map { "LIBRARY/REPLACE $lib.OLB $_.OBJ" }
753                                     @{$args{objs}}));
754       return <<"EOF";
755 $lib.OLB : $objs
756         LIBRARY/CREATE/OBJECT $lib.OLB
757         $fill_lib
758         - PURGE $lib.OLB
759 EOF
760   }
761   sub obj2bin {
762       my %args = @_;
763       my $bin = $args{bin};
764       my $bind = dirname($bin);
765       my $binn = basename($bin);
766       my @objs = map { "$_.OBJ" } @{$args{objs}};
767       my $objs = join(",", @objs);
768       my @deps = compute_lib_depends(@{$args{deps}});
769       my $deps = join(", -\n\t\t", @objs, @deps);
770
771       my $olb_count = scalar grep(m|\.OLB$|, @deps);
772       my $analyse_objs = "@ !";
773       if ($olb_count > 0) {
774           my $analyse_quals =
775               $config{target} =~ m|alpha| ? "/GSD" : "/SECTIONS=SYMTAB";
776           $analyse_objs = "- pipe ANALYSE/OBJECT$analyse_quals $objs | SEARCH SYS\$INPUT \"\"\"main\"\"\" ; nomain = \$severity .NE. 1"
777       }
778       # The "[]" hack is because in .OPT files, each line inherits the
779       # previous line's file spec as default, so if no directory spec
780       # is present in the current line and the previous line has one that
781       # doesn't apply, you're in for a surprise.
782       my $write_opt1 =
783           join(",-\"\n\t", map { my $x = $_ =~ /\[/ ? $_ : "[]".$_;
784                                  "\@ WRITE OPT_FILE \"$x" } @objs).
785           "\"";
786       my $write_opt2 =
787           join("\n\t", map { my @lines = ();
788                              my $x = $_ =~ /\[/ ? $_ : "[]".$_;
789                              if ($x =~ m|\.EXE$|) {
790                                  push @lines, "\@ WRITE OPT_FILE \"$x/SHARE\"";
791                              } elsif ($x =~ m|\.OLB$|) {
792                                  (my $l = $x) =~ s/\W/_/g;
793                                  push @lines, 
794                                      "\@ IF nomain THEN WRITE OPT_FILE \"$x/LIB\$(INCLUDE_MAIN_$l)\"",
795                                      "\@ IF .NOT. nomain THEN WRITE OPT_FILE \"$x/LIB\""
796                              }
797                              @lines
798                            } @deps)
799           || "\@ !";
800       # The linking commands looks a bit complex, but it's for good reason.
801       # When you link, say, foo.obj, bar.obj and libsomething.exe/share, and
802       # bar.obj happens to have a symbol that also exists in libsomething.exe,
803       # the linker will warn about it, loudly, and will then choose to pick
804       # the first copy encountered (the one in bar.obj in this example).
805       # On Unix and on Windows, the corresponding maneuvre goes through
806       # silently with the same effect.
807       # With some test programs, made for checking the internals of OpenSSL,
808       # we do this kind of linking deliberately, picking a few specific object
809       # files from within [.crypto] or [.ssl] so we can reach symbols that are
810       # otherwise unreachable (since the shareable images only exports the
811       # symbols listed in [.util]*.num), and then with the shared libraries
812       # themselves.  So we need to silence the warning about multiply defined
813       # symbols, to mimic the way linking work on Unix and Windows, and so
814       # the build isn't interrupted (MMS stops when warnings are signaled,
815       # by default), and so someone building doesn't have to worry where it
816       # isn't necessary.  If there are other warnings, however, we show them
817       # and let it break the build.
818       return <<"EOF"
819 $bin.EXE : $deps
820         $analyse_objs
821         @ OPEN/WRITE/SHARE=READ OPT_FILE $bin.OPT
822         $write_opt1
823         $write_opt2
824         @ CLOSE OPT_FILE
825         TYPE $bin.opt ! For debugging
826         - pipe SPAWN/WAIT/NOLOG/OUT=$bin.LINKLOG -
827                     LINK \$(LDFLAGS)/EXEC=\$\@ $bin.OPT/OPT \$(EX_LIBS) ; -
828                link_status = \$status ; link_severity = link_status .AND. 7
829         @ search_severity = 1
830         -@ IF link_severity .EQ. 0 THEN -
831                 pipe SEARCH $bin.LINKLOG "%","-"/MATCH=AND | -
832                      SPAWN/WAIT/NOLOG/OUT=NLA0: -
833                           SEARCH SYS\$INPUT: "-W-MULDEF,"/MATCH=NOR ; -
834                      search_severity = \$severity
835         @ ! search_severity is 3 when the last search didn't find any matching
836         @ ! string: %SEARCH-I-NOMATCHES, no strings matched
837         @ ! If that was the result, we pretend linking got through without
838         @ ! fault or warning.
839         @ IF search_severity .EQ. 3 THEN link_severity = 1
840         @ ! At this point, if link_severity shows that there was a fault
841         @ ! or warning, make sure to restore the linking status.
842         -@ IF .NOT. link_severity THEN TYPE $bin.LINKLOG
843         -@ DELETE $bin.LINKLOG;*
844         @ IF .NOT. link_severity THEN SPAWN/WAIT/NOLOG EXIT 'link_status'
845         - PURGE $bin.EXE,$bin.OPT
846 EOF
847       . ($config{target} =~ m|alpha| ? "" : <<"EOF"
848         SET IMAGE/FLAGS=(NOCALL_DEBUG) \$\@
849 EOF
850         );
851   }
852   sub in2script {
853       my %args = @_;
854       my $script = $args{script};
855       return "" if grep { $_ eq $script } @{$args{sources}}; # No overwrite!
856       my $sources = join(" ", @{$args{sources}});
857       my $dofile = abs2rel(rel2abs(catfile($config{sourcedir},
858                                            "util", "dofile.pl")),
859                            rel2abs($config{builddir}));
860       return <<"EOF";
861 $script : $sources
862         \$(PERL) "-I\$(BLDDIR)" "-Mconfigdata" $dofile -
863             "-o$target{build_file}" $sources > $script
864         SET FILE/PROT=(S:RWED,O:RWED,G:RE,W:RE) $script
865         PURGE $script
866 EOF
867   }
868   ""    # Important!  This becomes part of the template result.
869 -}