NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <netinet/ip6.h>

       int inet6_rth_add(
               void *bp,
               const struct in6_addr *addr );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Points to a buffer that is  to  contain  an  IPv6  Routing
       header.   Points  to an IPv6 address to add to the Routing
       header.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       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



                                                 inet6_rth_add(3)