kern/52472: Under-documentation of scope handling in KAME IPv6

[ef%math.uni-bonn.de@localhost]

>Number:         52472
>Category:       kern
>Synopsis:       Under-documentation of scope handling in KAME IPv6
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Aug 07 14:50:00 +0000 2017
>Originator:     Edgar Fuß
>Release:        
>Organization:
Mathematisches Institut der Universität Bonn
>Environment:
>Description:
The handling of scoped IPv6 addresses (in particular, link local addresses) in the KAME IPv6 stack is severely under-documented, especially the fact that the routing cache needs the scope embedded in the address.
>How-To-Repeat:
Code inspaection.
>Fix:
Some information from Chapter 2.9 (Handling Scope Zones) of ?IPv6 Core Protocols Implementation?, especially an ASCII-art form of Figure 2-12, should be included in ip6_scope.h or a README.scope file.