summaryrefslogtreecommitdiffstats
path: root/contrib/perl5/ext/DynaLoader/README
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/perl5/ext/DynaLoader/README')
-rw-r--r--contrib/perl5/ext/DynaLoader/README53
1 files changed, 0 insertions, 53 deletions
diff --git a/contrib/perl5/ext/DynaLoader/README b/contrib/perl5/ext/DynaLoader/README
deleted file mode 100644
index 0551cf3..0000000
--- a/contrib/perl5/ext/DynaLoader/README
+++ /dev/null
@@ -1,53 +0,0 @@
-Perl 5 DynaLoader
-
-See DynaLoader.pm for detailed specification.
-
-This module is very similar to the other Perl 5 modules except that
-Configure selects which dl_*.xs file to use.
-
-After Configure has been run the Makefile.PL will generate a Makefile
-which will run xsubpp on a specific dl_*.xs file and write the output
-to DynaLoader.c
-
-After that the processing is the same as any other module.
-
-Note that, to be effective, the DynaLoader module must be _statically_
-linked into perl! Configure should arrange this.
-
-This interface is based on the work and comments of (in no particular
-order): Larry Wall, Robert Sanders, Dean Roehrich, Jeff Okamoto, Anno
-Siegel, Thomas Neumann, Paul Marquess, Charles Bailey and others.
-
-The dl_*.xs files should either be named after the dynamic linking
-operating system interface used if that interface is available on more
-than one type of system, e.g.:
- dlopen for dlopen()/dlsym() type functions (SunOS, BSD)
- dld for the GNU dld library functions (linux, ?)
-or else the osname, e.g., hpux, next, vms etc.
-
-Both are determined by Configure and so only those specific names that
-Configure knows/uses will work.
-
-If porting the DynaLoader to a platform that has a core dynamic linking
-interface similar to an existing generic type, e.g., dlopen or dld,
-please try to port the corresponding dl_*.xs file (using #ifdef's if
-required).
-
-Otherwise, or if that proves too messy, create a new dl_*.xs file named
-after your osname. Configure will give preference to a dl_$osname.xs
-file if one exists.
-
-The file dl_dlopen.xs is a reference implementation by Paul Marquess
-which is a good place to start if porting from scratch. For more complex
-platforms take a look at dl_dld.xs. The dlutils.c file holds some
-common definitions that are #included into the dl_*.xs files.
-
-After the initial implementation of a new DynaLoader dl_*.xs file you
-may need to edit or create ext/MODULE/MODULE.bs files (library bootstrap
-files) to reflect the needs of your platform and linking software.
-
-Refer to DynaLoader.pm, lib/ExtUtils/MakeMaker.pm and any existing
-ext/MODULE/MODULE.bs files for more information.
-
-Tim Bunce.
-August 1994
OpenPOWER on IntegriCloud