This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

inet6_rthdr_segments()

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:

inet6_rthdr_segments()

This function returns the number of segments (addresses) contained in the Routing header described by cmsg.

Returns:

1 to 23: Success.
-1: An error has occurred.

Classification:

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes

See also:

inet6_rthdr_add(), inet6_rthdr_getaddr(), inet6_rthdr_getflags(), inet6_rthdr_init(), inet6_rthdr_lasthop(), inet6_rthdr_reverse(), inet6_rthdr_space()

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.