1 #
2 # Copyright (c) 2002, 2008, Oracle and/or its affiliates. All rights reserved.
3 #
4
5 #
6 # Makefile.PL for ::Exacct
7 #
8
9 #
10 # Linker flags note:
11 # The various .so files that comprise the ::Exacct module need to be able to
12 # cross-call each other, and therefore to prevent runtime linker errors it is
13 # necessary to establish linker dependencies between the various .so files.
14 #
15 # This causes several problems. The first of these is that perl .so files are
16 # built in one directory (under ../blib in this case) and installed into
17 # another, so it is necessary to record the dependency using a path relative to
18 # the dependent. This can be done with the $ORIGIN linker mechanism.
19
20 # The second problem is that it is necessary to specify the name of the
21 # dependee at link edit time in a manner that doesn't result in the build-time
22 # path of the dependee being hard coded in to the dependent, as this would
23 # stop ld.so.1 performing its normal search process for the files. This can't
24 # be done with the normal '--L/my/lib/path -lmylib' mechanism, because the XSUB
25 # .so files aren't prefixed with 'lib'. To do this the -h linker flag is used
26 # to explicitly set the SONAME in the dependee. This is then used as the name
27 # of the dependent in the dependee rather than the full path by which it was
28 # found at link edit time.
29 #
30 # For more details, refer to the Linker and Libraries Guide.
31 #
32
33 require 5.8.4;
34 use strict;
35 use warnings;
36 use ExtUtils::MakeMaker;
37
38 our (@defines, @man3pods);
39
40 #
41 # MakeMaker overrides.
42 #
43 package MY;
44 no warnings qw(once);
45
46 #
47 # Overrides that are common to both the ON and non-ON build environments.
48 #
49
50 #
51 # Force the parent directory to be built first, because the sub-modules all
52 # have a linker dependency against Exacct.so.
53 #
54 sub top_targets
55 {
56 my $self = shift(@_);
57 my $txt = $self->SUPER::top_targets(@_);
58 $txt =~ s/pm_to_blib subdirs/pm_to_blib \$(LINKTYPE) .WAIT subdirs/;
59 return($txt);
60 }
61
62 #
63 # Make 'install' wait for 'all' to complete.
64 #
65 sub install
66 {
67 my $self = shift(@_);
68 my $txt = $self->SUPER::install(@_);
69 $txt =~ s/ all / all .WAIT /g;
70 return($txt);
71 }
72
73 #
74 # Suppress the setting of LD_RUN_PATH, as it isn't necessary.
75 #
76 sub const_loadlibs
77 {
78 my $self = shift(@_);
79 delete($self->{LD_RUN_PATH});
80 return($self->SUPER::const_loadlibs(@_));
81 }
82
83 sub dynamic_lib
84 {
85 my $self = shift(@_);
86 my $txt = $self->SUPER::dynamic_lib(@_);
87 $txt =~ s/LD_RUN_PATH=\S*\s*//;
88 return($txt);
89 }
90
91 #
92 # ON-specific overrides.
93 #
94 if (exists($ENV{CODEMGR_WS}) && exists($ENV{ENVCPPFLAGS1})) {
95 #
96 # Override postamble and replace it with one that explicitly records
97 # the dependency between Exacct.c (generated from Exacct.xs by xsubpp)
98 # and the ExacctDefs.xi file (generated from sys/exacct.h by
99 # extract_defines). Note we have to mimic the -I processing done by cc
100 # to find the correct version of the file, as we want the copy from the
101 # proto area rather than /usr/include. This ensures that the constant
102 # values exported by the perl module stay up-to date with the
103 # corresponding #defines.
104 #
105 *postamble = sub {
106 return <<'EOF';
107 EXACCT_H:sh= \
108 for dir in $ENVCPPFLAGS1 $ENVCPPFLAGS2 $ENVCPPFLAGS3 $ENVCPPFLAGS4 \
109 /usr/include; do \
110 dir=`expr $dir : '^-I\(.*\)$' \| $dir`; \
111 file="$dir/sys/exacct.h"; \
112 test -f $file && echo $file && break; \
113 done;
114
115 Exacct.c: ExacctDefs.xi
116
117 ExacctDefs.xi: extract_defines $(EXACCT_H)
118 $(PERL) extract_defines Exacct $@ $(EXACCT_H)
119 EOF
120 };
121
122 # Enable/disable debugging as required.
123 @main::defines = ( DEFINE => '-DEXACCT_DEBUG' )
124 if (! exists($ENV{RELEASE_BUILD}));
125
126 # Don't install POD pages for ON.
127 @main::man3pods = ( MAN3PODS => {} );
128
129 #
130 # Non-ON overrides.
131 #
132 } else {
133 #
134 # Override postamble and replace it with one that explicitly records
135 # the dependency between Exacct.c (generated from Exacct.xs by xsubpp)
136 # and the ExacctDefs.xi file (generated from /usr/include/sys/exacct.h
137 # by extract_defines). This ensures that the constant values exported
138 # by the perl module stay up-to date with the corresponding #defines.
139 #
140 *postamble = sub {
141 return <<'EOF';
142 EXACCT_H = /usr/include/sys/exacct.h
143
144 Exacct.c: ExacctDefs.xi
145
146 ExacctDefs.xi: extract_defines $(EXACCT_H)
147 $(PERL) extract_defines Exacct $@ $(EXACCT_H)
148 EOF
149 };
150
151 # Install the POD documentation for non-ON builds.
152 my $man3pfx = '$(INST_MAN3DIR)/Sun::Solaris::Exacct';
153 @main::man3pods = (
154 MAN3PODS => { 'pod/Exacct.pod' => $man3pfx . '.$(MAN3EXT)' }
155 );
156 }
157
158 #
159 # Having set everything up, write the Makefile.
160 #
161 package main;
162
163 WriteMakefile(
164 NAME => 'Sun::Solaris::Exacct',
165 VERSION_FROM => 'Exacct.pm',
166 DIR => [ qw(Catalog File Object) ],
167 H => [ 'exacct_common.xh' ],
168 LIBS => [ '-lexacct' ],
169 @defines,
170 @man3pods,
171 dynamic_lib => { OTHERLDFLAGS => '-h $(DLBASE).$(DLEXT)' },
172 realclean => { FILES => 'ExacctDefs.xi' },
173 );