ivampiresp/Spdk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
e16f4bc7ce
Spdk/include/spdk_internal/usdt.h

37 lines
1.0 KiB
C
Raw Normal View History

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) 2021 Intel Corporation.
usdt: add User Space DTrace support to SPDK For now, we will keep this disabled by default, enable with --with-usdt option to the configure script. Long-term we will want to enable this by default, and only disable via configure. Modules can include spdk_internal/usdt.h and add probes such as: SPDK_DTRACE_PROBE2(probe_name, ptr, val); When USDT is enabled, these will translate to DTRACE_PROBE2(spdk, probe_name, ptr, val). When USDT is disabled, these will translate to nothing. Later patches will add some probe points to the nvmf target, some bpftrace scripts, and instructions for how to successfully capture data with these probe points and scripts. Signed-off-by: Jim Harris <james.r.harris@intel.com> Change-Id: Id168e2c800fa5522815a175026386319014cfdaa Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/7173 Community-CI: Mellanox Build Bot Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Konrad Sztyber <konrad.sztyber@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@mellanox.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com>
2021-03-31 22:33:20 +00:00
* All rights reserved.
*/
#ifndef SPDK_INTERNAL_USDT_H
#define SPDK_INTERNAL_USDT_H
#include "spdk/config.h"
usdt: pass ticks as the first probe argument This will allow to match and compare the DTrace probes with SPDK traces as they'll be using the same source for the timestamps. Signed-off-by: Konrad Sztyber <konrad.sztyber@intel.com> Change-Id: I686c3351428c75f9b618a1a909836504fccad828 Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/8101 Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Community-CI: Mellanox Build Bot Reviewed-by: Changpeng Liu <changpeng.liu@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@mellanox.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Ziye Yang <ziye.yang@intel.com>
2021-05-26 06:57:20 +00:00
#include "spdk/env.h"
usdt: add User Space DTrace support to SPDK For now, we will keep this disabled by default, enable with --with-usdt option to the configure script. Long-term we will want to enable this by default, and only disable via configure. Modules can include spdk_internal/usdt.h and add probes such as: SPDK_DTRACE_PROBE2(probe_name, ptr, val); When USDT is enabled, these will translate to DTRACE_PROBE2(spdk, probe_name, ptr, val). When USDT is disabled, these will translate to nothing. Later patches will add some probe points to the nvmf target, some bpftrace scripts, and instructions for how to successfully capture data with these probe points and scripts. Signed-off-by: Jim Harris <james.r.harris@intel.com> Change-Id: Id168e2c800fa5522815a175026386319014cfdaa Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/7173 Community-CI: Mellanox Build Bot Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Konrad Sztyber <konrad.sztyber@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@mellanox.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com>
2021-03-31 22:33:20 +00:00
usdt: don't emit probes in unit tests There is no point in producing USDT probes in unit tests and it breaks the build on some systems: ctrlr_discovery_ut.o(.note.stapsdt+0x14): error: relocation refers to local symbol "" [102], which is defined in a discarded section ctrlr_discovery_ut.o(.note.stapsdt+0x90): error: relocation refers to local symbol "" [108], which is defined in a discarded section ctrlr_discovery_ut.o(.note.stapsdt+0xf8): error: relocation refers to local symbol "" [110], which is defined in a discarded section ctrlr_discovery_ut.o(.note.stapsdt+0x15c): error: relocation refers to local symbol "" [112], which is defined in a discarded section Fixes issue #2027. Signed-off-by: Konrad Sztyber <konrad.sztyber@intel.com> Change-Id: Ic6dad60df1f7dccb7f99777ebc4435c618cb505a Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/8699 Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Community-CI: Broadcom CI <spdk-ci.pdl@broadcom.com> Community-CI: Mellanox Build Bot Reviewed-by: Karol Latecki <karol.latecki@intel.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Tomasz Zawadzki <tomasz.zawadzki@intel.com>
2021-07-07 08:42:13 +00:00
#if defined(SPDK_CONFIG_USDT) && !defined(SPDK_UNIT_TEST)
usdt: add User Space DTrace support to SPDK For now, we will keep this disabled by default, enable with --with-usdt option to the configure script. Long-term we will want to enable this by default, and only disable via configure. Modules can include spdk_internal/usdt.h and add probes such as: SPDK_DTRACE_PROBE2(probe_name, ptr, val); When USDT is enabled, these will translate to DTRACE_PROBE2(spdk, probe_name, ptr, val). When USDT is disabled, these will translate to nothing. Later patches will add some probe points to the nvmf target, some bpftrace scripts, and instructions for how to successfully capture data with these probe points and scripts. Signed-off-by: Jim Harris <james.r.harris@intel.com> Change-Id: Id168e2c800fa5522815a175026386319014cfdaa Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/7173 Community-CI: Mellanox Build Bot Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Konrad Sztyber <konrad.sztyber@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@mellanox.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com>
2021-03-31 22:33:20 +00:00
usdt: fix bpftrace parse error on arm64 bpftrace reports parse error on arm64: "parse error: 8@x0 4@[x21, #:lo12:.LANCHOR2] " using "nr" to override the default constraints string can fix this. //the default is: stapsdt 0x0000004b NT_STAPSDT (SystemTap probe descriptors) Provider: spdk Name: nvmf_tgt_state Location: 0x000000000006e664, Base: 0x00000000001ca6f0, Semaphore: 0x0000000000000000 Arguments: 8@x0 4@[x21, #:lo12:.LANCHOR2] //using "nr" as the constraints string: stapsdt 0x00000036 NT_STAPSDT (SystemTap probe descriptors) Provider: spdk Name: nvmf_tgt_state Location: 0x000000000006f680, Base: 0x00000000001cb730, Semaphore: 0x0000000000000000 Arguments: 8@x0 4@x1 Change-Id: I25736dcf5a8593d2c156da41a2e28532ab8fa570 Signed-off-by: Richael Zhuang <richael.zhuang@arm.com> Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/14642 Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Community-CI: Mellanox Build Bot Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Shuhei Matsumoto <smatsumoto@nvidia.com>
2022-09-13 03:01:03 +00:00
#if defined(__aarch64__)
#define STAP_SDT_ARG_CONSTRAINT nr
#endif
usdt: add User Space DTrace support to SPDK For now, we will keep this disabled by default, enable with --with-usdt option to the configure script. Long-term we will want to enable this by default, and only disable via configure. Modules can include spdk_internal/usdt.h and add probes such as: SPDK_DTRACE_PROBE2(probe_name, ptr, val); When USDT is enabled, these will translate to DTRACE_PROBE2(spdk, probe_name, ptr, val). When USDT is disabled, these will translate to nothing. Later patches will add some probe points to the nvmf target, some bpftrace scripts, and instructions for how to successfully capture data with these probe points and scripts. Signed-off-by: Jim Harris <james.r.harris@intel.com> Change-Id: Id168e2c800fa5522815a175026386319014cfdaa Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/7173 Community-CI: Mellanox Build Bot Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Konrad Sztyber <konrad.sztyber@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@mellanox.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com>
2021-03-31 22:33:20 +00:00
#include <sys/sdt.h>
usdt: pass ticks as the first probe argument This will allow to match and compare the DTrace probes with SPDK traces as they'll be using the same source for the timestamps. Signed-off-by: Konrad Sztyber <konrad.sztyber@intel.com> Change-Id: I686c3351428c75f9b618a1a909836504fccad828 Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/8101 Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Community-CI: Mellanox Build Bot Reviewed-by: Changpeng Liu <changpeng.liu@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@mellanox.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Ziye Yang <ziye.yang@intel.com>
2021-05-26 06:57:20 +00:00
#define SPDK_DTRACE_PROBE(name) DTRACE_PROBE1(spdk,name,spdk_get_ticks())
#define SPDK_DTRACE_PROBE1(name,a1) DTRACE_PROBE2(spdk,name,spdk_get_ticks(),a1)
#define SPDK_DTRACE_PROBE2(name,a1,a2) DTRACE_PROBE3(spdk,name,spdk_get_ticks(),a1,a2)
#define SPDK_DTRACE_PROBE3(name,a1,a2,a3) DTRACE_PROBE4(spdk,name,spdk_get_ticks(),a1,a2,a3)
#define SPDK_DTRACE_PROBE4(name,a1,a2,a3,a4) DTRACE_PROBE5(spdk,name,spdk_get_ticks(),a1,a2,a3,a4)
usdt: add User Space DTrace support to SPDK For now, we will keep this disabled by default, enable with --with-usdt option to the configure script. Long-term we will want to enable this by default, and only disable via configure. Modules can include spdk_internal/usdt.h and add probes such as: SPDK_DTRACE_PROBE2(probe_name, ptr, val); When USDT is enabled, these will translate to DTRACE_PROBE2(spdk, probe_name, ptr, val). When USDT is disabled, these will translate to nothing. Later patches will add some probe points to the nvmf target, some bpftrace scripts, and instructions for how to successfully capture data with these probe points and scripts. Signed-off-by: Jim Harris <james.r.harris@intel.com> Change-Id: Id168e2c800fa5522815a175026386319014cfdaa Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/7173 Community-CI: Mellanox Build Bot Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Konrad Sztyber <konrad.sztyber@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@mellanox.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com>
2021-03-31 22:33:20 +00:00
#else
#define SPDK_DTRACE_PROBE(...)
#define SPDK_DTRACE_PROBE1(...)
#define SPDK_DTRACE_PROBE2(...)
#define SPDK_DTRACE_PROBE3(...)
#define SPDK_DTRACE_PROBE4(...)
#endif
#endif /* SPDK_INTERNAL_USDT_H */
Reference in New Issue Copy Permalink