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