breakpoint

Command Function

Sets, deletes, and displays breakpoints.

Syntax

Setting a 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]

Deleting a breakpoint:

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]

Displaying breakpoints:

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

The breakpoint command can be abbreviated as b or break.

Parameter Description

**Table 1** **set** command parameters
Parameter	Description
-h/--help	Obtains help information. This parameter is optional.
-f/--file	Path to the source file to be debugged. This parameter is mandatory.
-l/--line	Line in the file, where the breakpoint is located. This parameter is mandatory.
-r/--rank	Rank ID. This parameter is optional.
-g/--group	Group ID. This parameter is optional. NOTE: The -g/--group option is not supported in Attach mode.
-t/--thread	Thread index. This parameter is optional.
-c/--condition	Conditional breakpoint expression. This parameter is optional. Example: x>10
-i/--ignore-count	Number of conditional breakpoint hits that are ignored. This parameter is optional. Example: 2

**Table 2** **delete** command parameters
Parameter	Description
-h/--help	Obtains help information. This parameter is optional.
-n/--number	ID of the breakpoint to be deleted. This parameter cannot be used together with the -a parameter. This parameter is optional.
-a/--all	Deletes all breakpoints. This parameter cannot be used together with the -n parameter. This parameter is optional. NOTE: Use either -n or -a but not both.
-r/--rank	Rank ID. This parameter is optional.
-g/--group	Group ID. This parameter is optional. NOTE: The -g/--group option is not supported in Attach mode.
-t/--thread	Thread index. This parameter is optional.

**Table 3** **list** command parameters
Parameter	Description
-h/--help	Obtains help information. This parameter is optional.
-r/--rank	Rank ID. This parameter is optional.
-g/--group	Group ID. This parameter is optional. NOTE: The -g/--group option is not supported in Attach mode.
-t/--thread	Thread index. This parameter is optional.

Example

Display the information about breakpoint functions:

1	breakpoint -h

Command output:

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.

Parent topic: Debugging Status Commands