Deprecated arguments for setting and going to a bookmark (use the new ‘bookmark’ arguments)
dhistory { -get_time | -go_timetime }
Arguments
-enable
Enables Replay immediately. Once replay is enabled and recording has started, it cannot be disabled until restart.
-disable
Disables Replay for next restart. Once enabled, replay cannot be disabled for a live process.
-info
Displays ReplayEngine information including the current time, the live time, and whether the process is in Replay or Record mode. If you enter dhistory without arguments, -info is the default.
-create_bookmarkcomment
Creates a Replay bookmark at the current execution location so you can return to it later. You can specify an optional comment to this command and it will be stored with the bookmark for display when you use the show_bookmarks command. A bookmark is created with a unique numeric ID, which is the return value.
-goto_bookmarkID
Goes to the bookmark with the specified ID. This returns the focus process to the execution location where the bookmark was first created.
-go_live
Returns the process to the PC and back into Record mode. You can resume your “regular” debugging session.
-show_bookmarks
Displays all Replay bookmarks. This command shows the bookmark ID along with information about what line number, PC and function the bookmark is on. If you added a comment to help you remember the significance of the bookmark, it displays this as well.
-delete_bookmarkID
Deletes the bookmark with the given ID.
-clear_bookmarks
Deletes all Replay bookmarks.
-saverecording-file
Saves the current replay history to a file. There is an optional argument to specify the name of the file to save to. The file specification can be a path or a simple file name, in which case it is saved in the current working directory. If no file is specified, the recording is saved in the current working directory with the file name replay_pid_hostname.recording.
To reload the recording file, use one of the following commands based on the functionality for loading core files. TotalView recognizes the recording file for what it is and acts appropriately.
To reload a recording at startup:
totalview -newUIexecutablerecording-file
To reload a recording file when TotalView is running:
dattachfilename-crecording-file
The recording-file argument can be either a path or a simple file name, in which case the current working directory is assumed.
-get_time — deprecated: use create_bookmark
Returns an integer value representing the program execution location at the current time. The integer value is a virtual timestamp. This virtual timestamp does not refer to the exact point in time; it has a granularity that is typically a few lines of code.
-go_timetime — deprecated: use goto_bookmark
Places the process back to the virtual time specified by the time integer argument. The time argument is a virtual timestamp as reported by dhistory -get_time. You cannot use this command to move to a specific instruction but you can use it to get to within a small block of code (usually within a few lines of your intended point in execution history). This command is typically used either for roughly bookmarking a point in code or for searching execution history. It may need to be combined with stepping and duntilcommands to return to an exact position.
Description
The dhistory command displays information about the current process either by default or when using the -infoargument. In addition, options to this command can obtain a debugging time, which can be stored in a variable to go back to a particular time.
In addition, you can enable and display ReplayEngine as well as put it back into regular debugging mode using the-go_live option. You’ll need to do this after your program is placed into replay mode. This occurs whenever you use any GUI or CLI command that moves to replay mode. For example, in the CLI, this can occur when you execute such commands as dnext or dout.
Command alias
Alias
Definition
Description
replay
dhistory
Performs actions upon ReplayEngine.
Examples
dhistory [-info]
Typing dhistory with no arguments or with the -info argument displays the following information:
History info for process 1
Live time: 421 0x80485d6
Current time: 421 0x80485d6
Live PC: 0x80485d6
Record Mode: True
Replay Wanted: True
Stop Reason: Normal result [waitpid, search, or goto_time
replay -create_bookmark “This is where the crash occurs”
3
Creates a bookmark at the current execution location and returns an ID. The comment appears in the list of bookmarks displayed with -show_bookmarks (see below). Note the use of the replay alias for this command, which might be easier to remember than dhistory.
replay -show_bookmarks
Displays a list of the currently defined bookmarks: