libnl  3.2.13
Attributes

Netlink Attributes Construction/Parsing Interface. More...


Detailed Description

Netlink Attributes Construction/Parsing Interface.

Related sections in the development guide:

Header

#include <netlink/attr.h>

Data Structures

struct  nla_policy
 Attribute validation policy. More...

Attribute Size Calculation

int nla_attr_size (int payload)
 Return size of attribute whithout padding.
int nla_total_size (int payload)
 Return size of attribute including padding.
int nla_padlen (int payload)
 Return length of padding at the tail of the attribute.

Parsing Attributes

int nla_type (const struct nlattr *nla)
 Return type of the attribute.
void * nla_data (const struct nlattr *nla)
 Return pointer to the payload section.
int nla_len (const struct nlattr *nla)
 Return length of the payload .
int nla_ok (const struct nlattr *nla, int remaining)
 Check if the attribute header and payload can be accessed safely.
struct nlattr * nla_next (const struct nlattr *nla, int *remaining)
 Return next attribute in a stream of attributes.
int nla_parse (struct nlattr *tb[], int maxtype, struct nlattr *head, int len, struct nla_policy *policy)
 Create attribute index based on a stream of attributes.
int nla_validate (struct nlattr *head, int len, int maxtype, struct nla_policy *policy)
 Validate a stream of attributes.
struct nlattr * nla_find (struct nlattr *head, int len, int attrtype)
 Find a single attribute in a stream of attributes.

Helper Functions

int nla_memcpy (void *dest, struct nlattr *src, int count)
 Copy attribute payload to another memory area.
size_t nla_strlcpy (char *dst, const struct nlattr *nla, size_t dstsize)
 Copy string attribute payload to a buffer.
int nla_memcmp (const struct nlattr *nla, const void *data, size_t size)
 Compare attribute payload with memory area.
int nla_strcmp (const struct nlattr *nla, const char *str)
 Compare string attribute payload with string.

Unspecific Attribute

struct nlattr * nla_reserve (struct nl_msg *msg, int attrtype, int attrlen)
 Reserve space for a attribute.
int nla_put (struct nl_msg *msg, int attrtype, int datalen, const void *data)
 Add a unspecific attribute to netlink message.
int nla_put_data (struct nl_msg *msg, int attrtype, struct nl_data *data)
 Add abstract data as unspecific attribute to netlink message.
int nla_put_addr (struct nl_msg *msg, int attrtype, struct nl_addr *addr)
 Add abstract address as unspecific attribute to netlink message.

Integer Attributes

int nla_put_u8 (struct nl_msg *msg, int attrtype, uint8_t value)
 Add 8 bit integer attribute to netlink message.
uint8_t nla_get_u8 (struct nlattr *nla)
 Return value of 8 bit integer attribute.
int nla_put_u16 (struct nl_msg *msg, int attrtype, uint16_t value)
 Add 16 bit integer attribute to netlink message.
uint16_t nla_get_u16 (struct nlattr *nla)
 Return payload of 16 bit integer attribute.
int nla_put_u32 (struct nl_msg *msg, int attrtype, uint32_t value)
 Add 32 bit integer attribute to netlink message.
uint32_t nla_get_u32 (struct nlattr *nla)
 Return payload of 32 bit integer attribute.
int nla_put_u64 (struct nl_msg *msg, int attrtype, uint64_t value)
 Add 64 bit integer attribute to netlink message.
uint64_t nla_get_u64 (struct nlattr *nla)
 Return payload of u64 attribute.

String Attribute

int nla_put_string (struct nl_msg *msg, int attrtype, const char *str)
 Add string attribute to netlink message.
char * nla_get_string (struct nlattr *nla)
 Return payload of string attribute.
char * nla_strdup (struct nlattr *nla)

Flag Attribute

int nla_put_flag (struct nl_msg *msg, int attrtype)
 Add flag netlink attribute to netlink message.
int nla_get_flag (struct nlattr *nla)
 Return true if flag attribute is set.

Microseconds Attribute

int nla_put_msecs (struct nl_msg *n, int attrtype, unsigned long msecs)
 Add a msecs netlink attribute to a netlink message.
unsigned long nla_get_msecs (struct nlattr *nla)
 Return payload of msecs attribute.

Nested Attribute

int nla_put_nested (struct nl_msg *msg, int attrtype, struct nl_msg *nested)
 Add nested attributes to netlink message.
struct nlattr * nla_nest_start (struct nl_msg *msg, int attrtype)
 Start a new level of nested attributes.
int nla_nest_end (struct nl_msg *msg, struct nlattr *start)
 Finalize nesting of attributes.
int nla_parse_nested (struct nlattr *tb[], int maxtype, struct nlattr *nla, struct nla_policy *policy)
 Create attribute index based on nested attribute.

Basic Attribute Data Types

enum  {
  NLA_UNSPEC,
  NLA_U8,
  NLA_U16,
  NLA_U32,
  NLA_U64,
  NLA_STRING,
  NLA_FLAG,
  NLA_MSECS,
  NLA_NESTED,
  __NLA_TYPE_MAX
}
 Basic attribute data types. More...

Attribute Construction (Exception Based)

#define NLA_PUT(msg, attrtype, attrlen, data)
 Add unspecific attribute to netlink message.
#define NLA_PUT_TYPE(msg, type, attrtype, value)
 Add atomic type attribute to netlink message.
#define NLA_PUT_U8(msg, attrtype, value)   NLA_PUT_TYPE(msg, uint8_t, attrtype, value)
 Add 8 bit integer attribute to netlink message.
#define NLA_PUT_U16(msg, attrtype, value)   NLA_PUT_TYPE(msg, uint16_t, attrtype, value)
 Add 16 bit integer attribute to netlink message.
#define NLA_PUT_U32(msg, attrtype, value)   NLA_PUT_TYPE(msg, uint32_t, attrtype, value)
 Add 32 bit integer attribute to netlink message.
#define NLA_PUT_U64(msg, attrtype, value)   NLA_PUT_TYPE(msg, uint64_t, attrtype, value)
 Add 64 bit integer attribute to netlink message.
#define NLA_PUT_STRING(msg, attrtype, value)   NLA_PUT(msg, attrtype, strlen(value) + 1, value)
 Add string attribute to netlink message.
#define NLA_PUT_FLAG(msg, attrtype)   NLA_PUT(msg, attrtype, 0, NULL)
 Add flag attribute to netlink message.
#define NLA_PUT_MSECS(msg, attrtype, msecs)   NLA_PUT_U64(msg, attrtype, msecs)
 Add msecs attribute to netlink message.
#define NLA_PUT_ADDR(msg, attrtype, addr)
 Add address attribute to netlink message.
#define NLA_PUT_DATA(msg, attrtype, data)
 Add abstract data attribute to netlink message.

Iterators

#define nla_for_each_attr(pos, head, len, rem)
 Iterate over a stream of attributes.
#define nla_for_each_nested(pos, nla, rem)
 Iterate over a stream of nested attributes.

Macro Definition Documentation

#define NLA_PUT (   msg,
  attrtype,
  attrlen,
  data 
)
Value:
do { \
if (nla_put(msg, attrtype, attrlen, data) < 0) \
goto nla_put_failure; \
} while(0)

Add unspecific attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
attrlenLength of attribute payload.
dataHead of attribute payload.

Definition at line 143 of file attr.h.

#define NLA_PUT_TYPE (   msg,
  type,
  attrtype,
  value 
)
Value:
do { \
type __tmp = value; \
NLA_PUT(msg, attrtype, sizeof(type), &__tmp); \
} while(0)

Add atomic type attribute to netlink message.

Parameters:
msgNetlink message.
typeAtomic type.
attrtypeAttribute type.
valueHead of attribute payload.

Definition at line 157 of file attr.h.

#define nla_for_each_attr (   pos,
  head,
  len,
  rem 
)
Value:
for (pos = head, rem = len; \
nla_ok(pos, rem); \
pos = nla_next(pos, &(rem)))

Iterate over a stream of attributes.

Parameters:
posloop counter, set to current attribute
headhead of attribute stream
lenlength of attribute stream
reminitialized to len, holds bytes currently remaining in stream

Definition at line 260 of file attr.h.

Referenced by nla_find(), nla_parse(), and nla_validate().

#define nla_for_each_nested (   pos,
  nla,
  rem 
)
Value:
for (pos = nla_data(nla), rem = nla_len(nla); \
nla_ok(pos, rem); \
pos = nla_next(pos, &(rem)))

Iterate over a stream of nested attributes.

Parameters:
posloop counter, set to current attribute
nlaattribute containing the nested attributes
reminitialized to len, holds bytes currently remaining in stream

Definition at line 272 of file attr.h.

Referenced by rtnl_ematch_parse_attr().

#define NLA_PUT_U8 (   msg,
  attrtype,
  value 
)    NLA_PUT_TYPE(msg, uint8_t, attrtype, value)

Add 8 bit integer attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
valueNumeric value.

Definition at line 169 of file attr.h.

#define NLA_PUT_U16 (   msg,
  attrtype,
  value 
)    NLA_PUT_TYPE(msg, uint16_t, attrtype, value)

Add 16 bit integer attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
valueNumeric value.

Definition at line 178 of file attr.h.

#define NLA_PUT_U32 (   msg,
  attrtype,
  value 
)    NLA_PUT_TYPE(msg, uint32_t, attrtype, value)

Add 32 bit integer attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
valueNumeric value.

Definition at line 187 of file attr.h.

Referenced by rtnl_neightbl_build_change_request().

#define NLA_PUT_U64 (   msg,
  attrtype,
  value 
)    NLA_PUT_TYPE(msg, uint64_t, attrtype, value)

Add 64 bit integer attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
valueNumeric value.

Definition at line 196 of file attr.h.

Referenced by rtnl_neightbl_build_change_request().

#define NLA_PUT_STRING (   msg,
  attrtype,
  value 
)    NLA_PUT(msg, attrtype, strlen(value) + 1, value)

Add string attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
valueNUL terminated character string.

Definition at line 205 of file attr.h.

Referenced by rtnl_link_build_delete_request(), rtnl_link_build_get_request(), rtnl_neightbl_build_change_request(), and rtnl_qdisc_build_delete_request().

#define NLA_PUT_FLAG (   msg,
  attrtype 
)    NLA_PUT(msg, attrtype, 0, NULL)

Add flag attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.

Definition at line 213 of file attr.h.

#define NLA_PUT_MSECS (   msg,
  attrtype,
  msecs 
)    NLA_PUT_U64(msg, attrtype, msecs)

Add msecs attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
msecsNumeric value in micro seconds.

Definition at line 222 of file attr.h.

#define NLA_PUT_ADDR (   msg,
  attrtype,
  addr 
)
Value:
NLA_PUT(msg, attrtype, nl_addr_get_len(addr), \

Add address attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
addrAbstract address object.

Definition at line 231 of file attr.h.

#define NLA_PUT_DATA (   msg,
  attrtype,
  data 
)
Value:
NLA_PUT(msg, attrtype, nl_data_get_size(data), \
nl_data_get(data))

Add abstract data attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
dataAbstract data object.

Definition at line 241 of file attr.h.


Enumeration Type Documentation

anonymous enum

Basic attribute data types.

See section Attribute Parsing (Netlink Core Library Development Guide) for more details.

Enumerator:
NLA_UNSPEC 

Unspecified type, binary data chunk.

NLA_U8 

8 bit integer

NLA_U16 

16 bit integer

NLA_U32 

32 bit integer

NLA_U64 

64 bit integer

NLA_STRING 

NUL terminated character string.

NLA_FLAG 

Flag.

NLA_MSECS 

Micro seconds (64bit)

NLA_NESTED 

Nested attributes.

Definition at line 37 of file attr.h.


Function Documentation

int nla_attr_size ( int  payload)

Return size of attribute whithout padding.

Parameters:
payloadPayload length of attribute.
<-------- nla_attr_size(payload) --------->
+------------------+- - -+- - - - - - - - - +- - -+
| Attribute Header | Pad | Payload | Pad |
+------------------+- - -+- - - - - - - - - +- - -+
Returns:
Size of attribute in bytes without padding.

Definition at line 55 of file attr.c.

Referenced by nla_padlen(), nla_reserve(), and nla_total_size().

+ Here is the caller graph for this function:

int nla_total_size ( int  payload)

Return size of attribute including padding.

Parameters:
payloadPayload length of attribute.
<----------- nla_total_size(payload) ----------->
+------------------+- - -+- - - - - - - - - +- - -+
| Attribute Header | Pad | Payload | Pad |
+------------------+- - -+- - - - - - - - - +- - -+
Returns:
Size of attribute in bytes.

Definition at line 73 of file attr.c.

References nla_attr_size().

Referenced by nla_padlen(), nla_reserve(), and rtnl_ematch_parse_attr().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int nla_padlen ( int  payload)

Return length of padding at the tail of the attribute.

Parameters:
payloadPayload length of attribute.
+------------------+- - -+- - - - - - - - - +- - -+
| Attribute Header | Pad | Payload | Pad |
+------------------+- - -+- - - - - - - - - +- - -+
<--->
Returns:
Length of padding in bytes.

Definition at line 91 of file attr.c.

References nla_attr_size(), and nla_total_size().

Referenced by nla_reserve().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int nla_type ( const struct nlattr *  nla)

Return type of the attribute.

Parameters:
nlaAttribute.
Returns:
Type of attribute.

Definition at line 109 of file attr.c.

Referenced by nla_find(), and nla_parse().

+ Here is the caller graph for this function:

void* nla_data ( const struct nlattr *  nla)

Return pointer to the payload section.

Parameters:
nlaAttribute.
Returns:
Pointer to start of payload section.

Definition at line 120 of file attr.c.

Referenced by nl_addr_alloc_attr(), nl_data_alloc_attr(), nla_get_string(), nla_get_u16(), nla_get_u32(), nla_get_u8(), nla_memcmp(), nla_memcpy(), nla_parse_nested(), nla_put(), nla_strcmp(), nla_strlcpy(), and rtnl_ematch_parse_attr().

+ Here is the caller graph for this function:

int nla_len ( const struct nlattr *  nla)

Return length of the payload .

Parameters:
nlaAttribute
Returns:
Length of payload in bytes.

Definition at line 131 of file attr.c.

Referenced by nl_addr_alloc_attr(), nl_data_alloc_attr(), nla_memcmp(), nla_memcpy(), nla_parse_nested(), nla_strcmp(), nla_strlcpy(), and rtnl_ematch_parse_attr().

+ Here is the caller graph for this function:

int nla_ok ( const struct nlattr *  nla,
int  remaining 
)

Check if the attribute header and payload can be accessed safely.

Parameters:
nlaAttribute of any kind.
remainingNumber of bytes remaining in attribute stream.

Verifies that the header and payload do not exceed the number of bytes left in the attribute stream. This function must be called before access the attribute header or payload when iterating over the attribute stream using nla_next().

Returns:
True if the attribute can be accessed safely, false otherwise.

Definition at line 148 of file attr.c.

struct nlattr* nla_next ( const struct nlattr *  nla,
int *  remaining 
)
read

Return next attribute in a stream of attributes.

Parameters:
nlaAttribute of any kind.
remainingVariable to count remaining bytes in stream.

Calculates the offset to the next attribute based on the attribute given. The attribute provided is assumed to be accessible, the caller is responsible to use nla_ok() beforehand. The offset (length of specified attribute including padding) is then subtracted from the remaining bytes variable and a pointer to the next attribute is returned.

nla_next() can be called as long as remainig is >0.

Returns:
Pointer to next attribute.

Definition at line 171 of file attr.c.

int nla_parse ( struct nlattr *  tb[],
int  maxtype,
struct nlattr *  head,
int  len,
struct nla_policy policy 
)

Create attribute index based on a stream of attributes.

Parameters:
tbIndex array to be filled (maxtype+1 elements).
maxtypeMaximum attribute type expected and accepted.
headHead of attribute stream.
lenLength of attribute stream.
policyAttribute validation policy.

Iterates over the stream of attributes and stores a pointer to each attribute in the index array using the attribute type as index to the array. Attribute with a type greater than the maximum type specified will be silently ignored in order to maintain backwards compatibility. If policy is not NULL, the attribute will be validated using the specified policy.

See also:
nla_validate
Returns:
0 on success or a negative error code.

Definition at line 244 of file attr.c.

References nla_for_each_attr, and nla_type().

Referenced by genlmsg_parse(), nla_parse_nested(), and nlmsg_parse().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int nla_validate ( struct nlattr *  head,
int  len,
int  maxtype,
struct nla_policy policy 
)

Validate a stream of attributes.

Parameters:
headHead of attributes stream.
lenLength of attributes stream.
maxtypeMaximum attribute type expected and accepted.
policyValidation policy.

Iterates over the stream of attributes and validates each attribute one by one using the specified policy. Attributes with a type greater than the maximum type specified will be silently ignored in order to maintain backwards compatibility.

See section Attribute Parsing (Netlink Core Library Development Guide) for more details.

Returns:
0 on success or a negative error code.

Definition at line 296 of file attr.c.

References nla_for_each_attr.

Referenced by genlmsg_validate(), and nlmsg_validate().

+ Here is the caller graph for this function:

struct nlattr* nla_find ( struct nlattr *  head,
int  len,
int  attrtype 
)
read

Find a single attribute in a stream of attributes.

Parameters:
headHead of attributes stream.
lenLength of attributes stream.
attrtypeAttribute type to look for.

Iterates over the stream of attributes and compares each type with the type specified. Returns the first attribute which matches the type.

Returns:
Pointer to attribute found or NULL.

Definition at line 325 of file attr.c.

References nla_for_each_attr, and nla_type().

Referenced by nlmsg_find_attr().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int nla_memcpy ( void *  dest,
struct nlattr *  src,
int  count 
)

Copy attribute payload to another memory area.

Parameters:
destPointer to destination memory area.
srcAttribute
countNumber of bytes to copy at most.

Note: The number of bytes copied is limited by the length of the attribute payload.

Returns:
The number of bytes copied to dest.

Definition at line 355 of file attr.c.

References nla_data(), and nla_len().

Referenced by nla_get_u64().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

size_t nla_strlcpy ( char *  dst,
const struct nlattr *  nla,
size_t  dstsize 
)

Copy string attribute payload to a buffer.

Parameters:
dstPointer to destination buffer.
nlaAttribute of type NLA_STRING.
dstsizeSize of destination buffer in bytes.

Copies at most dstsize - 1 bytes to the destination buffer. The result is always a valid NUL terminated string. Unlike strlcpy the destination buffer is always padded out.

Returns:
The length of string attribute without the terminating NUL.

Definition at line 380 of file attr.c.

References nla_data(), and nla_len().

+ Here is the call graph for this function:

int nla_memcmp ( const struct nlattr *  nla,
const void *  data,
size_t  size 
)

Compare attribute payload with memory area.

Parameters:
nlaAttribute.
dataMemory area to compare to.
sizeNumber of bytes to compare.
See also:
memcmp(3)
Returns:
An integer less than, equal to, or greater than zero.

Definition at line 407 of file attr.c.

References nla_data(), and nla_len().

+ Here is the call graph for this function:

int nla_strcmp ( const struct nlattr *  nla,
const char *  str 
)

Compare string attribute payload with string.

Parameters:
nlaAttribute of type NLA_STRING.
strNUL terminated string.
See also:
strcmp(3)
Returns:
An integer less than, equal to, or greater than zero.

Definition at line 425 of file attr.c.

References nla_data(), and nla_len().

+ Here is the call graph for this function:

struct nlattr* nla_reserve ( struct nl_msg *  msg,
int  attrtype,
int  attrlen 
)
read

Reserve space for a attribute.

Parameters:
msgNetlink Message.
attrtypeAttribute Type.
attrlenLength of payload.

Reserves room for a attribute in the specified netlink message and fills in the attribute header (type, length). Returns NULL if there is unsuficient space for the attribute.

Any padding between payload and the start of the next attribute is zeroed out.

Returns:
Pointer to start of attribute or NULL on failure.

Definition at line 458 of file attr.c.

References nla_attr_size(), nla_padlen(), nla_total_size(), and nlmsg_data().

Referenced by nla_put().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int nla_put ( struct nl_msg *  msg,
int  attrtype,
int  datalen,
const void *  data 
)

Add a unspecific attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
datalenLength of data to be used as payload.
dataPointer to data to be used as attribute payload.

Reserves room for a unspecific attribute and copies the provided data into the message as payload of the attribute. Returns an error if there is insufficient space for the attribute.

See also:
nla_reserve
Returns:
0 on success or a negative error code.

Definition at line 499 of file attr.c.

References nla_data(), nla_reserve(), and nlmsg_data().

Referenced by nla_nest_start(), nla_put_addr(), nla_put_data(), nla_put_flag(), nla_put_nested(), nla_put_string(), nla_put_u16(), nla_put_u32(), nla_put_u64(), and nla_put_u8().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int nla_put_data ( struct nl_msg *  msg,
int  attrtype,
struct nl_data *  data 
)

Add abstract data as unspecific attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
dataAbstract data object.

Equivalent to nla_put() except that the length of the payload is derived from the abstract data object.

See also:
nla_put
Returns:
0 on success or a negative error code.

Definition at line 529 of file attr.c.

References nl_data_get(), nl_data_get_size(), and nla_put().

+ Here is the call graph for this function:

int nla_put_addr ( struct nl_msg *  msg,
int  attrtype,
struct nl_addr *  addr 
)

Add abstract address as unspecific attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
addrAbstract address object.
See also:
nla_put
Returns:
0 on success or a negative error code.

Definition at line 544 of file attr.c.

References nl_addr_get_binary_addr(), nl_addr_get_len(), and nla_put().

+ Here is the call graph for this function:

int nla_put_u8 ( struct nl_msg *  msg,
int  attrtype,
uint8_t  value 
)

Add 8 bit integer attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
valueNumeric value to store as payload.
See also:
nla_put
Returns:
0 on success or a negative error code.

Definition at line 565 of file attr.c.

References nla_put().

+ Here is the call graph for this function:

uint8_t nla_get_u8 ( struct nlattr *  nla)

Return value of 8 bit integer attribute.

Parameters:
nla8 bit integer attribute
Returns:
Payload as 8 bit integer.

Definition at line 576 of file attr.c.

References nla_data().

+ Here is the call graph for this function:

int nla_put_u16 ( struct nl_msg *  msg,
int  attrtype,
uint16_t  value 
)

Add 16 bit integer attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
valueNumeric value to store as payload.
See also:
nla_put
Returns:
0 on success or a negative error code.

Definition at line 590 of file attr.c.

References nla_put().

+ Here is the call graph for this function:

uint16_t nla_get_u16 ( struct nlattr *  nla)

Return payload of 16 bit integer attribute.

Parameters:
nla16 bit integer attribute
Returns:
Payload as 16 bit integer.

Definition at line 601 of file attr.c.

References nla_data().

+ Here is the call graph for this function:

int nla_put_u32 ( struct nl_msg *  msg,
int  attrtype,
uint32_t  value 
)

Add 32 bit integer attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
valueNumeric value to store as payload.
See also:
nla_put
Returns:
0 on success or a negative error code.

Definition at line 615 of file attr.c.

References nla_put().

+ Here is the call graph for this function:

uint32_t nla_get_u32 ( struct nlattr *  nla)

Return payload of 32 bit integer attribute.

Parameters:
nla32 bit integer attribute.
Returns:
Payload as 32 bit integer.

Definition at line 626 of file attr.c.

References nla_data().

+ Here is the call graph for this function:

int nla_put_u64 ( struct nl_msg *  msg,
int  attrtype,
uint64_t  value 
)

Add 64 bit integer attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
valueNumeric value to store as payload.
See also:
nla_put
Returns:
0 on success or a negative error code.

Definition at line 640 of file attr.c.

References nla_put().

Referenced by nla_put_msecs().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

uint64_t nla_get_u64 ( struct nlattr *  nla)

Return payload of u64 attribute.

Parameters:
nlau64 netlink attribute
Returns:
Payload as 64 bit integer.

Definition at line 651 of file attr.c.

References nla_memcpy().

Referenced by nla_get_msecs().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int nla_put_string ( struct nl_msg *  msg,
int  attrtype,
const char *  str 
)

Add string attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
strNUL terminated string.
See also:
nla_put
Returns:
0 on success or a negative error code.

Definition at line 675 of file attr.c.

References nla_put().

+ Here is the call graph for this function:

char* nla_get_string ( struct nlattr *  nla)

Return payload of string attribute.

Parameters:
nlaString attribute.
Returns:
Pointer to attribute payload.

Definition at line 686 of file attr.c.

References nla_data().

+ Here is the call graph for this function:

int nla_put_flag ( struct nl_msg *  msg,
int  attrtype 
)

Add flag netlink attribute to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
See also:
nla_put
Returns:
0 on success or a negative error code.

Definition at line 710 of file attr.c.

References nla_put().

+ Here is the call graph for this function:

int nla_get_flag ( struct nlattr *  nla)

Return true if flag attribute is set.

Parameters:
nlaFlag netlink attribute.
Returns:
True if flag is set, otherwise false.

Definition at line 721 of file attr.c.

int nla_put_msecs ( struct nl_msg *  n,
int  attrtype,
unsigned long  msecs 
)

Add a msecs netlink attribute to a netlink message.

Parameters:
nnetlink message
attrtypeattribute type
msecsnumber of msecs

Definition at line 738 of file attr.c.

References nla_put_u64().

+ Here is the call graph for this function:

unsigned long nla_get_msecs ( struct nlattr *  nla)

Return payload of msecs attribute.

Parameters:
nlamsecs netlink attribute
Returns:
the number of milliseconds.

Definition at line 749 of file attr.c.

References nla_get_u64().

+ Here is the call graph for this function:

int nla_put_nested ( struct nl_msg *  msg,
int  attrtype,
struct nl_msg *  nested 
)

Add nested attributes to netlink message.

Parameters:
msgNetlink message.
attrtypeAttribute type.
nestedMessage containing attributes to be nested.

Takes the attributes found in the nested message and appends them to the message msg nested in a container of the type attrtype. The nested message may not have a family specific header.

See also:
nla_put
Returns:
0 on success or a negative error code.

Definition at line 773 of file attr.c.

References nla_put(), nlmsg_data(), and nlmsg_datalen().

Referenced by rtnl_neightbl_build_change_request().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

struct nlattr* nla_nest_start ( struct nl_msg *  msg,
int  attrtype 
)
read

Start a new level of nested attributes.

Parameters:
msgNetlink message.
attrtypeAttribute type of container.
Returns:
Pointer to container attribute.

Definition at line 790 of file attr.c.

References nla_put().

+ Here is the call graph for this function:

int nla_nest_end ( struct nl_msg *  msg,
struct nlattr *  start 
)

Finalize nesting of attributes.

Parameters:
msgNetlink message.
startContainer attribute as returned from nla_nest_start().

Corrects the container attribute header to include the appeneded attributes.

Returns:
0

Definition at line 812 of file attr.c.

References nlmsg_reserve().

+ Here is the call graph for this function:

int nla_parse_nested ( struct nlattr *  tb[],
int  maxtype,
struct nlattr *  nla,
struct nla_policy policy 
)

Create attribute index based on nested attribute.

Parameters:
tbIndex array to be filled (maxtype+1 elements).
maxtypeMaximum attribute type expected and accepted.
nlaNested Attribute.
policyAttribute validation policy.

Feeds the stream of attributes nested into the specified attribute to nla_parse().

See also:
nla_parse
Returns:
0 on success or a negative error code.

Definition at line 865 of file attr.c.

References nla_data(), nla_len(), and nla_parse().

Referenced by rtnl_ematch_parse_attr().

+ Here is the call graph for this function:

+ Here is the caller graph for this function: