home | O'Reilly's CD bookshelfs | FreeBSD | Linux | Cisco | Cisco Exam  


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, where 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.