HP-UX Reference (11i v2 04/09) - 3 Library Functions A-M (vol 6)

inet6_rth_space(3N) inet6_rth_space(3N)

If successful, the segleft member of the Routing header is updated to account for the new address in

the Routing header and the return value of the function is 0. Upon an error the return value of the

function is -1.

inet6_rth_reverse()

This function takes a Routing header extension header pointed to by the ﬁrst argument in and

writes a new Routing header. The new Routing header sends datagrams along the reverse of that

route. The function reverses the order of the addresses and sets the segleft member in the new rout-

ing header to the number of segments. Both arguments are allowed to point to the same buffer (that

is, the reversal can occur in place).

The return value of the function is 0 on success, or -1 upon an error.

inet6_rth_segments()

This function returns the number of segments (addresses) contained in the Routing header

described by bp which can be 0 or greater.

The return value of the function is -1 upon an error.

inet6_rth_getaddr()

This function returns a pointer to the IPv6 address speciﬁed by index (which must be a value

between 0 and one less than the value returned by

inet6_rth_segments())

in the Routing

header described by bp.

An application should ﬁrst call

inet6_rth_segments()

to obtain the number of segments in the

Routing header.

Upon an error, the return value of the function is NULL.

To use these functions, the application must be compiled with:

-D_HPUX_SOURCE -D_XOPEN_SOURCE_EXTENDED -lxnet -lipv6

The APIs are implemented based on internet-draft Advanced Sockets API for IPv6 <draft-ietf-ipngwg-

2292bis-02.txt>. The APIs may be updated, replaced, or obsoleted based on future changes to the docu-

ment.

EXAMPLES

Advanced Sockets API for IPv6 <draft-ietf-ipngwg-2292bis-02.txt> gives a comprehensive example in

Appendix B.

AUTHOR

The APIs were developed by HP.