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 asks for a confirmation before overwriting the old bookmark with the same name.

For example:

126         for (unsigned i = 0; i < sizeof indicator; ++i)
recording 7,678> info time -a
Current time is: 7,678:0x5555555555d2 (in recorded range: [1 - 7,678])
recording 7,678> 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, dollar sign, minus sign, plus sign, now, or with the name of a sub-command of the ugo command (start, end, undo etc.).

ugo bookmark name

Jump to a bookmarked time in execution history.

For example:

Program received signal SIGABRT, Aborted.
__pthread_kill_implementation (no_tid=0, signo=6, threadid=<optimized out>)
    at ./nptl/pthread_kill.c:44
44            return INTERNAL_SYSCALL_ERROR_P (ret) ? INTERNAL_SYSCALL_ERRNO (ret) : 0;
recording 1,154,255 sigabrt> ugo bookmark test
main (argc=2, argv=0x7fffffffec88) at hashtable.c:126
126         for (unsigned i = 0; i < sizeof indicator; ++i)
Have moved to bookmark: test.
0% 7,678 test> info time -a
Current time is: 7,678:0x5555555555d2 (in recorded range: [1 - 1,154,255])

info bookmarks

Show bookmarks.

For example:

0% 7,678 test> info bookmarks
Time                      Name
------------------------  -------
    7,678:0x5555555555d2  test
1,154,255:0x7ffff7e46b1c  sigabrt

delete bookmark [name]

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

For example:

0% 7,678 test> info bookmarks
Time                      Name
------------------------  -------
    7,678:0x5555555555d2  test
1,154,255:0x7ffff7e46b1c  sigabrt
0% 7,678 test> delete bookmark test
0% 7,678> info bookmarks
Time                      Name
------------------------  -------
1,154,255:0x7ffff7e46b1c  sigabrt
0% 7,678> delete bookmark
Delete all bookmarks? (y or n) y
0% 7,678> info bookmarks
No bookmarks.