mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-07-25 20:50:47 +00:00
76e5a7fab6
git-subtree-dir: submodules/HockeySDK-iOS git-subtree-mainline: 085acd26c4432939403765234266e3c1be0f3dd9 git-subtree-split: c7d0c7026303253e2ac576c02655691e5d314fe2
139 lines
5.1 KiB
Objective-C
139 lines
5.1 KiB
Objective-C
/*
|
|
* Author: Landon Fuller <landonf@plausiblelabs.com>
|
|
*
|
|
* Copyright (c) 2008-2009 Plausible Labs Cooperative, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person
|
|
* obtaining a copy of this software and associated documentation
|
|
* files (the "Software"), to deal in the Software without
|
|
* restriction, including without limitation the rights to use,
|
|
* copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the
|
|
* Software is furnished to do so, subject to the following
|
|
* conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
|
|
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
|
|
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
|
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
|
|
* OTHER DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
|
|
#import <Foundation/Foundation.h>
|
|
#import <mach/mach.h>
|
|
|
|
#import "PLCrashReporterConfig.h"
|
|
|
|
@class PLCrashMachExceptionServer;
|
|
@class PLCrashMachExceptionPortSet;
|
|
|
|
/**
|
|
* @ingroup functions
|
|
*
|
|
* Prototype of a callback function used to execute additional user code with signal information as provided
|
|
* by PLCrashReporter. Called upon completion of crash handling, after the crash report has been written to disk.
|
|
*
|
|
* @param info The signal info.
|
|
* @param uap The crash's threads context.
|
|
* @param context The API client's supplied context value.
|
|
*
|
|
* @sa async_satefy
|
|
* @ref async_safety
|
|
* @sa PLCrashReporter::setPostCrashCallbacks:
|
|
*/
|
|
typedef void (*PLCrashReporterPostCrashSignalCallback)(siginfo_t *info, ucontext_t *uap, void *context);
|
|
|
|
/**
|
|
* @ingroup types
|
|
*
|
|
* This structure contains callbacks supported by PLCrashReporter to allow the host application to perform
|
|
* additional tasks prior to program termination after a crash has occured.
|
|
*
|
|
* @sa async_satefy
|
|
* @ref async_safety
|
|
*/
|
|
typedef struct PLCrashReporterCallbacks {
|
|
/** The version number of this structure. If not one of the defined version numbers for this type, the behavior
|
|
* is undefined. The current version of this structure is 0. */
|
|
uint16_t version;
|
|
|
|
/** An arbitrary user-supplied context value. This value may be NULL. */
|
|
void *context;
|
|
|
|
/**
|
|
* The callback used to report caught signal information. In version 0 of this structure, all crashes will be
|
|
* reported via this function.
|
|
*
|
|
* @warning When using PLCrashReporterSignalHandlerTypeMach, the siginfo_t argument to this function will be derived
|
|
* from the Mach exception data, and may be incorrect, or may otherwise not match the expected data as provided via
|
|
* PLCrashReporterSignalHandlerTypeBSD. In addition, the provided ucontext_t value will be zero-initialized, and will
|
|
* not provide valid thread state.
|
|
*
|
|
* This callback will be deprecated in favor of a Mach-compatible replacement in a future release; support is maintained
|
|
* here to allow clients that rely on post-crash callbacks without thread state to make use of Mach exceptions.
|
|
*/
|
|
PLCrashReporterPostCrashSignalCallback handleSignal;
|
|
} PLCrashReporterCallbacks;
|
|
|
|
@interface PLCrashReporter : NSObject {
|
|
@private
|
|
/** Reporter configuration */
|
|
PLCrashReporterConfig *_config;
|
|
|
|
/** YES if the crash reporter has been enabled */
|
|
BOOL _enabled;
|
|
|
|
#if PLCRASH_FEATURE_MACH_EXCEPTIONS
|
|
/** The backing Mach exception server, if any. Nil if the reporter has not been enabled, or if
|
|
* the configured signal handler type is not PLCrashReporterSignalHandlerTypeMach. */
|
|
PLCrashMachExceptionServer *_machServer;
|
|
|
|
/** Previously registered Mach exception ports, if any. */
|
|
PLCrashMachExceptionPortSet *_previousMachPorts;
|
|
#endif /* PLCRASH_FEATURE_MACH_EXCEPTIONS */
|
|
|
|
/** Application identifier */
|
|
NSString *_applicationIdentifier;
|
|
|
|
/** Application version */
|
|
NSString *_applicationVersion;
|
|
|
|
/** Application marketing version */
|
|
NSString *_applicationMarketingVersion;
|
|
|
|
/** Path to the crash reporter internal data directory */
|
|
NSString *_crashReportDirectory;
|
|
}
|
|
|
|
+ (PLCrashReporter *) sharedReporter;
|
|
|
|
- (instancetype) initWithConfiguration: (PLCrashReporterConfig *) config;
|
|
|
|
- (BOOL) hasPendingCrashReport;
|
|
|
|
- (NSData *) loadPendingCrashReportData;
|
|
- (NSData *) loadPendingCrashReportDataAndReturnError: (NSError **) outError;
|
|
|
|
- (NSData *) generateLiveReportWithThread: (thread_t) thread;
|
|
- (NSData *) generateLiveReportWithThread: (thread_t) thread error: (NSError **) outError;
|
|
|
|
- (NSData *) generateLiveReport;
|
|
- (NSData *) generateLiveReportAndReturnError: (NSError **) outError;
|
|
|
|
- (BOOL) purgePendingCrashReport;
|
|
- (BOOL) purgePendingCrashReportAndReturnError: (NSError **) outError;
|
|
|
|
- (BOOL) enableCrashReporter;
|
|
- (BOOL) enableCrashReporterAndReturnError: (NSError **) outError;
|
|
|
|
- (void) setCrashCallbacks: (PLCrashReporterCallbacks *) callbacks;
|
|
|
|
@end
|