1slp.conf(4) File Formats slp.conf(4)
2
3
4
6 slp.conf - configuration file for Service Location Protocol agents
7
9 /etc/inet/slp.conf
10
11
13 slp.conf provides all Service Location Protocol ("SLP") agents with
14 their operational configuration. slpd(1M) reads slp.conf on startup.
15 Service Agents ("SAs") and User Agents ("UAs") read slp.conf on invoca‐
16 tion of the SA and UA library routines; configuration parameters are
17 then cached on a per-process basis. All SA's must use the same set of
18 properties as slpd on the local machine, since slpd acts as an SA
19 server.
20
21
22 The configuration file format consists of a newline-delimited list of
23 zero or more property definitions. Each property definition corre‐
24 sponds to a particular configurable SLP, network, or other parameter in
25 one or more of the three SLP agents. The file format grammar is shown
26 in RFC 2234 as follows:
27
28 config-file = line-list
29 line-list = line / line line-list
30 line = property-line / comment-line
31 comment-line = ( "#" / ";" ) 1*allchar newline
32 property-line = property newline
33 property = tag "=" value-list
34 tag = prop / prop "." tag
35 prop = 1*tagchar
36 value-list = value / value "," value-list
37 value = int / bool /
38 "(" value-list ")" / string
39 int = 1*DIGIT
40 bool = "true" / "false" / "TRUE" / "FALSE"
41 newline = CR / ( CRLF )
42 string = 1*stringchar
43 tagchar = DIGIT / ALPHA / tother / escape
44 tother = %x21-%x2d / %x2f /
45 %x3a / %x3c-%x40 /
46 %x5b-%x60 / %7b-%7e
47 ; i.e., all characters except `.',
48 ; and `='.
49 stringchar = DIGIT / ALPHA / sother / escape
50 sother = %x21-%x29 / %x2a-%x2b /
51 %x2d-%x2f / %x3a-%x40 /
52 %x5b-%x60 / %7b-%7e
53 ; i.e., all characters except `,'
54 allchar = DIGIT / ALPHA / HTAB / SP
55 escape = "
56 ; Used for reserved characters
57
58
59
60 The properties fall into one of the following categories:
61
62 o DA Configuration
63
64 o Static Scope Configuration
65
66 o Tracing and Logging
67
68 o Serialized Proxy Registrations
69
70 o Networking Configuration Parameters
71
72 o UA Configuration
73
74 DA Configuration
75 The following are configuration properties and their parameters for
76 DAs:
77
78 net.slp.isDA
79 Setting Type Boolean
80
81
82 Default Value False
83
84
85 Range of Values True or False
86
87 A boolean that indicates whether slpd(1M) is to
88 act as a DA. If False, slpd(1M) is not run as
89 a DA.
90
91
92 net.slp.DAHeartBeat
93 Setting Type Integer
94
95
96 Default Value 10800 seconds (3 hours)
97
98
99 Range of Values 2000 - 259200000 seconds
100
101 A 32-bit integer giving the number of seconds
102 for the passive DA advertisement heartbeat.
103 The default value is 10800 seconds. This prop‐
104 erty is ignored if net.slp.isDA is False.
105
106
107 net.slp.DAAttributes
108 Setting Type List of Strings
109
110
111 Default Value Unassigned
112
113
114 Range of Values List of Attribute Tag/Value
115 List Pairs
116
117 A comma-separated list of parenthesized
118 attribute tag/value list pairs that the DA must
119 advertise in DA advertisements. The property
120 must be in the SLP attribute list wire format,
121 which requires that you use a backslash ("
122
123
124 Static Scope Configuration
125 The following properties and their parameters allow you to configure
126 various aspects of scope and DA handling:
127
128 net.slp.useScopes
129 Setting Type List of Strings
130
131
132 Default Value Default, for SA and DA; unas‐
133 signed for UA.
134
135
136 Range of Values List of Strings
137
138 A list of strings indicating either the scopes
139 that a UA or an SA is allowed to use when mak‐
140 ing requests, or the scopes a DA must sup‐
141 port. If not present for the DA and SA, the
142 default scope Default is used. If not present
143 for the UA, then the user scoping model is in
144 force, in which active and passive DA or SA dis‐
145 covery are used for scope discovery. The scope
146 Default is used if no other information is
147 available. If a DA or SA gets another scope in
148 a request, a SCOPE_NOT_SUPPORTED error is
149 returned, unless the request was multicast, in
150 which case it is dropped. If a DA receives
151 another scope in a registration, a
152 SCOPE_NOT_SUPPORTED error will be returned.
153 Unlike other properties, this property is "read-
154 only", so attempts to change it programmati‐
155 cally after the configuration file has been
156 read are ignored.
157
158
159 net.slp.DAAddresses
160 Setting Type List of Strings
161
162
163 Default Value Unassigned
164
165
166 Range of Values IPv4 addresses or host names
167
168 A list of IP addresses or DNS-resolvable
169 names that denote the DAs to use for stati‐
170 cally configured UAs and SAs. The property is
171 read by slpd(1M), and registrations are for‐
172 warded to the DAs. The DAs are provided to UAs
173 upon request. Unlike other properties, this
174 property is "read-only", so attempts to change
175 it after the configuration file has been read
176 are ignored.
177
178 The following grammar describes the property:
179
180 addr-list = addr / addr "," addr-list
181 addr = fqdn / hostnumber
182 fqdn = ALPHA / ALPHA *[ anum / "-" ] anum
183 anum = ALPHA / DIGIT
184 hostnumber = 1*3DIGIT 3("." 1*3DIGIT)
185
186 The following is an example using this grammar:
187
188 sawah,mandi,sambal
189
190 IP addresses can be used instead of host names
191 in networks where DNS is not deployed, but net‐
192 work administrators are reminded that using IP
193 addresses will complicate machine renumbering,
194 since the SLP configuration property files in
195 statically configured networks will have to be
196 changed.
197
198
199 Tracing and Logging
200 These properties direct tracing and logging information to be sent to
201 syslogd at the LOG_INFO priority. These properties affect slpd(1M)
202 only.
203
204 net.slp.traceDATraffic
205 Setting Type Boolean
206
207
208 Default Value False
209
210
211 Range of Values True or False
212
213 Set net.slp.traceDATraffic to True to enable
214 logging of DA traffic by slpd.
215
216
217 net.slp.traceMsg
218 Setting Type Boolean
219
220
221 Default Value False
222
223
224 Range of Values True or False
225
226 Set net.slp.traceMsg to True to display
227 details about SLP messages. The fields in
228 all incoming messages and outgoing replies
229 are printed by slpd.
230
231
232 net.slp.traceDrop
233 Setting Type Boolean
234
235
236 Default Value False
237
238
239 Range of Values True or False
240
241 Set this property to True to display details
242 when an SLPmessage is dropped by slpd for any
243 reason.
244
245
246 net.slp.traceReg
247 Setting Type Boolean
248
249
250 Default Value False
251
252
253 Range of Values True or False
254
255 Set this property to True to display the ta‐
256 ble of service advertisements when a regis‐
257 tration or deregistration is processed by
258 slpd.
259
260
261 Serialized Proxy Registrations
262 The following properties control reading and writing serialized
263 registrations.
264
265 net.slp.serializedRegURL
266 Setting Type String
267
268
269 Default Value Unassigned
270
271
272 Range of Values Valid URL
273
274 A string containing a URL pointing to a
275 document, which contains serialized regis‐
276 trations that should be processed when the
277 slpd starts up.
278
279
280 Networking Configuration Parameters
281 The properties that follow allow you to set various network configura‐
282 tion parameters:
283
284 net.slp.isBroadcastOnly
285
286
287 Setting Type Boolean
288
289
290 Default Value False
291
292
293 Range of Values True or False
294
295 A boolean that indicates if broadcast should be used instead
296 of multicast.
297
298
299 net.slp.multicastTTL
300
301
302 Setting Type Positive Integer
303
304
305 Default Value 255
306
307
308 Range of Values A positive integer from 1 to 255.
309
310 A positive integer less than or equal to 255 that defines the
311 multicast TTL.
312
313
314 net.slp.DAActiveDiscoveryInterval
315
316
317 Setting Type Integer
318
319
320 Default Value 900 seconds (15 minutes)
321
322
323 Range of Values From 300 to 10800 seconds
324
325 A 16-bit positive integer giving the number of seconds between DA
326 active discovery queries. The default value is 900 seconds (15 min‐
327 utes). If the property is set to zero, active discovery is turned
328 off. This is useful when the DAs available are explicitly
329 restricted to those obtained from the net.slp.DAAddresses property.
330
331
332 net.slp.multicastMaximumWait
333
334
335 Setting Type Integer
336
337
338 Default Value 15000 milliseconds (15 seconds)
339
340
341 Range of Values 1000 to 60000 milliseconds
342
343 A 32-bit integer giving the maximum value for the sum of the
344 net.slp.multicastTimeouts values and net.slp.DADiscoveryTimeouts
345 values in milliseconds.
346
347
348 net.slp.multicastTimeouts
349
350
351 Setting Type List of Integers
352
353
354 Default Value 3000,3000,3000,3000
355
356
357 Range of Values List of Positive Integers
358
359 A list of 32-bit integers used as timeouts, in milliseconds, to
360 implement the multicast convergence algorithm. Each value specifies
361 the time to wait before sending the next request, or until nothing
362 new has been learned from two successive requests. In a fast net‐
363 work the aggressive values of 1000,1250,1500,2000,4000 allow better
364 performance. The sum of the list must equal net.slp.multicastMaxi‐
365 mumWait.
366
367
368 net.slp.passiveDADetection
369
370
371 Setting Type Boolean
372
373
374 Default Value True
375
376
377 Range of Values True or False
378
379 A boolean indicating whether slpd should perform passive DA
380 detection.
381
382
383 net.slp.DADiscoveryTimeouts
384
385
386 Setting Type List of Integers.
387
388
389 Default Value 2000,2000,2000,2000,3000,4000
390
391
392 Range of Values List of Positive Integers
393
394 A list of 32-bit integers used as timeouts, in milliseconds, to
395 implement the multicast convergence algorithm during active DA dis‐
396 covery. Each value specifies the time to wait before sending the
397 next request, or until nothing new has been learned from two suc‐
398 cessive requests. The sum of the list must equal net.slp.multicast‐
399 MaximumWait.
400
401
402 net.slp.datagramTimeouts
403
404
405 Setting Type List of Integers
406
407
408 Default Value 3000,3000,3000
409
410
411 Range of Values List of Positive Integers
412
413 A list of 32-bit integers used as timeouts, in milliseconds, to
414 implement unicast datagram transmission to DAs. The nth value
415 gives the time to block waiting for a reply on the nth try to con‐
416 tact the DA.
417
418
419 net.slp.randomWaitBound
420
421
422 Setting Type Integer
423
424
425 Default Value 1000 milliseconds (1 second)
426
427
428 Range of Values 1000 to 3000 milliseconds
429
430 Sets the upper bound for calculating the random wait time before
431 attempting to contact a DA.
432
433
434 net.slp.MTU
435
436
437 Setting Type Integer
438
439
440 Default Value 1400
441
442
443 Range of Values 128 to 8192
444
445 A 16-bit integer that specifies the network packet size, in bytes.
446 The packet size includes IP and TCP or UDP headers.
447
448
449 net.slp.interfaces
450
451
452 Setting Type List of Strings
453
454
455 Default Value Default interface
456
457
458 Range of Values IPv4 addresses or host names
459
460 List of strings giving the IP addresses or host names of the net‐
461 work interface cards on which the DA or SA should listen on port
462 427 for multicast, unicast UDP, and TCP messages. The default value
463 is unassigned, indicating that the default network interface card
464 should be used. An example is:
465
466 195.42.42.42,195.42.142.1,195.42.120.1
467
468 The example machine has three interfaces on which the DA should
469 listen. Note that if IP addresses are used, the property must be
470 renumbered if the network is renumbered.
471
472
473 UA Configuration
474 The following configuration parameters apply to the UA:
475
476 net.slp.locale
477 Setting Type String
478
479
480 Default Value en
481
482
483 Range of Values See RFC 1766 for a list of the
484 locale language tag names.
485
486 A RFC 1766 Language Tag for the language
487 locale. Setting this property causes the prop‐
488 erty value to become the default locale for
489 SLP messages.
490
491
492 net.slp.maxResults
493 Setting Type Integer
494
495
496 Default Value -1
497
498
499 Range of Values -1, positive integer
500
501 A 32 bit-integer that specifies the maximum num‐
502 ber of results to accumulate and return for a
503 synchronous request before the timeout, or the
504 maximum number of results to return through a
505 callback if the request results are reported
506 asynchronously. Positive integers and -1 are
507 legal values. If the value of net.slp.maxResults
508 is -1, all results should be returned.
509
510
511 net.slp.typeHint
512 Setting Type List of Strings
513
514
515 Default Value Unassigned
516
517
518 Range of Values Service type names
519
520 A list of service type names. In the absence of
521 any DAs, UAs perform SA discovery to find scopes.
522 If the net.slp.typeHint property is set, only
523 SA's advertising types on the list respond. Note
524 that UAs set this property programmatically. It
525 is not typically set in the configuration file.
526 The default is unassigned, meaning do not
527 restrict the type.
528
529
531 See attributes(5) for descriptions of the following attributes:
532
533
534
535
536 ┌─────────────────────────────┬─────────────────────────────┐
537 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
538 ├─────────────────────────────┼─────────────────────────────┤
539 │Availability │SUNWslpr │
540 ├─────────────────────────────┼─────────────────────────────┤
541 │CSI │Enabled │
542 ├─────────────────────────────┼─────────────────────────────┤
543 │Interface Stability │ Standard │
544 └─────────────────────────────┴─────────────────────────────┘
545
547 slpd(1M), slpd.reg(4), slp_api(3SLP), slp(7P)
548
549
550 System Administration Guide: Network Services
551
552
553 Alvestrand, H.RFC 1766: Tags for the Identification of Languages. Net‐
554 work Working Group. March 1995.
555
556
557 Crocker, D., Overell, P.RFC 2234, Augmented BNF for Syntax Specifica‐
558 tions: ABNF. The Internet Society. 1997.
559
560
561 Kempf, J. and Guttman, E. RFC 2614, An API for Service Location. The
562 Internet Society. June 1999.
563
564
565
566SunOS 5.11 18 Feb 2003 slp.conf(4)