inet6_opt_get_val(3) — Subroutines
NAME
inet6_opt_get_val − Extract data items from the data portion of an IPv6 option
SYNOPSIS
#include <netinet/ip6.h>
int inet6_opt_get_val(
void ∗databuf,
size_t offset,
void ∗val,
int vallen );
LIBRARY
Standard C Library (libc)
PARAMETERS
databuf
Points to a buffer that contains an extension header. This is a pointer returned by a call to inet6_opt_find() or inet6_opt_next().
offset
Specifies the location in the data portion of the option from which to extract the data. You can access the first byte after the option type and length by specifying the offset of 0 (zero).
valPoints to a destination for the extracted data.
vallen
Specifies the length of the data, in bytes, to be extracted.
DESCRIPTION
The inet6_opt_get_val() function copies data items from data buffer databuf beginning at offset to the location val. In addition, it returns the offset for the next data field to assist you in extracting option content that has multiple fields.
Make sure that each field is aligned on its natural boundaries.
RETURN VALUES
Upon successful completion, the inet6_opt_get_val() function returns the offset for the next field in the data buffer. Upon failure, it returns a -1.
SEE ALSO
Functions: inet6_opt_append(3), inet6_opt_find(3), inet6_opt_finish(3), inet6_opt_init(3), inet6_opt_next(3), inet6_opt_set_val(3).
Network Programmer’s Guide