NAME

inet6_rth_getaddr − Retrieve an address for an index from an IPv6 Routing header

SYNOPSIS

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

LIBRARY

Standard C Library (libc)

PARAMETERS

bpPoints to a buffer that contains an IPv6 Routing header. 

index
Specifies a value that identifies a position in a Routing header for a specific address. Valid values range from 0 to the return value from inet6_rth_segments() minus 1. 

DESCRIPTION

The inet6_rth_getaddr() function uses a specified index value and retrieves a pointer to an address in a Routing header specified by bp. Call inet6_rth_segments() before calling this function in order to determine the number of segments (addresses) in the Routing header. 

RETURN VALUES

Upon successful completion, the inet6_rth_getaddr() function returns a pointer to an address. Upon failure, it returns a NULL pointer. 

SEE ALSO

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

Network Programmer’s Guide