From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by dpdk.org (Postfix) with ESMTP id C6A39A490 for ; Mon, 15 Jan 2018 11:49:15 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 15 Jan 2018 02:49:14 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.46,363,1511856000"; d="scan'208";a="22237589" Received: from jeffguo-z170x-ud5.sh.intel.com (HELO localhost.localdomain) ([10.67.104.10]) by fmsmga001.fm.intel.com with ESMTP; 15 Jan 2018 02:49:12 -0800 From: Jeff Guo To: stephen@networkplumber.org, bruce.richardson@intel.com, ferruh.yigit@intel.com, gaetan.rivet@6wind.com Cc: konstantin.ananyev@intel.com, jblunck@infradead.org, shreyansh.jain@nxp.com, jingjing.wu@intel.com, dev@dpdk.org, jia.guo@intel.com, thomas@monjalon.net, helin.zhang@intel.com, motih@mellanox.com Date: Mon, 15 Jan 2018 18:48:49 +0800 Message-Id: <1516013331-18939-1-git-send-email-jia.guo@intel.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1515679534-22473-2-git-send-email-jia.guo@intel.com> References: <1515679534-22473-2-git-send-email-jia.guo@intel.com> Subject: [dpdk-dev] [PATCH V11 1/3] eal: add uevent monitor api and callback func X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 15 Jan 2018 10:49:16 -0000 This patch aim to add a general uevent mechanism in eal device layer, to enable all linux kernel object uevent monitoring, user could use these APIs to monitor and read out the device status info that sent from the kernel side, then corresponding to handle it, such as when detect hotplug uevent type, user could detach or attach the device, and more it benefit to use to do smoothly fail safe work. About uevent monitoring: a: add one epolling to poll the netlink socket, to monitor the uevent of the device. b: add enum of rte_eal_dev_event_type and struct of rte_eal_uevent. c: add below APIs in rte eal device layer. rte_dev_callback_register rte_dev_callback_unregister _rte_dev_callback_process rte_dev_event_monitor_start rte_dev_event_monitor_stop Signed-off-by: Jeff Guo --- v11->v10: modify some typo and add experimental tag in new file. --- lib/librte_eal/bsdapp/eal/eal_dev.c | 38 ++++++ lib/librte_eal/common/eal_common_dev.c | 125 ++++++++++++++++++ lib/librte_eal/common/include/rte_dev.h | 117 +++++++++++++++++ lib/librte_eal/linuxapp/eal/Makefile | 1 + lib/librte_eal/linuxapp/eal/eal_dev.c | 223 ++++++++++++++++++++++++++++++++ 5 files changed, 504 insertions(+) create mode 100644 lib/librte_eal/bsdapp/eal/eal_dev.c create mode 100644 lib/librte_eal/linuxapp/eal/eal_dev.c diff --git a/lib/librte_eal/bsdapp/eal/eal_dev.c b/lib/librte_eal/bsdapp/eal/eal_dev.c new file mode 100644 index 0000000..83ffdee --- /dev/null +++ b/lib/librte_eal/bsdapp/eal/eal_dev.c @@ -0,0 +1,38 @@ +/* SPDX-License-Identifier: BSD-3-Clause + * Copyright(c) 2018 Intel Corporation + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include + +#include "eal_thread.h" + +int +rte_dev_event_monitor_start(void) +{ + RTE_LOG(ERR, EAL, "Not support event monitor for FreeBSD\n"); + return -1; +} + +int +rte_dev_event_monitor_stop(void) +{ + RTE_LOG(ERR, EAL, "Not support event monitor for FreeBSD\n"); + return -1; +} diff --git a/lib/librte_eal/common/eal_common_dev.c b/lib/librte_eal/common/eal_common_dev.c index dda8f58..f87e769 100644 --- a/lib/librte_eal/common/eal_common_dev.c +++ b/lib/librte_eal/common/eal_common_dev.c @@ -42,9 +42,31 @@ #include #include #include +#include +#include #include "eal_private.h" +/* spinlock for device callbacks */ +static rte_spinlock_t rte_dev_event_lock = RTE_SPINLOCK_INITIALIZER; + +/** + * The user application callback description. + * + * It contains callback address to be registered by user application, + * the pointer to the parameters for callback, and the event type. + */ +struct rte_dev_event_callback { + TAILQ_ENTRY(rte_dev_event_callback) next; /**< Callbacks list */ + rte_dev_event_cb_fn cb_fn; /**< Callback address */ + void *cb_arg; /**< Callback parameter */ + char *dev_name; /**< device name */ + uint32_t active; /**< Callback is executing */ +}; + +/* A general callback for all registered devices */ +static struct rte_dev_event_cb_list dev_event_cbs; + static int cmp_detached_dev_name(const struct rte_device *dev, const void *_name) { @@ -234,3 +256,106 @@ int rte_eal_hotplug_remove(const char *busname, const char *devname) rte_eal_devargs_remove(busname, devname); return ret; } + +int +rte_dev_callback_register(char *device_name, rte_dev_event_cb_fn cb_fn, + void *cb_arg) +{ + struct rte_dev_event_callback *event_cb = NULL; + + rte_spinlock_lock(&rte_dev_event_lock); + + if (TAILQ_EMPTY(&(dev_event_cbs))) + TAILQ_INIT(&(dev_event_cbs)); + + TAILQ_FOREACH(event_cb, &(dev_event_cbs), next) { + if (event_cb->cb_fn == cb_fn && + event_cb->cb_arg == cb_arg && + !strcmp(event_cb->dev_name, device_name)) + break; + } + + /* create a new callback. */ + if (event_cb == NULL) { + /* allocate a new user callback entity */ + event_cb = malloc(sizeof(struct rte_dev_event_callback)); + if (event_cb != NULL) { + event_cb->cb_fn = cb_fn; + event_cb->cb_arg = cb_arg; + event_cb->dev_name = device_name; + } + TAILQ_INSERT_TAIL(&(dev_event_cbs), event_cb, next); + } + + rte_spinlock_unlock(&rte_dev_event_lock); + return (event_cb == NULL) ? -1 : 0; +} + +int +rte_dev_callback_unregister(char *device_name, rte_dev_event_cb_fn cb_fn, + void *cb_arg) +{ + int ret; + struct rte_dev_event_callback *event_cb, *next; + + if (!cb_fn || device_name == NULL) + return -EINVAL; + + rte_spinlock_lock(&rte_dev_event_lock); + + ret = 0; + + for (event_cb = TAILQ_FIRST(&(dev_event_cbs)); event_cb != NULL; + event_cb = next) { + + next = TAILQ_NEXT(event_cb, next); + + if (event_cb->cb_fn != cb_fn || + (event_cb->cb_arg != (void *)-1 && + event_cb->cb_arg != cb_arg) || + strcmp(event_cb->dev_name, device_name)) + continue; + + /* + * if this callback is not executing right now, + * then remove it. + */ + if (event_cb->active == 0) { + TAILQ_REMOVE(&(dev_event_cbs), event_cb, next); + rte_free(event_cb); + } else { + ret = -EAGAIN; + } + } + + rte_spinlock_unlock(&rte_dev_event_lock); + return ret; +} + +int +_rte_dev_callback_process(char *device_name, enum rte_dev_event_type event, + void *cb_arg) +{ + struct rte_dev_event_callback dev_cb; + struct rte_dev_event_callback *cb_lst; + int rc = 0; + + rte_spinlock_lock(&rte_dev_event_lock); + + if (device_name == NULL) + return -EINVAL; + + TAILQ_FOREACH(cb_lst, &(dev_event_cbs), next) { + if (cb_lst->cb_fn == NULL || cb_lst->cb_arg != cb_arg || + strcmp(cb_lst->dev_name, device_name)) + continue; + dev_cb = *cb_lst; + cb_lst->active = 1; + rc = dev_cb.cb_fn(device_name, event, + dev_cb.cb_arg); + cb_lst->active = 0; + } + + rte_spinlock_unlock(&rte_dev_event_lock); + return rc; +} diff --git a/lib/librte_eal/common/include/rte_dev.h b/lib/librte_eal/common/include/rte_dev.h index 9342e0c..f6c9acb 100644 --- a/lib/librte_eal/common/include/rte_dev.h +++ b/lib/librte_eal/common/include/rte_dev.h @@ -51,6 +51,30 @@ extern "C" { #include +/** + * The device event type. + */ +enum rte_dev_event_type { + RTE_DEV_EVENT_UNKNOWN, /**< unknown event type */ + RTE_DEV_EVENT_ADD, /**< device being added */ + RTE_DEV_EVENT_REMOVE, /**< device being removed */ + RTE_DEV_EVENT_MAX /**< max value of this enum */ +}; + +struct rte_dev_event { + enum rte_dev_event_type type; /**< device event type */ + int subsystem; /**< subsystem id */ + char *devname; /**< device name */ +}; + +typedef int (*rte_dev_event_cb_fn)(char *device_name, + enum rte_dev_event_type event, + void *cb_arg); + +struct rte_dev_event_callback; +/** @internal Structure to keep track of registered callbacks */ +TAILQ_HEAD(rte_dev_event_cb_list, rte_dev_event_callback); + __attribute__((format(printf, 2, 0))) static inline void rte_pmd_debug_trace(const char *func_name, const char *fmt, ...) @@ -293,4 +317,97 @@ __attribute__((used)) = str } #endif +/** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * + * It registers the callback for the specific event. Multiple + * callbacks cal be registered at the same time. + * + * @param device_name + * The device name. + * @param cb_fn + * callback address. + * @param cb_arg + * address of parameter for callback. + * + * @return + * - On success, zero. + * - On failure, a negative value. + */ +int rte_dev_callback_register(char *device_name, rte_dev_event_cb_fn cb_fn, + void *cb_arg); + +/** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * + * It unregisters the callback according to the specified event. + * + * @param device_name + * The device name. + * @param cb_fn + * callback address. + * @param cb_arg + * address of parameter for callback, (void *)-1 means to remove all + * registered which has the same callback address. + * + * @return + * - On success, return the number of callback entities removed. + * - On failure, a negative value. + */ +int rte_dev_callback_unregister(char *device_name, rte_dev_event_cb_fn cb_fn, + void *cb_arg); + +/** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * + * internal Executes all the user application registered callbacks for + * the specific device. It is for DPDK internal user only. User + * application should not call it directly. + * + * @param device_name + * The device name. + * @param event + * the device event type + * is permitted or not. + * @param cb_arg + * callback parameter. + * + * @return + * - On success, return zero. + * - On failure, a negative value. + */ +int +_rte_dev_callback_process(char *device_name, enum rte_dev_event_type event, + void *cb_arg); + +/** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * + * Start the device event monitoring. + * + * @param none + * @return + * - On success, zero. + * - On failure, a negative value. + */ +int +rte_dev_event_monitor_start(void); + +/** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * + * Stop the device event monitoring . + * + * @param none + * @return + * - On success, zero. + * - On failure, a negative value. + */ +int +rte_dev_event_monitor_stop(void); #endif /* _RTE_DEV_H_ */ diff --git a/lib/librte_eal/linuxapp/eal/Makefile b/lib/librte_eal/linuxapp/eal/Makefile index 588c0bd..43b00e5 100644 --- a/lib/librte_eal/linuxapp/eal/Makefile +++ b/lib/librte_eal/linuxapp/eal/Makefile @@ -39,6 +39,7 @@ SRCS-$(CONFIG_RTE_EXEC_ENV_LINUXAPP) += eal_lcore.c SRCS-$(CONFIG_RTE_EXEC_ENV_LINUXAPP) += eal_timer.c SRCS-$(CONFIG_RTE_EXEC_ENV_LINUXAPP) += eal_interrupts.c SRCS-$(CONFIG_RTE_EXEC_ENV_LINUXAPP) += eal_alarm.c +SRCS-$(CONFIG_RTE_EXEC_ENV_LINUXAPP) += eal_dev.c # from common dir SRCS-$(CONFIG_RTE_EXEC_ENV_LINUXAPP) += eal_common_lcore.c diff --git a/lib/librte_eal/linuxapp/eal/eal_dev.c b/lib/librte_eal/linuxapp/eal/eal_dev.c new file mode 100644 index 0000000..4f4beb5 --- /dev/null +++ b/lib/librte_eal/linuxapp/eal/eal_dev.c @@ -0,0 +1,223 @@ +/* SPDX-License-Identifier: BSD-3-Clause + * Copyright(c) 2018 Intel Corporation + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include + +#include "eal_thread.h" + +bool service_exit = true; + +bool service_no_init = true; + +#define DEV_EV_MNT_SERVICE_NAME "device_event_monitor_service" + +static int +dev_monitor_fd_new(void) +{ + + int uevent_fd; + + uevent_fd = socket(PF_NETLINK, SOCK_RAW | SOCK_CLOEXEC | + SOCK_NONBLOCK, + NETLINK_KOBJECT_UEVENT); + if (uevent_fd < 0) { + RTE_LOG(ERR, EAL, "create uevent fd failed\n"); + return -1; + } + return uevent_fd; +} + +static int +dev_monitor_enable(int netlink_fd) +{ + struct sockaddr_nl addr; + int ret; + int size = 64 * 1024; + int nonblock = 1; + + memset(&addr, 0, sizeof(addr)); + addr.nl_family = AF_NETLINK; + addr.nl_pid = 0; + addr.nl_groups = 0xffffffff; + + if (bind(netlink_fd, (struct sockaddr *) &addr, sizeof(addr)) < 0) { + RTE_LOG(ERR, EAL, "bind failed\n"); + goto err; + } + + setsockopt(netlink_fd, SOL_SOCKET, SO_PASSCRED, &size, sizeof(size)); + + ret = ioctl(netlink_fd, FIONBIO, &nonblock); + if (ret != 0) { + RTE_LOG(ERR, EAL, "ioctl(FIONBIO) failed\n"); + goto err; + } + return 0; +err: + close(netlink_fd); + return -1; +} + +static int +dev_uev_process(__rte_unused struct epoll_event *events, __rte_unused int nfds) +{ + /* TODO: device uevent processing */ + return 0; +} + +/** + * It builds/rebuilds up the epoll file descriptor with all the + * file descriptors being waited on. Then handles the interrupts. + * + * @param arg + * pointer. (unused) + * + * @return + * - On success, zero. + * - On failure, a negative value. + */ +static int32_t dev_uev_monitoring(__rte_unused void *arg) +{ + int netlink_fd = -1; + struct epoll_event ep_kernel; + int fd_ep = -1; + + service_exit = false; + + fd_ep = epoll_create1(EPOLL_CLOEXEC); + if (fd_ep < 0) { + RTE_LOG(ERR, EAL, "error creating epoll fd: %m\n"); + goto out; + } + + netlink_fd = dev_monitor_fd_new(); + + if (dev_monitor_enable(netlink_fd) < 0) { + RTE_LOG(ERR, EAL, "error subscribing to kernel events\n"); + goto out; + } + + memset(&ep_kernel, 0, sizeof(struct epoll_event)); + ep_kernel.events = EPOLLIN | EPOLLPRI | EPOLLRDHUP | EPOLLHUP; + ep_kernel.data.fd = netlink_fd; + if (epoll_ctl(fd_ep, EPOLL_CTL_ADD, netlink_fd, + &ep_kernel) < 0) { + RTE_LOG(ERR, EAL, "error addding fd to epoll: %m\n"); + goto out; + } + + while (!service_exit) { + int fdcount; + struct epoll_event ev[1]; + + fdcount = epoll_wait(fd_ep, ev, 1, -1); + if (fdcount < 0) { + if (errno != EINTR) + RTE_LOG(ERR, EAL, "error receiving uevent " + "message: %m\n"); + continue; + } + + /* epoll_wait has at least one fd ready to read */ + if (dev_uev_process(ev, fdcount) < 0) { + if (errno != EINTR) + RTE_LOG(ERR, EAL, "error processing uevent " + "message: %m\n"); + } + } + return 0; +out: + if (fd_ep >= 0) + close(fd_ep); + if (netlink_fd >= 0) + close(netlink_fd); + rte_panic("uev monitoring fail\n"); + return -1; +} + +int +rte_dev_event_monitor_start(void) +{ + int ret; + struct rte_service_spec service; + uint32_t id; + const uint32_t sid = 0; + + if (!service_no_init) + return 0; + + uint32_t slcore_1 = rte_get_next_lcore(/* start core */ -1, + /* skip master */ 1, + /* wrap */ 0); + + ret = rte_service_lcore_add(slcore_1); + if (ret) { + RTE_LOG(ERR, EAL, "dev event monitor lcore add fail"); + return ret; + } + + memset(&service, 0, sizeof(service)); + snprintf(service.name, sizeof(service.name), DEV_EV_MNT_SERVICE_NAME); + + service.socket_id = rte_socket_id(); + service.callback = dev_uev_monitoring; + service.callback_userdata = NULL; + service.capabilities = 0; + ret = rte_service_component_register(&service, &id); + if (ret) { + RTE_LOG(ERR, EAL, "Failed to register service %s " + "err = %" PRId32, + service.name, ret); + return ret; + } + ret = rte_service_runstate_set(sid, 1); + if (ret) { + RTE_LOG(ERR, EAL, "Failed to set the runstate of " + "the service"); + return ret; + } + ret = rte_service_component_runstate_set(id, 1); + if (ret) { + RTE_LOG(ERR, EAL, "Failed to set the backend runstate" + " of a component"); + return ret; + } + ret = rte_service_map_lcore_set(sid, slcore_1, 1); + if (ret) { + RTE_LOG(ERR, EAL, "Failed to enable lcore 1 on " + "dev event monitor service"); + return ret; + } + rte_service_lcore_start(slcore_1); + service_no_init = false; + return 0; +} + +int +rte_dev_event_monitor_stop(void) +{ + service_exit = true; + service_no_init = true; + return 0; +} -- 2.7.4