17c478bd9Sstevel@tonic-gate#
27c478bd9Sstevel@tonic-gate# CDDL HEADER START
37c478bd9Sstevel@tonic-gate#
47c478bd9Sstevel@tonic-gate# The contents of this file are subject to the terms of the
57c478bd9Sstevel@tonic-gate# Common Development and Distribution License, Version 1.0 only
67c478bd9Sstevel@tonic-gate# (the "License").  You may not use this file except in compliance
77c478bd9Sstevel@tonic-gate# with the License.
87c478bd9Sstevel@tonic-gate#
97c478bd9Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
107c478bd9Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
117c478bd9Sstevel@tonic-gate# See the License for the specific language governing permissions
127c478bd9Sstevel@tonic-gate# and limitations under the License.
137c478bd9Sstevel@tonic-gate#
147c478bd9Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
157c478bd9Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
167c478bd9Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
177c478bd9Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
187c478bd9Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
197c478bd9Sstevel@tonic-gate#
207c478bd9Sstevel@tonic-gate# CDDL HEADER END
217c478bd9Sstevel@tonic-gate#
227c478bd9Sstevel@tonic-gate# Copyright 1999 Sun Microsystems, Inc.  All rights reserved.
237c478bd9Sstevel@tonic-gate# Use is subject to license terms.
247c478bd9Sstevel@tonic-gate#
257c478bd9Sstevel@tonic-gate
267c478bd9Sstevel@tonic-gate#
277c478bd9Sstevel@tonic-gate# Example configuration file for SLP. This file lists and explains
287c478bd9Sstevel@tonic-gate# each property you can set for SLP. No properties are acutally set,
297c478bd9Sstevel@tonic-gate# so uncomment and edit any properties you wish to change. The
30*bbf21555SRichard Lowe# file /etc/inet/slp.conf must exist in order for slpd(8) to start,
317c478bd9Sstevel@tonic-gate# so copy this file to /etc/inet/slp.conf to enable SLP. See
32*bbf21555SRichard Lowe# slp.conf(5), slpd(8), or RFC 2614 for more information.
337c478bd9Sstevel@tonic-gate#
347c478bd9Sstevel@tonic-gate
357c478bd9Sstevel@tonic-gate# Specifies if slpd should act as a DA. Default is false.
367c478bd9Sstevel@tonic-gate#
377c478bd9Sstevel@tonic-gate# net.slp.isDA=true
387c478bd9Sstevel@tonic-gate#
397c478bd9Sstevel@tonic-gate
407c478bd9Sstevel@tonic-gate# Static scope configuration
417c478bd9Sstevel@tonic-gate#
427c478bd9Sstevel@tonic-gate# Determines the set of scopes which this SA or DA supports. These scopes
437c478bd9Sstevel@tonic-gate# will also be included in the list returned from a find scopes query.
447c478bd9Sstevel@tonic-gate# This example simply sets the property to the default:
457c478bd9Sstevel@tonic-gate# net.slp.useScopes=default
467c478bd9Sstevel@tonic-gate#
477c478bd9Sstevel@tonic-gate# This example sets the property to a site-specific list:
487c478bd9Sstevel@tonic-gate# net.slp.useScopes=building17,building18,admin
497c478bd9Sstevel@tonic-gate#
507c478bd9Sstevel@tonic-gate
517c478bd9Sstevel@tonic-gate# Static DA Configuration
527c478bd9Sstevel@tonic-gate#
537c478bd9Sstevel@tonic-gate# Forces UAs and SAs to use a set of DAs.
547c478bd9Sstevel@tonic-gate#
557c478bd9Sstevel@tonic-gate# This example specifies two DAs:
567c478bd9Sstevel@tonic-gate# net.slp.DAAddresses=192.168.1.20,192.168.2.20
577c478bd9Sstevel@tonic-gate#
587c478bd9Sstevel@tonic-gate
597c478bd9Sstevel@tonic-gate# Serialized Proxy Registrations
607c478bd9Sstevel@tonic-gate#
617c478bd9Sstevel@tonic-gate# Specifies a file containing a set of registrations to be processed
627c478bd9Sstevel@tonic-gate# when slpd starts up, written as an URL.
637c478bd9Sstevel@tonic-gate# To load a proxy-registration file at /etc/inet/slpd.reg:
647c478bd9Sstevel@tonic-gate# net.slp.serializedRegURL=file:/etc/inet/slpd.reg
657c478bd9Sstevel@tonic-gate#
667c478bd9Sstevel@tonic-gate
677c478bd9Sstevel@tonic-gate# Tracing and Logging
687c478bd9Sstevel@tonic-gate#
697c478bd9Sstevel@tonic-gate# By default, all tracing and logging is disabled.
707c478bd9Sstevel@tonic-gate#
717c478bd9Sstevel@tonic-gate# Display messages about traffic with DAs:
727c478bd9Sstevel@tonic-gate# net.slp.traceDATraffic=true
737c478bd9Sstevel@tonic-gate#
747c478bd9Sstevel@tonic-gate# Display details about SLP messages:
757c478bd9Sstevel@tonic-gate# net.slp.traceMsg=true
767c478bd9Sstevel@tonic-gate#
777c478bd9Sstevel@tonic-gate# Display details whenever a message is dropped:
787c478bd9Sstevel@tonic-gate# net.slp.traceDrop=true
797c478bd9Sstevel@tonic-gate#
807c478bd9Sstevel@tonic-gate# Dump service table upon registration or deregistration:
817c478bd9Sstevel@tonic-gate# net.slp.traceReg=true
827c478bd9Sstevel@tonic-gate#
837c478bd9Sstevel@tonic-gate
847c478bd9Sstevel@tonic-gate#
857c478bd9Sstevel@tonic-gate# Set this property to change the default DA Heartbeat (10800 seconds).
867c478bd9Sstevel@tonic-gate# This example sets it to 7200 seconds (two hours):
877c478bd9Sstevel@tonic-gate# net.slp.DAHeartBeat=7200
887c478bd9Sstevel@tonic-gate#
897c478bd9Sstevel@tonic-gate
907c478bd9Sstevel@tonic-gate#
917c478bd9Sstevel@tonic-gate# Use this property to configure special attributes for DAs; these
927c478bd9Sstevel@tonic-gate# will be included in the attrs field in a DAAdvert. Currently
937c478bd9Sstevel@tonic-gate# the only useful property is min-refresh-interval, which allows
947c478bd9Sstevel@tonic-gate# you to set the minimum interval for which a DA will accept
957c478bd9Sstevel@tonic-gate# registration refreshes. This example sets the minimum interval
967c478bd9Sstevel@tonic-gate# to 3 hours (10800 seconds):
977c478bd9Sstevel@tonic-gate# net.slp.DAAttributes=(min-refresh-interval=10800)
987c478bd9Sstevel@tonic-gate#
997c478bd9Sstevel@tonic-gate
1007c478bd9Sstevel@tonic-gate#
1017c478bd9Sstevel@tonic-gate# Use this property to configure special attributes for SAs; these
1027c478bd9Sstevel@tonic-gate# will be included in the attrs field in a SAAdvert. This example
1037c478bd9Sstevel@tonic-gate# sets the attribute "special-features" to "none":
1047c478bd9Sstevel@tonic-gate# net.slp.SAAttributes=(special-features=none)
1057c478bd9Sstevel@tonic-gate#
1067c478bd9Sstevel@tonic-gate
1077c478bd9Sstevel@tonic-gate#
1087c478bd9Sstevel@tonic-gate# Force SLP agents to use broadcast only (instead of the default multicast):
1097c478bd9Sstevel@tonic-gate# net.slp.isBroadcastOnly=true
1107c478bd9Sstevel@tonic-gate#
1117c478bd9Sstevel@tonic-gate
1127c478bd9Sstevel@tonic-gate#
1137c478bd9Sstevel@tonic-gate# Disable passive DA detection. Default is enabled.
1147c478bd9Sstevel@tonic-gate# net.slp.passiveDADetection=false
1157c478bd9Sstevel@tonic-gate#
1167c478bd9Sstevel@tonic-gate
1177c478bd9Sstevel@tonic-gate#
1187c478bd9Sstevel@tonic-gate# Change the multicast time-to-live (TTL). Default is 255. This example
1197c478bd9Sstevel@tonic-gate# limits SLP multicast to the local subnet only:
1207c478bd9Sstevel@tonic-gate# net.slp.multicastTTL=1
1217c478bd9Sstevel@tonic-gate#
1227c478bd9Sstevel@tonic-gate
1237c478bd9Sstevel@tonic-gate#
1247c478bd9Sstevel@tonic-gate# Set this property to change the default interval between DA discoveries.
1257c478bd9Sstevel@tonic-gate# Default is 900 seconds (15 minutes). This example changes it to 2 minutes
1267c478bd9Sstevel@tonic-gate# (at the risk of increasing network congestion):
1277c478bd9Sstevel@tonic-gate# net.slp.DAActiveDiscoveryInterval=120
1287c478bd9Sstevel@tonic-gate#
1297c478bd9Sstevel@tonic-gate
1307c478bd9Sstevel@tonic-gate#
1317c478bd9Sstevel@tonic-gate# Set this property to change the maximum amount of time to wait until
1327c478bd9Sstevel@tonic-gate# multicast convergance completes. Default is 15000 ms (15 seconds). This
1337c478bd9Sstevel@tonic-gate# example changes it to 20000 ms (20 seconds), which may be desirable on
1347c478bd9Sstevel@tonic-gate# congested networks with many SAs:
1357c478bd9Sstevel@tonic-gate# net.slp.multicastMaximumWait=20000
1367c478bd9Sstevel@tonic-gate#
1377c478bd9Sstevel@tonic-gate
1387c478bd9Sstevel@tonic-gate#
1397c478bd9Sstevel@tonic-gate# Set this property to control the intervals used in multicast convergance.
1407c478bd9Sstevel@tonic-gate# The default is 3000,3000,3000,3000,3000 (all 3 seconds). The following
1417c478bd9Sstevel@tonic-gate# example reduces the initial intervals, which may be increase responsiveness
1427c478bd9Sstevel@tonic-gate# on fast networks:
1437c478bd9Sstevel@tonic-gate# net.slp.multicastTimeouts=1000,1250,1500,2000,4000
1447c478bd9Sstevel@tonic-gate#
1457c478bd9Sstevel@tonic-gate# This example sets it to an aggressively short value; this may be useful
1467c478bd9Sstevel@tonic-gate# for increased responsiveness on fast, reliable networks:
1477c478bd9Sstevel@tonic-gate# net.slp.multicastTimeouts=1000
1487c478bd9Sstevel@tonic-gate
1497c478bd9Sstevel@tonic-gate#
1507c478bd9Sstevel@tonic-gate# This property works in a manner similar to net.slp.multicastTimeouts,
1517c478bd9Sstevel@tonic-gate# but acts on DA discovery multicast convergance instead. Default is
1527c478bd9Sstevel@tonic-gate# 2000,2000,2000,2000,3000,4000. This example increases the intervals,
1537c478bd9Sstevel@tonic-gate# which may help to discovery DAs which are slow, heavily loaded, or on
1547c478bd9Sstevel@tonic-gate# congested networks:
1557c478bd9Sstevel@tonic-gate# net.slp.DADiscoveryTimeouts=3000,3000,4000,4000,4000,4000
1567c478bd9Sstevel@tonic-gate#
1577c478bd9Sstevel@tonic-gate
1587c478bd9Sstevel@tonic-gate#
1597c478bd9Sstevel@tonic-gate# This property controls the retransmission intervals used for datagram
1607c478bd9Sstevel@tonic-gate# unicast. Default is 3000,3000,3000. This example decreases the
1617c478bd9Sstevel@tonic-gate# intervals for more aggressive retransmission, to 2 seconds:
1627c478bd9Sstevel@tonic-gate# net.slp.datagramTimeouts=2000,2000,2000
1637c478bd9Sstevel@tonic-gate#
1647c478bd9Sstevel@tonic-gate
1657c478bd9Sstevel@tonic-gate#
1667c478bd9Sstevel@tonic-gate# Set this property to change the maximum random wait bound (used with
1677c478bd9Sstevel@tonic-gate# initial DA discovery, for instance). Default is 1000 ms (1 second).
1687c478bd9Sstevel@tonic-gate# This example changes it to 2 seconds:
1697c478bd9Sstevel@tonic-gate# net.slp.randomWaitBound=2000
1707c478bd9Sstevel@tonic-gate#
1717c478bd9Sstevel@tonic-gate
1727c478bd9Sstevel@tonic-gate#
1737c478bd9Sstevel@tonic-gate# Change this property to change the maximum size of any datagram to
1747c478bd9Sstevel@tonic-gate# send (MTU), in bytes. Default is 1400. This example changes it to
1757c478bd9Sstevel@tonic-gate# 1500 bytes:
1767c478bd9Sstevel@tonic-gate# net.slp.MTU=1500
1777c478bd9Sstevel@tonic-gate#
1787c478bd9Sstevel@tonic-gate
1797c478bd9Sstevel@tonic-gate#
1807c478bd9Sstevel@tonic-gate# Set this property to restrict SLP to specific interfaces. Default is
1817c478bd9Sstevel@tonic-gate# empty, which causes SLP to use the the default interface.
1827c478bd9Sstevel@tonic-gate#
1837c478bd9Sstevel@tonic-gate# net.slp.interfaces=192.168.1.5,192.168.3.5
1847c478bd9Sstevel@tonic-gate#
1857c478bd9Sstevel@tonic-gate
1867c478bd9Sstevel@tonic-gate#
1877c478bd9Sstevel@tonic-gate# This property specifies the language tag to use for all messages.
1887c478bd9Sstevel@tonic-gate# Default is "en". This example changes it to "de":
1897c478bd9Sstevel@tonic-gate# net.slp.locale=de
1907c478bd9Sstevel@tonic-gate#
1917c478bd9Sstevel@tonic-gate
1927c478bd9Sstevel@tonic-gate#
1937c478bd9Sstevel@tonic-gate# Set this property to limit the total number of results for any
1947c478bd9Sstevel@tonic-gate# SLP query. Default is all results (-1). This example limits it
1957c478bd9Sstevel@tonic-gate# to 100:
1967c478bd9Sstevel@tonic-gate# net.slp.maxResults=100
1977c478bd9Sstevel@tonic-gate#
1987c478bd9Sstevel@tonic-gate
1997c478bd9Sstevel@tonic-gate#
2007c478bd9Sstevel@tonic-gate# A type hint will be used if an agent needs to discover scopes with
2017c478bd9Sstevel@tonic-gate# service agent solicitations. If the type hint is set, only service
2027c478bd9Sstevel@tonic-gate# agents which support those types will respond. In effect, this poses
2037c478bd9Sstevel@tonic-gate# the query: "find me all scopes which contain these service types."
2047c478bd9Sstevel@tonic-gate#
2057c478bd9Sstevel@tonic-gate# This sets the type hint to service:foo and service:bar:
2067c478bd9Sstevel@tonic-gate# net.slp.typeHint=service:foo,service:bar
2077c478bd9Sstevel@tonic-gate#
208