inet6_rth_reverse()--Reverse the Order of Addresses in the IPv6 Routing Header
Syntax
#include <netinet/in.h>
int inet6_rth_reverse(const void *in,
void *out)
Service Program Name: QSOSRV1IP6
Default Public Authority: *USE
Threadsafe: Yes
The inet6_rth_reverse() function reads a routing extension
header and writes a new routing extension header with the addresses in reverse order.
Parameters
- in
- (Input) Pointer to a buffer that contains the routing extension header.
- out
- (I/O) Pointer to a buffer to store the new routing extension header with reverse addresses.
Authorities
No authorization is required.
Return Value
inet6_rth_reverse() returns an integer. Possible values are:
- -1 (unsuccessful)
- 0 (successful)
Error Conditions
When inet6_rth_reverse() fails, errno can be set to one of the following:
[EFAULT] |
Bad address.
The system detected an address that was not valid while attempting to access
the buffer pointed to by the in or out parameter.
|
Usage Notes
- The in and out parameters can point to the same buffer.
- The ip6r_segleft member in the ip6_rthdr structure will be set
to the number of segments in the new header.
- This function can be used to send datagram packets along the reverse route of the packets received.
Related Information
API introduced: V6R1
[ Back to top | UNIX-Type APIs | APIs by category ]