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