2018-10-06 07:40:00 +08:00
|
|
|
/* SPDX-License-Identifier: (LGPL-2.1 OR BSD-2-Clause) */
|
2018-01-31 04:55:02 +08:00
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* NETLINK Netlink attributes
|
|
|
|
|
*
|
|
|
|
|
* Copyright (c) 2003-2013 Thomas Graf <tgraf@suug.ch>
|
|
|
|
|
*/
|
|
|
|
|
|
2018-10-04 06:26:42 +08:00
|
|
|
#ifndef __LIBBPF_NLATTR_H
|
|
|
|
|
#define __LIBBPF_NLATTR_H
|
2018-01-31 04:55:02 +08:00
|
|
|
|
|
|
|
|
#include <stdint.h>
|
|
|
|
|
#include <linux/netlink.h>
|
|
|
|
|
/* avoid multiple definition of netlink features */
|
|
|
|
|
#define __LINUX_NETLINK_H
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Standard attribute types to specify validation policy
|
|
|
|
|
*/
|
|
|
|
|
enum {
|
2018-10-04 06:26:40 +08:00
|
|
|
LIBBPF_NLA_UNSPEC, /**< Unspecified type, binary data chunk */
|
|
|
|
|
LIBBPF_NLA_U8, /**< 8 bit integer */
|
|
|
|
|
LIBBPF_NLA_U16, /**< 16 bit integer */
|
|
|
|
|
LIBBPF_NLA_U32, /**< 32 bit integer */
|
|
|
|
|
LIBBPF_NLA_U64, /**< 64 bit integer */
|
|
|
|
|
LIBBPF_NLA_STRING, /**< NUL terminated character string */
|
|
|
|
|
LIBBPF_NLA_FLAG, /**< Flag */
|
|
|
|
|
LIBBPF_NLA_MSECS, /**< Micro seconds (64bit) */
|
|
|
|
|
LIBBPF_NLA_NESTED, /**< Nested attributes */
|
|
|
|
|
__LIBBPF_NLA_TYPE_MAX,
|
2018-01-31 04:55:02 +08:00
|
|
|
};
|
|
|
|
|
|
2018-10-04 06:26:40 +08:00
|
|
|
#define LIBBPF_NLA_TYPE_MAX (__LIBBPF_NLA_TYPE_MAX - 1)
|
2018-01-31 04:55:02 +08:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @ingroup attr
|
|
|
|
|
* Attribute validation policy.
|
|
|
|
|
*
|
|
|
|
|
* See section @core_doc{core_attr_parse,Attribute Parsing} for more details.
|
|
|
|
|
*/
|
2018-10-04 06:26:40 +08:00
|
|
|
struct libbpf_nla_policy {
|
|
|
|
|
/** Type of attribute or LIBBPF_NLA_UNSPEC */
|
2018-01-31 04:55:02 +08:00
|
|
|
uint16_t type;
|
|
|
|
|
|
|
|
|
|
/** Minimal length of payload required */
|
|
|
|
|
uint16_t minlen;
|
|
|
|
|
|
|
|
|
|
/** Maximal length of payload allowed */
|
|
|
|
|
uint16_t maxlen;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @ingroup attr
|
|
|
|
|
* Iterate over a stream of attributes
|
|
|
|
|
* @arg pos loop counter, set to current attribute
|
|
|
|
|
* @arg head head of attribute stream
|
|
|
|
|
* @arg len length of attribute stream
|
|
|
|
|
* @arg rem initialized to len, holds bytes currently remaining in stream
|
|
|
|
|
*/
|
2018-10-04 06:26:40 +08:00
|
|
|
#define libbpf_nla_for_each_attr(pos, head, len, rem) \
|
2018-01-31 04:55:02 +08:00
|
|
|
for (pos = head, rem = len; \
|
|
|
|
|
nla_ok(pos, rem); \
|
|
|
|
|
pos = nla_next(pos, &(rem)))
|
|
|
|
|
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
/**
|
2018-10-04 06:26:40 +08:00
|
|
|
* libbpf_nla_data - head of payload
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
* @nla: netlink attribute
|
|
|
|
|
*/
|
2018-10-04 06:26:40 +08:00
|
|
|
static inline void *libbpf_nla_data(const struct nlattr *nla)
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
{
|
|
|
|
|
return (char *) nla + NLA_HDRLEN;
|
|
|
|
|
}
|
|
|
|
|
|
2018-10-04 06:26:40 +08:00
|
|
|
static inline uint8_t libbpf_nla_getattr_u8(const struct nlattr *nla)
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
{
|
2018-10-04 06:26:40 +08:00
|
|
|
return *(uint8_t *)libbpf_nla_data(nla);
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
}
|
|
|
|
|
|
2018-10-04 06:26:40 +08:00
|
|
|
static inline uint32_t libbpf_nla_getattr_u32(const struct nlattr *nla)
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
{
|
2018-10-04 06:26:40 +08:00
|
|
|
return *(uint32_t *)libbpf_nla_data(nla);
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
}
|
|
|
|
|
|
2018-10-04 06:26:40 +08:00
|
|
|
static inline const char *libbpf_nla_getattr_str(const struct nlattr *nla)
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
{
|
2018-10-04 06:26:40 +08:00
|
|
|
return (const char *)libbpf_nla_data(nla);
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
2018-10-04 06:26:40 +08:00
|
|
|
* libbpf_nla_len - length of payload
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
* @nla: netlink attribute
|
|
|
|
|
*/
|
2018-10-04 06:26:40 +08:00
|
|
|
static inline int libbpf_nla_len(const struct nlattr *nla)
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
{
|
|
|
|
|
return nla->nla_len - NLA_HDRLEN;
|
|
|
|
|
}
|
|
|
|
|
|
2018-10-04 06:26:40 +08:00
|
|
|
int libbpf_nla_parse(struct nlattr *tb[], int maxtype, struct nlattr *head,
|
|
|
|
|
int len, struct libbpf_nla_policy *policy);
|
|
|
|
|
int libbpf_nla_parse_nested(struct nlattr *tb[], int maxtype,
|
|
|
|
|
struct nlattr *nla,
|
|
|
|
|
struct libbpf_nla_policy *policy);
|
tools/bpf: add more netlink functionalities in lib/bpf
This patch added a few netlink attribute parsing functions
and the netlink API functions to query networking links, tc classes,
tc qdiscs and tc filters. For example, the following API is
to get networking links:
int nl_get_link(int sock, unsigned int nl_pid,
dump_nlmsg_t dump_link_nlmsg,
void *cookie);
Note that when the API is called, the user also provided a
callback function with the following signature:
int (*dump_nlmsg_t)(void *cookie, void *msg, struct nlattr **tb);
The "cookie" is the parameter the user passed to the API and will
be available for the callback function.
The "msg" is the information about the result, e.g., ifinfomsg or
tcmsg. The "tb" is the parsed netlink attributes.
Signed-off-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-09-06 07:58:05 +08:00
|
|
|
|
2018-10-04 06:26:40 +08:00
|
|
|
int libbpf_nla_dump_errormsg(struct nlmsghdr *nlh);
|
2018-01-31 04:55:02 +08:00
|
|
|
|
2018-10-04 06:26:42 +08:00
|
|
|
#endif /* __LIBBPF_NLATTR_H */
|
