1slp.conf(4)                      File Formats                      slp.conf(4)
2
3
4

NAME

6       slp.conf - configuration file for Service Location Protocol agents
7

SYNOPSIS

9       /etc/inet/slp.conf
10
11

DESCRIPTION

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

ATTRIBUTES

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

SEE ALSO

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)
Impressum