Reverses the order of addresses in an IPv6 routing header.
    Format
      #include  <in6.h>
      int inet6_rth_reverse  ( const void *in, void *out );

1  –  Arguments

 in
    Points to a buffer that contains an IPv6 routing header.
 out
    Points to a buffer that is to contain the routing header with the
    reversed addresses. This parameter can point to the same buffer
    specified by the in parameter.

2  –  Description

    This function reads an IPv6 routing header and writes a new
    routing header, reversing the order of addresses in the new
    header. The in and out parameters can point to the same buffer.
    The function sets the ip6r0_segleft member in the ip6_rthdr0
    structure to the number of segments (addresses) in the new
    header.
    The ip6_rthdr0 structure is defined in the IP6.H header file.

3  –  Return Values

    0 (zero)           Success
    -1                 Failure