← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/strace.py

  • Committer: Martin Packman
  • Date: 2011-11-24 17:01:07 UTC
  • mto: This revision was merged to the branch mainline in revision 6304.
  • Revision ID: martin.packman@canonical.com-20111124170107-b3yd5vkzdglmnjk7
Allow a bracketed suffix in option help test

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/strace.py
 
1
# Copyright (C) 2007, 2009, 2010 Canonical Ltd
 
2
#   Authors: Robert Collins <robert.collins@canonical.com>
 
3
#
 
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.
 
8
#
 
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.
 
13
#
 
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
 
17
 
 
18
"""Support for running strace against the current process."""
 
19
 
 
20
import errno
 
21
import os
 
22
import signal
 
23
import subprocess
 
24
import tempfile
 
25
 
 
26
from bzrlib import errors
 
27
 
 
28
 
 
29
# this is currently test-focused, so importing bzrlib.tests is ok. We might
 
30
# want to move feature to its own module though.
 
31
from bzrlib.tests.features import Feature
 
32
 
 
33
 
 
34
def strace(function, *args, **kwargs):
 
35
    """Invoke strace on function.
 
36
 
 
37
    :return: a tuple: function-result, a StraceResult.
 
38
    """
 
39
    return strace_detailed(function, args, kwargs)
 
40
 
 
41
 
 
42
def strace_detailed(function, args, kwargs, follow_children=True):
 
43
    # FIXME: strace is buggy
 
44
    # (https://bugs.launchpad.net/ubuntu/+source/strace/+bug/103133) and the
 
45
    # test suite hangs if the '-f' is given to strace *and* more than one
 
46
    # thread is running. Using follow_children=False allows the test suite to
 
47
    # disable fork following to work around the bug.
 
48
 
 
49
    # capture strace output to a file
 
50
    log_file = tempfile.NamedTemporaryFile()
 
51
    log_file_fd = log_file.fileno()
 
52
    err_file = tempfile.NamedTemporaryFile()
 
53
    pid = os.getpid()
 
54
    # start strace
 
55
    strace_cmd = ['strace', '-r', '-tt', '-p', str(pid), '-o', log_file.name]
 
56
    if follow_children:
 
57
        strace_args.append('-f')
 
58
    # need to catch both stdout and stderr to work around
 
59
    # bug 627208
 
60
    proc = subprocess.Popen(strace_cmd,
 
61
                            stdout=subprocess.PIPE,
 
62
                            stderr=err_file.fileno())
 
63
    # Wait for strace to attach
 
64
    attached_notice = proc.stdout.readline()
 
65
    # Run the function to strace
 
66
    result = function(*args, **kwargs)
 
67
    # stop strace
 
68
    os.kill(proc.pid, signal.SIGQUIT)
 
69
    proc.communicate()
 
70
    # grab the log
 
71
    log_file.seek(0)
 
72
    log = log_file.read()
 
73
    log_file.close()
 
74
    # and stderr
 
75
    err_file.seek(0)
 
76
    err_messages = err_file.read()
 
77
    err_file.close()
 
78
    # and read any errors
 
79
    if err_messages.startswith("attach: ptrace(PTRACE_ATTACH,"):
 
80
        raise StraceError(err_messages=err_messages)
 
81
    return result, StraceResult(log, err_messages)
 
82
 
 
83
 
 
84
class StraceError(errors.BzrError):
 
85
    
 
86
    _fmt = "strace failed: %(err_messages)s"
 
87
 
 
88
 
 
89
class StraceResult(object):
 
90
    """The result of stracing a function."""
 
91
 
 
92
    def __init__(self, raw_log, err_messages):
 
93
        """Create a StraceResult.
 
94
 
 
95
        :param raw_log: The output that strace created.
 
96
        """
 
97
        self.raw_log = raw_log
 
98
        self.err_messages = err_messages
 
99
 
 
100