Count the segments in an IPv6 routing header 
Synopsis:
#include <netinet/in.h>
int inet6_rthdr_segments(const struct cmsghdr *cmsg);
 
Arguments:
- cmsg
 
- A pointer to ancillary data containing a routing header.
 
 
Library:
libsocket
Use the -l socket option to
qcc
to link against this library.
 
Description:
This function returns the number of segments (addresses)
contained in the routing header described by cmsg.
Based on:
- W. Stevens and M. Thomas, Advanced Sockets API for IPv6, 
  RFC 2292, February 1998. Contains good examples.
 
- S. Deering and R. Hinden, Internet Protocol, Version 6 
  (IPv6) Specification, RFC 2460, December 1998.
 
 
Returns:
- 1 to 23
 
- Success.
 
- -1
 
- An error occurred.
 
 
Classification:
RFC 2292
| Safety: | 
  | 
| Cancellation point | 
No | 
| Interrupt handler | 
No | 
| Signal handler | 
Yes | 
| Thread | 
Yes |