1 /*
2  * Copyright (C) 2020 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #ifndef ANDROID_WATCHDOG_H
18 #define ANDROID_WATCHDOG_H
19 
20 #include <chrono>
21 #include <time.h>
22 
23 namespace android {
24 
25 /*
26  * An RAII-style object, which would crash the process if a timeout expires
27  * before the object is destroyed.
28  * The calling thread would be sent a SIGABORT, which would typically result in
29  * a stack trace.
30  *
31  * Sample usage:
32  * {
33  *     Watchdog watchdog(std::chrono::milliseconds(10));
34  *     DoSomething();
35  * }
36  * // If we got here, the function completed in time.
37  */
38 class Watchdog final {
39 public:
40     Watchdog(std::chrono::steady_clock::duration timeout);
41     ~Watchdog();
42 
43 private:
44     timer_t mTimerId;
45 };
46 
47 }  // namespace android
48 
49 #endif  // ANDROID_WATCHDOG_H
50