Package FuzzManager :: Package FTB :: Package Signatures :: Module CrashInfo :: Class CrashInfo
[hide private]
[frames] | no frames]

Class CrashInfo

source code


Abstract base class that provides a method to instantiate the right sub class. It also supports generating a CrashSignature based on the stored information.

Nested Classes [hide private]
  __metaclass__
Metaclass for defining Abstract Base Classes (ABCs).
Instance Methods [hide private]
 
__init__(self)
x.__init__(...) initializes x; see help(type(x)) for signature
source code
 
__str__(self)
str(x)
source code
dict
toCacheObject(self)
Create a cache object for restoring the class instance later on without parsing the crash data again.
source code
String
createShortSignature(self)
Returns: A string representing this crash (short signature)
source code
CrashSignature
createCrashSignature(self, forceCrashAddress=False, forceCrashInstruction=False, maxFrames=8, minimumSupportedVersion=13)
Returns: A crash signature object
source code

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __subclasshook__

Static Methods [hide private]
CrashInfo
fromRawCrashData(stdout, stderr, configuration, auxCrashData=None, cacheObject=None)
Create appropriate CrashInfo instance from raw crash data
source code
str
sanitizeStackFrame(frame)
This function removes function arguments and other non-generic parts of the function frame, returning a (hopefully) generic function name.
source code
Class Variables [hide private]
  __abstractmethods__ = frozenset([])
  _abc_cache = <_weakrefset.WeakSet object at 0x7ff6c7069c50>
  _abc_negative_cache = <_weakrefset.WeakSet object at 0x7ff6c70...
  _abc_negative_cache_version = 23
  _abc_registry = <_weakrefset.WeakSet object at 0x7ff6c7069b50>
Properties [hide private]

Inherited from object: __class__

Method Details [hide private]

__init__(self)
(Constructor)

source code 

x.__init__(...) initializes x; see help(type(x)) for signature

Overrides: object.__init__
(inherited documentation)

__str__(self)
(Informal representation operator)

source code 

str(x)

Overrides: object.__str__
(inherited documentation)

toCacheObject(self)

source code 

Create a cache object for restoring the class instance later on without parsing the crash data again. This object includes all class fields except for the storage heavy raw objects like stdout, stderr and raw crashdata.

Returns: dict
Dictionary containing expensive class fields

fromRawCrashData(stdout, stderr, configuration, auxCrashData=None, cacheObject=None)
Static Method

source code 

Create appropriate CrashInfo instance from raw crash data

Parameters:
  • stdout (List of strings) - List of lines as they appeared on stdout
  • stderr (List of strings) - List of lines as they appeared on stderr
  • configuration (ProgramConfiguration) - Exact program configuration that is associated with the crash
  • auxCrashData (List of strings) - Optional additional crash output (e.g. GDB). If not specified, stderr is used.
  • cacheObject (Dictionary) - The cache object that should be used to restore the class fields instead of parsing the crash data. The appropriate object can be created by calling the toCacheObject method.
Returns: CrashInfo
Crash information object

createShortSignature(self)

source code 
Returns: String
A string representing this crash (short signature)

createCrashSignature(self, forceCrashAddress=False, forceCrashInstruction=False, maxFrames=8, minimumSupportedVersion=13)

source code 
Parameters:
  • forceCrashAddress (bool) - If True, the crash address will be included in any case
  • forceCrashInstruction (bool) - If True, the crash instruction will be included in any case
  • maxFrames (int) - How many frames (at most) should be included in the signature
  • minimumSupportedVersion (int) - The minimum crash signature standard version that the generated signature should be valid for (10 => 1.0, 13 => 1.3)
Returns: CrashSignature
A crash signature object

sanitizeStackFrame(frame)
Static Method

source code 

This function removes function arguments and other non-generic parts of the function frame, returning a (hopefully) generic function name.

Parameters:
  • frame - The stack frame to sanitize
  • forceCrashAddress (str)
Returns: str
Sanitized stack frame

Class Variable Details [hide private]

_abc_negative_cache

Value:
<_weakrefset.WeakSet object at 0x7ff6c7069cd0>