From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by dpdk.org (Postfix) with ESMTP id 4D2892C8 for ; Fri, 7 Jul 2017 18:41:15 +0200 (CEST) Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Jul 2017 09:41:14 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.40,323,1496127600"; d="scan'208";a="123916345" Received: from silpixa00398672.ir.intel.com ([10.237.223.128]) by fmsmga005.fm.intel.com with ESMTP; 07 Jul 2017 09:41:12 -0700 From: Harry van Haaren To: dev@dpdk.org Cc: thomas@monjalon.net, jerin.jacob@caviumnetworks.com, keith.wiles@intel.com, bruce.richardson@intel.com, Harry van Haaren Date: Fri, 7 Jul 2017 17:41:00 +0100 Message-Id: <1499445667-32588-1-git-send-email-harry.van.haaren@intel.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1498735421-100164-1-git-send-email-harry.van.haaren@intel.com> References: <1498735421-100164-1-git-send-email-harry.van.haaren@intel.com> Subject: [dpdk-dev] [PATCH v4 0/7] service cores: cover letter 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: Fri, 07 Jul 2017 16:41:16 -0000 This patchset introduces service cores to DPDK. A service core is an lcore that performs functions to abstract away details of differences in environment of the application. An example is using the eventdev API, where either a software or hardware PMD performs scheduling. In the case of the software PMD an lcore is required to perform scheduling, which means application logic would have to be aware of the PMD running under the API. To abstract away the differences in HW / SW PMDs, service cores can run the SW PMD service without application logic specifying the exact cores to use. Note that eventdev is only one API that benefits; timers, interrupts handling, statistics and monitoring, and a range of other infrastructure that requires a slice of CPU time may all benefit from service cores. The application is not obliged to manually use the service cores API, however if an application wishes to use the service cores API for fine grained control over how the services are run, this is possible. Deciding between a performance threading-profile and scaled-down profile can be achieved by advanced usage of service cores and setting the lcore mappings. Patch 5/7 shows how a PMD can register a service to run a function. This is then available (along with any other registered services) to be run by the service cores. Patches 6/7 and 7/7 add documentation, and claim maintainership. Regards, -Harry v4: - Range of fixes as suggested by Jerin - Improved unit tests, ensuring ex-service cores become available to app - Added functions to EXPERIMENTAL tag in .map files (Thomas) - Added @warning experimental notes to Doxygen API documentation (Thomas) - Various smaller fixes / cleanups - See commit notes for details v3: - Added docs - Added release notes - Updated maintainers file - Compile checks with devtools/test-build.sh - Validated patches apply to latest dpdk/master - Based on discussion, rte_service_iterate() is *not* included, but could be adding at a later date if use-cases require it. - Future work includes enabling the eventdev_pipeline sample app, but there is still some churn there to enable both HW/SW PMDs seamlessly. Once sample app is enabled a service core walk-through with that sample app can be added to the docs, to provide a tutorial on service-core usage. Harry van Haaren (7): service cores: header and implementation service cores: EAL init changes service cores: coremask parsing service cores: add unit tests event/sw: enable SW PMD with service capability doc: add service cores to doc and release notes maintainers: claim service cores MAINTAINERS | 7 + doc/api/doxy-api-index.md | 1 + doc/guides/eventdevs/sw.rst | 4 +- doc/guides/prog_guide/index.rst | 1 + doc/guides/prog_guide/service_cores.rst | 81 +++ doc/guides/rel_notes/release_17_08.rst | 8 + drivers/event/sw/sw_evdev.c | 32 + drivers/event/sw/sw_evdev.h | 3 + lib/librte_eal/bsdapp/eal/Makefile | 1 + lib/librte_eal/bsdapp/eal/eal.c | 23 + lib/librte_eal/bsdapp/eal/rte_eal_version.map | 22 + lib/librte_eal/common/Makefile | 1 + lib/librte_eal/common/eal_common_lcore.c | 1 + lib/librte_eal/common/eal_common_options.c | 90 ++- lib/librte_eal/common/include/rte_eal.h | 4 + lib/librte_eal/common/include/rte_lcore.h | 3 +- lib/librte_eal/common/include/rte_service.h | 383 ++++++++++++ .../common/include/rte_service_private.h | 140 +++++ lib/librte_eal/common/rte_service.c | 687 +++++++++++++++++++++ lib/librte_eal/linuxapp/eal/Makefile | 1 + lib/librte_eal/linuxapp/eal/eal.c | 23 + lib/librte_eal/linuxapp/eal/eal_thread.c | 9 +- lib/librte_eal/linuxapp/eal/rte_eal_version.map | 22 + test/test/Makefile | 2 + test/test/test_service_cores.c | 538 ++++++++++++++++ 25 files changed, 2083 insertions(+), 4 deletions(-) create mode 100644 doc/guides/prog_guide/service_cores.rst create mode 100644 lib/librte_eal/common/include/rte_service.h create mode 100644 lib/librte_eal/common/include/rte_service_private.h create mode 100644 lib/librte_eal/common/rte_service.c create mode 100644 test/test/test_service_cores.c -- 2.7.4