BIND 10 #2307: Add perfdhcp man page

[BIND 10 Development]

#2307: Add perfdhcp man page
-------------------------------------+-------------------------------------
            Reporter:  jreed         |                        Owner:
                Type:  task          |  stephen
            Priority:  low           |                       Status:
           Component:  perfdhcp      |  reviewing
            Keywords:                |                    Milestone:  DHCP-
           Sensitive:  0             |  Kea0.9-alpha
         Sub-Project:  DHCP          |                   Resolution:
Estimated Difficulty:  4             |                 CVSS Scoring:
         Total Hours:  0.5           |              Defect Severity:  N/A
                                     |  Feature Depending on Ticket:
                                     |          Add Hours to Ticket:  0.5
                                     |                    Internal?:  0
-------------------------------------+-------------------------------------
Changes (by marcin):

 * hours:  0 => 0.5
 * owner:  marcin => stephen
 * totalhours:  0 => 0.5


Comment:

 Reviewed commit 6ca0d329098fd60d5c6af5d0ea5c5a07eebf7de5

 make clean should remove the perfdhcp.1 file. Currently it doesn't.

 Also, the gitignore should be updated to exclude man page so as someone
 doesn't commit this file accidentally.

 DESCRIPTION
 It should be mentioned that perfdhcp supports DHCPv6 Renew and Release
 apart from 4-way exchanges. Maybe something like this:

  - OLD:
   By default, 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.

 - NEW: By default, 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 DHCPv6
 Release messages at the specified rate in parallel with 4-way exchanges.

 Or something like this.


 TEMPLATES
 The template files are NOT used to create ADVERTISE packets - the second
 template is used to create REQUEST packets. ADVERTISE is a response from
 the server.


 Some typos:
   - !''With one template file specified, that file will be used as the
 pattern for SOLICIT packets: perfdhcp will generate the ADVERTISE packets.
 .!'' - spurious dot at the end.
   - !''Received a message which doesn't match one sent to the server (i.e.
 it is a duplicate message, a message that has arrived after an excessive
 delay, or one that is just not recognised).!'' - Shouldn't it be
 !''recognized!'' ?
   - !''The selector keyletters are ... !'' - shouldn't it be !''key
 letters!''?

 Do you think it is worth to add !ChangeLog for perfdhcp man page.
 Personally, I think we should as it is a user visible addition.

-- 
Ticket URL: <http://bind10.isc.org/ticket/2307#comment:9>
BIND 10 Development <http://bind10.isc.org>
BIND 10 Development