]>
git.proxmox.com Git - mirror_frr.git/blob - zebra/kernel_netlink.h
1 /* Declarations and definitions for kernel interaction over netlink
2 * Copyright (C) 2016 Cumulus Networks, Inc.
4 * This file is part of GNU Zebra.
6 * GNU Zebra is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by the
8 * Free Software Foundation; either version 2, or (at your option) any
11 * GNU Zebra is distributed in the hope that it will be useful, but
12 * WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * General Public License for more details.
16 * You should have received a copy of the GNU General Public License along
17 * with this program; see the file COPYING; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
21 #ifndef _ZEBRA_KERNEL_NETLINK_H
22 #define _ZEBRA_KERNEL_NETLINK_H
31 ((struct rtattr *)(((char *)(h)) + NLMSG_ALIGN(sizeof(struct nhmsg))))
34 #define NL_RCV_PKT_BUF_SIZE 32768
35 #define NL_PKT_BUF_SIZE 8192
38 * nl_attr_put - add an attribute to the Netlink message.
40 * Returns true if the attribute could be added to the message (fits into the
41 * buffer), otherwise false is returned.
43 extern bool nl_attr_put(struct nlmsghdr
*n
, unsigned int maxlen
, int type
,
44 const void *data
, unsigned int alen
);
45 extern bool nl_attr_put8(struct nlmsghdr
*n
, unsigned int maxlen
, int type
,
47 extern bool nl_attr_put16(struct nlmsghdr
*n
, unsigned int maxlen
, int type
,
49 extern bool nl_attr_put32(struct nlmsghdr
*n
, unsigned int maxlen
, int type
,
53 * nl_attr_nest - start an attribute nest.
55 * Returns a valid pointer to the beginning of the nest if the attribute
56 * describing the nest could be added to the message (fits into the buffer),
57 * otherwise NULL is returned.
59 extern struct rtattr
*nl_attr_nest(struct nlmsghdr
*n
, unsigned int maxlen
,
63 * nl_attr_nest_end - finalize nesting of attributes.
65 * Updates the length field of the attribute header to include the appeneded
66 * attributes. Returns a total length of the Netlink message.
68 extern int nl_attr_nest_end(struct nlmsghdr
*n
, struct rtattr
*nest
);
71 * nl_attr_rtnh - append a rtnexthop record to the Netlink message.
73 * Returns a valid pointer to the rtnexthop struct if it could be added to
74 * the message (fits into the buffer), otherwise NULL is returned.
76 extern struct rtnexthop
*nl_attr_rtnh(struct nlmsghdr
*n
, unsigned int maxlen
);
79 * nl_attr_rtnh_end - finalize adding a rtnexthop record.
81 * Updates the length field of the rtnexthop to include the appeneded
84 extern void nl_attr_rtnh_end(struct nlmsghdr
*n
, struct rtnexthop
*rtnh
);
86 extern void netlink_parse_rtattr(struct rtattr
**tb
, int max
,
87 struct rtattr
*rta
, int len
);
88 extern void netlink_parse_rtattr_flags(struct rtattr
**tb
, int max
,
89 struct rtattr
*rta
, int len
,
90 unsigned short flags
);
91 extern void netlink_parse_rtattr_nested(struct rtattr
**tb
, int max
,
93 extern const char *nl_msg_type_to_str(uint16_t msg_type
);
94 extern const char *nl_rtproto_to_str(uint8_t rtproto
);
95 extern const char *nl_family_to_str(uint8_t family
);
96 extern const char *nl_rttype_to_str(uint8_t rttype
);
98 extern int netlink_parse_info(int (*filter
)(struct nlmsghdr
*, ns_id_t
, int),
99 const struct nlsock
*nl
,
100 const struct zebra_dplane_info
*dp_info
,
101 int count
, bool startup
);
102 extern int netlink_talk_filter(struct nlmsghdr
*h
, ns_id_t ns
, int startup
);
103 extern int netlink_talk(int (*filter
)(struct nlmsghdr
*, ns_id_t
, int startup
),
104 struct nlmsghdr
*n
, struct nlsock
*nl
,
105 struct zebra_ns
*zns
, bool startup
);
106 extern int netlink_request(struct nlsock
*nl
, void *req
);
108 enum netlink_msg_status
{
117 * netlink_batch_add_msg - add message to the netlink batch using dplane
120 * @ctx: Dataplane context
121 * @msg_encoder: A function that encodes dplane context object into
122 * netlink message. Should take dplane context object,
123 * pointer to a buffer and buffer's length as parameters
124 * and should return -1 on error, 0 on buffer overflow or
125 * size of the encoded message.
126 * @ignore_res: Whether the result of this message should be ignored.
127 * This should be used in some 'update' cases where we
128 * need to send two messages for one context object.
130 * Return: Status of the message.
132 extern enum netlink_msg_status
netlink_batch_add_msg(
133 struct nl_batch
*bth
, struct zebra_dplane_ctx
*ctx
,
134 ssize_t (*msg_encoder
)(struct zebra_dplane_ctx
*, void *, size_t),
140 extern int netlink_config_write_helper(struct vty
*vty
);
143 * Configure size of the batch buffer and sending threshold. If 'unset', reset
146 extern void netlink_set_batch_buffer_size(uint32_t size
, uint32_t threshold
,
149 #endif /* HAVE_NETLINK */
155 #endif /* _ZEBRA_KERNEL_NETLINK_H */