1
# Copyright (C) 2007, 2009, 2010 Canonical Ltd
1
# Copyright (C) 2007 Canonical Ltd
2
2
# Authors: Robert Collins <robert.collins@canonical.com>
4
4
# This program is free software; you can redistribute it and/or modify
14
14
# You should have received a copy of the GNU General Public License
15
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
16
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18
18
"""Support for running strace against the current process."""
20
from __future__ import absolute_import
27
from bzrlib import errors
25
# this is currently test-focused, so importing bzrlib.tests is ok. We might
26
# want to move feature to its own module though.
27
from bzrlib.tests import Feature
30
30
def strace(function, *args, **kwargs):
33
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
35
# capture strace output to a file
46
log_file = tempfile.NamedTemporaryFile()
36
log_file = tempfile.TemporaryFile()
47
37
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
40
proc = subprocess.Popen(['strace',
41
'-f', '-r', '-tt', '-p', str(pid),
45
# TODO? confirm its started (test suite should be sufficient)
46
# (can loop on proc.pid, but that may not indicate started and attached.)
62
47
result = function(*args, **kwargs)
64
49
os.kill(proc.pid, signal.SIGQUIT)
68
53
log = log_file.read()
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"
55
return result, StraceResult(log)
85
58
class StraceResult(object):
86
59
"""The result of stracing a function."""
88
def __init__(self, raw_log, err_messages):
61
def __init__(self, raw_log):
89
62
"""Create a StraceResult.
91
64
:param raw_log: The output that strace created.
93
66
self.raw_log = raw_log
94
self.err_messages = err_messages
69
class _StraceFeature(Feature):
73
proc = subprocess.Popen(['strace'],
74
stderr=subprocess.PIPE,
75
stdout=subprocess.PIPE)
79
if e.errno == errno.ENOENT:
80
# strace is not installed
85
def feature_name(self):
88
StraceFeature = _StraceFeature()