unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.9)
Page:
Section:
Apropos / Subsearch:
optional field



File Formats                                          slp.conf(4)



NAME
     slp.conf - configuration file for Service Location  Protocol
     agents

SYNOPSIS
     /etc/inet/slp.conf

DESCRIPTION
     slp.conf  provides all  Service  Location  Protocol  ("SLP")
     agents  with   their   operational   configuration. slpd(1M)
     reads slp.conf on startup. Service Agents ("SAs")  and  User
     Agents  ("UAs") read slp.conf on invocation of the SA and UA
     library routines; configuration parameters are  then  cached
     on  a  per-process  basis. All SA's must use the same set of
     properties as slpd on the local machine, since slpd acts  as
     an SA server.

     The configuration  file  format  consists  of  a  <newline>-
     delimited  list  of zero or  more property definitions. Each
     property definition corresponds to a particular configurable
     SLP, network, or other parameter in one or more of the three
     SLP agents.  The file format grammar is shown in RFC 2234 as
     follows:

     config-file   =  line-list
     line-list     =  line / line line-list
     line          =  property-line / comment-line
     comment-line  =  ( "#" / ";" ) 1*allchar newline
     property-line =  property newline
     property      =  tag "=" value-list
     tag           =  prop / prop "." tag
     prop          =  1*tagchar
     value-list    =  value / value "," value-list
     value         =  int / bool /
                      "(" value-list ")" / string
     int           =  1*DIGIT
     bool          =  "true" / "false" / "TRUE" / "FALSE"
     newline       =  CR / ( CRLF )
     string        =  1*stringchar
     tagchar       =  DIGIT / ALPHA / tother / escape
     tother        =  %x21-%x2d / %x2f /
                      %x3a / %x3c-%x40 /
                      %x5b-%x60 / %7b-%7e
                      ; i.e., all characters except `.',
                      ; and `='.
     stringchar    =  DIGIT / ALPHA / sother / escape
     sother        =  %x21-%x29 / %x2a-%x2b /
                      %x2d-%x2f / %x3a-%x40 /
                      %x5b-%x60 / %7b-%7e
                      ; i.e., all characters except `,'
     allchar       =  DIGIT / ALPHA / HTAB / SP
     escape        =  "



SunOS 5.9           Last change: 18 Feb 2003                    1






File Formats                                          slp.conf(4)



                      ; Used for reserved characters

     The properties fall into one of the following categories:

        o  DA Configuration

        o  Static Scope Configuration

        o  Tracing and Logging

        o  Serialized Proxy Registrations

        o  Networking Configuration Parameters

        o  UA Configuration

  DA Configuration
     The following are configuration properties and their parame-
     ters for DAs:

          net.slp.isDA

                Setting Type
                      Boolean

                Default Value
                      False

                Range of Values
                      True or False

                A boolean that indicates whether slpd(1M)  is  to
                act  as  a DA. If False, slpd(1M) is not run as a
                DA.

          net.slp.DAHeartBeat

                Setting Type
                      Integer

                Default Value
                      10800 seconds (3 hours)

                Range of Values
                      2000 - 259200000 seconds

                A 32-bit integer  giving the  number  of  seconds
                for  the passive DA  advertisement heartbeat. The
                default value is  10800 seconds. This property is
                ignored if net.slp.isDA is False.

          net.slp.DAAttributes



SunOS 5.9           Last change: 18 Feb 2003                    2






File Formats                                          slp.conf(4)



                Setting Type
                      List of Strings

                Default Value
                      Unassigned

                Range of Values
                      List of Attribute Tag/Value List Pairs

                A comma-separated list of parenthesized attribute
                tag/value  list  pairs that the DA must advertise
                in DA advertisements.  The property  must  be  in
                the   SLP   attribute  list  wire  format,  which
                requires that you use a backslash  ("  to  escape
                reserved characters. See RFC 2608 for more infor-
                mation on reserved characters, or  refer  to  the
                System  Administration Guide: Resource Management
                and Network Services.


  Static Scope Configuration
     The following properties and their parameters allow  you  to
     configure various aspects of scope and DA handling:

     net.slp.useScopes

           Setting Type
                 List of Strings

           Default Value
                 Default, for SA and DA; unassigned for UA.

           Range of Values
                 List of Strings

           A list of  strings indicating either the scopes that a
           UA or an SA is allowed to use when making requests, or
           the scopes  a DA  must  support. If  not  present  for
           the  DA  and SA, the default scope Default is used. If
           not present for the UA, then the user scoping model is
           in  force,  in  which  active  and  passive  DA  or SA
           discovery are used  for  scope  discovery.  The  scope
           Default  is used if no other information is available.
           If a DA or SA gets another   scope  in  a  request,  a
           SCOPE_NOT_SUPPORTED  error  is   returned,  unless the
           request was multicast, in which case it is dropped. If
           a  DA  receives  another  scope  in  a registration, a
           SCOPE_NOT_SUPPORTED error will  be  returned.   Unlike
           other  properties,  this  property  is "read-only", so
           attempts to change it programmatically after the  con-
           figuration file has been  read are ignored.




SunOS 5.9           Last change: 18 Feb 2003                    3






File Formats                                          slp.conf(4)



     net.slp.DAAddresses

           Setting Type
                 List of Strings

           Default Value
                 Unassigned

           Range of Values
                 IPv4 addresses or host names

     A  list of  IP  addresses  or   DNS-resolvable   names  that
     denote  the   DAs to  use for statically  configured UAs and
     SAs. The property is read by slpd(1M), and registrations are
     forwarded  to  the  DAs.  The  DAs  are provided to UAs upon
     request. Unlike other properties, this  property  is  "read-
     only", so attempts to change it after the configuration file
     has been read are ignored.

     The following grammar describes the property:


     addr-list     =  addr / addr "," addr-list
     addr          =  fqdn / hostnumber
     fqdn          =  ALPHA / ALPHA *[ anum / "-" ] anum
     anum          =  ALPHA / DIGIT
     hostnumber    =  1*3DIGIT 3("." 1*3DIGIT)

     The following is an example using this grammar:


     sawah,mandi,sambal

          IP addresses can be used instead of host names in  net-
          works  where  DNS is not deployed, but network adminis-
          trators are reminded that using IP addresses will  com-
          plicate  machine  renumbering, since the SLP configura-
          tion property files in statically  configured  networks
          will have to be changed.

  Tracing and Logging
     These properties direct tracing and logging  information  to
     be  sent  to syslogd at the LOG_INFO priority. These proper-
     ties affect slpd(1M) only.

     net.slp.traceDATraffic

           Setting Type
                 Boolean

           Default Value
                 False



SunOS 5.9           Last change: 18 Feb 2003                    4






File Formats                                          slp.conf(4)



           Range of Values
                 True or False

           Set net.slp.traceDATraffic to True to  enable  logging
           of DA traffic by slpd.

     net.slp.traceMsg

           Setting Type
                 Boolean

           Default Value
                 False

           Range of Values
                 True or False

           Set net.slp.traceMsg to True to display details  about
           SLP  messages. The  fields  in all  incoming  messages
           and outgoing replies are printed by slpd.

     net.slp.traceDrop

           Setting Type
                 Boolean

           Default Value
                 False

           Range of Values
                 True or False

           Set this property to True to display details  when  an
           SLPmessage is dropped by slpd for any reason.

     net.slp.traceReg

           Setting Type
                 Boolean

           Default Value
                 False

           Range of Values
                 True or False

           Set this property to True to  display  the   table  of
           service advertisements when a registration or deregis-
           tration is processed by slpd.

  Serialized Proxy Registrations




SunOS 5.9           Last change: 18 Feb 2003                    5






File Formats                                          slp.conf(4)



     The following properties   control   reading   and   writing
     serialized registrations.

     net.slp.serializedRegURL

           Setting Type
                 String

           Default Value
                 Unassigned

           Range of Values
                 Valid URL

           A  string containing  a  URL pointing to  a  document,
           which  contains  serialized  registrations that should
           be processed when the slpd starts up.

  Networking Configuration Parameters
     The properties that follow allow you to set various  network
     configuration parameters:

     net.slp.isBroadcastOnly

           Setting Type
                 Boolean

           Default Value
                 False

           Range of Values
                 True or False

           A  boolean that indicates if   broadcast   should   be
           used instead of multicast.

     net.slp.multicastTTL

           Setting Type
                 Positive Integer

           Default Value
                 255

           Range of Values
                 A positive integer from 1 to 255.

           A positive integer  less than or  equal  to  255  that
           defines the multicast TTL.

     net.slp.DAActiveDiscoveryInterval




SunOS 5.9           Last change: 18 Feb 2003                    6






File Formats                                          slp.conf(4)



           Setting Type
                 Integer

           Default Value
                 900 seconds (15 minutes)

           Range of Values
                 From 300 to 10800 seconds

           A 16-bit positive integer giving the number of seconds
           between DA active discovery queries. The default value
           is 900 seconds (15 minutes). If the property is set to
           zero,  active  discovery is turned off. This is useful
           when the DAs available are  explicitly  restricted  to
           those obtained from the net.slp.DAAddresses property.

     net.slp.multicastMaximumWait

           Setting Type
                 Integer

           Default Value
                 15000 milliseconds (15 seconds)

           Range of Values
                  1000 to 60000 milliseconds

           A 32-bit integer giving the maximum value for the  sum
           of    the    net.slp.multicastTimeouts    values   and
           net.slp.DADiscoveryTimeouts values in milliseconds.

     net.slp.multicastTimeouts

           Setting Type
                 List of Integers

           Default Value
                 3000,3000,3000,3000

           Range of Values
                 List of Positive Integers

           A list of 32-bit integers used as  timeouts,  in  mil-
           liseconds,  to  implement  the  multicast  convergence
           algorithm. Each  value  specifies  the  time  to  wait
           before  sending the next request, or until nothing new
           has been learned from two successive  requests.  In  a
           fast     network     the    aggressive    values    of
           1000,1250,1500,2000,4000 allow better performance. The
           sum       of       the       list      must      equal
           net.slp.multicastMaximumWait.




SunOS 5.9           Last change: 18 Feb 2003                    7






File Formats                                          slp.conf(4)



     net.slp.passiveDADetection

           Setting Type
                 Boolean

           Default Value
                 True

           Range of Values
                 True or False

           A  boolean indicating   whether  slpd  should  perform
           passive  DA  detection.

     net.slp.DADiscoveryTimeouts

           Setting Type
                 List of  Integers.

           Default Value
                 2000,2000,2000,2000,3000,4000

           Range of Values
                 List of Positive Integers

           A list of 32-bit integers used as  timeouts,  in  mil-
           liseconds,  to  implement  the  multicast  convergence
           algorithm during  active  DA  discovery.   Each  value
           specifies  the  time  to  wait before sending the next
           request, or until nothing new has  been  learned  from
           two  successive  requests.  The  sum  of the list must
           equal net.slp.multicastMaximumWait.

     net.slp.datagramTimeouts

           Setting Type
                 List of Integers

           Default Value
                 3000,3000,3000

           Range of Values
                 List of Positive Integers

           A list of 32-bit integers used as  timeouts,  in  mil-
           liseconds,  to implement unicast datagram transmission
           to DAs.  The nth value gives the time to block waiting
           for a reply on the nth try to contact the DA.

     net.slp.randomWaitBound

           Setting Type



SunOS 5.9           Last change: 18 Feb 2003                    8






File Formats                                          slp.conf(4)



                 Integer

           Default Value
                 1000 milliseconds (1 second)

           Range of Values
                 1000 to 3000 milliseconds

           Sets the upper bound for calculating the  random  wait
           time before attempting to contact a DA.

     net.slp.MTU

           Setting Type
                 Integer

           Default Value
                 1400

           Range of Values
                 128 to 8192

           A 16-bit integer that specifies  the  network   packet
           size, in bytes. The packet size includes IP and TCP or
           UDP headers.

     net.slp.interfaces

           Setting Type
                 List of Strings

           Default Value
                 Default interface

           Range of Values
                 IPv4 addresses or host names

     List of strings giving the IP addresses or host names of the
     network  interface cards on which the DA or SA should listen
     on port 427 for multicast, unicast UDP,  and  TCP  messages.
     The default value is unassigned, indicating that the default
     network interface card should be used. An example is:


     195.42.42.42,195.42.142.1,195.42.120.1

          The example machine has three interfaces on  which  the
          DA  should  listen. Note that if IP addresses are used,
          the property must  be  renumbered  if  the  network  is
          renumbered.





SunOS 5.9           Last change: 18 Feb 2003                    9






File Formats                                          slp.conf(4)



  UA Configuration
     The following configuration parameters apply to the UA:

     net.slp.locale

           Setting Type
                 String

           Default Value
                 en

           Range of Values
                 See RFC 1766 for a list of the  locale  language
                 tag names.

           A  RFC 1766  Language  Tag for  the language   locale.
           Setting  this  property causes the property  value  to
           become the default  locale for SLP messages.

     net.slp.maxResults

           Setting Type
                 Integer

           Default Value
                 -1

           Range of Values
                 -1, positive integer

           A 32 bit-integer that specifies the maximum number  of
           results  to  accumulate  and  return for a synchronous
           request before the timeout, or the maximum  number  of
           results  to  return  through a callback if the request
           results   are   reported   asynchronously.    Positive
           integers  and  -1  are  legal values.  If the value of
           net.slp.maxResults  is  -1,  all  results  should   be
           returned.

     net.slp.typeHint

           Setting Type
                 List of Strings

           Default Value
                 Unassigned

           Range of Values
                 Service type names

           A list of service type names.  In the absence  of  any
           DAs,  UAs perform SA discovery to find scopes.  If the



SunOS 5.9           Last change: 18 Feb 2003                   10






File Formats                                          slp.conf(4)



           net.slp.typeHint property is set, only SA's  advertis-
           ing types on the list respond.  Note that UAs set this
           property programmatically. It is not typically set  in
           the  configuration  file.  The  default is unassigned,
           meaning do not restrict the type.

ATTRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWslpr                    |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         |  Standard                   |
    |_____________________________|_____________________________|


SEE ALSO
     slpd(1M), slpd.reg(4), slp_api(3SLP), slp(7P)

     System Administration Guide: Resource Management and Network
     Services

     Alvestrand, H.RFC  1766:  Tags  for  the  Identification  of
     Languages. Network Working Group. March 1995.

     Crocker, D., Overell, P.RFC 2234, Augmented BNF  for  Syntax
     Specifications: ABNF. The Internet Society. 1997.

     Kempf, J. and Guttman, E. RFC 2614, An API for Service Loca-
     tion. The Internet Society. June 1999.




















SunOS 5.9           Last change: 18 Feb 2003                   11