Remove breakpoints from a simulation
Syntax
remove_bps [‑all] [‑file <arg>] [‑line <arg>] [‑quiet] [‑verbose]
[<BreakPointObjsOrIds>...]
Usage
Name | Description |
---|---|
[-all]
|
Remove all breakpoints |
[-file]
|
The specific file to remove the breakpoint from given a line number |
[-line]
|
The specific line number to remove the breakpoint given a filename Default: -1 |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
[<BreakPointObjsOrIds>]
|
A list of one or more breakpoint objects and/or breakpoint object ID's to be removed |
Categories
Description
Remove specified breakpoints from the current simulation. You must have an open simulation to use this command.
A breakpoint is a user-determined stopping point in the source code used for debugging the design. When simulating a design with breakpoints, simulation of the design stops at each breakpoint to let you examine values and verify the design behavior.
The breakpoints in the current simulation can be reported using the report_bps
command.
This command returns nothing, or an error if the command fails.
Arguments
-all
- (Optional) Remove all breakpoints in the current simulation.
-file <arg>
- (Optional) Remove an existing breakpoint in the specified HDL source file.
-line <arg>
- (Optional) Remove an existing breakpoint at the specified line number of the HDL source file.
-file
and -line
must be used together to define an existing breakpoint.-quiet
- (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
-verbose
- (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config
command.<BreakPointObjsOrIds> - (Optional) Specifies one or more breakpoint objects in the current simulation to remove. The breakpoint object is returned by the add_bp
command when the breakpoint is added to the simulation.
Examples
The following example removes all the breakpoints in the current simulation:
remove_bps -all