ExtUtils::Mksymlists

Produces option files used by some operating systems' linkers during creation of shared libraries for dynamic extensions. Normally called from a Makefile when a module is built; it exports one function.

Mksymlists 
Mksymlists (varlist)

Creates the linker option file. The varlist argument is a list of key/value pairs. For example: 

use ExtUtils::Mksymlists; Mksymlists({ NAME => $name, DL_VARS => [$var1, $var2, $var3], DL_FUNCS => [$pkg1 => [$func1, $func2], $pkg2 => [$func3]});

Valid keys are:

  • DLBASE
  • The name by which the linker knows the module. If not specified, it is derived from the NAME attribute. Currently used only by OS/2.
  • DL_FUNCS
  • Identical to the MakeMaker DL_FUNCS attribute and usually taken from it. Its value is a reference to a hash, in which each key is a package name, and each value is a reference to an array of function names to be exported by the module.
  • DL_VARS
  • Identical to the MakeMaker DL_VARS attribute, and usually taken from it. Its value is a reference to an array of variable names to be exported by the extension.
  • FILE
  • The name of the linker option file (minus the OS-specific extension) if you don't want to use the default value (the last word of the NAME attribute).
  • FUNCLIST
  • An alternate way of specifying function names to be exported from the module. Its value is a reference to an array of function names to be exported, which are passed unaltered to the linker options file.
  • NAME
  • The name of the module for which the linker option file is to be produced. Should always be specified.