utils.WindowsCoreDumpArchiver Class Reference

Inheritance diagram for utils.WindowsCoreDumpArchiver:

Public Member Functions
	__init__ (self, output_directory)
	__exit__ (self, *args)
Public Member Functions inherited from utils.BaseCoreDumpArchiver
	__enter__ (self)

Static Public Attributes
	CDBG_PROMPT_RE = re.compile(r'^\d+:\d+>')

Protected Member Functions
	_find_cdb (self)
	_dump_all_stacks (self)
	_cleanup (self)
	_find_all_coredumps (self)
	_find_coredump_file (self, crash)
	_report_missing_crashes (self, missing, throw=False)
Protected Member Functions inherited from utils.BaseCoreDumpArchiver
	_safe_cleanup (self)
	_archive (self, crashes)
	_is_shard (self)
	_get_file_name (self, file)
	_move (self, files)
	_tar (self, file)
	_upload (self, files)
	_find_unexpected_crashes (self)

Protected Attributes
	_dumps_by_pid
	_search_dir
Protected Attributes inherited from utils.BaseCoreDumpArchiver
	_bucket
	_binaries_dir
	_search_dir
	_output_directory

Additional Inherited Members
Static Protected Attributes inherited from utils.BaseCoreDumpArchiver
str	_UNEXPECTED_CRASHES_FILE = 'unexpected-crashes'

Detailed Description

Definition at line 846 of file utils.py.

Constructor & Destructor Documentation

__init__()

utils.WindowsCoreDumpArchiver.__init__	(		self,
			output_directory
	)

Reimplemented from utils.BaseCoreDumpArchiver.

Definition at line 848 of file utils.py.

    def __init__(self, output_directory):
        super(WindowsCoreDumpArchiver, self).__init__(
            WindowsCoreDumpEnabler.DUMPS_FOLDER, output_directory)
        self._dumps_by_pid = None
 

Member Function Documentation

__exit__()

utils.WindowsCoreDumpArchiver.__exit__	(		self,
		*	args
	)

Reimplemented from utils.BaseCoreDumpArchiver.

Definition at line 908 of file utils.py.

    def __exit__(self, *args):
        try:
            self._dump_all_stacks()
        except Exception as error:
            print('ERROR: Unable to dump stacks from dumps: {}'.format(error))
 
        super(WindowsCoreDumpArchiver, self).__exit__(*args)
 

_cleanup()

utils.WindowsCoreDumpArchiver._cleanup (   self )

protected

Reimplemented from utils.BaseCoreDumpArchiver.

Definition at line 916 of file utils.py.

    def _cleanup(self):
        found = super(WindowsCoreDumpArchiver, self)._cleanup()
        for core in glob.glob(os.path.join(self._search_dir, '*')):
            found = True
            TryUnlink(core)
        return found
 

_dump_all_stacks()

utils.WindowsCoreDumpArchiver._dump_all_stacks (   self )

protected

Definition at line 875 of file utils.py.

    def _dump_all_stacks(self):
        # On Windows due to crashpad integration crashes do not produce any
        # stacktraces. Dump stack traces from dumps Crashpad collected using
        # CDB (if available).
        cdb_path = self._find_cdb()
        if cdb_path is None:
            return
 
        dumps = self._find_all_coredumps()
        if not dumps:
            return
 
        print('### Collected {} crash dumps'.format(len(dumps)))
        for dump in dumps:
            print()
            print('### Dumping stacks from {} using CDB'.format(dump))
            cdb_output = subprocess.check_output(
                '"{}" -z "{}" -kqm -c "!uniqstack -b -v -p;qd"'.format(
                    cdb_path, dump),
                stderr=subprocess.STDOUT)
            # Extract output of uniqstack from the whole output of CDB.
            output = False
            for line in cdb_output.split('\n'):
                if re.match(WindowsCoreDumpArchiver.CDBG_PROMPT_RE, line):
                    output = True
                elif line.startswith('quit:'):
                    break
                elif output:
                    print(line)
        print()
        print('#############################################')
        print()
 

_find_all_coredumps()

utils.WindowsCoreDumpArchiver._find_all_coredumps (   self )

protected

Return coredumps that were recorded (if supported by the platform).
This method will be overridden by concrete platform specific implementations.

Reimplemented from utils.BaseCoreDumpArchiver.

Definition at line 923 of file utils.py.

    def _find_all_coredumps(self):
        pattern = os.path.join(self._search_dir, '*.dmp')
        return [core_filename for core_filename in glob.glob(pattern)]
 

_find_cdb()

utils.WindowsCoreDumpArchiver._find_cdb (   self )

protected

Definition at line 854 of file utils.py.

    def _find_cdb(self):
        win_toolchain_json_path = os.path.join(DART_DIR, 'build',
                                               'win_toolchain.json')
        if not os.path.exists(win_toolchain_json_path):
            return None
 
        with open(win_toolchain_json_path, 'r') as f:
            win_toolchain_info = json.loads(f.read())
 
        win_sdk_path = win_toolchain_info['win_sdk']
 
        # We assume that we are running on 64-bit Windows.
        # Note: x64 CDB can work with both X64 and IA32 dumps.
        cdb_path = os.path.join(win_sdk_path, 'Debuggers', 'x64', 'cdb.exe')
        if not os.path.exists(cdb_path):
            return None
 
        return cdb_path
 

_find_coredump_file()

utils.WindowsCoreDumpArchiver._find_coredump_file (   self,   crash  )

protected

Definition at line 927 of file utils.py.

    def _find_coredump_file(self, crash):
        if self._dumps_by_pid is None:
            # If this function is invoked the first time then look through the directory
            # that contains crashes for all dump files and collect pid -> filename
            # mapping.
            self._dumps_by_pid = {}
            minidump = GetMinidumpUtils()
            pattern = os.path.join(self._search_dir, '*.dmp')
            for core_filename in glob.glob(pattern):
                pid = minidump.GetProcessIdFromDump(core_filename)
                if pid != -1:
                    self._dumps_by_pid[str(pid)] = core_filename
        if crash.pid in self._dumps_by_pid:
            return self._dumps_by_pid[crash.pid]
 

_report_missing_crashes()

utils.WindowsCoreDumpArchiver._report_missing_crashes (   self,   missing,   throw = False  )

protected

Reimplemented from utils.BaseCoreDumpArchiver.

Definition at line 942 of file utils.py.

    def _report_missing_crashes(self, missing, throw=False):
        # Let's only print the debugging information and not throw. We'll do more
        # validation for werfault.exe and throw afterwards.
        super(WindowsCoreDumpArchiver, self)._report_missing_crashes(
            missing, throw=False)
 
        if throw:
            missing_as_string = ', '.join([str(c) for c in missing])
            raise Exception(
                'Missing crash dumps for: {}'.format(missing_as_string))
 
 

Member Data Documentation

_dumps_by_pid

utils.WindowsCoreDumpArchiver._dumps_by_pid

protected

Definition at line 851 of file utils.py.

_search_dir

utils.WindowsCoreDumpArchiver._search_dir

protected

Definition at line 918 of file utils.py.

CDBG_PROMPT_RE

utils.WindowsCoreDumpArchiver.CDBG_PROMPT_RE = re.compile(r'^\d+:\d+>')

static

Definition at line 873 of file utils.py.

---

The documentation for this class was generated from the following file:

• third_party/dart-lang/sdk/tools/utils.py