"""Python sys.excepthook hook to generate apport crash dumps."""
# Copyright (c) 2006 - 2009 Canonical Ltd.
# Authors: Robert Collins <robert@ubuntu.com>
# Martin Pitt <martin.pitt@ubuntu.com>
#
# This program is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by the
# Free Software Foundation; either version 2 of the License, or (at your
# option) any later version. See http://www.gnu.org/copyleft/gpl.html for
# the full text of the license.
import sys
CONFIG = "/etc/default/apport"
def enabled():
"""Return whether Apport should generate crash reports."""
# This doesn't use apport.packaging.enabled() because it is too heavyweight
# See LP: #528355
try:
# pylint: disable=import-outside-toplevel; for Python startup time
import re
with open(CONFIG, encoding="utf-8") as config_file:
conf = config_file.read()
return re.search(r"^\s*enabled\s*=\s*0\s*$", conf, re.M) is None
except OSError:
# if the file does not exist, assume it's enabled
return True
def apport_excepthook(binary, exc_type, exc_obj, exc_tb):
# TODO: Split into smaller functions/methods
# pylint: disable=too-many-branches,too-many-locals
# pylint: disable=too-many-return-statements,too-many-statements
"""Catch an uncaught exception and make a traceback."""
# create and save a problem report. Note that exceptions in this code
# are bad, and we probably need a per-thread reentrancy guard to
# prevent that happening. However, on Ubuntu there should never be
# a reason for an exception here, other than [say] a read only var
# or some such. So what we do is use a try - finally to ensure that
# the original excepthook is invoked, and until we get bug reports
# ignore the other issues.
# import locally here so that there is no routine overhead on python
# startup time - only when a traceback occurs will this trigger.
# pylint: disable=import-outside-toplevel
try:
# ignore 'safe' exit types.
if exc_type in (KeyboardInterrupt,):
return
# do not do anything if apport was disabled
if not enabled():
return
try:
import contextlib
import io
import os
import re
import traceback
import apport.report
from apport.fileutils import (
increment_crash_counter,
likely_packaged,
should_skip_crash,
)
except (ImportError, OSError):
return
# for interactive Python sessions, sys.argv[0] == ""
if not binary:
return
binary = os.path.realpath(binary)
# filter out binaries in user accessible paths
if not likely_packaged(binary):
return
report = apport.report.Report()
# special handling of dbus-python exceptions
if hasattr(exc_obj, "get_dbus_name"):
name = exc_obj.get_dbus_name()
if name == "org.freedesktop.DBus.Error.NoReply":
# NoReply is an useless crash, we do not even get the method it
# was trying to call; needs actual crash from D-BUS backend
# (LP #914220)
return
if name == "org.freedesktop.DBus.Error.ServiceUnknown":
dbus_service_unknown_analysis(exc_obj, report)
else:
report["_PythonExceptionQualifier"] = name
# disambiguate OSErrors with errno:
if exc_type == OSError and exc_obj.errno is not None:
report["_PythonExceptionQualifier"] = str(exc_obj.errno)
# append a basic traceback. In future we may want to include
# additional data such as the local variables, loaded modules etc.
tb_file = io.StringIO()
traceback.print_exception(exc_type, exc_obj, exc_tb, file=tb_file)
report["Traceback"] = tb_file.getvalue().strip()
report.add_proc_info(extraenv=["PYTHONPATH", "PYTHONHOME"])
report.add_user_info()
# override the ExecutablePath with the script that was actually running
report["ExecutablePath"] = binary
if "ExecutableTimestamp" in report:
report["ExecutableTimestamp"] = str(int(os.stat(binary).st_mtime))
try:
report["PythonArgs"] = f"{sys.argv!r}"
except AttributeError:
pass
if report.check_ignored():
return
with contextlib.suppress(SystemError, ValueError):
report.add_package_info()
report["_HooksRun"] = "no"
report_dir = os.environ.get("APPORT_REPORT_DIR", "/var/crash")
try:
os.makedirs(report_dir, mode=0o3777, exist_ok=True)
except OSError:
return
mangled_program = re.sub("/", "_", binary)
# get the uid for now, user name later
pr_filename = f"{report_dir}/{mangled_program}.{os.getuid()}.crash"
if os.path.exists(pr_filename):
increment_crash_counter(report, pr_filename)
if should_skip_crash(report, pr_filename):
return
# remove the old file, so that we can create the new one with
# os.O_CREAT|os.O_EXCL
os.unlink(pr_filename)
with os.fdopen(
os.open(pr_filename, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o640), "wb"
) as report_file:
report.write(report_file)
finally:
# resume original processing to get the default behaviour,
# but do not trigger an AttributeError on interpreter shutdown.
if sys: # pylint: disable=using-constant-test
sys.__excepthook__(exc_type, exc_obj, exc_tb)
def dbus_service_unknown_analysis(exc_obj, report):
"""Analyze D-Bus service error and add analysis to report."""
# TODO: Split into smaller functions/methods
# pylint: disable=too-many-locals
# pylint: disable=import-outside-toplevel; for Python startup time
import re
import subprocess
from configparser import ConfigParser, NoOptionError, NoSectionError
from glob import glob
# determine D-BUS name
match = re.search(
r"name\s+(\S+)\s+was not provided by any .service", exc_obj.get_dbus_message()
)
if not match:
if sys.stderr:
sys.stderr.write(
"Error: cannot parse D-BUS name from exception: "
+ exc_obj.get_dbus_message()
)
return
dbus_name = match.group(1)
# determine .service file and Exec name for the D-BUS name
services = [] # tuples of (service file, exe name, running)
for service_file in glob("/usr/share/dbus-1/*services/*.service"):
service = ConfigParser(interpolation=None)
service.read(service_file, encoding="UTF-8")
try:
if service.get("D-BUS Service", "Name") == dbus_name:
exe = service.get("D-BUS Service", "Exec")
running = (
subprocess.call(["pidof", "-sx", exe], stdout=subprocess.PIPE) == 0
)
services.append((service_file, exe, running))
except (NoSectionError, NoOptionError):
if sys.stderr:
sys.stderr.write(
f"Invalid D-BUS .service file {service_file}:"
f" {exc_obj.get_dbus_message()}"
)
continue
if not services:
report["DbusErrorAnalysis"] = f"no service file providing {dbus_name}"
else:
report["DbusErrorAnalysis"] = "provided by"
for service, exe, running in services:
report[
"DbusErrorAnalysis"
] += f" {service} ({exe} is {'' if running else 'not '}running)"
def install():
"""Install the python apport hook."""
# Record before the program can mutate sys.argv and can call os.chdir().
binary = sys.argv[0]
if binary and not binary.startswith("/"):
# pylint: disable=import-outside-toplevel; for Python startup time
import os
try:
binary = f"{os.getcwd()}/{binary}"
except FileNotFoundError:
try:
binary = os.readlink("/proc/self/cwd")
if binary.endswith(" (deleted)"):
binary = binary[:-10]
except OSError:
return
def partial_apport_excepthook(exc_type, exc_obj, exc_tb):
return apport_excepthook(binary, exc_type, exc_obj, exc_tb)
sys.excepthook = partial_apport_excepthook
|