Specifications

12
Loadable Modules
The DLM Mechanism . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2
Loadable Module Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2
The Difference between Static Modules and Loadable Modules. . . . . . . . . . . . 12-2
Overview of the Load Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3
Overview of the Unload Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3
The Difference between a Demand Load and an Auto Load . . . . . . . . . . . . . . . 12-3
Demand Load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3
Auto Load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3
Demand Unload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-4
Auto Unload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-4
Making Modules Loadable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-5
Coding a Wrapper. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-5
Wrapper Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-5
Wrapper Data Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-6
Wrapper Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-6
Sample Wrapper Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-7
Packaging a Loadable Module for Installation. . . . . . . . . . . . . . . . . . . . . . . . . . 12-10
Master File Definitions for Loadable Modules . . . . . . . . . . . . . . . . . . . . . . 12-10
System File Definitions for Loadable Modules. . . . . . . . . . . . . . . . . . . . . . 12-11
Mtune File Definitions for Loadable Modules . . . . . . . . . . . . . . . . . . . . . . 12-11
Installing and Configuring a Loadable Module . . . . . . . . . . . . . . . . . . . . . . . . . 12-12
Managing Loadable Modules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-12
Loading the Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-12
Querying the Module's Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-13
Modifying the DLM Search Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-13
Unloading the Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-14
Debugging a Loadable Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-14
DLM Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-14
Dynamic Symbols and kdb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-14