19e43c163c
This change does the following: Base Netlink KPIs (ability to register the family, parse and/or write a Netlink message) are always present in the kernel. Specifically, * Implementation of genetlink family/group registration/removal, some base accessors (netlink_generic_kpi.c, 260 LoC) are compiled in unconditionally. * Basic TLV parser functions (netlink_message_parser.c, 507 LoC) are compiled in unconditionally. * Glue functions (netlink<>rtsock), malloc/core sysctl definitions (netlink_glue.c, 259 LoC) are compiled in unconditionally. * The rest of the KPI _functions_ are defined in the netlink_glue.c, but their implementation calls a pointer to either the stub function or the actual function, depending on whether the module is loaded or not. This approach allows to have only 1k LoC out of ~3.7k LoC (current sys/netlink implementation) in the kernel, which will not grow further. It also allows for the generic netlink kernel customers to load successfully without requiring Netlink module and operate correctly once Netlink module is loaded. Reviewed by: imp MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D39269
113 lines
4.1 KiB
C
113 lines
4.1 KiB
C
/*-
|
|
* SPDX-License-Identifier: BSD-2-Clause-FreeBSD
|
|
*
|
|
* Copyright (c) 2022 Alexander V. Chernikov <melifaro@FreeBSD.org>
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef _NETLINK_NETLINK_CTL_H_
|
|
#define _NETLINK_NETLINK_CTL_H_
|
|
|
|
#ifdef _KERNEL
|
|
/*
|
|
* This file provides headers for the public KPI of the netlink
|
|
* subsystem
|
|
*/
|
|
#include <sys/_eventhandler.h>
|
|
|
|
MALLOC_DECLARE(M_NETLINK);
|
|
|
|
/*
|
|
* Macro for handling attribute TLVs
|
|
*/
|
|
#define _roundup2(x, y) (((x)+((y)-1))&(~((y)-1)))
|
|
|
|
#define NETLINK_ALIGN_SIZE sizeof(uint32_t)
|
|
#define NETLINK_ALIGN(_len) _roundup2(_len, NETLINK_ALIGN_SIZE)
|
|
|
|
#define NLA_ALIGN_SIZE sizeof(uint32_t)
|
|
#define NLA_ALIGN(_len) _roundup2(_len, NLA_ALIGN_SIZE)
|
|
#define NLA_HDRLEN ((int)sizeof(struct nlattr))
|
|
#define NLA_DATA_LEN(_nla) ((int)((_nla)->nla_len - NLA_HDRLEN))
|
|
#define NLA_DATA(_nla) NL_ITEM_DATA(_nla, NLA_HDRLEN)
|
|
#define NLA_DATA_CONST(_nla) NL_ITEM_DATA_CONST(_nla, NLA_HDRLEN)
|
|
#define NLA_TYPE(_nla) ((_nla)->nla_type & 0x3FFF)
|
|
|
|
#ifndef typeof
|
|
#define typeof __typeof
|
|
#endif
|
|
|
|
#define NLA_NEXT(_attr) (struct nlattr *)((char *)_attr + NLA_ALIGN(_attr->nla_len))
|
|
#define _NLA_END(_start, _len) ((char *)(_start) + (_len))
|
|
#define NLA_FOREACH(_attr, _start, _len) \
|
|
for (typeof(_attr) _end = (typeof(_attr))_NLA_END(_start, _len), _attr = (_start); \
|
|
((char *)_attr < (char *)_end) && \
|
|
((char *)NLA_NEXT(_attr) <= (char *)_end); \
|
|
_attr = (_len -= NLA_ALIGN(_attr->nla_len), NLA_NEXT(_attr)))
|
|
|
|
#define NL_ARRAY_LEN(_a) (sizeof(_a) / sizeof((_a)[0]))
|
|
|
|
#include <netlink/netlink_message_writer.h>
|
|
#include <netlink/netlink_message_parser.h>
|
|
|
|
|
|
/* Protocol handlers */
|
|
struct nl_pstate;
|
|
typedef int (*nl_handler_f)(struct nlmsghdr *hdr, struct nl_pstate *npt);
|
|
|
|
bool netlink_register_proto(int proto, const char *proto_name, nl_handler_f handler);
|
|
bool netlink_unregister_proto(int proto);
|
|
|
|
/* Common helpers */
|
|
bool nl_has_listeners(int netlink_family, uint32_t groups_mask);
|
|
bool nlp_has_priv(struct nlpcb *nlp, int priv);
|
|
struct ucred *nlp_get_cred(struct nlpcb *nlp);
|
|
uint32_t nlp_get_pid(const struct nlpcb *nlp);
|
|
bool nlp_unconstrained_vnet(const struct nlpcb *nlp);
|
|
|
|
/* netlink_generic.c */
|
|
struct genl_cmd {
|
|
const char *cmd_name;
|
|
nl_handler_f cmd_cb;
|
|
uint32_t cmd_flags;
|
|
uint32_t cmd_priv;
|
|
uint32_t cmd_num;
|
|
};
|
|
|
|
uint32_t genl_register_family(const char *family_name, size_t hdrsize,
|
|
int family_version, int max_attr_idx);
|
|
bool genl_unregister_family(const char *family_name);
|
|
bool genl_register_cmds(const char *family_name, const struct genl_cmd *cmds,
|
|
int count);
|
|
uint32_t genl_register_group(const char *family_name, const char *group_name);
|
|
|
|
struct genl_family;
|
|
const char *genl_get_family_name(const struct genl_family *gf);
|
|
uint32_t genl_get_family_id(const struct genl_family *gf);
|
|
|
|
typedef void (*genl_family_event_handler_t)(void *arg, const struct genl_family *gf, int action);
|
|
EVENTHANDLER_DECLARE(genl_family_event, genl_family_event_handler_t);
|
|
|
|
#endif
|
|
#endif
|