2010-08-03 05:26:00 +08:00
|
|
|
"""
|
2010-10-09 01:21:27 +08:00
|
|
|
Test some lldb help commands.
|
2010-08-03 05:26:00 +08:00
|
|
|
|
|
|
|
See also CommandInterpreter::OutputFormattedHelpText().
|
|
|
|
"""
|
2010-06-26 07:15:47 +08:00
|
|
|
|
2010-07-01 08:18:39 +08:00
|
|
|
import os, time
|
2010-08-06 07:42:46 +08:00
|
|
|
import unittest2
|
2010-07-03 11:41:59 +08:00
|
|
|
import lldb
|
2010-08-10 07:44:24 +08:00
|
|
|
from lldbtest import *
|
2010-06-26 07:15:47 +08:00
|
|
|
|
2010-09-02 03:59:58 +08:00
|
|
|
class HelpCommandTestCase(TestBase):
|
2010-06-26 07:15:47 +08:00
|
|
|
|
2010-07-03 11:41:59 +08:00
|
|
|
mydir = "help"
|
2010-06-26 07:15:47 +08:00
|
|
|
|
|
|
|
def test_simplehelp(self):
|
|
|
|
"""A simple test of 'help' command and its output."""
|
2010-08-21 03:17:39 +08:00
|
|
|
self.expect("help",
|
|
|
|
startstr = 'The following is a list of built-in, permanent debugger commands')
|
2010-06-29 04:55:57 +08:00
|
|
|
|
2011-09-10 01:49:36 +08:00
|
|
|
self.expect("help", matching=False,
|
|
|
|
substrs = ['next'])
|
|
|
|
|
|
|
|
self.expect("help -a", matching=True,
|
|
|
|
substrs = ['next'])
|
|
|
|
|
|
|
|
def test_help_on_help(self):
|
|
|
|
"""Testing the help on the help facility."""
|
|
|
|
self.expect("help help", matching=True,
|
|
|
|
substrs = ['--show-aliases',
|
|
|
|
'--hide-user-commands'])
|
|
|
|
|
2011-01-06 08:03:01 +08:00
|
|
|
def version_number_string(self):
|
|
|
|
"""Helper function to find the version number string of lldb."""
|
2011-06-21 03:06:45 +08:00
|
|
|
plist = os.path.join(os.environ["LLDB_SRC"], "resources", "LLDB-Info.plist")
|
2011-01-06 08:03:01 +08:00
|
|
|
try:
|
|
|
|
CFBundleVersionSegFound = False
|
|
|
|
with open(plist, 'r') as f:
|
|
|
|
for line in f:
|
|
|
|
if CFBundleVersionSegFound:
|
|
|
|
version_line = line.strip()
|
|
|
|
import re
|
|
|
|
m = re.match("<string>(.*)</string>", version_line)
|
|
|
|
if m:
|
|
|
|
version = m.group(1)
|
|
|
|
return version
|
|
|
|
else:
|
|
|
|
# Unsuccessful, let's juts break out of the for loop.
|
|
|
|
break
|
|
|
|
|
|
|
|
if line.find("<key>CFBundleVersion</key>") != -1:
|
|
|
|
# Found our match. The next line contains our version
|
|
|
|
# string, for example:
|
|
|
|
#
|
|
|
|
# <string>38</string>
|
|
|
|
CFBundleVersionSegFound = True
|
|
|
|
|
|
|
|
except:
|
|
|
|
# Just fallthrough...
|
2011-01-07 08:17:44 +08:00
|
|
|
import traceback
|
|
|
|
traceback.print_exc()
|
2011-01-06 08:03:01 +08:00
|
|
|
pass
|
|
|
|
|
|
|
|
# Use None to signify that we are not able to grok the version number.
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
2012-05-26 08:32:39 +08:00
|
|
|
def test_help_arch(self):
|
|
|
|
"""Test 'help arch' which should list of supported architectures."""
|
|
|
|
self.expect("help arch",
|
|
|
|
substrs = ['arm', 'x86_64', 'i386'])
|
|
|
|
|
2010-12-24 04:21:44 +08:00
|
|
|
def test_help_version(self):
|
|
|
|
"""Test 'help version' and 'version' commands."""
|
|
|
|
self.expect("help version",
|
|
|
|
substrs = ['Show version of LLDB debugger.'])
|
2011-01-06 08:03:01 +08:00
|
|
|
version_str = self.version_number_string()
|
2011-08-27 07:50:10 +08:00
|
|
|
import re
|
|
|
|
match = re.match('[0-9]+', version_str)
|
2013-03-01 00:51:15 +08:00
|
|
|
if sys.platform.startswith("darwin"):
|
2013-04-03 08:04:27 +08:00
|
|
|
search_regexp = ['lldb-' + (version_str if match else '[0-9]+')]
|
2013-03-01 00:51:15 +08:00
|
|
|
else:
|
|
|
|
search_regexp = ['lldb version (\d|\.)+.*$']
|
|
|
|
|
2010-12-24 04:21:44 +08:00
|
|
|
self.expect("version",
|
2013-03-01 00:51:15 +08:00
|
|
|
patterns = search_regexp)
|
2010-12-24 04:21:44 +08:00
|
|
|
|
2011-07-15 06:20:12 +08:00
|
|
|
def test_help_should_not_crash_lldb(self):
|
|
|
|
"""Command 'help disasm' should not crash lldb."""
|
|
|
|
self.runCmd("help disasm", check=False)
|
|
|
|
self.runCmd("help unsigned-integer")
|
|
|
|
|
2010-06-29 04:55:57 +08:00
|
|
|
def test_help_should_not_hang_emacsshell(self):
|
2010-09-08 00:19:35 +08:00
|
|
|
"""Command 'settings set term-width 0' should not hang the help command."""
|
2012-08-23 01:17:09 +08:00
|
|
|
self.expect("settings set term-width 0",
|
|
|
|
COMMAND_FAILED_AS_EXPECTED, error=True,
|
|
|
|
substrs = ['error: 0 is out of range, valid values must be between'])
|
|
|
|
# self.runCmd("settings set term-width 0")
|
2010-08-21 03:17:39 +08:00
|
|
|
self.expect("help",
|
|
|
|
startstr = 'The following is a list of built-in, permanent debugger commands')
|
2010-06-26 07:15:47 +08:00
|
|
|
|
2012-05-08 07:04:49 +08:00
|
|
|
def test_help_breakpoint_set(self):
|
|
|
|
"""Test that 'help breakpoint set' does not print out redundant lines of:
|
|
|
|
'breakpoint set [-s <shlib-name>] ...'."""
|
|
|
|
self.expect("help breakpoint set", matching=False,
|
|
|
|
substrs = ['breakpoint set [-s <shlib-name>]'])
|
|
|
|
|
2010-10-09 01:21:27 +08:00
|
|
|
def test_help_image_dump_symtab_should_not_crash(self):
|
|
|
|
"""Command 'help image dump symtab' should not crash lldb."""
|
2011-05-04 07:55:05 +08:00
|
|
|
# 'image' is an alias for 'target modules'.
|
2010-10-09 01:21:27 +08:00
|
|
|
self.expect("help image dump symtab",
|
2011-05-04 07:18:45 +08:00
|
|
|
substrs = ['dump symtab',
|
2010-10-09 01:21:27 +08:00
|
|
|
'sort-order'])
|
|
|
|
|
2010-12-02 03:10:59 +08:00
|
|
|
def test_help_image_du_sym_is_ambiguous(self):
|
|
|
|
"""Command 'help image du sym' is ambiguous and spits out the list of candidates."""
|
|
|
|
self.expect("help image du sym",
|
|
|
|
COMMAND_FAILED_AS_EXPECTED, error=True,
|
|
|
|
substrs = ['error: ambiguous command image du sym',
|
|
|
|
'symfile',
|
|
|
|
'symtab'])
|
|
|
|
|
|
|
|
def test_help_image_du_line_should_work(self):
|
|
|
|
"""Command 'help image du line' is not ambiguous and should work."""
|
2011-05-04 07:55:05 +08:00
|
|
|
# 'image' is an alias for 'target modules'.
|
2010-12-02 03:10:59 +08:00
|
|
|
self.expect("help image du line",
|
2013-07-04 01:58:31 +08:00
|
|
|
substrs = ['Dump the debug symbol file for one or more target modules'])
|
2010-12-02 03:10:59 +08:00
|
|
|
|
2011-08-23 06:22:00 +08:00
|
|
|
def test_help_target_variable_syntax(self):
|
|
|
|
"""Command 'help target variable' should display <variable-name> ..."""
|
|
|
|
self.expect("help target variable",
|
|
|
|
substrs = ['<variable-name> [<variable-name> [...]]'])
|
|
|
|
|
2011-09-24 01:57:49 +08:00
|
|
|
def test_help_watchpoint_and_its_args(self):
|
|
|
|
"""Command 'help watchpoint', 'help watchpt-id', and 'help watchpt-id-list' should work."""
|
|
|
|
self.expect("help watchpoint",
|
|
|
|
substrs = ['delete', 'disable', 'enable', 'list'])
|
|
|
|
self.expect("help watchpt-id",
|
|
|
|
substrs = ['<watchpt-id>'])
|
|
|
|
self.expect("help watchpt-id-list",
|
|
|
|
substrs = ['<watchpt-id-list>'])
|
|
|
|
|
2012-02-08 09:13:31 +08:00
|
|
|
def test_help_watchpoint_set(self):
|
2012-02-09 06:37:48 +08:00
|
|
|
"""Test that 'help watchpoint set' prints out 'expression' and 'variable'
|
|
|
|
as the possible subcommands."""
|
2012-02-08 09:13:31 +08:00
|
|
|
self.expect("help watchpoint set",
|
2012-02-09 06:37:48 +08:00
|
|
|
substrs = ['The following subcommands are supported:'],
|
|
|
|
patterns = ['expression +--',
|
|
|
|
'variable +--'])
|
2012-02-08 09:13:31 +08:00
|
|
|
|
2010-06-26 07:15:47 +08:00
|
|
|
|
|
|
|
if __name__ == '__main__':
|
2010-08-06 05:23:45 +08:00
|
|
|
import atexit
|
2010-06-30 03:44:16 +08:00
|
|
|
lldb.SBDebugger.Initialize()
|
2010-08-06 05:23:45 +08:00
|
|
|
atexit.register(lambda: lldb.SBDebugger.Terminate())
|
2010-08-06 07:42:46 +08:00
|
|
|
unittest2.main()
|