Netscape ENTERPRISE SERVER 6.1, Руководство пользователя

Страница: 124 / 373

Creating and Using Custom SAFs
124 Netscape Enterprise Server NSAPI Programmer’s Guide • April 2002 (Draft)
Load and Initialize the SAF
For each shared library (plugin) containing custom SAFs to be loaded into the
Enterprise Server, add an
Init
directive that invokes the
load-modules
SAF to
magnus.conf
.
The syntax for a directive that calls
load-modules
is:
Init fn=load-modules shlib=
[path]sharedlibname
funcs="
SAF1,...,SAFn"
•
shlib
is the local file system path to the shared library (plugin).
•
funcs
is a comma-separated list of function names to be loaded from the
shared library. Function names are case-sensitive. You may use dash (-) in
place of underscore (_) in function names. There should be no spaces in the
function name list.
If the new SAFs require initialization, be sure that the initialization function is
included in the
funcs
list.
For example, if you created a shared library
animations.so
that defines two SAFs
do_small_anim()
and
do_big_anim()
and also defines the initialization function
init_my_animations
, you would add the following directive to load the plugin:
If necessary, also add an
Init
directive that calls the initialization function for the
newly loaded plugin. For example, if you defined the function
init_my_new_SAF()
to perform an operation on the
maxAnimLoop
parameter, you
would a directive such as the following to
magnus.conf
:
Init fn=init_my_animations maxAnimLoop=5
Instruct the Server to Call the SAFs
Next, add directives to
obj.conf
to instruct the server to call each custom SAF at
the appropriate time. The syntax for directives is:
Directive
fn=
function-name
[
name1
="
value1
"]...[
nameN
="
valueN
"]
• Directive is one of the server directives, such as
AuthTrans
,
Service
, and so on.
Init fn=load-modules shlib=animations.so
funcs="do_small_anim,do_big_anim,init_my_animations"