| Index: src/trusted/validator_mips/validation-report.py
 | 
| diff --git a/src/trusted/validator_mips/validation-report.py b/src/trusted/validator_mips/validation-report.py
 | 
| new file mode 100755
 | 
| index 0000000000000000000000000000000000000000..cc7373dee3673d647e140f5e35f46ad9e66a98cd
 | 
| --- /dev/null
 | 
| +++ b/src/trusted/validator_mips/validation-report.py
 | 
| @@ -0,0 +1,124 @@
 | 
| +#!/usr/bin/python
 | 
| +#
 | 
| +# Copyright (c) 2012 The Native Client Authors. All rights reserved.
 | 
| +# Use of this source code is governed by a BSD-style license that can be
 | 
| +# found in the LICENSE file.
 | 
| +#
 | 
| +
 | 
| +import sys
 | 
| +import os
 | 
| +import textwrap
 | 
| +from subprocess import Popen, PIPE
 | 
| +
 | 
| +_OBJDUMP = 'mips-linux-gnu-objdump'
 | 
| +
 | 
| +
 | 
| +def _objdump(binary, vaddr, ctx_before, ctx_after):
 | 
| +    args = [
 | 
| +        _OBJDUMP,
 | 
| +        '-d',
 | 
| +        '-G',
 | 
| +        binary,
 | 
| +        '--start-address=0x%08X' % (vaddr - (4 * ctx_before)),
 | 
| +        '--stop-address=0x%08X' % (vaddr + 4 + (4 * ctx_after))]
 | 
| +    highlight = ctx_before
 | 
| +    lines = 0
 | 
| +    for line in Popen(args, stdout=PIPE).stdout.read().split('\n'):
 | 
| +        if line.startswith(' '):
 | 
| +            if highlight == 0:
 | 
| +                print '--> ', line
 | 
| +            else:
 | 
| +                print '    ', line
 | 
| +            highlight -= 1
 | 
| +            lines += 1
 | 
| +    if not lines:
 | 
| +        print '    (not found)'
 | 
| +
 | 
| +
 | 
| +def _problem_info(code):
 | 
| +    return {
 | 
| +        'kProblemUnsafe': ['Instruction is unsafe', 0, 0],
 | 
| +        'kProblemBranchSplitsPattern': ['The destination of this branch is '
 | 
| +            'at middle of an pseudo-instruction that must be executed in full',
 | 
| +            0, 0],
 | 
| +        'kProblemPatternCrossesBundle': ['This instruction is part of a '
 | 
| +            'sequence that must execute in full, but it spans a bundle edge '
 | 
| +            '-- so an indirect branch may target it',
 | 
| +            1, 1],
 | 
| +        'kProblemBranchInvalidDest': ['This branch targets a location that is '
 | 
| +            'outside of the application\'s executable code, over 256 MB',
 | 
| +            0, 0],
 | 
| +        'kProblemUnsafeLoadStore': ['This load/store instruction is not '
 | 
| +            'preceded by a valid store mask instruction',
 | 
| +            1, 0],
 | 
| +        'kProblemUnsafeJumpRegister': ['This indirect jump instruction is not '
 | 
| +            'preceded by a valid jump mask instruction',
 | 
| +            1, 0],
 | 
| +        'kProblemUnsafeDataWrite': ['This instruction affects a register that '
 | 
| +            'must contain a valid data-region address (sp), but is not '
 | 
| +            'followed by a valid store mask instruction',
 | 
| +            0, 1],
 | 
| +        'kProblemReadOnlyRegister': ['This instruction changes the contents of'
 | 
| +            ' read-only register',
 | 
| +            0, 0],
 | 
| +        'kProblemMisalignedCall': ['This linking branch/jump instruction is '
 | 
| +            'not at the bundle offset +8, so when its RA result is masked, the'
 | 
| +            ' caller will not return to the next instruction (start of next '
 | 
| +            'bundle)',
 | 
| +            0, 0],
 | 
| +        'kProblemUnalignedJumpToTrampoline':['The destination of this '
 | 
| +            'jump/branch instruction is in trampoline code section but '
 | 
| +            'address is not bundle aligned',
 | 
| +            0, 0],
 | 
| +        'kProblemDataRegInDelaySlot':['This instruction changes value of a '
 | 
| +            'stack pointer but is located in the delay slot of jump/branch',
 | 
| +            1, 0],
 | 
| +    }[code]
 | 
| +
 | 
| +
 | 
| +def _safety_msg(val):
 | 
| +    return {
 | 
| +        0: 'UNKNOWN',  # Should not appear
 | 
| +        1: 'is undefined',
 | 
| +        2: 'has unpredictable effects',
 | 
| +        3: 'is deprecated',
 | 
| +        4: 'is forbidden',
 | 
| +        5: 'uses forbidden operands',
 | 
| +    }[val]
 | 
| +
 | 
| +
 | 
| +def _explain_problem(binary, vaddr, safety, code, ref_vaddr):
 | 
| +    msg, ctx_before, ctx_after = _problem_info(code)
 | 
| +    if safety == 6:
 | 
| +        msg = "At %08X: %s:" % (vaddr, msg)
 | 
| +    else:
 | 
| +        msg = ("At %08X: %s (%s):"
 | 
| +            % (vaddr, msg, _safety_msg(safety)))
 | 
| +    print '\n'.join(textwrap.wrap(msg, 70, subsequent_indent='  '))
 | 
| +    _objdump(binary, vaddr, ctx_before, ctx_after)
 | 
| +    if ref_vaddr:
 | 
| +        print "Destination address %08X:" % ref_vaddr
 | 
| +        _objdump(binary, ref_vaddr, 1, 1)
 | 
| +
 | 
| +
 | 
| +def _parse_report(line):
 | 
| +    vaddr_hex, safety, code, ref_vaddr_hex = line.split()
 | 
| +    return (int(vaddr_hex, 16), int(safety), code, int(ref_vaddr_hex, 16))
 | 
| +
 | 
| +
 | 
| +def main(argv):
 | 
| +    if len(argv) != 2:
 | 
| +        sys.stderr.write('Error, provide one parameter to the script.\n')
 | 
| +        return 1
 | 
| +    if not os.path.exists(sys.argv[1]):
 | 
| +        sys.stderr.write('Error, input file does not exist.\n')
 | 
| +        return 1
 | 
| +    for line in sys.stdin:
 | 
| +        if line.startswith('ncval: '):
 | 
| +            line = line[7:].strip()
 | 
| +            _explain_problem(sys.argv[1], *_parse_report(line))
 | 
| +    return 0
 | 
| +
 | 
| +
 | 
| +if __name__ == '__main__':
 | 
| +  sys.exit(main(sys.argv))
 | 
| 
 |