[apple/xnu.git] / libkern / firehose / tracepoint_private.h

/*
 * Copyright (c) 2013-2016 Apple Inc. All rights reserved.
 *
 * @APPLE_APACHE_LICENSE_HEADER_START@
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * @APPLE_APACHE_LICENSE_HEADER_END@
 */

#ifndef __FIREHOSE_ACTIVITY__
#define __FIREHOSE_ACTIVITY__

#include <machine/cpu_capabilities.h>
#include <mach/mach_time.h>
#include <os/base.h>
#if KERNEL
#include <atm/atm_internal.h>
#endif
#include "firehose_types_private.h"

OS_ASSUME_NONNULL_BEGIN

/*!
 * @typedef firehose_tracepoint_id_u
 *
 * @abstract
 * Broken down tracepoint identifier.
 */
typedef union {
	struct {
		firehose_tracepoint_namespace_t _namespace;
		firehose_tracepoint_type_t _type;
		firehose_tracepoint_flags_t _flags;
		uint32_t _code;
	} ftid;
	firehose_tracepoint_id_t ftid_value;
} firehose_tracepoint_id_u;

#define FIREHOSE_STAMP_SLOP (1ULL << 36) // ~1minute

/*!
 * @typedef firehose_trace_uuid_info_t
 *
 * @abstract
 * Info needed by logd when kexts are loaded or unloaded
 *
 */
typedef struct firehose_trace_uuid_info_s {
	uuid_t ftui_uuid;      /* uuid of binary */
	uint64_t ftui_address; /* load address */
	uint64_t ftui_size;    /* load size */
	char ftui_path[];      /* full path of binary - Unused in the kernel*/
} *firehose_trace_uuid_info_t;

/*!
 * @typedef firehose_tracepoint_t
 */
typedef struct firehose_tracepoint_s {
	firehose_tracepoint_id_u ft_id;
	uint64_t ft_thread;
	union {
		struct {
			uint64_t ft_timestamp_delta : 48;
			uint64_t ft_length : 16;
		};
		uint64_t ft_stamp_and_length;
	};
	uint8_t ft_data[];
} *firehose_tracepoint_t;

#define FIREHOSE_TRACE_ID_MAKE(ns, type, flags, code) \
	(((firehose_tracepoint_id_u){ .ftid = { \
		._namespace = ns, \
		._type = type, \
		._flags = flags, \
		._code = code, \
	} }).ftid_value)

#define FIREHOSE_TRACE_ID_SET_NS(tid, ns) \
	((tid).ftid._namespace = firehose_tracepoint_namespace_##ns)

#define FIREHOSE_TRACE_ID_SET_TYPE(tid, ns, type) \
	((tid).ftid._type = _firehose_tracepoint_type_##ns##_##type)

#define FIREHOSE_TRACE_ID_HAS_FLAG(tid, ns, flag) \
	((tid).ftid._flags & _firehose_tracepoint_flags_##ns##_##flag)
#define FIREHOSE_TRACE_ID_SET_FLAG(tid, ns, flag) \
	((void)((tid).ftid._flags |= _firehose_tracepoint_flags_##ns##_##flag))
#define FIREHOSE_TRACE_ID_CLEAR_FLAG(tid, ns, flag) \
	((void)((tid).ftid._flags &= ~_firehose_tracepoint_flags_##ns##_##flag))

#define FIREHOSE_TRACE_ID_SET_CODE(tid, code) \
	((tid).ftid._code = code)

__BEGIN_DECLS

#if __has_feature(address_sanitizer)
__attribute__((no_sanitize("address")))
#endif
__OSX_AVAILABLE(10.12) __IOS_AVAILABLE(10.0)
__TVOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0)
OS_ALWAYS_INLINE
static inline bool
firehose_precise_timestamps_enabled(void)
{
#if KERNEL
	return (atm_get_diagnostic_config() & 0x80) == 0;
#else
	return (*((volatile uint32_t *)_COMM_PAGE_ATM_DIAGNOSTIC_CONFIG) & 0x80) == 0;
#endif
}

#if __has_feature(address_sanitizer)
__attribute__((no_sanitize("address")))
#endif
__OSX_AVAILABLE(10.12) __IOS_AVAILABLE(10.0)
__TVOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0)
OS_ALWAYS_INLINE
static inline uint64_t
firehose_tracepoint_time(firehose_activity_flags_t flags)
{
	if (firehose_precise_timestamps_enabled() ||
			(flags & firehose_activity_flags_precise_timestamp)) {
		return mach_continuous_time();
	} else {
		return mach_continuous_approximate_time();
	}
}

#ifdef KERNEL
__OSX_AVAILABLE(10.12) __IOS_AVAILABLE(10.0)
__TVOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0)
void
firehose_trace_metadata(firehose_stream_t stream, firehose_tracepoint_id_u ftid,
			uint64_t stamp, const void* pubdata, size_t publen);
#endif
__END_DECLS

OS_ASSUME_NONNULL_END

#endif // __FIREHOSE_FIREHOSE__
Commit	Line	Data
39037602 A	1	/*
	2	* Copyright (c) 2013-2016 Apple Inc. All rights reserved.
	3	*
	4	* @APPLE_APACHE_LICENSE_HEADER_START@
	5	*
	6	* Licensed under the Apache License, Version 2.0 (the "License");
	7	* you may not use this file except in compliance with the License.
	8	* You may obtain a copy of the License at
	9	*
	10	* http://www.apache.org/licenses/LICENSE-2.0
	11	*
	12	* Unless required by applicable law or agreed to in writing, software
	13	* distributed under the License is distributed on an "AS IS" BASIS,
	14	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	15	* See the License for the specific language governing permissions and
	16	* limitations under the License.
	17	*
	18	* @APPLE_APACHE_LICENSE_HEADER_END@
	19	*/
	20
	21	#ifndef __FIREHOSE_ACTIVITY__
	22	#define __FIREHOSE_ACTIVITY__
	23
	24	#include <machine/cpu_capabilities.h>
	25	#include <mach/mach_time.h>
	26	#include <os/base.h>
	27	#if KERNEL
	28	#include <atm/atm_internal.h>
	29	#endif
	30	#include "firehose_types_private.h"
	31
	32	OS_ASSUME_NONNULL_BEGIN
	33
	34	/*!
	35	* @typedef firehose_tracepoint_id_u
	36	*
	37	* @abstract
	38	* Broken down tracepoint identifier.
	39	*/
	40	typedef union {
	41	struct {
	42	firehose_tracepoint_namespace_t _namespace;
	43	firehose_tracepoint_type_t _type;
	44	firehose_tracepoint_flags_t _flags;
	45	uint32_t _code;
	46	} ftid;
	47	firehose_tracepoint_id_t ftid_value;
	48	} firehose_tracepoint_id_u;
	49
	50	#define FIREHOSE_STAMP_SLOP (1ULL << 36) // ~1minute
	51
	52	/*!
	53	* @typedef firehose_trace_uuid_info_t
	54	*
	55	* @abstract
	56	* Info needed by logd when kexts are loaded or unloaded
	57	*
	58	*/
	59	typedef struct firehose_trace_uuid_info_s {
	60	uuid_t ftui_uuid; /* uuid of binary */
	61	uint64_t ftui_address; /* load address */
	62	uint64_t ftui_size; /* load size */
	63	char ftui_path[]; /* full path of binary - Unused in the kernel*/
	64	} *firehose_trace_uuid_info_t;
65
66	/*!
67	* @typedef firehose_tracepoint_t
68	*/
69	typedef struct firehose_tracepoint_s {
70	firehose_tracepoint_id_u ft_id;
71	uint64_t ft_thread;
72	union {
73	struct {
74	uint64_t ft_timestamp_delta : 48;
75	uint64_t ft_length : 16;
76	};
77	uint64_t ft_stamp_and_length;
78	};
79	uint8_t ft_data[];
80	} *firehose_tracepoint_t;
81
82	#define FIREHOSE_TRACE_ID_MAKE(ns, type, flags, code) \
83	(((firehose_tracepoint_id_u){ .ftid = { \
84	._namespace = ns, \
85	._type = type, \
86	._flags = flags, \
87	._code = code, \
88	} }).ftid_value)
89
90	#define FIREHOSE_TRACE_ID_SET_NS(tid, ns) \
91	((tid).ftid._namespace = firehose_tracepoint_namespace_##ns)
92
93	#define FIREHOSE_TRACE_ID_SET_TYPE(tid, ns, type) \
94	((tid).ftid._type = _firehose_tracepoint_type_##ns##_##type)
95
96	#define FIREHOSE_TRACE_ID_HAS_FLAG(tid, ns, flag) \
97	((tid).ftid._flags & _firehose_tracepoint_flags_##ns##_##flag)
98	#define FIREHOSE_TRACE_ID_SET_FLAG(tid, ns, flag) \
99	((void)((tid).ftid._flags \|= _firehose_tracepoint_flags_##ns##_##flag))
100	#define FIREHOSE_TRACE_ID_CLEAR_FLAG(tid, ns, flag) \
101	((void)((tid).ftid._flags &= ~_firehose_tracepoint_flags_##ns##_##flag))
102
103	#define FIREHOSE_TRACE_ID_SET_CODE(tid, code) \
104	((tid).ftid._code = code)
105
106	__BEGIN_DECLS
107
108	#if __has_feature(address_sanitizer)
109	__attribute__((no_sanitize("address")))
110	#endif
111	__OSX_AVAILABLE(10.12) __IOS_AVAILABLE(10.0)
112	__TVOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0)
113	OS_ALWAYS_INLINE
114	static inline bool
115	firehose_precise_timestamps_enabled(void)
116	{
117	#if KERNEL
118	return (atm_get_diagnostic_config() & 0x80) == 0;
119	#else
120	return (((volatile uint32_t )_COMM_PAGE_ATM_DIAGNOSTIC_CONFIG) & 0x80) == 0;
121	#endif
122	}
123
124	#if __has_feature(address_sanitizer)
125	__attribute__((no_sanitize("address")))
126	#endif
127	__OSX_AVAILABLE(10.12) __IOS_AVAILABLE(10.0)
128	__TVOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0)
129	OS_ALWAYS_INLINE
130	static inline uint64_t
131	firehose_tracepoint_time(firehose_activity_flags_t flags)
132	{
133	if (firehose_precise_timestamps_enabled() \|\|
134	(flags & firehose_activity_flags_precise_timestamp)) {
135	return mach_continuous_time();
136	} else {
137	return mach_continuous_approximate_time();
138	}
139	}
140
141	#ifdef KERNEL
142	__OSX_AVAILABLE(10.12) __IOS_AVAILABLE(10.0)
143	__TVOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0)
144	void
145	firehose_trace_metadata(firehose_stream_t stream, firehose_tracepoint_id_u ftid,
146	uint64_t stamp, const void* pubdata, size_t publen);
147	#endif
148	__END_DECLS
149
150	OS_ASSUME_NONNULL_END
151
152	#endif // __FIREHOSE_FIREHOSE__