Profile of DynaLoader.pm

Filename	/usr/lib/perl5/5.14/i686-cygwin-threads-64int/DynaLoader.pm
Statements	Executed 953 statements in 58.1ms

Subroutines
Calls	P	F	Exclusive Time	Inclusive Time	Subroutine
195	2	1	40.3ms	40.3ms	DynaLoader::::CORE:ftfileDynaLoader::CORE:ftfile (opcode)
51	2	1	7.99ms	7.99ms	DynaLoader::::CORE:ftdirDynaLoader::CORE:ftdir (opcode)
1	1	1	7.19ms	8.16ms	DynaLoader::::croakDynaLoader::croak
1	1	1	2.62ms	49.2ms	DynaLoader::::dl_findfileDynaLoader::dl_findfile
1	1	1	199µs	199µs	DynaLoader::::BEGIN@18DynaLoader::BEGIN@18
1	1	1	193µs	59.4ms	DynaLoader::::bootstrapDynaLoader::bootstrap
3	3	1	52µs	52µs	DynaLoader::::CORE:regcompDynaLoader::CORE:regcomp (opcode)
31	9	1	50µs	50µs	DynaLoader::::CORE:matchDynaLoader::CORE:match (opcode)
1	1	1	22µs	56µs	DynaLoader::::BEGIN@22DynaLoader::BEGIN@22
11	1	1	19µs	19µs	DynaLoader::::CORE:substDynaLoader::CORE:subst (opcode)
0	0	0	0s	0s	DynaLoader::::bootstrap_inheritDynaLoader::bootstrap_inherit
0	0	0	0s	0s	DynaLoader::::dl_expandspecDynaLoader::dl_expandspec
0	0	0	0s	0s	DynaLoader::::dl_find_symbol_anywhereDynaLoader::dl_find_symbol_anywhere
0	0	0	0s	0s	DynaLoader::::dl_load_flagsDynaLoader::dl_load_flags

Call graph for these subroutines as a Graphviz dot language file.

Line	State ments	Time on line	Calls	Time in subs	Code
1
2					# Generated from DynaLoader_pm.PL
3
4					package DynaLoader;
5
6					# And Gandalf said: 'Many folk like to know beforehand what is to
7					# be set on the table; but those who have laboured to prepare the
8					# feast like to keep their secret; for wonder makes the words of
9					# praise louder.'
10
11					# (Quote from Tolkien suggested by Anno Siegel.)
12					#
13					# See pod text at end of file for documentation.
14					# See also ext/DynaLoader/README in source tree for other information.
15					#
16					# Tim.Bunce@ig.co.uk, August 1994
17
18					# spent 199µs within DynaLoader::BEGIN@18 which was called: # once (199µs+0s) by installer::BEGIN@32 at line 20 BEGIN {
19	1	20µs			$VERSION = '1.13';
20	1	62µs	1	199µs	} # spent 199µs making 1 call to DynaLoader::BEGIN@18
21
22	2	3.31ms	2	90µs	# spent 56µs (22+34) within DynaLoader::BEGIN@22 which was called: # once (22µs+34µs) by installer::BEGIN@32 at line 22 use Config; # spent 56µs making 1 call to DynaLoader::BEGIN@22 # spent 34µs making 1 call to Config::import
23
24					# enable debug/trace messages from DynaLoader perl code
25	1	5µs			$dl_debug = $ENV{PERL_DL_DEBUG} \|\| 0 unless defined $dl_debug;
26
27					#
28					# Flags to alter dl_load_file behaviour. Assigned bits:
29					# 0x01 make symbols available for linking later dl_load_file's.
30					# (only known to work on Solaris 2 using dlopen(RTLD_GLOBAL))
31					# (ignored under VMS; effect is built-in to image linking)
32					#
33					# This is called as a class method $module->dl_load_flags. The
34					# definition here will be inherited and result on "default" loading
35					# behaviour unless a sub-class of DynaLoader defines its own version.
36					#
37
38					sub dl_load_flags { 0x00 }
39
40	1	40µs	3	24µs	($dl_dlext, $dl_so, $dlsrc) = @Config::Config{qw(dlext so dlsrc)}; # spent 24µs making 3 calls to Config::FETCH, avg 8µs/call
41
42
43	1	500ns			$do_expand = 0;
44
45	1	2µs			@dl_require_symbols = (); # names of symbols we need
46	1	500ns			@dl_resolve_using = (); # names of files to link with
47	1	600ns			@dl_library_path = (); # path to look for files
48
49					#XSLoader.pm may have added elements before we were required
50					#@dl_shared_objects = (); # shared objects for symbols we have
51					#@dl_librefs = (); # things we have loaded
52					#@dl_modules = (); # Modules we have loaded
53
54					# This is a fix to support DLD's unfortunate desire to relink -lc
55	1	2µs			@dl_resolve_using = dl_findfile('-lc') if $dlsrc eq "dl_dld.xs";
56
57					# Initialise @dl_library_path with the 'standard' library path
58					# for this platform as determined by Configure.
59
60	1	14µs	1	5µs	push(@dl_library_path, split(' ', $Config::Config{libpth})); # spent 5µs making 1 call to Config::FETCH
61
62
63	1	8µs	1	5µs	my $ldlibpthname = $Config::Config{ldlibpthname}; # spent 5µs making 1 call to Config::FETCH
64	1	8µs	1	4µs	my $ldlibpthname_defined = defined $Config::Config{ldlibpthname}; # spent 4µs making 1 call to Config::FETCH
65	1	7µs	1	4µs	my $pthsep = $Config::Config{path_sep}; # spent 4µs making 1 call to Config::FETCH
66
67					# Add to @dl_library_path any extra directories we can gather from environment
68					# during runtime.
69
70	1	3µs			if ($ldlibpthname_defined &&
71					exists $ENV{$ldlibpthname}) {
72	1	51µs	1	16µs	push(@dl_library_path, split(/$pthsep/, $ENV{$ldlibpthname})); # spent 16µs making 1 call to DynaLoader::CORE:regcomp
73					}
74
75					# E.g. HP-UX supports both its native SHLIB_PATH and LD_LIBRARY_PATH.
76
77	1	2µs			if ($ldlibpthname_defined &&
78					$ldlibpthname ne 'LD_LIBRARY_PATH' &&
79					exists $ENV{LD_LIBRARY_PATH}) {
80					push(@dl_library_path, split(/$pthsep/, $ENV{LD_LIBRARY_PATH}));
81					}
82
83
84					# No prizes for guessing why we don't say 'bootstrap DynaLoader;' here.
85					# NOTE: All dl_*.xs (including dl_none.xs) define a dl_error() XSUB
86	1	3µs			boot_DynaLoader('DynaLoader') if defined(&boot_DynaLoader) &&
87					!defined(&dl_error);
88
89	1	500ns			if ($dl_debug) {
90					print STDERR "DynaLoader.pm loaded (@INC, @dl_library_path)\n";
91					print STDERR "DynaLoader not linked into this perl\n"
92					unless defined(&boot_DynaLoader);
93					}
94
95	1	107µs			1; # End of main code
96
97
98	2	3.18ms	1	495µs	# spent 8.16ms (7.19+971µs) within DynaLoader::croak which was called: # once (7.19ms+971µs) by DynaLoader::bootstrap at line 160 sub croak { require Carp; Carp::croak(@_) } # spent 495µs making 1 call to Carp::croak
99
100					sub bootstrap_inherit {
101	1	2µs			my $module = $_[0];
102	1	27µs			local isa = {"$module\::ISA"};
103	1	42µs			local @isa = (@isa, 'DynaLoader');
104					# Cannot goto due to delocalization. Will report errors on a wrong line?
105	1	6µs	1	59.4ms	bootstrap(@_); # spent 59.4ms making 1 call to DynaLoader::bootstrap
106					}
107
108					# spent 59.4ms (193µs+59.2) within DynaLoader::bootstrap which was called: # once (193µs+59.2ms) by installer::BEGIN@32 at line 105 sub bootstrap {
109					# use local vars to enable $module.bs script to edit values
110	1	3µs			local(@args) = @_;
111	1	1µs			local($module) = $args[0];
112	1	1µs			local(@dirs, $file);
113
114	1	500ns			unless ($module) {
115					require Carp;
116					Carp::confess("Usage: DynaLoader::bootstrap(module)");
117					}
118
119					# A common error on platforms which don't support dynamic loading.
120					# Since it's fatal and potentially confusing we give a detailed message.
121	1	2µs			croak("Can't load module $module, dynamic loading not available in this perl.\n".
122					" (You may need to build a new perl executable which either supports\n".
123					" dynamic loading or has the $module module statically linked into it.)\n")
124					unless defined(&dl_load_file);
125
- -
128	1	5µs			my @modparts = split(/::/,$module);
129	1	2µs			my $modfname = $modparts[-1];
130
131					# Some systems have restrictions on files names for DLL's etc.
132					# mod2fname returns appropriate file base name (typically truncated)
133					# It may also edit @modparts if required.
134	1	600ns			$modfname = &mod2fname(\@modparts) if defined &mod2fname;
135
136
137
138	1	4µs			my $modpname = join('/',@modparts);
139
140	1	500ns			print STDERR "DynaLoader::bootstrap for $module ",
141					"(auto/$modpname/$modfname.$dl_dlext)\n"
142					if $dl_debug;
143
144	1	15µs			foreach (@INC) {
145
146	11	18µs			my $dir = "$_/auto/$modpname";
147
148	11	1.93ms	11	1.85ms	next unless -d $dir; # skip over uninteresting directories # spent 1.85ms making 11 calls to DynaLoader::CORE:ftdir, avg 168µs/call
149
150					# check for common cases to avoid autoload of dl_findfile
151					my $try = "$dir/$modfname.$dl_dlext";
152					last if $file = ($do_expand) ? dl_expandspec($try) : ((-f $try) && $try);
153
154					# no luck here, save dir for possible later dl_findfile search
155					push @dirs, $dir;
156					}
157					# last resort, let dl_findfile have a go in all known locations
158	1	32µs	1	49.2ms	$file = dl_findfile(map("-L$_",@dirs,@INC), $modfname) unless $file; # spent 49.2ms making 1 call to DynaLoader::dl_findfile
159
160	1	18µs	1	8.16ms	croak("Can't locate loadable object for module $module in \@INC (\@INC contains: @INC)") # spent 8.16ms making 1 call to DynaLoader::croak
161					unless $file; # wording similar to error from 'require'
162
163
164					my $bootname = "boot_$module";
165					$bootname =~ s/\W/_/g;
166					@dl_require_symbols = ($bootname);
167
168					# Execute optional '.bootstrap' perl script for this module.
169					# The .bs file can be used to configure @dl_resolve_using etc to
170					# match the needs of the individual module on this architecture.
171					my $bs = $file;
172					$bs =~ s/(\.\w+)?(;\d*)?$/\.bs/; # look for .bs 'beside' the library
173					if (-s $bs) { # only read file if it's not empty
174					print STDERR "BS: $bs ($^O, $dlsrc)\n" if $dl_debug;
175					eval { do $bs; };
176					warn "$bs: $@\n" if $@;
177					}
178
179					my $boot_symbol_ref;
180
181
182
183					# Many dynamic extension loading problems will appear to come from
184					# this section of code: XYZ failed at line 123 of DynaLoader.pm.
185					# Often these errors are actually occurring in the initialisation
186					# C code of the extension XS file. Perl reports the error as being
187					# in this perl code simply because this was the last perl code
188					# it executed.
189
190					my $libref = dl_load_file($file, $module->dl_load_flags) or
191					croak("Can't load '$file' for module $module: ".dl_error());
192
193					push(@dl_librefs,$libref); # record loaded object
194
195					my @unresolved = dl_undef_symbols();
196					if (@unresolved) {
197					require Carp;
198					Carp::carp("Undefined symbols present after loading $file: @unresolved\n");
199					}
200
201					$boot_symbol_ref = dl_find_symbol($libref, $bootname) or
202					croak("Can't find '$bootname' symbol in $file\n");
203
204					push(@dl_modules, $module); # record loaded module
205
206					boot:
207					my $xs = dl_install_xsub("${module}::bootstrap", $boot_symbol_ref, $file);
208
209					# See comment block above
210
211					push(@dl_shared_objects, $file); # record files loaded
212
213					&$xs(@args);
214					}
215
216					# spent 49.2ms (2.62+46.5) within DynaLoader::dl_findfile which was called: # once (2.62ms+46.5ms) by DynaLoader::bootstrap at line 158 sub dl_findfile {
217					# Read ext/DynaLoader/DynaLoader.doc for detailed information.
218					# This function does not automatically consider the architecture
219					# or the perl library auto directories.
220	1	9µs			my (@args) = @_;
221	1	1µs			my (@dirs, $dir); # which directories to search
222	1	500ns			my (@found); # full paths to real files we have found
223					#my $dl_ext= 'dll'; # $Config::Config{'dlext'} suffix for perl extensions
224					#my $dl_so = 'dll'; # $Config::Config{'so'} suffix for shared libraries
225
226	1	500ns			print STDERR "dl_findfile(@args)\n" if $dl_debug;
227
228					# accumulate directories but process files as they appear
229	1	9µs			arg: foreach(@args) {
230					# Special fast case: full filepath requires no search
231
232
233	12	2.47ms	22	2.38ms	if (m:/: && -f $_) { # spent 2.36ms making 10 calls to DynaLoader::CORE:ftfile, avg 236µs/call # spent 16µs making 12 calls to DynaLoader::CORE:match, avg 1µs/call
234					push(@found,$_);
235					last arg unless wantarray;
236					next;
237					}
238
239
240					# Deal with directories first:
241					# Using a -L prefix is the preferred option (faster and more robust)
242	45	151µs	23	47µs	if (m:^-L:) { s/^-L//; push(@dirs, $_); next; } # spent 28µs making 12 calls to DynaLoader::CORE:match, avg 2µs/call # spent 19µs making 11 calls to DynaLoader::CORE:subst, avg 2µs/call
243
244					# Otherwise we try to try to spot directories by a heuristic
245					# (this is a more complicated issue than it first appears)
246	1	6µs	1	600ns	if (m:/: && -d $_) { push(@dirs, $_); next; } # spent 600ns making 1 call to DynaLoader::CORE:match
247
248
249
250					# Only files should get this far...
251	1	1µs			my(@names, $name); # what filenames to look for
252	1	6µs	1	1µs	if (m:-l: ) { # convert -lname to appropriate library name # spent 1µs making 1 call to DynaLoader::CORE:match
253					s/-l//;
254					push(@names,"lib$_.$dl_so");
255					push(@names,"lib$_.a");
256					} else { # Umm, a bare name. Try various alternatives:
257					# these should be ordered with the most likely first
258	1	38µs	2	27µs	push(@names,"$_.$dl_dlext") unless m/\.$dl_dlext$/o; # spent 26µs making 1 call to DynaLoader::CORE:regcomp # spent 500ns making 1 call to DynaLoader::CORE:match
259	1	18µs	2	10µs	push(@names,"$_.$dl_so") unless m/\.$dl_so$/o; # spent 9µs making 1 call to DynaLoader::CORE:regcomp # spent 500ns making 1 call to DynaLoader::CORE:match
260
261	1	8µs	1	1µs	push(@names,"cyg$_.$dl_so") unless m:/:; # spent 1µs making 1 call to DynaLoader::CORE:match
262
263	1	7µs	1	1µs	push(@names,"lib$_.$dl_so") unless m:/:; # spent 1µs making 1 call to DynaLoader::CORE:match
264	1	6µs	1	1µs	push(@names,"$_.a") if !m/\.a$/ and $dlsrc eq "dl_dld.xs"; # spent 1µs making 1 call to DynaLoader::CORE:match
265	1	3µs			push(@names, $_);
266					}
267	1	1µs			my $dirsep = '/';
268
269	1	11µs			foreach $dir (@dirs, @dl_library_path) {
270	40	6.39ms	40	6.14ms	next unless -d $dir; # spent 6.14ms making 40 calls to DynaLoader::CORE:ftdir, avg 154µs/call
271
272	37	207µs			foreach $name (@names) {
273	185	306µs			my($file) = "$dir$dirsep$name";
274	185	76µs			print STDERR " checking in $dir for $name\n" if $dl_debug;
275	185	39.0ms	185	37.9ms	$file = ($do_expand) ? dl_expandspec($file) : (-f $file && $file); # spent 37.9ms making 185 calls to DynaLoader::CORE:ftfile, avg 205µs/call
276					#$file = _check_file($file);
277	185	449µs			if ($file) {
278					push(@found, $file);
279					next arg; # no need to look any further
280					}
281					}
282					}
283					}
284	1	500ns			if ($dl_debug) {
285					foreach(@dirs) {
286					print STDERR " dl_findfile ignored non-existent directory: $_\n" unless -d $_;
287					}
288					print STDERR "dl_findfile found: @found\n";
289					}
290	1	29µs			return $found[0] unless wantarray;
291					@found;
292					}
293
- -
296					sub dl_expandspec {
297					my($spec) = @_;
298					# Optional function invoked if DynaLoader.pm sets $do_expand.
299					# Most systems do not require or use this function.
300					# Some systems may implement it in the dl_*.xs file in which case
301					# this Perl version should be excluded at build time.
302
303					# This function is designed to deal with systems which treat some
304					# 'filenames' in a special way. For example VMS 'Logical Names'
305					# (something like unix environment variables - but different).
306					# This function should recognise such names and expand them into
307					# full file paths.
308					# Must return undef if $spec is invalid or file does not exist.
309
310					my $file = $spec; # default output to input
311
312					return undef unless -f $file;
313					print STDERR "dl_expandspec($spec) => $file\n" if $dl_debug;
314					$file;
315					}
316
317					sub dl_find_symbol_anywhere
318					{
319					my $sym = shift;
320					my $libref;
321					foreach $libref (@dl_librefs) {
322					my $symref = dl_find_symbol($libref,$sym);
323					return $symref if $symref;
324					}
325					return undef;
326					}
327
328					__END__

					# spent 7.99ms within DynaLoader::CORE:ftdir which was called 51 times, avg 157µs/call: # 40 times (6.14ms+0s) by DynaLoader::dl_findfile at line 270, avg 154µs/call # 11 times (1.85ms+0s) by DynaLoader::bootstrap at line 148, avg 168µs/call sub DynaLoader::CORE:ftdir; # opcode
					# spent 40.3ms within DynaLoader::CORE:ftfile which was called 195 times, avg 207µs/call: # 185 times (37.9ms+0s) by DynaLoader::dl_findfile at line 275, avg 205µs/call # 10 times (2.36ms+0s) by DynaLoader::dl_findfile at line 233, avg 236µs/call sub DynaLoader::CORE:ftfile; # opcode
					# spent 50µs within DynaLoader::CORE:match which was called 31 times, avg 2µs/call: # 12 times (28µs+0s) by DynaLoader::dl_findfile at line 242, avg 2µs/call # 12 times (16µs+0s) by DynaLoader::dl_findfile at line 233, avg 1µs/call # once (1µs+0s) by DynaLoader::dl_findfile at line 263 # once (1µs+0s) by DynaLoader::dl_findfile at line 264 # once (1µs+0s) by DynaLoader::dl_findfile at line 252 # once (1µs+0s) by DynaLoader::dl_findfile at line 261 # once (600ns+0s) by DynaLoader::dl_findfile at line 246 # once (500ns+0s) by DynaLoader::dl_findfile at line 259 # once (500ns+0s) by DynaLoader::dl_findfile at line 258 sub DynaLoader::CORE:match; # opcode
					# spent 52µs within DynaLoader::CORE:regcomp which was called 3 times, avg 17µs/call: # once (26µs+0s) by DynaLoader::dl_findfile at line 258 # once (16µs+0s) by installer::BEGIN@32 at line 72 # once (9µs+0s) by DynaLoader::dl_findfile at line 259 sub DynaLoader::CORE:regcomp; # opcode
					# spent 19µs within DynaLoader::CORE:subst which was called 11 times, avg 2µs/call: # 11 times (19µs+0s) by DynaLoader::dl_findfile at line 242, avg 2µs/call sub DynaLoader::CORE:subst; # opcode