[#2232] Text edits

doc/sphinx/man/perfdhcp.8.rst

@@ -9,8 +9,8 @@
    information regarding copyright ownership.
 
 
-perfdhcp - DHCP benchmarking tool
+``perfdhcp`` - DHCP benchmarking tool
----------------------------------
+-------------------------------------
 
 Synopsis
 ~~~~~~~~
@@ -20,34 +20,34 @@ Synopsis
 Description
 ~~~~~~~~~~~
 
-``perfdhcp`` is a DHCP benchmarking tool. It provides a way of measuring
+``perfdhcp`` is a DHCP benchmarking tool. It provides a way to measure
 the performance of DHCP servers by generating large amounts of traffic
-from simulated multiple clients. It is able to test both IPv4 and IPv6
+from multiple simulated clients. It is able to test both IPv4 and IPv6
 servers, and provides statistics concerning response times and the
 number of requests that are dropped.
 
-The tool supports scenarios, which offer certain behaviours.
+The tool supports two different scenarios, which offer certain behaviors to be tested.
-By default (basic scenario) tests are run using the full four-packet exchange sequence
+By default (the basic scenario), tests are run using the full four-packet exchange sequence
 (DORA for DHCPv4, SARR for DHCPv6). An option is provided to run tests
 using the initial two-packet exchange (DO and SA) instead. It is also
 possible to configure ``perfdhcp`` to send DHCPv6 RENEW and RELEASE messages
-at a specified rate in parallel with the DHCPv6 four-way exchanges. By
+at a specified rate, in parallel with the DHCPv6 four-way exchanges. By
-default, if there is no response received with 1 second, a response is
+default, if there is no response received with one second, a response is
-considered lost and perfdhcp continues with other transactions.
+considered lost and ``perfdhcp`` continues with other transactions.
 
-Second scenario is called avalanche, which is selected by ``--scenario avalanche``.
+A second scenario, called avalanche, is selected via ``--scenario avalanche``.
-It first sends as many Discovery or Solicit messages as request in -R option then
+It first sends as many Discovery or Solicit messages as requests in the ``-R`` option; then
-a retransmission (with exponential back off mechanism) is used for each simulated client until all requests are
+a retransmission (with an exponential back-off mechanism) is used for each simulated client, until all requests are
-answered. It will generate report when all clients get their addresses or when
+answered. It generates a report when all clients receive their addresses, or when
-it will be manually stopped. This scenario attempts to replicate a
+it is manually stopped. This scenario attempts to replicate a
 case where the server is not able to handle the traffic swiftly
-enough. Real clients will assume the packet or the response was lost
+enough. Real clients will assume the packet or response was lost
 and will retransmit, further increasing DHCP traffic. This is
-sometimes called avalanche effect, thus the scenario name.
+sometimes called an avalanche effect, thus the scenario name.
-Option ``-p`` is ignored in avalanche scenario.
+Option ``-p`` is ignored in the avalanche scenario.
 
-When running a performance test, ``perfdhcp`` will exchange packets with
+When running a performance test, ``perfdhcp`` exchanges packets with
-the server under test as fast as possible unless the ``-r`` parameter is used to
+the server under test as quickly as possible, unless the ``-r`` parameter is used to
 limit the request rate. The length of the test can be limited by setting
 a threshold on any or all of the number of requests made by
 ``perfdhcp``, the elapsed time, or the number of requests dropped by the
@@ -65,37 +65,37 @@ perform DNS updates. This may be used to discover performance
 bottlenecks for different server configurations (e.g. DDNS enabled or
 disabled).
 
-Up to two template files can be specified on the command line, each file
+Up to two template files can be specified on the command line, with each file
-representing the contents of a particular type of packet, the type being
+representing the contents of a particular type of packet, and the type being
 determined by the test being carried out. For example, if testing
 DHCPv6:
 
 -  With no template files specified on the command line, ``perfdhcp``
-   will generate both SOLICIT and REQUEST packets.
+   generates both Solicit and Request packets.
 
--  With one template file specified, that file will be used as the
+-  With one template file specified, that file is used as the
-   pattern for SOLICIT packets: ``perfdhcp`` will generate the REQUEST
+   pattern for Solicit packets: ``perfdhcp`` generates the Request
    packets.
 
--  With two template files given on the command line, the first will be
+-  With two template files given on the command line, the first is
-   used as the pattern for SOLICIT packets, the second as the pattern
+   used as the pattern for Solicit packets, and the second as the pattern
-   for REQUEST packets.
+   for Request packets.
 
-(Similar determination applies to DHCPv4's DISCOVER and REQUEST
+(A similar determination applies to DHCPv4's DHCPDISCOVER and DHCPREQUEST
 packets.)
 
-The template file holds the DHCP packet represented as a stream of ASCII
+The template file holds the DHCP packet, represented as a stream of ASCII
-hexadecimal digits and it excludes any IP/UDP stack headers. The
+hexadecimal digits; it excludes any IP/UDP stack headers. The
 template file must not contain any characters other than hexadecimal
 digits and spaces. Spaces are discarded when the template file is parsed;
-in the file, '12B4' is the same as '12 B4' which is the same as '1 2
+in the file, ``12B4`` is the same as ``12 B4``, which is the same as
-B 4'.
+``1 2 B 4``.
 
 The template files should be used in conjunction with the command-line
 parameters which specify offsets of the data fields being modified in
 outbound packets. For example, the ``-E time-offset`` switch specifies
 the offset of the DHCPv6 Elapsed Time option in the packet template.
-If the offset is specified, ``perfdhcp`` will inject the current elapsed-time
+If the offset is specified, ``perfdhcp`` injects the current elapsed-time
 value into this field before sending the packet to the server.
 
 In many scenarios, ``perfdhcp`` needs to simulate multiple clients,
@@ -108,89 +108,89 @@ note that this offset points to the end (not the beginning) of the
 client identifier (or HW address field). The number of bytes being
 randomized depends on the number of simulated clients. If the number of
 simulated clients is between 1 and 255, only one byte (to which the
-randomization offset points) will be randomized. If the number of
+randomization offset points) is randomized. If the number of
-simulated clients is between 256 and 65535, two bytes will be
+simulated clients is between 256 and 65535, two bytes are
-randomized. Note that the last two bytes of the client identifier will be
+randomized. Note that the last two bytes of the client identifier are
 randomized in this case: the byte which the randomization offset parameter
 points to, and the one which precedes it (random-offset - 1). If the
-number of simulated clients exceeds 65535, three bytes will be
+number of simulated clients exceeds 65535, three bytes are
 randomized, and so on.
 
-Perfdhcp can now simulate traffic from multiple subnets by enabling option
+``perfdhcp`` can simulate traffic from multiple subnets by enabling option
--J and passing path to file that contains v4 or v6 addresses that will be
+``-J`` and passing a path to a file that contains v4 or v6 addresses to be
-used as relay in generated messages. That enable testing of vast numbers
+used as relays in generated messages. That enables testing of vast numbers
-of Kea shared networks. While testing Kea v4 it should be started with
+of Kea shared networks. While testing DHCPv4, Kea should be started with the
-KEA_TEST_SEND_RESPONSES_TO_SOURCE environment variable to force Kea
+``KEA_TEST_SEND_RESPONSES_TO_SOURCE`` environment variable, to force Kea
-to send generated messages to source address of incoming packet.
+to send generated messages to the source address of the incoming packet.
 
 Templates may currently be used to generate packets being sent to the
-server in 4-way exchanges, i.e. SOLICIT, REQUEST (DHCPv6) and DISCOVER,
+server in 4-way exchanges, i.e. Solicit, Request (DHCPv6) and DHCPDISCOVER,
-REQUEST (DHCPv4). They cannot be used when RENEW or RELEASE packets are
+DHCPREQUEST (DHCPv4). They cannot be used when Renew or DHCPRELEASE packets are
 being sent.
 
 Options
 ~~~~~~~
 
 ``-1``
-   Takes the server-ID option from the first received message.
+   Takes the ``server-id`` option from the first received message.
 
 ``-4``
    Establishes DHCPv4 operation; this is the default. It is incompatible with the
    ``-6`` option.
 
 ``-6``
-   Establishes DHCPv6 operation. This is incompatible with the ``-4`` option.
+   Establishes DHCPv6 operation. It is incompatible with the ``-4`` option.
 
 ``-b basetype=value``
    Indicates the base MAC or DUID used to simulate different clients. The basetype
    may be "mac" or "duid". (The keyword "ether" may alternatively used
    for MAC.) The ``-b`` option can be specified multiple times. The MAC
    address must consist of six octets separated by single (:) or double
-   (::) colons, for example: mac=00:0c:01:02:03:04. The DUID value is a
+   (::) colons; for example: mac=00:0c:01:02:03:04. The DUID value is a
    hexadecimal string; it must be at least six octets long and not
    longer than 64 bytes, and the length must be less than 128
-   hexadecimal digits, for example: duid=0101010101010101010110111F14.
+   hexadecimal digits. For example: duid=0101010101010101010110111F14.
 
 ``-d drop-time``
    Specifies the time after which a request is treated as having been
    lost. The value is given in seconds and may contain a fractional
-   component. The default is 1 second.
+   component. The default is 1.
 
 ``-e lease-type``
    Specifies the type of lease being requested from the server. It may
    be one of the following:
 
-   **address-only**
+   ``address-only``
-      Only regular addresses (v4 or v6) will be requested.
+      Only regular addresses (v4 or v6) are requested.
 
-   **prefix-only**
+   ``prefix-only``
-      Only IPv6 prefixes will be requested.
+      Only IPv6 prefixes are requested.
 
-   **address-and-prefix**
+   ``address-and-prefix``
-      Both IPv6 addresses and prefixes will be requested.
+      Both IPv6 addresses and prefixes are requested.
 
    The ``-e prefix-only`` and ``-e address-and-prefix`` forms may not be used
    with the ``-4`` option.
 
 ``-F release-rate``
-   Specifies the rate at which RELEASE requests are sent to a server. This value
+   Specifies the rate at which Release requests are sent to a server. This value
    is only valid when used in conjunction with the exchange rate (given
    by ``-r rate``). Furthermore, the sum of this value and the renew-rate
    (given by ``-f rate``) must be equal to or less than the exchange
    rate value.
 
 ``-f renew-rate``
-   Specifies the rate at which DHCPv4 or DHCPv6 renew requests are sent to a server.
+   Specifies the rate at which DHCPv4 DHCPREQUEST or DHCPv6 Renew requests are sent to a server.
    This value is only valid when used in conjunction with the exchange
    rate (given by ``-r rate``). Furthermore, the sum of this value and
    the release-rate (given by ``-F rate``) must be equal to or less than the
    exchange rate.
 
 ``-g thread-mode``
-   Allows selection of thread-mode, which can be either 'single' or 'multi'. In multi-thread mode
+   Allows selection of thread-mode, which can be either ``single`` or ``multi``. In multi-thread mode,
    packets are received in a separate thread, which allows better
    utilisation of CPUs. In a single-CPU system it is better to run in one
-   thread to avoid threads blocking each other. If more than one CPU is
+   thread, to avoid threads blocking each other. If more than one CPU is
    present in the system, multi-thread mode is the default; otherwise
    single-thread is the default.
 
@@ -199,18 +199,19 @@ Options
 
 ``-i``
    Performs only the initial part of the exchange: DISCOVER-OFFER if ``-4`` is
-   selected, SOLICIT-ADVERTISE if ``-6`` is chosen.
+   selected, Solicit-Advertise if ``-6`` is chosen.
 
    ``-i`` is incompatible with the following options: ``-1``, ``-d``,
    ``-D``, ``-E``, ``-S``, ``-I`` and ``-F``. In addition, it cannot be
-   used with multiple instances of ``-O``, ``-T`` and ``-X``.
+   used with multiple instances of ``-O``, ``-T``, and ``-X``.
 
 ``-J remote-address-list-file``
-    Text file that include multiple addresses. If provided perfdhcp will choose
+    Specifies a text file that includes multiple addresses, and is
-    randomly one of addresses for each exchange. This is used to generate traffic
+    designed to test shared networks. If provided, ``perfdhcp``
-    from multiple subnets. Designed to test shared-networks. While testing kea v4 it
+    randomly chooses one of the addresses for each exchange, to generate traffic
-    should be started with KEA_TEST_SEND_RESPONSES_TO_SOURCE=ENABLE
+    from multiple subnets. When testing DHCPv4, it
-    env variable otherwise perfdhcp will not be able to receive responses.
+    should be started with the ``KEA_TEST_SEND_RESPONSES_TO_SOURCE=ENABLE``
+    environment variable; otherwise, ``perfdhcp`` will not be able to receive responses.
 
 ``-l local-addr|interface``
    For DHCPv4 operation, specifies the local hostname/address to use when
@@ -226,10 +227,10 @@ Options
 
 ``-M mac-list-file``
    Specifies a text file containing a list of MAC addresses, one per line. If
-   provided, a MAC address will be chosen randomly from this list for
+   provided, a MAC address is chosen randomly from this list for
    every new exchange. In DHCPv6, MAC addresses are used to
    generate DUID-LLs. This parameter must not be used in conjunction
-   with the -b parameter.
+   with the ``-b`` parameter.
 
 ``-N remote-port``
    Specifies the remote port to use. This must be zero or a positive
@@ -244,8 +245,8 @@ Options
    does not offer any kind of logic behind those options; they are simply
    inserted into packets and sent as is. Be careful not to duplicate
    options that are already inserted. For example, to insert client
-   class identifier (option code 60) with a string 'docsis', use
+   class identifier (option code 60) with a string "docsis", use
-   -o 60,646f63736973. The ``-o`` may be used multiple times. It is
+   "-o 60,646f63736973". The ``-o`` may be used multiple times. It is
    necessary to specify the protocol family (either ``-4`` or ``-6``) before
    using ``-o``.
 
@@ -262,7 +263,7 @@ Options
 
 ``-R num-clients``
    Specifies how many different clients are used. With a value of 1 (the
-   default), all requests seem to come from the same client.
+   default), all requests appear to come from the same client.
    Must be a positive number.
 
 ``-s seed``
@@ -271,7 +272,7 @@ Options
    seed is not used; this is the default.
 
 ``--scenario name``
-   Specifies type of the scenario, can be **basic** (default) or **avalanche**.
+   Specifies the type of scenario, and can be ``basic`` (the default) or ``avalanche``.
 
 ``-T template-file``
    Specifies a file containing the template to use as a stream of
@@ -280,16 +281,16 @@ Options
    section above).
 
 ``-u``
-   Enable checking address uniqueness. Lease valid lifetime should not be shorter
+   Enables checks for address uniqueness. The lease valid-lifetime should not be shorter
-   than test duration and clients should not request address more than once without
+   than the test duration, and clients should not request an address more than once without
-   releasing it first.
+   releasing it.
 
 ``-v``
    Prints the version of this program.
 
 ``-W exit-wait-time``
    Specifies the exit-wait-time parameter, which causes ``perfdhcp`` to wait for
-   exit-wait-time after an exit condition has been met, to receive all
+   a certain amount of time after an exit condition has been met, to receive all
    packets without sending any new packets. Expressed in microseconds.
    If not specified, 0 is used (i.e. exit immediately after exit
    conditions are met).
@@ -304,34 +305,34 @@ Options
    string of single keywords specifying the operations for which verbose
    output is desired. The selector key letters are:
 
-   **a**
+   ``a``
-      Prints the decoded command line arguments.
+      Prints the decoded command-line arguments.
 
-   **e**
+   ``e``
       Prints the exit reason.
 
-   **i**
+   ``i``
-      Prints the rate processing details.
+      Prints the rate-processing details.
 
-   **l**
+   ``l``
       Prints the received leases.
 
-   **s**
+   ``s``
-      Prints the first server-ID.
+      Prints the first server ID.
 
-   **t**
+   ``t``
       When finished, prints timers of all successful exchanges.
 
-   **T**
+   ``T``
       When finished, prints templates.
 
 ``-y seconds``
-   Time in seconds after which perfdhcp will start simulating the client waiting longer for server responses. This increase the
+   Time in seconds after which ``perfdhcp`` starts simulating the client waiting longer for server responses. This increases the
-   secs field in DHCPv4 and sends increased values in Elapsed option in DHCPv6. Must be used with '-Y'.
+   ``secs`` field in DHCPv4 and sends increased values in the ``Elapsed Time`` option in DHCPv6. Must be used with ``-Y``.
 
 ``-Y seconds``
-   Period of time in seconds in which perfdhcp will be simulating the client waiting longer for server responses. This increase
+   Time in seconds during which ``perfdhcp`` simulates the client waiting longer for server responses. This increases
-   the secs field in DHCPv4 and sends increased values in Elapsed option in DHCPv6. Must be used with '-y'.
+   the ``secs`` field in DHCPv4 and sends increased values in the ``Elapsed Time`` option in DHCPv6. Must be used with ``-y``.
 
 DHCPv4-Only Options
 ~~~~~~~~~~~~~~~~~~~
@@ -347,7 +348,7 @@ DHCPv6-Only Options
 The following options only apply for DHCPv6 (i.e. when ``-6`` is given).
 
 ``-c``
-   Adds a rapid-commit option (exchanges will be SOLICIT-ADVERTISE).
+   Adds a rapid-commit option (exchanges are Solicit-Advertise).
 
 ``-A encapsulation-level``
    Specifies that relayed traffic must be generated. The argument
@@ -365,13 +366,13 @@ specified multiple times on the command line; each occurrence affects
 the corresponding template file (see "Templates" above).
 
 ``-E time-offset``
-   Specifies the offset of the secs field (DHCPv4) or elapsed-time option (DHCPv6) in the
+   Specifies the offset of the ``secs`` field (DHCPv4) or ``Elapsed Time`` option (DHCPv6) in the
-   second (i.e. REQUEST) template; must be 0 or a positive integer. A
+   second (i.e. Request) template; must be 0 or a positive integer. A
    value of 0 disables this.
 
 ``-I ip-offset``
-   Specifies the offset of the IP address (DHCPv4) in the requested-IP
+   Specifies the offset of the IP address (DHCPv4) in the ``requested-ip``
-   option or IA_NA option (DHCPv6) in the second (REQUEST) template.
+   option or ``IA_NA`` option (DHCPv6) in the second (Request) template.
 
 ``-O random-offset``
    Specifies the offset of the last octet to randomize in the template. This
@@ -379,7 +380,7 @@ the corresponding template file (see "Templates" above).
    use this option.
 
 ``-S srvid-offset``
-   Specifies the offset of the server-ID option in the second (REQUEST) template.
+   Specifies the offset of the ``server-id`` option in the second (Request) template.
    This must be a positive integer, and the switch can only be used
    when the template option (``-T``) is also given.
 
@@ -392,22 +393,22 @@ Options Controlling a Test
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ``-D max-drop``
-   Aborts the test immediately if **max-drop** requests have been dropped.
+   Aborts the test immediately if "max-drop" requests have been dropped.
    Use ``-D 0`` to abort if even a single request has
-   been dropped. **max-drop** must be a positive integer. If **max-drop**
+   been dropped. "max-drop" must be a positive integer. If "max-drop"
-   includes the suffix '%', it specifies a maximum percentage of
+   includes the suffix ``%``, it specifies the maximum percentage of
-   requests that may be dropped before abort. In this case, testing of
+   requests that may be dropped before aborting. In this case, testing of
-   the threshold begins after 10 requests have been expected to be
+   the threshold begins after 10 requests are expected to have been
    received.
 
 ``-n num-requests``
-   Initiates **num-request** transactions. No report is generated until all
+   Initiates "num-request" transactions. No report is generated until all
    transactions have been initiated/waited-for, after which a report is
    generated and the program terminates.
 
 ``-p test-period``
-   Sends requests for **test-period**, which is specified in the same manner
+   Sends requests for "test-period", which is specified in the same manner
-   as ``-d``. This can be used as an alternative to ``-n`` or both
+   as ``-d``. This can be used as an alternative to ``-n``, or both
    options can be given, in which case the testing is completed when
    either limit is reached.
 
@@ -422,14 +423,14 @@ Options Controlling a Test
 Arguments
 ~~~~~~~~~
 
-server
+``server``
    Indicates the server to test, specified as an IP address. In the DHCPv6 case, the
-   special name 'all' can be used to refer to
+   special name ``all`` can be used to refer to
-   All_DHCP_Relay_Agents_and_Servers (the multicast address FF02::1:2),
+   ``All_DHCP_Relay_Agents_and_Servers`` (the multicast address FF02::1:2),
-   or the special name 'servers' to refer to All_DHCP_Servers (the
+   or the special name ``servers`` to refer to ``All_DHCP_Servers`` (the
    multicast address FF05::1:3). The server is mandatory except where
    the ``-l`` option is given to specify an interface, in which case it
-   defaults to 'all'.
+   defaults to ``all``.
 
 Errors
 ~~~~~~
@@ -450,7 +451,7 @@ locallimit
 Exit Status
 ~~~~~~~~~~~
 
-``perfdhcp`` can exit with one of the following status codes:
+``perfdhcp`` exits with one of the following status codes:
 
 0
    Success.
@@ -468,28 +469,55 @@ Exit Status
 Usage Examples
 ~~~~~~~~~~~~~~
 
-Simulate regular DHCPv4 traffic: 100 DHCPv4 devices (-R 100), 10 packets per second (-r 10), show the query/response rate details (-xi),
+Here is an example that simulates regular DHCPv4 traffic of 100 DHCPv4 devices (-R 100),
-the report should be shown every 2 seconds (-t 2), send the packets to the IP 192.0.2.1:
+10 packets per second (-r 10), shows the query/response rate details (-xi),
+shows a report every 2 seconds (-t 2), and sends the packets to the IP 192.0.2.1:
 
-sudo perfdhcp -xi -t 2 -r 10 -R 100 192.0.2.1
+.. code-block::
 
-Here's a similar case, but for DHCPv6. Note that DHCPv6 protocol uses link-local addresses, so you need to specify the interface
+   sudo perfdhcp -xi -t 2 -r 10 -R 100 192.0.2.1
-(eth0 in this example) to send the traffic. 'all' is a convenience alias for All_DHCP_Relay_Agents_and_Servers (the multicast
-address FF02::1:2). Alternatively, you can use 'servers' alias to refer to All_DHCP_Servers (the multicast address FF05::1:3),
-or skip it all together and the default value (all) will be used.
 
-sudo perfdhcp -6 -xi -t 1 -r 1 -R 10 -l eth0 all
+Here's a similar case, but for DHCPv6. Note that the DHCPv6 protocol uses link-local
+addresses, so the interface (eth0 in this example) must be specified on which to send the
+traffic. ``all`` is a convenience alias for ``All_DHCP_Relay_Agents_and_Servers``
+(the multicast address FF02::1:2). It is also possible to use the ``servers`` alias
+to refer to ``All_DHCP_Servers`` (the multicast address FF05::1:3). The default is ``all``.
 
-The following examples simulate normal DHCPv4 and DHCPv6 traffic that after 3 seconds starts pretending to not receive any
+.. code-block::
-responses from the server for 10 seconds. DHCPv4 protocol signals this by increased secs field and DHCPv6 uses elapsed option
-for that. In real networks this indicates that the clients are not getting responses in a timely matter. This can be used
-to simulate some HA scenarios, as Kea uses secs field and elapsed option value as one of the indicators that the HA partner
-is not responding. When enabled with -y and -Y, the secs and elapsed time value increased steadily.
 
-sudo perfdhcp -xi -t 1 -r 1 -y 10 -Y 3 192.0.2.1
+   sudo perfdhcp -6 -xi -t 1 -r 1 -R 10 -l eth0 all
 
-sudo perfdhcp -6 -xi -t 1 -r 1 -y 10 -Y 3 2001:db8::1
+The following examples simulate normal DHCPv4 and DHCPv6 traffic that, after 3 seconds,
+starts pretending not to receive any responses from the server for 10 seconds. The
+DHCPv4 protocol signals this by an increased ``secs`` field, while DHCPv6 uses the
+``Elapsed Time`` option. In real networks, this indicates that clients are not getting
+responses in a timely matter. This can be used to simulate some HA scenarios, as Kea
+uses the ``secs`` field and ``Elapsed Time`` option value as one of the indicators
+that the HA partner is not responding. When enabled with ``-y`` and ``-Y``, the ``secs``
+and ``Elapsed Time`` values increase steadily.
 
+.. code-block::
+
+   sudo perfdhcp -xi -t 1 -r 1 -y 10 -Y 3 192.0.2.1
+
+   sudo perfdhcp -6 -xi -t 1 -r 1 -y 10 -Y 3 2001:db8::1
+
+Documentation
+~~~~~~~~~~~~~
+
+Kea comes with an extensive Kea Administrator Reference Manual that covers
+all aspects of running the Kea software - compilation, installation,
+configuration, configuration examples, and much more. Kea also features a
+Kea Messages Manual, which lists all possible messages Kea can print
+with a brief description for each of them. Both documents are
+available in various formats (.txt, .html, .pdf) with the Kea
+distribution. The Kea documentation is available at
+https://kea.readthedocs.io.
+
+Kea source code is documented in the Kea Developer's Guide,
+available at https://reports.kea.isc.org/dev_guide/.
+
+The Kea project website is available at https://kea.isc.org.
 
 Mailing Lists and Support
 ~~~~~~~~~~~~~~~~~~~~~~~~~