inet6_rthdr_add()

Add an address to an IPv6 routing header

Synopsis:

#include <netinet/in.h>

int inet6_rthdr_add(struct cmsghdr *cmsg, 
                    const struct in6_addr *addr, 
                    unsigned int flags);

Arguments:

addr

A pointer to the IPv6 address structure to add to the routing header.

flags

Routing header flags. For an IPv6 Type 0 routing header, it's either IPV6_RTHDR_LOOSE or IPV6_RTHDR_STRICT.

cmsg

A pointer to Ancillary data containing the routing header.

Library:

libsocket

Use the -l socket option to qcc to link against this library.

Description:

This function adds the address pointed to by addr to the end of the Routing header being constructed and sets the type of this hop to the value of flags.

If successful, the cmsg_len member of the cmsghdr structure is updated to account for the new address in the routing header.

Returns:

0

Success.

-1

An error has occurred.

Classification:

RFC 2292

See also:

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

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.