breakpoint断点命令

命令功能

设置、删除、查看断点。

命令格式

设置断点：

breakpoint set [-h | --help] {-f FILE_NAME | --file FILE_NAME} {-l LINE_NUMBER | --line LINE_NUMBER} [-r RANK_ID | --rank RANK_ID] [-g GROUP_ID | --group GROUP_ID] [-t THREAD_INDEX | --thread THREAD_INDEX] [-c | --condition] [-i | --ignore-count]

删除断点：

breakpoint delete [-h | --help] [-n BREAKPOINT_ID | --number BREAKPOINT_ID] [-a | --all] [-r RANK_ID | --rank RANK_ID] [-g GROUP_ID | --group GROUP_ID] [-t THREAD_INDEX | --thread THREAD_INDEX]

查看断点：

breakpoint list [-h | --help] [-r RANK_ID | --rank RANK_ID] [-g GROUP_ID | --group GROUP_ID] [-t THREAD_INDEX | --thread THREAD_INDEX]

breakpoint命令可简写为b、break。

参数说明

表1 set命令参数说明
参数	参数选项	参数说明
-h/--help	-	可选参数，获取帮助信息。
-f/--file	FILE_NAME	必选参数，指定调试源码文件路径。
-l/--line	LINE_NUMBER	必选参数，指定文件中断点所在行。
-r/--rank	RANK_ID	可选参数，指定rank ID。
-g/--group	GROUP_ID	可选参数，指定group ID。说明：在Attach模式下不支持使用-g/--group参数。
-t/--thread	THREAD_INDEX	可选参数，指定线程索引。
-c/--condition	CONDITION	可选参数，指定条件断点表达式。例如：x>10
-i/--ignore-count	IGNORE_COUNT	可选参数，指定条件断点命中忽略次数。例如：2

表2 delete命令参数说明
参数	参数选项	参数说明
-h/--help	-	可选参数，获取帮助信息。
-n/--number	BREAKPOINT_ID	可选参数，指定需要删除的断点ID，与-a参数冲突。
-a/--all	-	可选参数，删除全部断点，与-n参数冲突。说明： -n和-a参数不能同时指定，也不能同时不指定。
-r/--rank	RANK_ID	可选参数，指定rank ID。
-g/--group	GROUP_ID	可选参数，指定group ID。说明：在Attach模式下不支持使用-g/--group参数。
-t/--thread	THREAD_INDEX	可选参数，指定线程索引。

表3 list命令参数说明
参数	参数选项	参数说明
-h/--help	-	可选参数，获取帮助信息。
-r/--rank	RANK_ID	可选参数，指定rank ID。
-g/--group	GROUP_ID	可选参数，指定group ID。说明：在Attach模式下不支持使用-g/--group参数。
-t/--thread	THREAD_INDEX	可选参数，指定线程索引。

使用示例

执行以下命令，查看断点支持的功能信息：

1	breakpoint -h

返回信息如下：

The most commonly used breakpoint(b/break) sub commands are:
   set                 Adds breakpoints.
   list                Views breakpoints.
   delete              Deletes breakpoints.

 See 'breakpoint(b/break) COMMAND -h/--help' for more information on a specific command.

父主题： 调试状态命令