rpld.conf(4)

NAME

     rpld.conf - Remote Program Load (RPL)  server  configuration
     file

SYNOPSIS

     /etc/rpld.conf

DESCRIPTION

     The  /etc/rpld.conf file contains the configuration informa-
     tion  for  operation  of   rpld,  the RPL-based network boot
     server.  It is a text file  containing  keyword-value  pairs
     and comments.
      The keyword-value pairs specify the value to use for param-
     eters  used  by  the RPL server.  Comments can be entered by
     starting the line using the # character.  The user  can  add
     comments to the file for customized configurations.
      Alternate RPL server configuration files can  be  specified
     when  running  the  RPL  server by supplying a configuration
     file similar to the default configuration file.

  Keywords
     All keywords are case-sensitive.  Not all keywords  must  be
     present.   (However, note that the end keyword at the end of
     the file must be present.) If  a  keyword  is  not  present,
     internal  defaults,  which  are the default values described
     here, will be used. Keyword-value pairs are specified by:

     keyword = value

      DebugLevel
           Specify the number of error, warning, and  information
           messages  to be generated while the RPL server is run-
           ning.  The valid range is 0-9.  A value of 0 means  no
           message  at  all, while a value of 9 will generate the
           most messages.  The default is 0. Note that it is best
           to  limit  the value to 8 or below; use of level 9 may
           generate so many debug messages that  the  performance
           of the RPL server may be impacted.

     DebugDest
           A numeric value specifying where to send the  messages
           to:

           0 = standard output
           1 = syslogd
           2 = log file

           The default is 2.

     MaxClients
           A numeric  value  specifying  the  maximum  number  of
           simultaneous network boot clients to be in service.  A
           value  of  -1  means  unlimited  except  where  system
           resources  is the limiting factor.  Any positive value
           will set a limit on the number of  clients  to  be  in
           service  at  the same time unless system resource con-
           straints come in before the limit.  The default is -1.

     BackGround
           A numeric value  indicating  whether  the  RPL  server
           should  run in the background or not. A 0 means run in
           the background and a 1 means do not run in  the  back-
           ground.   The  difference  is  whether the server will
           relinquish  the  controlling  terminal  or  not.   The
           default is 1.

     FrameSize
           The default size of data frames to  be  used  to  send
           bootfile  data to the network boot clients.  This size
           should not exceed the limits imposed by the underlying
           physical  media. For  ethernet/802.3, the maximum phy-
           sical frame size is 1500 octets.  The default is 1500.
           Note  that the protocol overhead of LLC1 and RPL is 32
           octets, resulting in a maximum  data  length  of  1468
           octets.

     LogFile
           The log file to which messages will be sent if DebugD-
           est  is  set  to 2 (the default).  The default file is
           var/spool/rpld.log.

     StartDelay
           The initial delay factor to use to control  the  speed
           of downloading.  In the default mode of operation, the
           downloading process does not wait for a positive  ack-
           nowledgment from the client before the next data frame
           is sent.  In the  case  of  a  fast  server  and  slow
           client,  data  overrun  can  result  and  requests for
           retransmission will be frequent.   By  using  a  delay
           factor,  the  speed  of data transfer is controlled to
           avoid retransmission requests.
            Note that the unit of delay is machine dependent  and
           bears no correlation with the actual time delayed.

     DelayGran
           Delay granularity.  If the initial delay factor is not
           suitable  and  the  rate  of downloading is either too
           fast or too slow,  retransmission  requests  from  the
           clients will be used to adjust the delay factor either
           upward (to slow down the data rate)  or  downward  (to
           speed  up  the  data  rate).  The delay granularity is
           used as the delay delta for adjustment.

     end   Keyword at the end of the file.  It must be present.

FILES

     /etc/rpld.conf

     /usr/sbin/rpld

ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Architecture                | x86                         |
    |_____________________________|_____________________________|

SEE ALSO

     rpld(1M), attributes(5)