//===-- BreakpointSite.h ----------------------------------------*- C++ -*-===// // // The LLVM Compiler Infrastructure // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// #ifndef liblldb_BreakpointSite_h_ #define liblldb_BreakpointSite_h_ // C Includes // C++ Includes #include <list> // Other libraries and framework includes // Project includes #include "lldb/lldb-private.h" #include "lldb/Core/UserID.h" #include "lldb/Breakpoint/StoppointLocation.h" #include "lldb/Breakpoint/BreakpointLocationCollection.h" namespace lldb_private { //---------------------------------------------------------------------- /// @class BreakpointSite BreakpointSite.h "lldb/Breakpoint/BreakpointSite.h" /// @brief Class that manages the actual breakpoint that will be inserted /// into the running program. /// /// The BreakpointSite class handles the physical breakpoint that is /// actually inserted in the target program. As such, it is also the /// one that gets hit, when the program stops. It keeps a list of all /// BreakpointLocations that share this phsyical site. When the /// breakpoint is hit, all the locations are informed by the breakpoint /// site. Breakpoint sites are owned by the process. //---------------------------------------------------------------------- class BreakpointSite : public STD_ENABLE_SHARED_FROM_THIS(BreakpointSite), public StoppointLocation { public: enum Type { eSoftware, // Breakpoint opcode has been written to memory and m_saved_opcode // and m_trap_opcode contain the saved and written opcode. eHardware, // Breakpoint site is set as a hardware breakpoint eExternal // Breakpoint site is managed by an external debug nub or // debug interface where memory reads trasparently will not // display any breakpoint opcodes. }; virtual ~BreakpointSite (); //---------------------------------------------------------------------- // This section manages the breakpoint traps //---------------------------------------------------------------------- //------------------------------------------------------------------ /// Returns the Opcode Bytes for this breakpoint //------------------------------------------------------------------ uint8_t * GetTrapOpcodeBytes (); //------------------------------------------------------------------ /// Returns the Opcode Bytes for this breakpoint - const version //------------------------------------------------------------------ const uint8_t * GetTrapOpcodeBytes () const; //------------------------------------------------------------------ /// Get the size of the trap opcode for this address //------------------------------------------------------------------ size_t GetTrapOpcodeMaxByteSize () const; //------------------------------------------------------------------ /// Sets the trap opcode //------------------------------------------------------------------ bool SetTrapOpcode (const uint8_t *trap_opcode, size_t trap_opcode_size); //------------------------------------------------------------------ /// Gets the original instruction bytes that were overwritten by the trap //------------------------------------------------------------------ uint8_t * GetSavedOpcodeBytes (); //------------------------------------------------------------------ /// Gets the original instruction bytes that were overwritten by the trap const version //------------------------------------------------------------------ const uint8_t * GetSavedOpcodeBytes () const; //------------------------------------------------------------------ /// Says whether \a addr and size \a size intersects with the address \a intersect_addr //------------------------------------------------------------------ bool IntersectsRange (lldb::addr_t addr, size_t size, lldb::addr_t *intersect_addr, size_t *intersect_size, size_t *opcode_offset) const; //------------------------------------------------------------------ /// Tells whether the current breakpoint site is enabled or not /// /// This is a low-level enable bit for the breakpoint sites. If a /// breakpoint site has no enabled owners, it should just get /// removed. This enable/disable is for the low-level target code /// to enable and disable breakpoint sites when single stepping, /// etc. //------------------------------------------------------------------ bool IsEnabled () const; //------------------------------------------------------------------ /// Sets whether the current breakpoint site is enabled or not /// /// @param[in] enabled /// \b true if the breakoint is enabled, \b false otherwise. //------------------------------------------------------------------ void SetEnabled (bool enabled); //------------------------------------------------------------------ /// Enquires of the breakpoint locations that produced this breakpoint site whether /// we should stop at this location. /// /// @param[in] context /// This contains the information about this stop. /// /// @return /// \b true if we should stop, \b false otherwise. //------------------------------------------------------------------ virtual bool ShouldStop (StoppointCallbackContext *context); //------------------------------------------------------------------ /// Standard Dump method /// /// @param[in] context /// The stream to dump this output. //------------------------------------------------------------------ void Dump (Stream *s) const; //------------------------------------------------------------------ /// The "Owners" are the breakpoint locations that share this /// breakpoint site. The method adds the \a owner to this breakpoint /// site's owner list. /// /// @param[in] context /// \a owner is the Breakpoint Location to add. //------------------------------------------------------------------ void AddOwner (const lldb::BreakpointLocationSP &owner); //------------------------------------------------------------------ /// This method returns the number of breakpoint locations currently /// located at this breakpoint site. /// /// @return /// The number of owners. //------------------------------------------------------------------ uint32_t GetNumberOfOwners (); //------------------------------------------------------------------ /// This method returns the the breakpoint location at index \a index /// located at this breakpoint site. The owners are listed ordinally /// from 0 to GetNumberOfOwners() - 1 so you can use this method to iterate /// over the owners /// /// @param[in] index /// The index in the list of owners for which you wish the owner location. /// @return /// A shared pointer to the breakpoint location at that index. //------------------------------------------------------------------ lldb::BreakpointLocationSP GetOwnerAtIndex (uint32_t index); //------------------------------------------------------------------ /// Check whether the owners of this breakpoint site have any /// thread specifiers, and if yes, is \a thread contained in any /// of these specifiers. /// /// @param[in] thread /// The thread against which to test. /// /// return /// \b true if the collection contains at least one location that /// would be valid for this thread, false otherwise. //------------------------------------------------------------------ bool ValidForThisThread (Thread *thread); //------------------------------------------------------------------ /// Print a description of this breakpoint site to the stream \a s. /// GetDescription tells you about the breakpoint site's owners. /// Use BreakpointSite::Dump(Stream *) to get information about the /// breakpoint site itself. /// /// @param[in] s /// The stream to which to print the description. /// /// @param[in] level /// The description level that indicates the detail level to /// provide. /// /// @see lldb::DescriptionLevel //------------------------------------------------------------------ void GetDescription (Stream *s, lldb::DescriptionLevel level); bool IsBreakpointAtThisSite (lldb::break_id_t bp_id); BreakpointSite::Type GetType () const { return m_type; } void SetType (BreakpointSite::Type type) { m_type = type; } private: friend class Process; //------------------------------------------------------------------ /// The method removes the owner at \a break_loc_id from this breakpoint list. /// /// @param[in] context /// \a break_loc_id is the Breakpoint Location to remove. //------------------------------------------------------------------ uint32_t RemoveOwner (lldb::break_id_t break_id, lldb::break_id_t break_loc_id); BreakpointSite::Type m_type;///< The type of this breakpoint site. uint8_t m_saved_opcode[8]; ///< The saved opcode bytes if this breakpoint site uses trap opcodes. uint8_t m_trap_opcode[8]; ///< The opcode that was used to create the breakpoint if it is a software breakpoint site. bool m_enabled; ///< Boolean indicating if this breakpoint site enabled or not. // Consider adding an optimization where if there is only one // owner, we don't store a list. The usual case will be only one owner... BreakpointLocationCollection m_owners; ///< This has the BreakpointLocations that share this breakpoint site. static lldb::break_id_t GetNextID(); // Only the Process can create breakpoint sites in // Process::CreateBreakpointSite (lldb::BreakpointLocationSP &, bool). BreakpointSite (BreakpointSiteList *list, const lldb::BreakpointLocationSP& owner, lldb::addr_t m_addr, lldb::tid_t tid, bool use_hardware); DISALLOW_COPY_AND_ASSIGN(BreakpointSite); }; } // namespace lldb_private #endif // liblldb_BreakpointSite_h_