Bookmarks

A bookmark names a time in a program’s execution history, in order to be able to jump to the bookmarked time from any later point in a debugging session.

Create a bookmark using the ubookmark command, jump to a bookmarked time using the ugo bookmark command, and list bookmarks using the info bookmarks command.

ubookmark [name]

Create a bookmark at the current time in execution history.

If name is omitted, choose a name automatically.

Creating a new bookmark overwrites old bookmarks with the same name.

For example:

126         for (unsigned i = 0; i < sizeof indicator; ++i)
recording 14,207> info time -a
Current time is: 14,207:0x5555555555b4 (in recorded range: [1 - 14,207])
recording 14,207> ubookmark test
Added bookmark 'test'.

The bookmark test now refers to the current time in the program’s execution history.

Bookmarks can be deleted with the delete bookmark command.

Note

Bookmark names may not start with a number, space, hyphen, comma, or with the name of a sub-command of the ugo command (start, end, undo, and so on).

ugo bookmark name

Jump to a bookmarked time in execution history.

For example:

Program received signal SIGABRT, Aborted.
__GI_raise (sig=sig@entry=6) at ../sysdeps/unix/sysv/linux/raise.c:50
50      ../sysdeps/unix/sysv/linux/raise.c: No such file or directory.
recording 1,169,218 sigabrt> ugo bookmark test
main (argc=2, argv=0x7fffffffdc68) at hashtable.c:126
126         for (unsigned i = 0; i < sizeof indicator; ++i)
Have moved to bookmark: test.
1% 14,207 test> info time -a
Current time is: 14,207:0x5555555555b4 (in recorded range: [1 - 1,169,218])

info bookmarks

Show bookmarks.

For example:

1% 14,207 test> info bookmarks
    14,207:0x5555555555b4: test
    1,169,218:0x7ffff7e0603b: sigabrt

delete bookmark [name]

Delete bookmark name, or, with no argument, delete all bookmarks.

For example:

1% 14,207 test> info bookmarks
    14,207:0x5555555555b4: test
    1,169,218:0x7ffff7e0603b: sigabrt
1% 14,207 test> delete bookmark test
1% 14,207> info bookmarks
    1,169,218:0x7ffff7e0603b: sigabrt
1% 14,207> delete bookmark
Delete all bookmarks? (y or n) y
1% 14,207> info bookmarks