xref: /illumos-gate/usr/src/lib/libslp/etc/slp.conf.example (revision fc910014e8a32a65612105835a10995f2c13d942)
1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License, Version 1.0 only
6# (the "License").  You may not use this file except in compliance
7# with the License.
8#
9# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10# or http://www.opensolaris.org/os/licensing.
11# See the License for the specific language governing permissions
12# and limitations under the License.
13#
14# When distributing Covered Code, include this CDDL HEADER in each
15# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16# If applicable, add the following below this CDDL HEADER, with the
17# fields enclosed by brackets "[]" replaced with your own identifying
18# information: Portions Copyright [yyyy] [name of copyright owner]
19#
20# CDDL HEADER END
21#
22# Copyright 1999 Sun Microsystems, Inc.  All rights reserved.
23# Use is subject to license terms.
24#
25
26#
27# Example configuration file for SLP. This file lists and explains
28# each property you can set for SLP. No properties are acutally set,
29# so uncomment and edit any properties you wish to change. The
30# file /etc/inet/slp.conf must exist in order for slpd(8) to start,
31# so copy this file to /etc/inet/slp.conf to enable SLP. See
32# slp.conf(5), slpd(8), or RFC 2614 for more information.
33#
34
35# Specifies if slpd should act as a DA. Default is false.
36#
37# net.slp.isDA=true
38#
39
40# Static scope configuration
41#
42# Determines the set of scopes which this SA or DA supports. These scopes
43# will also be included in the list returned from a find scopes query.
44# This example simply sets the property to the default:
45# net.slp.useScopes=default
46#
47# This example sets the property to a site-specific list:
48# net.slp.useScopes=building17,building18,admin
49#
50
51# Static DA Configuration
52#
53# Forces UAs and SAs to use a set of DAs.
54#
55# This example specifies two DAs:
56# net.slp.DAAddresses=192.168.1.20,192.168.2.20
57#
58
59# Serialized Proxy Registrations
60#
61# Specifies a file containing a set of registrations to be processed
62# when slpd starts up, written as an URL.
63# To load a proxy-registration file at /etc/inet/slpd.reg:
64# net.slp.serializedRegURL=file:/etc/inet/slpd.reg
65#
66
67# Tracing and Logging
68#
69# By default, all tracing and logging is disabled.
70#
71# Display messages about traffic with DAs:
72# net.slp.traceDATraffic=true
73#
74# Display details about SLP messages:
75# net.slp.traceMsg=true
76#
77# Display details whenever a message is dropped:
78# net.slp.traceDrop=true
79#
80# Dump service table upon registration or deregistration:
81# net.slp.traceReg=true
82#
83
84#
85# Set this property to change the default DA Heartbeat (10800 seconds).
86# This example sets it to 7200 seconds (two hours):
87# net.slp.DAHeartBeat=7200
88#
89
90#
91# Use this property to configure special attributes for DAs; these
92# will be included in the attrs field in a DAAdvert. Currently
93# the only useful property is min-refresh-interval, which allows
94# you to set the minimum interval for which a DA will accept
95# registration refreshes. This example sets the minimum interval
96# to 3 hours (10800 seconds):
97# net.slp.DAAttributes=(min-refresh-interval=10800)
98#
99
100#
101# Use this property to configure special attributes for SAs; these
102# will be included in the attrs field in a SAAdvert. This example
103# sets the attribute "special-features" to "none":
104# net.slp.SAAttributes=(special-features=none)
105#
106
107#
108# Force SLP agents to use broadcast only (instead of the default multicast):
109# net.slp.isBroadcastOnly=true
110#
111
112#
113# Disable passive DA detection. Default is enabled.
114# net.slp.passiveDADetection=false
115#
116
117#
118# Change the multicast time-to-live (TTL). Default is 255. This example
119# limits SLP multicast to the local subnet only:
120# net.slp.multicastTTL=1
121#
122
123#
124# Set this property to change the default interval between DA discoveries.
125# Default is 900 seconds (15 minutes). This example changes it to 2 minutes
126# (at the risk of increasing network congestion):
127# net.slp.DAActiveDiscoveryInterval=120
128#
129
130#
131# Set this property to change the maximum amount of time to wait until
132# multicast convergance completes. Default is 15000 ms (15 seconds). This
133# example changes it to 20000 ms (20 seconds), which may be desirable on
134# congested networks with many SAs:
135# net.slp.multicastMaximumWait=20000
136#
137
138#
139# Set this property to control the intervals used in multicast convergance.
140# The default is 3000,3000,3000,3000,3000 (all 3 seconds). The following
141# example reduces the initial intervals, which may be increase responsiveness
142# on fast networks:
143# net.slp.multicastTimeouts=1000,1250,1500,2000,4000
144#
145# This example sets it to an aggressively short value; this may be useful
146# for increased responsiveness on fast, reliable networks:
147# net.slp.multicastTimeouts=1000
148
149#
150# This property works in a manner similar to net.slp.multicastTimeouts,
151# but acts on DA discovery multicast convergance instead. Default is
152# 2000,2000,2000,2000,3000,4000. This example increases the intervals,
153# which may help to discovery DAs which are slow, heavily loaded, or on
154# congested networks:
155# net.slp.DADiscoveryTimeouts=3000,3000,4000,4000,4000,4000
156#
157
158#
159# This property controls the retransmission intervals used for datagram
160# unicast. Default is 3000,3000,3000. This example decreases the
161# intervals for more aggressive retransmission, to 2 seconds:
162# net.slp.datagramTimeouts=2000,2000,2000
163#
164
165#
166# Set this property to change the maximum random wait bound (used with
167# initial DA discovery, for instance). Default is 1000 ms (1 second).
168# This example changes it to 2 seconds:
169# net.slp.randomWaitBound=2000
170#
171
172#
173# Change this property to change the maximum size of any datagram to
174# send (MTU), in bytes. Default is 1400. This example changes it to
175# 1500 bytes:
176# net.slp.MTU=1500
177#
178
179#
180# Set this property to restrict SLP to specific interfaces. Default is
181# empty, which causes SLP to use the the default interface.
182#
183# net.slp.interfaces=192.168.1.5,192.168.3.5
184#
185
186#
187# This property specifies the language tag to use for all messages.
188# Default is "en". This example changes it to "de":
189# net.slp.locale=de
190#
191
192#
193# Set this property to limit the total number of results for any
194# SLP query. Default is all results (-1). This example limits it
195# to 100:
196# net.slp.maxResults=100
197#
198
199#
200# A type hint will be used if an agent needs to discover scopes with
201# service agent solicitations. If the type hint is set, only service
202# agents which support those types will respond. In effect, this poses
203# the query: "find me all scopes which contain these service types."
204#
205# This sets the type hint to service:foo and service:bar:
206# net.slp.typeHint=service:foo,service:bar
207#
208