NAME    [Toc]    [Back]

       inet6_opt_finish  -  Return  the  total  length of an IPv6
       extension header, including padding,  and  initialize  the
       option

SYNOPSIS    [Toc]    [Back]

       #include <netinet/ip6.h>

       int inet6_opt_finish(
               void *extbuf,
               size_t extlen,
               int prevlen );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Points to a buffer that contains an extension header. This
       is either a valid pointer or a  NULL  pointer.   Specifies
       the length of the extension header to finish initializing.
       A valid value is any number greater than or  equal  to  0.
       Specifies  the  length  of  the existing extension header.
       Obtain this value from a prior call to inet6_opt_init() or
       inet6_opt_append().

DESCRIPTION    [Toc]    [Back]

       The inet6_opt_finish() function when called with extbuf as
       a NULL pointer and extlen as 0, returns the  total  number
       of  bytes in an extension header, including final padding.

       If you specify extbuf as  a  valid  pointer  and  a  valid
       extlen  parameter,  the function returns the same information
 as  in  the  previous  case,  increments  the  buffer
       pointer,  and  verifies that the buffer is large enough to
       hold the header.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the  inet6_opt_finish()  function
  returns  the  total  number of bytes in an extension
       header, including padding. Upon failure, it returns a  -1.

SEE ALSO    [Toc]    [Back]

       Functions:     inet6_opt_append(3),     inet6_opt_find(3),
       inet6_opt_get_val(3),                   inet6_opt_init(3),
       inet6_opt_next(3), inet6_opt_set_val(3).

       Network Programmer's Guide



                                              inet6_opt_finish(3)