Native crash logging functions and constants.
android build fingerprint
system device language as reported by sys.get_sys_info
device model as reported by sys.get_sys_info
engine version as hash
engine version as release number
system language as reported by sys.get_sys_info
device manufacturer as reported by sys.get_sys_info
The max number of sysfields.
system name as reported by sys.get_sys_info
system version as reported by sys.get_sys_info
system territory as reported by sys.get_sys_info
The max number of user fields.
The max size of a single user field.
read backtrace recorded in a loaded crash dump
A table is returned containing the addresses of the call stack.
handle -
number crash dump handle
backtrace -
table table containing the backtrace
read text blob recorded in a crash dump
The format of read text blob is platform specific and not guaranteed but can be useful for manual inspection.
handle -
number crash dump handle
blob -
string string with the platform specific data
get all loaded modules from when the crash occured
The function returns a table containing entries with sub-tables that have fields 'name' and 'address' set for all loaded modules.
handle -
number crash dump handle
modules -
table module table
read signal number from a crash report
handle -
number crash dump handle
signal -
number signal number
reads a system field from a loaded crash dump
handle -
number crash dump handle
index -
number system field enum. Must be less than crash.SYSFIELD_MAX
value -
string value recorded in the crash dump, or nil if it didn't exist
reads user field from a loaded crash dump
handle -
number crash dump handle
index -
number user data slot index
value -
string user data value recorded in the crash dump
loads a previously written crash dump
The crash dump will be removed from disk upon a successful load, so loading is one-shot.
handle -
number handle to the loaded dump, or nil if no dump was found
releases a previously loaded crash dump
handle -
number handle to loaded crash dump
sets the file location for crash dumps
Crashes occuring before the path is set will be stored to a default engine location.
path -
string file path to use
stores user-defined string value
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 -
number slot index. 0-indexed
value -
string string value to store
writes crash dump
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