aboutsummaryrefslogtreecommitdiffstats
path: root/include/sys/trace_dbgmsg.h
diff options
context:
space:
mode:
authorNed Bass <[email protected]>2014-12-12 18:07:39 -0800
committerBrian Behlendorf <[email protected]>2015-01-06 16:53:24 -0800
commit49ee64e5e6ec7240bc63d96064f2feeb8f84ed9d (patch)
treeafba44d079cb1f7006bb4232781d9795bb986ec3 /include/sys/trace_dbgmsg.h
parent74328ee18f94d27f9c802d29fdd311018dab2adf (diff)
Remove duplicate typedefs from trace.h
Older versions of GCC (e.g. GCC 4.4.7 on RHEL6) do not allow duplicate typedef declarations with the same type. The trace.h header contains some typedefs to avoid 'unknown type' errors for C files that haven't declared the type in question. But this causes build failures for C files that have already declared the type. Newer versions of GCC (e.g. v4.6) allow duplicate typedefs with the same type unless pedantic error checking is in force. To support the older versions we need to remove the duplicate typedefs. Removal of the typedefs means we can't built tracepoints code using those types unless the required headers have been included. To facilitate this, all tracepoint event declarations have been moved out of trace.h into separate headers. Each new header is explicitly included from the C file that uses the events defined therein. The trace.h header is still indirectly included form zfs_context.h and provides the implementation of the dprintf(), dbgmsg(), and SET_ERROR() interfaces. This makes those interfaces readily available throughout the code base. The macros that redefine DTRACE_PROBE* to use Linux tracepoints are also still provided by trace.h, so it is a prerequisite for the other trace_*.h headers. These new Linux implementation-specific headers do introduce a small divergence from upstream ZFS in several core C files, but this should not present a significant maintenance burden. Signed-off-by: Ned Bass <[email protected]> Signed-off-by: Brian Behlendorf <[email protected]> Issue #2953
Diffstat (limited to 'include/sys/trace_dbgmsg.h')
-rw-r--r--include/sys/trace_dbgmsg.h137
1 files changed, 137 insertions, 0 deletions
diff --git a/include/sys/trace_dbgmsg.h b/include/sys/trace_dbgmsg.h
new file mode 100644
index 000000000..24b34bcf3
--- /dev/null
+++ b/include/sys/trace_dbgmsg.h
@@ -0,0 +1,137 @@
+/*
+ * CDDL HEADER START
+ *
+ * The contents of this file are subject to the terms of the
+ * Common Development and Distribution License (the "License").
+ * You may not use this file except in compliance with the License.
+ *
+ * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+ * or http://www.opensolaris.org/os/licensing.
+ * See the License for the specific language governing permissions
+ * and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL HEADER in each
+ * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+ * If applicable, add the following below this CDDL HEADER, with the
+ * fields enclosed by brackets "[]" replaced with your own identifying
+ * information: Portions Copyright [yyyy] [name of copyright owner]
+ *
+ * CDDL HEADER END
+ */
+
+/* Do not include this file directly. Please use <sys/trace.h> instead. */
+#ifndef _SYS_TRACE_DBGMSG_INDIRECT
+#error "trace_dbgmsg.h included directly"
+#endif
+
+/*
+ * This file defines tracepoint events for use by the dbgmsg(),
+ * dprintf(), and SET_ERROR() interfaces. These are grouped here because
+ * they all provide a way to store simple messages in the debug log (as
+ * opposed to events used by the DTRACE_PROBE interfaces which typically
+ * dump structured data).
+ *
+ * This header is included inside the trace.h multiple inclusion guard,
+ * and it is guarded above against direct inclusion, so it and need not
+ * be guarded separately.
+ */
+
+/*
+ * Generic support for one argument tracepoints of the form:
+ *
+ * DTRACE_PROBE1(...,
+ * const char *, ...);
+ */
+
+DECLARE_EVENT_CLASS(zfs_dbgmsg_class,
+ TP_PROTO(const char *msg),
+ TP_ARGS(msg),
+ TP_STRUCT__entry(
+ __string(msg, msg)
+ ),
+ TP_fast_assign(
+ __assign_str(msg, msg);
+ ),
+ TP_printk("%s", __get_str(msg))
+);
+
+#define DEFINE_DBGMSG_EVENT(name) \
+DEFINE_EVENT(zfs_dbgmsg_class, name, \
+ TP_PROTO(const char *msg), \
+ TP_ARGS(msg))
+DEFINE_DBGMSG_EVENT(zfs_zfs__dbgmsg);
+
+
+/*
+ * Generic support for four argument tracepoints of the form:
+ *
+ * DTRACE_PROBE4(...,
+ * const char *, ...,
+ * const char *, ...,
+ * int, ...,
+ * const char *, ...);
+ */
+
+DECLARE_EVENT_CLASS(zfs_dprintf_class,
+ TP_PROTO(const char *file, const char *function, int line,
+ const char *msg),
+ TP_ARGS(file, function, line, msg),
+ TP_STRUCT__entry(
+ __field(const char *, file)
+ __field(const char *, function)
+ __field(int, line)
+ __string(msg, msg)
+ ),
+ TP_fast_assign(
+ __entry->file = file;
+ __entry->function = function;
+ __entry->line = line;
+ __assign_str(msg, msg);
+ ),
+ TP_printk("%s:%d:%s(): %s", __entry->file, __entry->line,
+ __entry->function, __get_str(msg))
+);
+
+#define DEFINE_DPRINTF_EVENT(name) \
+DEFINE_EVENT(zfs_dprintf_class, name, \
+ TP_PROTO(const char *file, const char *function, int line, \
+ const char *msg), \
+ TP_ARGS(file, function, line, msg))
+DEFINE_DPRINTF_EVENT(zfs_zfs__dprintf);
+
+/*
+ * Generic support for four argument tracepoints of the form:
+ *
+ * DTRACE_PROBE4(...,
+ * const char *, ...,
+ * const char *, ...,
+ * int, ...,
+ * uintptr_t, ...);
+ */
+
+DECLARE_EVENT_CLASS(zfs_set_error_class,
+ TP_PROTO(const char *file, const char *function, int line,
+ uintptr_t error),
+ TP_ARGS(file, function, line, error),
+ TP_STRUCT__entry(
+ __field(const char *, file)
+ __field(const char *, function)
+ __field(int, line)
+ __field(uintptr_t, error)
+ ),
+ TP_fast_assign(
+ __entry->file = strchr(file, '/') ? strrchr(file, '/') + 1 : file;
+ __entry->function = function;
+ __entry->line = line;
+ __entry->error = error;
+ ),
+ TP_printk("%s:%d:%s(): error 0x%lx", __entry->file, __entry->line,
+ __entry->function, __entry->error)
+);
+
+#define DEFINE_SET_ERROR_EVENT(name) \
+DEFINE_EVENT(zfs_set_error_class, name, \
+ TP_PROTO(const char *file, const char *function, int line, \
+ uintptr_t error), \
+ TP_ARGS(file, function, line, error))
+DEFINE_SET_ERROR_EVENT(zfs_set__error);