INET6OPTIONSPACE(3) BSD Library Functions Manual INET6OPTIONSPACE(3)

NAME
     iinneett66ooppttiioonnssppaaccee, iinneett66ooppttiioonniinniitt, iinneett66ooppttiioonnaappppeenndd,
     iinneett66ooppttiioonnaalllloocc, iinneett66ooppttiioonnnneexxtt, iinneett66ooppttiioonnffiinndd - IPv6 Hop-by-
     Hop and Destination Options manipulation

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>
     ##iinncclluuddee <>

     int
     iinneett66ooppttiioonnssppaaccee(int nbytes);

     int
     iinneett66ooppttiioonniinniitt(void *bp, struct cmsghdr **cmsgp, int type);

     int
     iinneett66ooppttiioonnaappppeenndd(struct cmsghdr *cmsg, const uint8t *typep,
         int multx, int plusy);

     uint8t *
     iinneett66ooppttiioonnaalllloocc(struct cmsghdr *cmsg, int datalen, int multx,
         int plusy);

     int
     iinneett66ooppttiioonnnneexxtt(const struct cmsghdr *cmsg, uint8t **tptrp);

     int
     iinneett66ooppttiioonnffiinndd(const struct cmsghdr *cmsg, uint8t **tptrp,
         int type);

DESCRIPTION
     Building and parsing the Hop-by-Hop and Destination options is compli-
     cated due to alignment constranints, padding and ancillary data manipula-
     tion.  RFC2292 defines a set of functions to help the application.  The
     function prototypes for these functions are all in the 
     header.

     The full description of these functions is available in RFC2292.

DIAGNOSTICS
     iinneett66ooppttiioonniinniitt() and iinneett66ooppttiioonnaappppeenndd() return 0 on success or -1
     on an error.

     iinneett66ooppttiioonnaalllloocc() returns NULL on an error.

     On errors, iinneett66ooppttiioonnnneexxtt() and iinneett66ooppttiioonnffiinndd() return -1 setting
     *tptrp to non NULL value.

EEXXAAMMPPLLEESS
     RFC2292 gives comprehensive examples in chapter 6.

SEE ALSO
     W. Stevens and M. Thomas, Advanced Sockets API for IPv6, RFC2292,
     February 1998.

     S. Deering and R. Hinden, Internet Protocol, Version 6 (IPv6)
     Specification, RFC2460, December 1998.

HISTORY     The implementation first appeared in KAME advanced networking kit.

STANDARDS     The functions are documented in ``Advanced Sockets API for IPv6''
     (RFC2292).

BUGS
BSD                            December 10, 1999                           BSD