rpld.conf(4) File Formats rpld.conf(4)NAMErpld.conf - Remote Program Load (RPL) server configuration file
SYNOPSIS
/etc/rpld.conf
DESCRIPTION
The /etc/rpld.conf file contains the configuration information for
operation of rpld, the RPL-based network boot server. It is a text
file containing keyword-value pairs and comment.
The keyword-value pairs specify the value to use for parameters 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 con‐
figurations.
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 simul‐
taneous 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 constraints 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 physi‐
cal 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
DebugDest 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
acknowledgment 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 fac‐
tor, 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 attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Architecture │x86 │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOrpld(1M), attributes(5)SunOS 5.10 03 Dec 2003 rpld.conf(4)
