Spdk/lib/trace_parser/Makefile

#  SPDX-License-Identifier: BSD-3-Clause
#  Copyright (C) 2015 Intel Corporation.
#  All rights reserved.
#

SPDK_ROOT_DIR := $(abspath $(CURDIR)/../..)

include $(SPDK_ROOT_DIR)/mk/spdk.common.mk

SO_VER := 4
SO_MINOR := 0

CXX_SRCS = trace.cpp
LIBNAME = trace_parser
LOCAL_SYS_LIBS = -lrt

SPDK_MAP_FILE = $(abspath $(CURDIR)/spdk_trace_parser.map)

include $(SPDK_ROOT_DIR)/mk/spdk.lib.mk
Replace most BSD 3-clause license text with SPDX identifier. Many open source projects have moved to using SPDX identifiers to specify license information, reducing the amount of boilerplate code in every source file. This patch replaces the bulk of SPDK .c, .cpp and Makefiles with the BSD-3-Clause identifier. Almost all of these files share the exact same license text, and this patch only modifies the files that contain the most common license text. There can be slight variations because the third clause contains company names - most say "Intel Corporation", but there are instances for Nvidia, Samsung, Eideticom and even "the copyright holder". Used a bash script to automate replacement of the license text with SPDX identifier which is checked into scripts/spdx.sh. Signed-off-by: Jim Harris <james.r.harris@intel.com> Change-Id: Iaa88ab5e92ea471691dc298cfe41ebfb5d169780 Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/12904 Community-CI: Broadcom CI <spdk-ci.pdl@broadcom.com> Community-CI: Mellanox Build Bot Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@nvidia.com> Reviewed-by: Changpeng Liu <changpeng.liu@intel.com> Reviewed-by: Dong Yi <dongx.yi@intel.com> Reviewed-by: Konrad Sztyber <konrad.sztyber@intel.com> Reviewed-by: Paul Luse <paul.e.luse@intel.com> Reviewed-by: <qun.wan@intel.com> 2022-06-03 19:15:11 +00:00			`# SPDX-License-Identifier: BSD-3-Clause`
update Intel copyright notices per Intel policy to include file commit date using git cmd below. The policy does not apply to non-Intel (C) notices. git log --follow -C90% --format=%ad --date default <file> \| tail -1 and then pull just the 4 digit year from the result. Intel copyrights were not added to files where Intel either had no contribution ot the contribution lacked substance (ie license header updates, formatting changes, etc). Contribution date used "--follow -C95%" to get the most accurate date. Note that several files in this patch didn't end the license/(c) block with a blank comment line so these were added as the vast majority of files do have this last blank line. Simply there for consistency. Signed-off-by: paul luse <paul.e.luse@intel.com> Change-Id: Id5b7ce4f658fe87132f14139ead58d6e285c04d4 Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/15192 Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com> Community-CI: Mellanox Build Bot 2022-11-01 20:26:26 +00:00			`# Copyright (C) 2015 Intel Corporation.`
lib/trace_parser: add trace_parser library stubs This library will provide functions that parse traces recorded by an SPDK application. This includes merging traces from multiple cores, sorting them by their timestamp and constructing trace entries spanning across multiple buffers. All of these tasks are currently implemented in the spdk_trace app, so most of its code will be moved here (this is the reason for using C++). The motivation for extracting this code to a library is to be able to use it from places other than the spdk_trace app, specifically the `scripts/bpf/trace.py` script. The main reason for creating a separate library instead of extending libtrace is to avoid pulling in all of its dependencies. ISA-L is the most problematic, as we only build it as a static library, which makes it impossible to use with dlopen (making it unusable in scripts). Signed-off-by: Konrad Sztyber <konrad.sztyber@intel.com> Change-Id: If101ca3425d7404abd51b0da2031358d0be44766 Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/9428 Community-CI: Broadcom CI <spdk-ci.pdl@broadcom.com> Community-CI: Mellanox Build Bot Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@mellanox.com> 2021-08-30 12:47:27 +00:00			`# All rights reserved.`
			`#`

			`SPDK_ROOT_DIR := $(abspath $(CURDIR)/../..)`

			`include $(SPDK_ROOT_DIR)/mk/spdk.common.mk`

so_ver: increase all major versions To allow SO_MINOR updates on LTS for the whole year it is supported, the major version for all components needs to be increased. This is to prevent scenario where two versions exists with matching versions, but conflicting ABI. Ex. Next SPDK release adds an API call increasing the minor version, then LTS needs just a subset of those additions. Increasing major so version after LTS, allows the future releases to update versions as needed. Yet allowing LTS to increase minor version separately. Disabled test for increasing SO version without ABI change, as that is goal of this patch. This check shall be removed with SPDK 23.05 release. Looks like this was left over from prior LTS, to avoid that make sure it is only skipped when running against v23.01.x as latest release. This patch: - increases SO_VER by 1 for all components - resets SO_MINOR to 0 for all components - removes suppressions for ABI tests Short reference to how the versions were changed: MAX=$(git grep "SO_VER := " \| cut -d" " -f 3 \| sort -ubnr \| head -1) for((i=$MAX;i>0;i-=1)); do find . -name "Makefile" -exec \ sed -i -e "s/SO_VER := $i\$/SO_VER := $(($i+1))/g" {} +; done find . -name "Makefile" -exec \ sed -i -e "s/SO_MINOR := .*/SO_MINOR := 0/g" {} + Change-Id: I3e5681802c0a5ac6d7d652a18896997cd07cc8bf Signed-off-by: Tomasz Zawadzki <tomasz.zawadzki@intel.com> Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/16419 Reviewed-by: Ben Walker <benjamin.walker@intel.com> Reviewed-by: Konrad Sztyber <konrad.sztyber@intel.com> Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> 2023-01-23 17:24:28 +00:00			`SO_VER := 4`
lib/trace_parser: add trace_parser library stubs This library will provide functions that parse traces recorded by an SPDK application. This includes merging traces from multiple cores, sorting them by their timestamp and constructing trace entries spanning across multiple buffers. All of these tasks are currently implemented in the spdk_trace app, so most of its code will be moved here (this is the reason for using C++). The motivation for extracting this code to a library is to be able to use it from places other than the spdk_trace app, specifically the `scripts/bpf/trace.py` script. The main reason for creating a separate library instead of extending libtrace is to avoid pulling in all of its dependencies. ISA-L is the most problematic, as we only build it as a static library, which makes it impossible to use with dlopen (making it unusable in scripts). Signed-off-by: Konrad Sztyber <konrad.sztyber@intel.com> Change-Id: If101ca3425d7404abd51b0da2031358d0be44766 Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/9428 Community-CI: Broadcom CI <spdk-ci.pdl@broadcom.com> Community-CI: Mellanox Build Bot Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@mellanox.com> 2021-08-30 12:47:27 +00:00			`SO_MINOR := 0`

			`CXX_SRCS = trace.cpp`
			`LIBNAME = trace_parser`
			`LOCAL_SYS_LIBS = -lrt`

			`SPDK_MAP_FILE = $(abspath $(CURDIR)/spdk_trace_parser.map)`

			`include $(SPDK_ROOT_DIR)/mk/spdk.lib.mk`