NAME

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

SYNOPSIS

#include <netinet/ip6.h>
int inet6_opt_finish(
        void ∗extbuf,
        size_t extlen,
        int prevlen );

LIBRARY

Standard C Library (libc)

PARAMETERS

extbuf
Points to a buffer that contains an extension header. This is either a valid pointer or a NULL pointer.

extlen
Specifies the length of the extension header to finish initializing. A valid value is any number greater than or equal to 0.

prevlen
Specifies the length of the existing extension header. Obtain this value from a prior call to inet6_opt_init() or inet6_opt_append(). 

DESCRIPTION

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

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

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