14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18
17
"""Handling and reporting crashes.
20
19
A crash is an exception propagated up almost to the top level of Bazaar.
22
21
If we have apport <https://launchpad.net/apport/>, we store a report of the
23
crash using apport into it's /var/crash spool directory, from where the user
22
crash using apport into its /var/crash spool directory, from where the user
24
23
can either manually send it to Launchpad. In some cases (at least Ubuntu
25
24
development releases), Apport may pop up a window asking if they want
33
32
In principle apport can run on any platform though as of Feb 2010 there seem
34
33
to be some portability bugs.
36
To force this off in bzr turn set APPORT_DISABLE in the environment or
35
To force this off in brz turn set APPORT_DISABLE in the environment or
40
# for interactive testing, try the 'bzr assert-fail' command
39
from __future__ import absolute_import
41
# for interactive testing, try the 'brz assert-fail' command
41
42
# or see http://code.launchpad.net/~mbp/bzr/bzr-fail
43
44
# to test with apport it's useful to set
68
71
if report_bug_to_apport(exc_info, stderr):
69
72
# wrote a file; if None then report the old way
71
except ImportError, e:
74
except ImportError as e:
72
75
trace.mutter("couldn't find apport bug-reporting library: %s" % e)
76
except Exception as e:
75
77
# this should only happen if apport is installed but it didn't
76
78
# work, eg because of an io error writing the crash file
77
stderr.write("bzr: failed to report crash using apport:\n "
79
trace.mutter("brz: failed to report crash using apport: %r" % e)
80
trace.log_exception_quietly()
80
81
return report_bug_legacy(exc_info, stderr)
84
85
"""Report a bug by just printing a message to the user."""
85
86
trace.print_exception(exc_info, err_file)
86
87
err_file.write('\n')
87
err_file.write('bzr %s on python %s (%s)\n' % \
89
bzrlib._format_version_tuple(sys.version_info),
90
platform.platform(aliased=1)))
91
err_file.write('arguments: %r\n' % sys.argv)
90
err_file.write(textwrap.fill(l,
91
width=78, subsequent_indent=' ') + '\n')
92
print_wrapped('brz %s on python %s (%s)\n' % \
94
breezy._format_version_tuple(sys.version_info),
95
platform.platform(aliased=1)))
96
print_wrapped('arguments: %r\n' % sys.argv)
97
print_wrapped(textwrap.fill(
98
'plugins: ' + plugin.format_concise_plugin_list(),
100
subsequent_indent=' ',
93
103
'encoding: %r, fsenc: %r, lang: %r\n' % (
94
104
osutils.get_user_encoding(), sys.getfilesystemencoding(),
95
105
os.environ.get('LANG')))
96
err_file.write("plugins:\n")
97
err_file.write(_format_plugin_list())
106
# We used to show all the plugins here, but it's too verbose.
100
109
"*** Bazaar has encountered an internal error. This probably indicates a\n"
101
110
" bug in Bazaar. You can help us fix it by filing a bug report at\n"
102
" https://bugs.launchpad.net/bzr/+filebug\n"
111
" https://bugs.launchpad.net/brz/+filebug\n"
103
112
" including this traceback and a description of the problem.\n"
112
121
# this function is based on apport_package_hook.py, but omitting some of the
113
122
# Ubuntu-specific policy about what to report and when
115
# if the import fails, the exception will be caught at a higher level and
116
# we'll report the error by other means
124
# This import is apparently not used, but we're doing it so that if the
125
# import fails, the exception will be caught at a higher level and we'll
126
# report the error by other means.
119
129
crash_filename = _write_apport_report_to_file(exc_info)
121
131
if crash_filename is None:
122
132
stderr.write("\n"
123
"apport is set to ignore crashes in this version of bzr.\n"
133
"apport is set to ignore crashes in this version of brz.\n"
126
136
trace.print_exception(exc_info, stderr)
143
153
exc_type, exc_object, exc_tb = exc_info
146
# add_proc_info gives you the memory map of the process, which is not so
147
# useful for Bazaar but does tell you what binary libraries are loaded.
148
# More importantly it sets the ExecutablePath, InterpreterPath, etc.
156
# add_proc_info sets the ExecutablePath, InterpreterPath, etc.
149
157
pr.add_proc_info()
158
# It also adds ProcMaps which for us is rarely useful and mostly noise, so
150
161
pr.add_user_info()
152
163
# Package and SourcePackage are needed so that apport will report about even
153
# non-packaged versions of bzr; also this reports on their packaged
164
# non-packaged versions of brz; also this reports on their packaged
154
165
# dependencies which is useful.
155
pr['SourcePackage'] = 'bzr'
156
pr['Package'] = 'bzr'
166
pr['SourcePackage'] = 'brz'
167
pr['Package'] = 'brz'
158
169
pr['CommandLine'] = pprint.pformat(sys.argv)
159
pr['BzrVersion'] = bzrlib.__version__
160
pr['PythonVersion'] = bzrlib._format_version_tuple(sys.version_info)
170
pr['BrzVersion'] = breezy.__version__
171
pr['PythonVersion'] = breezy._format_version_tuple(sys.version_info)
161
172
pr['Platform'] = platform.platform(aliased=1)
162
173
pr['UserEncoding'] = osutils.get_user_encoding()
163
174
pr['FileSystemEncoding'] = sys.getfilesystemencoding()
164
pr['Locale'] = os.environ.get('LANG')
165
pr['BzrPlugins'] = _format_plugin_list()
175
pr['Locale'] = os.environ.get('LANG', 'C')
176
pr['BrzPlugins'] = _format_plugin_list()
166
177
pr['PythonLoadedModules'] = _format_module_list()
167
pr['BzrDebugFlags'] = pprint.pformat(debug.debug_flags)
178
pr['BrzDebugFlags'] = pprint.pformat(debug.debug_flags)
169
180
# actually we'd rather file directly against the upstream product, but
170
181
# apport does seem to count on there being one in there; we might need to
171
182
# redirect it elsewhere anyhow
172
pr['SourcePackage'] = 'bzr'
173
pr['Package'] = 'bzr'
183
pr['SourcePackage'] = 'brz'
184
pr['Package'] = 'brz'
175
# tell apport to file directly against the bzr package using
176
# <https://bugs.edge.launchpad.net/bzr/+bug/391015>
186
# tell apport to file directly against the brz package using
187
# <https://bugs.launchpad.net/bzr/+bug/391015>
178
189
# XXX: unfortunately apport may crash later if the crashdb definition
179
190
# file isn't present
180
pr['CrashDb'] = 'bzr'
191
pr['CrashDb'] = 'brz'
182
193
tb_file = StringIO()
183
194
traceback.print_exception(exc_type, exc_object, exc_tb, file=tb_file)
186
197
_attach_log_tail(pr)
188
# We want to use the 'bzr' crashdb so that it gets sent directly upstream,
199
# We want to use the 'brz' crashdb so that it gets sent directly upstream,
189
200
# which is a reasonable default for most internal errors. However, if we
190
201
# set it here then apport will crash later if it doesn't know about that
191
# crashdb. Instead, we rely on the bzr package installing both a
202
# crashdb. Instead, we rely on the brz package installing both a
192
203
# source hook telling crashes to go to this crashdb, and a crashdb
193
204
# configuration describing it.
196
207
# TODO: strip that out and attach the rest
198
209
#attach_file_if_exists(report,
199
# os.path.join(dot_bzr, 'bazaar.conf', 'BzrConfig')
210
# os.path.join(dot_brz, 'breezy.conf', 'BrzConfig')
200
211
#attach_file_if_exists(report,
201
# os.path.join(dot_bzr, 'locations.conf', 'BzrLocations')
212
# os.path.join(dot_brz, 'locations.conf', 'BrzLocations')
203
214
# strip username, hostname, etc
216
227
def _attach_log_tail(pr):
218
bzr_log = open(trace._get_bzr_log_filename(), 'rt')
219
except (IOError, OSError), e:
220
pr['BzrLogTail'] = repr(e)
229
brz_log = open(trace._get_brz_log_filename(), 'rt')
230
except (IOError, OSError) as e:
231
pr['BrzLogTail'] = repr(e)
223
lines = bzr_log.readlines()
224
pr['BzrLogTail'] = ''.join(lines[-40:])
234
lines = brz_log.readlines()
235
pr['BrzLogTail'] = ''.join(lines[-40:])
229
240
def _open_crash_file():
232
243
# on unix this should be /var/crash and should already exist; on
233
244
# Windows or if it's manually configured it might need to be created,
234
245
# and then it should be private
235
os.makedirs(crash_dir, mode=0600)
246
os.makedirs(crash_dir, mode=0o600)
236
247
date_string = time.strftime('%Y-%m-%dT%H:%M', time.gmtime())
237
248
# XXX: getuid doesn't work on win32, but the crash directory is per-user
238
249
if sys.platform == 'win32':
249
260
return filename, os.fdopen(
250
261
os.open(filename,
251
262
os.O_WRONLY|os.O_CREAT|os.O_EXCL,
256
267
def _format_plugin_list():
258
for name, a_plugin in sorted(plugin.plugins().items()):
259
plugin_lines.append(" %-20s %s [%s]" %
260
(name, a_plugin.path(), a_plugin.__version__))
261
return '\n'.join(plugin_lines)
268
return ''.join(plugin.describe_plugins(show_paths=True))
264
271
def _format_module_list():