1
# Copyright (C) 2007, 2009, 2010 Canonical Ltd
2
# Authors: Robert Collins <robert.collins@canonical.com>
4
# This program is free software; you can redistribute it and/or modify
5
# it under the terms of the GNU General Public License as published by
6
# the Free Software Foundation; either version 2 of the License, or
7
# (at your option) any later version.
9
# This program is distributed in the hope that it will be useful,
10
# but WITHOUT ANY WARRANTY; without even the implied warranty of
11
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
# GNU General Public License for more details.
14
# You should have received a copy of the GNU General Public License
15
# along with this program; if not, write to the Free Software
16
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18
"""Support for running strace against the current process."""
20
from __future__ import absolute_import
27
from bzrlib import errors
30
def strace(function, *args, **kwargs):
31
"""Invoke strace on function.
33
:return: a tuple: function-result, a StraceResult.
35
return strace_detailed(function, args, kwargs)
38
def strace_detailed(function, args, kwargs, follow_children=True):
39
# FIXME: strace is buggy
40
# (https://bugs.launchpad.net/ubuntu/+source/strace/+bug/103133) and the
41
# test suite hangs if the '-f' is given to strace *and* more than one
42
# thread is running. Using follow_children=False allows the test suite to
43
# disable fork following to work around the bug.
45
# capture strace output to a file
46
log_file = tempfile.NamedTemporaryFile()
47
log_file_fd = log_file.fileno()
48
err_file = tempfile.NamedTemporaryFile()
51
strace_cmd = ['strace', '-r', '-tt', '-p', str(pid), '-o', log_file.name]
53
strace_cmd.append('-f')
54
# need to catch both stdout and stderr to work around
56
proc = subprocess.Popen(strace_cmd,
57
stdout=subprocess.PIPE,
58
stderr=err_file.fileno())
59
# Wait for strace to attach
60
attached_notice = proc.stdout.readline()
61
# Run the function to strace
62
result = function(*args, **kwargs)
64
os.kill(proc.pid, signal.SIGQUIT)
72
err_messages = err_file.read()
75
if err_messages.startswith("attach: ptrace(PTRACE_ATTACH,"):
76
raise StraceError(err_messages=err_messages)
77
return result, StraceResult(log, err_messages)
80
class StraceError(errors.BzrError):
82
_fmt = "strace failed: %(err_messages)s"
85
class StraceResult(object):
86
"""The result of stracing a function."""
88
def __init__(self, raw_log, err_messages):
89
"""Create a StraceResult.
91
:param raw_log: The output that strace created.
93
self.raw_log = raw_log
94
self.err_messages = err_messages