Re: [dhcwg] I-D Action: draft-ietf-dhc-conn-status-00.txt

[Simon Perreault <[e-mail]>]

This is getting better!

Some editorial suggestions about this new part:

>       option-code   OPTION_HOST_CONNECTIVITY (TBA).
>       option-len    1.
>       status        8-bit field indicating IP family connectivity status
>                     of a host. The following codes are defined:
>                     +------+----------+
>                     |  Bit | Status   |
>                     +----- +----------+
>                     |  1   | IPv4     |
>                     |  2   | IPv6     |
>                     | 3..8 | Reserved |
>                     +------+----------+

Two things:
- It is customary to number bits starting from zero.
- It would be better to illustrate the bits in the preceding figure
rather than in a separate table. Something like this:

>       0                   1                   2                   3
>       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
>       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
>       |   OPTION_HOST_CONNECTIVITY    |          option-len           |
>       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
>       |  Reserved |S|F|                                               |
>       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Then explain what Reserved, S, and F stand for. No need for a separate
table.

In that figure, please also offset bit numbers by one character to the
right. The rationale being that we are numbering bits, not frontiers
between bits. Also the 3-byte empty space needs to be either named or
removed. This would give either this:

>        0                   1                   2                   3
>        0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
>       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
>       |   OPTION_HOST_CONNECTIVITY    |          option-len           |
>       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
>       |  Reserved |S|F|                Reserved                       |
>       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

or this:

>        0                   1                   2                   3
>        0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
>       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
>       |   OPTION_HOST_CONNECTIVITY    |          option-len           |
>       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
>       |  Reserved |S|F|
>       +-+-+-+-+-+-+-+-+

Simon
-- 
DTN made easy, lean, and smart --> http://postellation.viagenie.ca
NAT64/DNS64 open-source        --> http://ecdysis.viagenie.ca
STUN/TURN server               --> http://numb.viagenie.ca