Package ghidra.program.database.bookmark
Class BookmarkDBManager
java.lang.Object
ghidra.program.database.bookmark.BookmarkDBManager
- All Implemented Interfaces:
ErrorHandler
,ManagerDB
,BookmarkManager
-
Field Summary
Fields inherited from interface ghidra.program.model.listing.BookmarkManager
OLD_BOOKMARK_PROPERTY_OBJECT_CLASS1, OLD_BOOKMARK_PROPERTY_OBJECT_CLASS2
-
Constructor Summary
ConstructorDescriptionBookmarkDBManager
(DBHandle handle, AddressMap addrMap, OpenMode openMode, Lock lock, TaskMonitor monitor) Constructs a new CodeManager for a program. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Notification that an IO exception occurred.defineType
(String type, Icon icon, Color color, int priority) Define a bookmark type with its marker icon and color.void
deleteAddressRange
(Address startAddr, Address endAddr, TaskMonitor monitor) Delete all objects which have been applied to the address range startAddr to endAddr and update the database accordingly.getBookmark
(long id) Returns the bookmark that has the given id or null if no such bookmark exists.getBookmark
(Address addr, String type, String category) Get a specific bookmarkgetBookmarkAddresses
(String type) Get addresses for bookmarks of a specified type.int
Returns the total number of bookmarks in the programint
getBookmarkCount
(String type) Return the number of bookmarks of the given typeBookmark[]
getBookmarks
(Address addr) Get all bookmarks on a specific addressBookmark[]
getBookmarks
(Address address, String type) Get bookmarks of the indicated type on a specific addressReturns an iterator over all bookmarksgetBookmarksIterator
(Address startAddress, boolean forward) Returns an iterator over all bookmark types, starting at the given address, with traversal in the given direction.getBookmarksIterator
(String type) Get iterator over all bookmarks of the specified type.getBookmarkType
(String type) Get a bookmark typeReturns list of known bookmark typesString[]
getCategories
(String type) Get list of categories used for a specified typeReturns the program associated with this BookmarkManager.boolean
hasBookmarks
(String type) Returns true if program contains one or more bookmarks of the given typevoid
invalidateCache
(boolean all) Invalidate cached objects held by this manager.void
moveAddressRange
(Address fromAddr, Address toAddr, long length, TaskMonitor monitor) Move all objects within an address range to a new location.void
programReady
(OpenMode openMode, int currentRevision, TaskMonitor monitor) Callback from program made to each manager after the program has completed initialization.void
removeBookmark
(Bookmark bookmark) Remove bookmarkvoid
removeBookmarks
(AddressSetView set, TaskMonitor monitor) Removes all bookmarks over the given address set.void
removeBookmarks
(AddressSetView set, String type, TaskMonitor monitor) Removes all bookmarks of the given type over the given address setvoid
removeBookmarks
(AddressSetView set, String type, String category, TaskMonitor monitor) Removes all bookmarks of the given type and category over the given address setvoid
removeBookmarks
(String type) Removes all bookmarks of the given type.void
removeBookmarks
(String type, String category, TaskMonitor monitor) Removes all bookmarks with the given type and category.setBookmark
(Address addr, String type, String category, String comment) Set a bookmark.void
setProgram
(ProgramDB program) Callback from program used to indicate all manager have been created.
-
Constructor Details
-
BookmarkDBManager
public BookmarkDBManager(DBHandle handle, AddressMap addrMap, OpenMode openMode, Lock lock, TaskMonitor monitor) throws VersionException, IOException Constructs a new CodeManager for a program.- Parameters:
handle
- handle to databaseaddrMap
- addressMap to convert between addresses and long values.openMode
- either READ_ONLY, UPDATE, or UPGRADElock
- the program synchronization lockmonitor
- the task monitor use while upgrading.- Throws:
VersionException
- if the database is incompatible with the current schemaIOException
- if there is a problem accessing the database.
-
-
Method Details
-
setProgram
Description copied from interface:ManagerDB
Callback from program used to indicate all manager have been created. When this method is invoked, all managers have been instantiated but may not be fully initialized.- Specified by:
setProgram
in interfaceManagerDB
- Parameters:
program
- the program is set when all the initializations have been completed.
-
programReady
public void programReady(OpenMode openMode, int currentRevision, TaskMonitor monitor) throws IOException, CancelledException Description copied from interface:ManagerDB
Callback from program made to each manager after the program has completed initialization. This method may be used by managers to perform additional upgrading which may have been deferred.- Specified by:
programReady
in interfaceManagerDB
- Parameters:
openMode
- the mode that the program is being opened.currentRevision
- current program revision. If openMode is UPGRADE, this value reflects the pre-upgrade value.monitor
- the task monitor to use in any upgrade operations.- Throws:
IOException
- if a database io error occurs.CancelledException
- if the user cancelled the operation via the task monitor.
-
dbError
Description copied from interface:ErrorHandler
Notification that an IO exception occurred.- Specified by:
dbError
in interfaceErrorHandler
- Parameters:
e
-IOException
which was cause of error
-
invalidateCache
public void invalidateCache(boolean all) Invalidate cached objects held by this manager.- Specified by:
invalidateCache
in interfaceManagerDB
- Parameters:
all
- if false, some managers may not need to update their cache if they can tell that its not necessary. If this flag is true, then all managers should clear their cache no matter what.
-
defineType
Description copied from interface:BookmarkManager
Define a bookmark type with its marker icon and color. The icon and color values are not permanently stored. Therefor, this method must be re-invoked by a plugin each time a program is opened if a custom icon and color are desired.- Specified by:
defineType
in interfaceBookmarkManager
- Parameters:
type
- bookmark typeicon
- marker icon which may get scaledcolor
- marker colorpriority
- the bookmark priority- Returns:
- bookmark type object
-
getBookmarkTypes
Description copied from interface:BookmarkManager
Returns list of known bookmark types- Specified by:
getBookmarkTypes
in interfaceBookmarkManager
- Returns:
- list of known bookmark types
-
getProgram
Description copied from interface:BookmarkManager
Returns the program associated with this BookmarkManager.- Specified by:
getProgram
in interfaceBookmarkManager
- Returns:
- the program associated with this BookmarkManager.
-
getBookmarkType
Description copied from interface:BookmarkManager
Get a bookmark type- Specified by:
getBookmarkType
in interfaceBookmarkManager
- Parameters:
type
- bookmark type name- Returns:
- bookmark type or null if type is unknown
-
setBookmark
Description copied from interface:BookmarkManager
Set a bookmark.- Specified by:
setBookmark
in interfaceBookmarkManager
- Parameters:
addr
- the address at which to set a bookmarktype
- the name of the bookmark type.category
- the category for the bookmark.comment
- the comment to associate with the bookmark.- Returns:
- the new bookmark
-
getBookmark
Description copied from interface:BookmarkManager
Get a specific bookmark- Specified by:
getBookmark
in interfaceBookmarkManager
- Parameters:
addr
- the address of the bookmark to retrievetype
- the name of the bookmark type.category
- the category of the bookmark.- Returns:
- the bookmark with the given attributes, or null if no bookmarks match.
-
removeBookmark
Description copied from interface:BookmarkManager
Remove bookmark- Specified by:
removeBookmark
in interfaceBookmarkManager
- Parameters:
bookmark
- the bookmark to remove.
-
removeBookmarks
Description copied from interface:BookmarkManager
Removes all bookmarks of the given type.- Specified by:
removeBookmarks
in interfaceBookmarkManager
- Parameters:
type
- bookmark type
-
removeBookmarks
public void removeBookmarks(String type, String category, TaskMonitor monitor) throws CancelledException Description copied from interface:BookmarkManager
Removes all bookmarks with the given type and category.- Specified by:
removeBookmarks
in interfaceBookmarkManager
- Parameters:
type
- the type of the bookmarks to be removed.category
- bookmark category of the types to be removed.monitor
- a task monitor to report the progress.- Throws:
CancelledException
- if the user (via the monitor) cancelled the operation.
-
getBookmarks
Description copied from interface:BookmarkManager
Get all bookmarks on a specific address- Specified by:
getBookmarks
in interfaceBookmarkManager
- Parameters:
addr
- the address at which to retrieve all bookmarks.- Returns:
- array of bookmarks
-
getBookmarks
Description copied from interface:BookmarkManager
Get bookmarks of the indicated type on a specific address- Specified by:
getBookmarks
in interfaceBookmarkManager
- Parameters:
address
- the address at which to search for bookmarks.type
- bookmark type to search for- Returns:
- array of bookmarks
-
hasBookmarks
Description copied from interface:BookmarkManager
Returns true if program contains one or more bookmarks of the given type- Specified by:
hasBookmarks
in interfaceBookmarkManager
- Parameters:
type
- the type of bookmark to check for.- Returns:
- true if program contains one or more bookmarks of the given type
-
getCategories
Description copied from interface:BookmarkManager
Get list of categories used for a specified type- Specified by:
getCategories
in interfaceBookmarkManager
- Parameters:
type
- bookmark type- Returns:
- array of category strings
-
getBookmarkAddresses
Description copied from interface:BookmarkManager
Get addresses for bookmarks of a specified type.- Specified by:
getBookmarkAddresses
in interfaceBookmarkManager
- Parameters:
type
- bookmark type- Returns:
- address set containing bookmarks of the specified type.
-
getBookmark
Description copied from interface:BookmarkManager
Returns the bookmark that has the given id or null if no such bookmark exists.- Specified by:
getBookmark
in interfaceBookmarkManager
- Parameters:
id
- the id of the bookmark to be retrieved.- Returns:
- the bookmark
-
getBookmarkCount
public int getBookmarkCount()Description copied from interface:BookmarkManager
Returns the total number of bookmarks in the program- Specified by:
getBookmarkCount
in interfaceBookmarkManager
- Returns:
- the total number of bookmarks in the program
-
getBookmarkCount
Description copied from interface:BookmarkManager
Return the number of bookmarks of the given type- Specified by:
getBookmarkCount
in interfaceBookmarkManager
- Parameters:
type
- the type of bookmarks to count- Returns:
- the number of bookmarks of the given type
-
getBookmarksIterator
Description copied from interface:BookmarkManager
Get iterator over all bookmarks of the specified type.- Specified by:
getBookmarksIterator
in interfaceBookmarkManager
- Parameters:
type
- the bookmark type to search for- Returns:
- an iterator over all bookmarks of the specified type.
-
getBookmarksIterator
Description copied from interface:BookmarkManager
Returns an iterator over all bookmark types, starting at the given address, with traversal in the given direction.- Specified by:
getBookmarksIterator
in interfaceBookmarkManager
- Parameters:
startAddress
- the address at which to startforward
- true to iterate in the forward direction; false for backwards- Returns:
- an iterator over all bookmark types, starting at the given address, with traversal in the given direction.
-
getBookmarksIterator
Description copied from interface:BookmarkManager
Returns an iterator over all bookmarks- Specified by:
getBookmarksIterator
in interfaceBookmarkManager
- Returns:
- an iterator over all bookmarks
-
removeBookmarks
Description copied from interface:BookmarkManager
Removes all bookmarks over the given address set.- Specified by:
removeBookmarks
in interfaceBookmarkManager
- Parameters:
set
- the set of addresses from which to remove all bookmarks.monitor
- a task monitor to report the progress.- Throws:
CancelledException
- if the user (via the monitor) cancelled the operation.
-
removeBookmarks
public void removeBookmarks(AddressSetView set, String type, TaskMonitor monitor) throws CancelledException Description copied from interface:BookmarkManager
Removes all bookmarks of the given type over the given address set- Specified by:
removeBookmarks
in interfaceBookmarkManager
- Parameters:
set
- the set of addresses from which to remove all bookmarks of the given type.type
- the type of bookmarks to remove.monitor
- a task monitor to report the progress.- Throws:
CancelledException
- if the user (via the monitor) cancelled the operation.
-
removeBookmarks
public void removeBookmarks(AddressSetView set, String type, String category, TaskMonitor monitor) throws CancelledException Description copied from interface:BookmarkManager
Removes all bookmarks of the given type and category over the given address set- Specified by:
removeBookmarks
in interfaceBookmarkManager
- Parameters:
set
- the set of addresses from which to remove all bookmarks of the given type and category.type
- the type of bookmarks to remove.category
- the category of bookmarks to remove.monitor
- a task monitor to report the progress.- Throws:
CancelledException
- if the user (via the monitor) cancelled the operation.
-
deleteAddressRange
public void deleteAddressRange(Address startAddr, Address endAddr, TaskMonitor monitor) throws CancelledException Description copied from interface:ManagerDB
Delete all objects which have been applied to the address range startAddr to endAddr and update the database accordingly. The specified start and end addresses must form a valid range within a singleAddressSpace
.- Specified by:
deleteAddressRange
in interfaceManagerDB
- Parameters:
startAddr
- the first address in the range.endAddr
- the last address in the range.monitor
- the task monitor to use in any upgrade operations.- Throws:
CancelledException
- if the user cancelled the operation via the task monitor.
-
moveAddressRange
public void moveAddressRange(Address fromAddr, Address toAddr, long length, TaskMonitor monitor) throws CancelledException Description copied from interface:ManagerDB
Move all objects within an address range to a new location.- Specified by:
moveAddressRange
in interfaceManagerDB
- Parameters:
fromAddr
- the first address of the range to be moved.toAddr
- the address where to the range is to be moved.length
- the number of addresses to move.monitor
- the task monitor to use in any upgrade operations.- Throws:
CancelledException
- if the user cancelled the operation via the task monitor.
-