Returns the number of segments (addresses) in an IPv6 routing
    header.
    Format
      #include  <in6.h>
      int inet6_rth_segments  ( const void *bp );

1  –  Arguments

 bp
    Points to a buffer that contains an IPv6 routing header.

2  –  Description

    This function returns the number of segments (or addresses) in an
    IPv6 routing header.

3  –  Return Values

    x                  Upon successful completion, the inet6_rth_
                       segments() function returns the number of
                       segments, 0 (zero) or greater than 0.
    -1                 Failure