Native crash logging functions and constants.
Performs the same steps as if a crash had just occured but allows the program to continue. The generated dump can be read by crash.load_previous
Crashes occuring before the path is set will be stored to a default engine location.
path - file path to use
The crash dump will be removed from disk upon a successful load, so loading is one-shot.
handle - handle to the loaded dump, or nil
if no dump was found
releases a previously loaded crash dump
handle - handle to loaded crash dump
Store a user value that will get written to a crash dump when a crash occurs. This can be user id:s, breadcrumb data etc. There are 32 slots indexed from 0. Each slot stores at most 255 characters.
index - slot index. 0-indexed
value - string value to store
The function returns a table containing entries with sub-tables that have fields 'name' and 'address' set for all loaded modules.
handle - crash dump handle
modules - module table
reads user field from a loaded crash dump
handle - crash dump handle
index - user data slot index
value - user data value recorded in the crash dump
reads a system field from a loaded crash dump
handle - crash dump handle
index - system field enum. Must be less than crash.SYSFIELD_MAX
value - value recorded in the crash dump, or nil
if it didn't exist
read signal number from a crash report
handle - crash dump handle
signal - signal number
A table is returned containing the addresses of the call stack.
handle - crash dump handle
backtrace - table containing the backtrace
The format of read text blob is platform specific and not guaranteed but can be useful for manual inspection.
handle - crash dump handle
blob - string with the platform specific data
engine version as release number
engine version as hash
device model as reported by sys.get_sys_info
device manufacturer as reported by sys.get_sys_info
system name as reported by sys.get_sys_info
system version as reported by sys.get_sys_info
system language as reported by sys.get_sys_info
system device language as reported by sys.get_sys_info
system territory as reported by sys.get_sys_info
android build fingerprint
The max number of sysfields.
The max number of user fields.
The max size of a single user field.