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