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:


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

  1. The in and out parameters can point to the same buffer.
  2. The ip6r_segleft member in the ip6_rthdr structure will be set to the number of segments in the new header.
  3. 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 ]