<!DOCTYPE doctype PUBLIC "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1">
<meta name="GENERATOR"
content="Mozilla/4.72C-CCK-MCD Caldera Systems OpenLinux [en] (X11; U; Linux 2.2.14 i686) [Netscape]">
<title>OpenSLP Users Guide - The slp.conf File</title>
</head>
<body text="#000000" bgcolor="#ffffff" link="#0000ee" vlink="#551a8b"
alink="#ff0000">
<h2> The slp.conf File</h2>
<hr width="100%">
<p>The slp.conf file contains configuration information that affects the operation
of the OpenSLP daemon (slpd) and any application that uses the OpenSLP library.
The master slp.conf file is located at <tt>/etc/slp.conf</tt>. There
is <a href="CommandLine.html">command line option</a> that forces slpd to
read a different configuration file, but the SLP library is hard coded to
read from <tt>/etc/slp.conf</tt> and can only be changed by re-compiling
the library. </p>
<p>The OpenSLP slp.conf file diverges <i>slightly</i> from the <a
href="../../rfc/rfc2614.txt">RFC 2614</a> specification for the slp configuration
file, so you should probably read <a
href="#Divergence%20from%20RFC%202614">Divergence from RFC 2614</a> even
if you are familiar with the RFC spec. <br>
</p>
<h3> File Syntax</h3>
The slp.conf file syntax is very simple. OpenSLP follows the syntax
specified in <a href="../../rfc/rfc2614.txt">RFC 2614</a> which is simply
a list of key/value pairs separated by newlines; comment lines begin with
a '#' or a ';'. A good example file is copied to <tt>/etc/slp.conf</tt>
with the OpenSLP distribution. Take a look at it or <a
href="../../rfc/rfc2614.txt">read the RFC if you need more details</a>. <br>
<h3> Settings</h3>
The following is a list of settings that are supported by OpenSLP:
<p><b>net.slp.useScopes</b> </p>
<blockquote>This option is a comma delimited list of strings indicating the
only scopes a UA or SA is allowed when making requests or registering or
the scopes a DA must support. The default value is "DEFAULT".</blockquote>
<p><b>net.slp.DAAddresses</b></p>
<blockquote>Allows administrator to force UA and SA agents to use specific
DAs. If this setting is not used dynamic DA discovery will be used to
determine which DAs to use. Default is to use dynamic DA discovery.</blockquote>
<b>net.slp.isBroadcastOnly</b>
<blockquote>Force broadcasts to be used instead of multicast. This setting
is seldom necessary since OpenSLP will automatically use broadcast if multicast
is unavailable. Default is false.</blockquote>
<b>net.slp.passiveDADetection</b>
<blockquote>A boolean indicating whether passive DA detection should be used.
Default is true.</blockquote>
<b>net.slp.DAActiveDiscoveryInterval</b>
<blockquote>A 16 bit positive integer giving the number of seconds between
DA active discovery queries. Default is 900 seconds (15 minutes).
If the property is set to zero, active discovery is turned off. This
is useful when the DAs available are explicitly restricted to those obtained
from DHCP or the net.slp.DAAddresses property.</blockquote>
<b>net.slp.multicastTTL</b>
<blockquote>A positive integer that is less than or equal to 255. The
default is 255.</blockquote>
<b>net.slp.multicastMaximumWait</b>
<blockquote>An integer giving the maximum amount of time (in milliseconds)
to perform multicast requests. Default is 15000 ms or 15 secs.</blockquote>
<b>net.slp.unicastMaxi</b>mumWait
<blockquote>An integer giving the maximum amount of time (in milliseconds)
to perform unicast requests. Default is 15000 ms or 15 secs.</blockquote>
<b>net.slp.randomWaitBound</b>
<blockquote>An integer giving the maximum value for all random wait parameters.
Default is 1000 or 1 sec.</blockquote>
<b>net.slp.MTU</b>
<blockquote>A integer giving the network packet MTU in bytes. Default
is 1400 bytes.</blockquote>
<b>net.slp.interfaces</b>
<blockquote>A list of IP address of network interfaces on which the DA/SA
should listen for slp requests. By default, OpenSLP will use all interfaces.</blockquote>
<b>net.slp.securityEnabled</b>
<blockquote>Indicates whether all agents should use authentication blocks.</blockquote>
net.slp.locale
<blockquote>A RFC 1766 Language Tag [6] for the language locale. Setting
this property causes the property value to become the default locale for
SLP messages. Default is "en". This property is also used for
SA and DA configuration.</blockquote>
<b>net.slp.maxResults</b>
<blockquote>A 32 bit integer giving the maximum number of results to accumulate
and return for a synchronous request before the timeout, or the maximum number
of results to return through a callback if the request results are reported
asynchronously.</blockquote>
<b>net.slp.isDA </b>
<blockquote>A boolean indicating if the SLP server is to act as a DA. If false,
not run as a DA. Default is false.</blockquote>
<b>net.slp.DAHeartBeat</b>
<blockquote>A 32 bit integer giving the number of seconds for the DA heartbeat.
Default is 3 hours (10800 seconds). Ignored if net.slp.isDA is false.</blockquote>
net.slp.DAAttributes (currently ignored)
<blockquote>A comma-separated list of parenthesized attribute/value list pairs
that the DA must advertise in DAAdverts. The property must be in the
SLP attribute list wire format, including escapes for reserved characters.
[7]</blockquote>
<h3> <a name="Divergance from RFC 2614"></a>Divergence from RFC 2614</h3>
OpenSLP does not support all of the settings that are specified by RFC 2614.
The reasons for not supporting some of the settings range from the implementors'
opinions that they are either not useful or very difficult to implement with
regard to their usefulness. The following is a list of options that
OpenSLP has no plans to support.
<p><b>net.slp.serializedRegURL</b> </p>
<blockquote>slpd accepts the [-r] command line parameter that specifies the
serialized registration file to use.</blockquote>
<b>net.slp.multicastTimeouts</b>
<blockquote>OpenSLP does not honor this parameter. Currently multicast
timeouts are generated internally based on the net.slp.multicastMaximumWait
parameter.</blockquote>
<b>net.slp.DADiscoveryTimeouts</b>
<blockquote>OpenSLP does not honor this parameter. Currently multicast
timeouts are generated internally based on the net.slp.multicastMaximumWait
parameter.</blockquote>
<b>net.slp.datagramTimeouts</b>
<blockquote>OpenSLP does not honor this parameter. Currently unicast
timeouts are generated internally based on the net.slp.unicastMaximumWait
parameter.</blockquote>
<br>
</body>
</html>
