diff options
Diffstat (limited to 'python')
| -rw-r--r-- | python/binaryview.py | 19 | ||||
| -rw-r--r-- | python/lowlevelil.py | 1 |
2 files changed, 20 insertions, 0 deletions
diff --git a/python/binaryview.py b/python/binaryview.py index bf55c047..2f7d39be 100644 --- a/python/binaryview.py +++ b/python/binaryview.py @@ -188,7 +188,10 @@ class AnalysisCompletionEvent(object): def cancel(self): """ + The ``cancel`` method will cancel analysis for an :class:`AnalysisCompletionEvent`. + .. warning: This method should only be used when the system is being shut down and no further analysis should be done afterward. + """ self.callback = self._empty_callback core.BNCancelAnalysisCompletionEvent(self.handle) @@ -1833,6 +1836,7 @@ class BinaryView(object): .. note:: This method **may** be overridden by custom BinaryViews. Use :func:`add_auto_segment` to provide data without overriding this method. + .. warning:: This method **must not** be called directly. :return: returns the size of the virtual address range used by the BinaryView. @@ -1847,6 +1851,7 @@ class BinaryView(object): .. note:: This method **may** be overridden by custom BinaryViews. Use :func:`add_auto_segment` to provide data without overriding this method. + .. warning:: This method **must not** be called directly. :param int addr: a virtual address to attempt to read from @@ -1863,6 +1868,7 @@ class BinaryView(object): .. note:: This method **may** be overridden by custom BinaryViews. Use :func:`add_auto_segment` to provide data without overriding this method. + .. warning:: This method **must not** be called directly. :param int addr: a virtual address @@ -1878,6 +1884,7 @@ class BinaryView(object): the bytes ``data`` to rebased address ``addr``. .. note:: This method **may** be overridden by custom BinaryViews. If not overridden, inserting is disallowed + .. warning:: This method **must not** be called directly. :param int addr: a virtual address @@ -1893,6 +1900,7 @@ class BinaryView(object): ``length`` bytes from the rebased address ``addr``. .. note:: This method **may** be overridden by custom BinaryViews. If not overridden, removing data is disallowed + .. warning:: This method **must not** be called directly. :param int addr: a virtual address @@ -1908,6 +1916,7 @@ class BinaryView(object): .. note:: This method **may** be overridden by custom BinaryViews. Use :func:`add_auto_segment` to provide data without overriding this method. + .. warning:: This method **must not** be called directly. :param int addr: a virtual address to be checked @@ -1922,6 +1931,7 @@ class BinaryView(object): .. note:: This method **may** be overridden by custom BinaryViews. Use :func:`add_auto_segment` to provide data without overriding this method. + .. warning:: This method **must not** be called directly. :param int addr: a virtual address to be checked @@ -1937,6 +1947,7 @@ class BinaryView(object): .. note:: This method **may** be overridden by custom BinaryViews. Use :func:`add_auto_segment` to provide data without overriding this method. + .. warning:: This method **must not** be called directly. :param int offset: a virtual address to be checked @@ -1951,6 +1962,7 @@ class BinaryView(object): .. note:: This method **may** be overridden by custom BinaryViews. Use :func:`add_auto_segment` to provide data without overriding this method. + .. warning:: This method **must not** be called directly. :param int addr: a virtual address to be checked @@ -1965,6 +1977,7 @@ class BinaryView(object): .. note:: This method **may** be overridden by custom BinaryViews. Use :func:`add_auto_segment` to provide data without overriding this method. + .. warning:: This method **must not** be called directly. :param int addr: a virtual address to be checked @@ -1980,6 +1993,7 @@ class BinaryView(object): .. note:: This method **may** be overridden by custom BinaryViews. Use :func:`add_auto_segment` to provide data without overriding this method. + .. warning:: This method **must not** be called directly. :param int addr: a virtual address to start checking from. @@ -1997,6 +2011,7 @@ class BinaryView(object): .. note:: This method **may** be overridden by custom BinaryViews. Use :func:`add_auto_segment` to provide data without overriding this method. + .. warning:: This method **must not** be called directly. :return: returns the first virtual address in the BinaryView. @@ -2009,6 +2024,7 @@ class BinaryView(object): ``perform_get_entry_point`` implements a query for the initial entry point for code execution. .. note:: This method **should** be implemented for custom BinaryViews that are executable. + .. warning:: This method **must not** be called directly. :return: the virtual address of the entry point @@ -2021,6 +2037,7 @@ class BinaryView(object): ``perform_is_executable`` implements a check which returns true if the BinaryView is executable. .. note:: This method **must** be implemented for custom BinaryViews that are executable. + .. warning:: This method **must not** be called directly. :return: true if the current BinaryView is executable, false if it is not executable or on error @@ -2033,6 +2050,7 @@ class BinaryView(object): ``perform_get_default_endianness`` implements a check which returns true if the BinaryView is executable. .. note:: This method **may** be implemented for custom BinaryViews that are not LittleEndian. + .. warning:: This method **must not** be called directly. :return: either :const:`Endianness.LittleEndian <binaryninja.enums.Endianness.LittleEndian>` or :const:`Endianness.BigEndian <binaryninja.enums.Endianness.BigEndian>` @@ -2046,6 +2064,7 @@ class BinaryView(object): True. .. note:: This method **may** be implemented for custom BinaryViews that are relocatable. + .. warning:: This method **must not** be called directly. :return: True if the BinaryView is relocatable, False otherwise diff --git a/python/lowlevelil.py b/python/lowlevelil.py index e5eef3c0..ff5829e7 100644 --- a/python/lowlevelil.py +++ b/python/lowlevelil.py @@ -944,6 +944,7 @@ class LowLevelILFunction(object): ``replace_expr`` allows modification of LowLevelILExpressions but ONLY during lifting. .. warning:: This function should ONLY be called as a part of a lifter. It will otherwise not do anything useful as there's no way to trigger re-analysis of IL levels at this time. + :param LowLevelILExpr original: the LowLevelILExpr to replace (may also be an expression index) :param LowLevelILExpr new: the LowLevelILExpr to add to the current LowLevelILFunction (may also be an expression index) :rtype: None |