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 11,140> info time -a
Current time is: 11,140:0x555555555502 (in recorded range: [1 - 11,140])
recording 11,140> 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, 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:

__pthread_kill_implementation (threadid=<optimized out>, signo=signo@entry=6,
    no_tid=no_tid@entry=0) at ./nptl/pthread_kill.c:44
44      ./nptl/pthread_kill.c: No such file or directory.
recording 1,160,708 sigabrt> ugo bookmark test
main (argc=2, argv=0x7fffffffd6d8) at hashtable.c:126
126         for (unsigned i = 0; i < sizeof indicator; ++i)
Have moved to bookmark: test.
0% 11,140 test> info time -a
Current time is: 11,140:0x555555555502 (in recorded range: [1 - 1,160,708])

info bookmarks

Show bookmarks.

For example:

0% 11,140 test> info bookmarks
Time                      Name
------------------------  -------
   11,140:0x555555555502  test
1,160,708:0x7ffff7e54ccc  sigabrt

delete bookmark [name]

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

For example:

0% 11,140 test> info bookmarks
Time                      Name
------------------------  -------
   11,140:0x555555555502  test
1,160,708:0x7ffff7e54ccc  sigabrt
0% 11,140 test> delete bookmark test
0% 11,140> info bookmarks
Time                      Name
------------------------  -------
1,160,708:0x7ffff7e54ccc  sigabrt
0% 11,140> delete bookmark
Delete all bookmarks? (y or n) y
0% 11,140> info bookmarks
No bookmarks.