feat: Add SIGTERM support

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## 8.25.0
 
+- Add SIGTERM support ([#3895](https://github.com/getsentry/sentry-cocoa/pull/3895))
+
 ### Features
 
 - Add Session Replay, which is **still experimental**. (#3625)

Sources/SentryCrash/Recording/SentryCrashDoctor.m

@@ -351,6 +351,11 @@
  return NO;
 }
 
+- (BOOL)wasProgramTerminationRequested:(NSDictionary *)errorReport
+{
+ return [(errorReport[@SentryCrashField_Signal][@SentryCrashField_Signal]) intValue] == SIGTERM;
+}
+
 - (SentryCrashDoctorFunctionCall *)lastFunctionCall:(NSDictionary *)report
 {
  SentryCrashDoctorFunctionCall *function = [[SentryCrashDoctorFunctionCall alloc] init];
@@ -471,7 +476,11 @@
  (void *)address];
  }
  }
-
+
+ if ([self wasProgramTerminationRequested:errorReport]) {
+ return @"Graceful OS termination requested.";
+ }
+
  return nil;
  } @catch (NSException *e) {
  NSArray *symbols = [e callStackSymbols];

Sources/SentryCrash/Recording/Tools/SentryCrashSignalInfo.c

@@ -115,7 +115,8 @@ static const SentryCrashSignalInfo g_fatalSignalData[] = {
  SIGNAL_INFO_NOCODES(SIGPIPE),
  SIGNAL_INFO(SIGSEGV, g_sigSegVCodes),
  SIGNAL_INFO_NOCODES(SIGSYS),
- SIGNAL_INFO(SIGTERM, g_sigTrapCodes),
+ SIGNAL_INFO(SIGTRAP, g_sigTrapCodes),
+ SIGNAL_INFO_NOCODES(SIGTERM),
 };
 static const int g_fatalSignalsCount = sizeof(g_fatalSignalData) / sizeof(*g_fatalSignalData);
 
@@ -130,6 +131,15 @@ static const int g_fatalSignals[] = {
  SIGSEGV,
  SIGSYS,
  SIGTRAP,
+
+ // SIGTERM can be caught and is usually sent by iOS and variants
+ // when Apple wants to try and gracefully shutdown the app
+ // before sending a SIGKILL (which can't be caught).
+ // Some areas I've seen this happen are:
+ // - When the OS updates an app.
+ // - In some circumstances for Watchdog Events.
+ // - Resource overuse (CPU, Disk, ...).
+ SIGTERM,
 };
 
 const char *