1 /*
2 * Copyright (c) 2025, 2026, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 *
23 */
24
25 #ifndef SHARE_JFR_PERIODIC_SAMPLING_JFRSAMPLEREQUEST_HPP
26 #define SHARE_JFR_PERIODIC_SAMPLING_JFRSAMPLEREQUEST_HPP
27
28 #include "jfr/utilities/jfrTime.hpp"
29 #include "memory/allocation.hpp"
30 #include "utilities/growableArray.hpp"
31
32 class JavaThread;
33 class JfrThreadLocal;
34
35 enum JfrSampleResult {
36 THREAD_SUSPENSION_ERROR,
37 WRONG_THREAD_STATE,
38 UNPARSABLE_TOP_FRAME,
39 INVALID_STACK_TRACE,
40 CRASH,
41 NO_LAST_JAVA_FRAME,
42 UNKNOWN,
43 FAIL,
44 SKIP,
45 SAMPLE_NATIVE,
46 SAMPLE_JAVA,
47 NOF_SAMPLING_RESULTS
48 };
49
50 enum JfrSampleRequestType {
51 NO_SAMPLE,
52 JAVA_SAMPLE,
53 NATIVE_SAMPLE,
54 WAITING_FOR_NATIVE_SAMPLE,
55 NOF_SAMPLE_STATES
56 };
57
58 enum JfrSampleRequestFrameType {
59 NONE,
60 INTERPRETER,
61 NEEDS_STACK_REPAIR,
62 NOF_FRAME_TYPES
63 };
64
65 struct JfrSampleRequest {
66 void* _sample_sp;
67 void* _sample_pc;
68 void* _sample_bcp;
69 JfrTicks _sample_ticks;
70
71 JfrSampleRequest() :
72 _sample_sp(nullptr),
73 _sample_pc(nullptr),
74 _sample_bcp(nullptr),
75 _sample_ticks() {}
76
77 JfrSampleRequest(const JfrTicks& ticks) :
78 _sample_sp(nullptr),
79 _sample_pc(nullptr),
80 _sample_bcp(nullptr),
81 _sample_ticks(ticks) {}
82 };
83
84 typedef GrowableArrayCHeap<JfrSampleRequest, mtTracing> JfrSampleRequestQueue;
85
86 class JfrSampleRequestBuilder : AllStatic {
87 public:
88 static JfrSampleResult build_java_sample_request(const void* ucontext,
89 JfrThreadLocal* tl,
90 JavaThread* jt);
91 static void build_cpu_time_sample_request(JfrSampleRequest &request,
92 void* ucontext,
93 JavaThread* jt,
94 JfrThreadLocal* tl,
95 JfrTicks& now);
96 };
97
98 #endif // SHARE_JFR_PERIODIC_SAMPLING_JFRSAMPLEREQUEST_HPP