NAME

inet6_rth_add − Add an IPv6 address to the Routing header under construction

SYNOPSIS

#include <netinet/ip6.h>
int inet6_rth_add(
        void ∗bp,
        const struct in6_addr ∗addr );

LIBRARY

Standard C Library (libc)

PARAMETERS

bpPoints to a buffer that is to contain an IPv6 Routing header. 

addrPoints to an IPv6 address to add to the Routing header. 

DESCRIPTION

The inet6_rth_add() function adds IPv6 address to the end of the Routing header under construction. The address pointed to by addr cannot be either an IPv6 V4-mapped address or an IPv6 multicast address. 

The function increments the ip60r_segleft member in the ip6_rthdr0 structure. The ip6_rthdr0 structure is defined in netinet/ip6.h. 

Only Routing Header Type 0 is supported. 

RETURN VALUES

Upon successful completion, the inet6_rth_add() function returns 0 (zero). Upon failure, it returns a -1. 

SEE ALSO

Functions: inet6_rth_getaddr(3), inet6_rth_init(3), inet6_rth_reverse(3), inet6_rth_segments(3), inet6_rth_space(3). 

Network Programmer’s Guide