summaryrefslogtreecommitdiff
path: root/python
diff options
context:
space:
mode:
authorMark Rowe <mark@vector35.com>2025-08-20 11:51:43 -0400
committerMark Rowe <mark@vector35.com>2025-08-27 09:26:37 -0700
commit6293afcb4e10997838f94c38430feba9742bea75 (patch)
tree479fc7d9044dc7bd39eddef370fa70661a55e3df /python
parenteb09898c0ea423328d929dec4d1730030f99abe4 (diff)
Clarify the documentation on how multiple symbols at the same address are handled
Diffstat (limited to 'python')
-rw-r--r--python/binaryview.py9
1 files changed, 6 insertions, 3 deletions
diff --git a/python/binaryview.py b/python/binaryview.py
index e0c6cf10..d516c054 100644
--- a/python/binaryview.py
+++ b/python/binaryview.py
@@ -6410,7 +6410,8 @@ class BinaryView:
``define_auto_symbol`` adds a symbol to the internal list of automatically discovered Symbol objects in a given
namespace.
- .. warning:: If multiple symbols for the same address are defined, only the most recent symbol will ever be used.
+ .. warning:: If multiple symbols for the same address are defined, only the most recently added symbol with the
+ highest confidence and lowest SymbolType value will ever be used.
:param sym: the symbol to define
:rtype: None
@@ -6423,7 +6424,8 @@ class BinaryView:
"""
``define_auto_symbol_and_var_or_function`` Defines an "Auto" symbol, and a Variable/Function alongside it.
- .. warning:: If multiple symbols for the same address are defined, only the most recent symbol will ever be used.
+ .. warning:: If multiple symbols for the same address are defined, only the most recently added symbol with the
+ highest confidence and lowest SymbolType value will ever be used.
:param sym: Symbol to define
:param type: Type for the function/variable being defined (can be None)
@@ -6465,7 +6467,8 @@ class BinaryView:
"""
``define_user_symbol`` adds a symbol to the internal list of user added Symbol objects.
- .. warning:: If multiple symbols for the same address are defined, only the most recent symbol will ever be used.
+ .. warning:: If multiple symbols for the same address are defined, only the most recently added symbol with the
+ highest confidence and lowest SymbolType value will ever be used.
:param Symbol sym: the symbol to define
:rtype: None