reven2.address._AbstractAddress

class documentation

class _AbstractAddress(object):

Known subclasses: reven2.address.LinearAddress, reven2.address.LogicalAddress, reven2.address.LogicalAddressSegmentIndex, reven2.address.PhysicalAddress

View In Hierarchy

The abstract class from which any address representation is derived.

It contains implementation of comparison operators and addition/substraction operators.

Method	`__add__`	Undocumented
Method	`__and__`	Undocumented
Method	`__eq__`	Compares the instance for equality with an object.
Method	`__ge__`	Undocumented
Method	`__gt__`	Undocumented
Method	`__hash__`	Returns the hash for this value.
Method	`__iadd__`	Undocumented
Method	`__iand__`	Undocumented
Method	`__init__`	Undocumented
Method	`__ior__`	Undocumented
Method	`__isub__`	Undocumented
Method	`__le__`	Undocumented
Method	`__lt__`	Undocumented
Method	`__ne__`	Compares the instance for equality with an object.
Method	`__or__`	Undocumented
Method	`__sub__`	Undocumented
Method	`format_as_html`	This method gets an html formatting string representation for this class instance.
Method	`format_as_html_for_classic_jupyter_notebook`	This method gets an html formatting string representation for this class instance.
Method	`offset.setter`	Undocumented
Property	`offset`	Property: The offset of the address.
Class Method	`_unique_id`	Undocumented
Static Method	`_unpack`	Unpack a low level representation of an address to its high level representation.
Static Method	`_unpack_segment_register`	Undocumented
Method	`_address_data`	Undocumented
Method	`_is_comparable`	Whether two address objects are comparable or not.
Method	`_pack`	Pack an address to its high level representation.
Method	`_repr_html_`	Representation used by Jupyter when an instance of the address classes is displayed in a cell.
Class Variable	`_unique_count`	Undocumented
Instance Variable	`_formatter`	Undocumented
Instance Variable	`_offset`	Undocumented

def __add__(self, other):

Undocumented

Parameters
other:`_SupportsInt`	Undocumented
Returns
`AddressType`	Undocumented

def __and__(self, other):

Undocumented

Parameters
other:`_SupportsInt`	Undocumented
Returns
`AddressType`	Undocumented

def __eq__(self, other):

Compares the instance for equality with an object.

if the object is an address comparable to this instance, then the addresses are equal if their offset is equal.
Otherwise, the object is never equal to the instance.

Note

Comparable addresses are addresses of the same kind (linear, logical, physical) and the same kind parameters (segment, segment index, etc.). We could say that two addresses are comparable when they have the same address space.

Parameters
other:`_Any`	Undocumented
Returns
`bool`	Undocumented

def __ge__(self, other):

Undocumented

def __gt__(self, other):

Undocumented

def __hash__(self):

overridden in reven2.address.LogicalAddress, reven2.address.LogicalAddressSegmentIndex

Returns the hash for this value.

Returns
`int`	Undocumented

def __iadd__(self, other):

Undocumented

Parameters
other:`_SupportsInt`	Undocumented
Returns
`AddressType`	Undocumented

def __iand__(self, other):

Undocumented

Parameters
other:`_SupportsInt`	Undocumented
Returns
`AddressType`	Undocumented

def __init__(self, offset, formatter):

overridden in reven2.address.LinearAddress, reven2.address.LogicalAddress, reven2.address.LogicalAddressSegmentIndex, reven2.address.PhysicalAddress

Undocumented

Parameters
offset:`int`	Undocumented
formatter:`_Optional[Formatter]`	Undocumented

def __ior__(self, other):

Undocumented

Parameters
other:`_SupportsInt`	Undocumented
Returns
`AddressType`	Undocumented

def __isub__(self, other):

Undocumented

Parameters
other:`_SupportsInt`	Undocumented
Returns
`AddressType`	Undocumented

def __le__(self, other):

Undocumented

def __lt__(self, other):

Undocumented

def __ne__(self, other):

Compares the instance for equality with an object.

if the object is an address comparable to this instance, then the addresses are equal if their offset is equal.
Otherwise, the object is never equal to the instance.

Note

Comparable addresses are addresses of the same kind (linear, logical, physical) and the same kind parameters (segment, segment index, etc.). We could say that two addresses are comparable when they have the same address space.

Parameters
other:`_Any`	Undocumented
Returns
`bool`	Undocumented

def __or__(self, other):

Undocumented

Parameters
other:`_SupportsInt`	Undocumented
Returns
`AddressType`	Undocumented

def __sub__(self, other):

Undocumented

Parameters
other:`_SupportsInt`	Undocumented
Returns
`AddressType`	Undocumented

def format_as_html(self):

This method gets an html formatting string representation for this class instance.

Information

Returns
`str`	`String`

def format_as_html_for_classic_jupyter_notebook(self):

This method gets an html formatting string representation for this class instance.

The address is returned as a clickable link containing the address string, that publishes the address to all tracked reven2.session.Sessions.

Warning

The link only works using classic Jupyter Notebook. It does not work with the JupyterLab used by esReven.

Information

Returns
`str`	`String`

@offset.setter
def offset(self, offset):

Undocumented

Parameters
offset:`int`	Undocumented

@property
offset: int =

Property: The offset of the address.

Examples

>>> hex(address.PhysicalAddress(0xfffff800c99455b0).offset)
'0xfffff800c99455b0'
>>> hex(address.LinearAddress(0xfffff800c99455b0).offset)
'0xfffff800c99455b0'
>>> hex(address.LogicalAddress(0xfffff800c99455b0).offset)
'0xfffff800c99455b0'
>>> hex(address.LogicalAddressSegmentIndex(0xfffff800c99455b0).offset)
'0xfffff800c99455b0'

Information

Returns
An `integer`.

@classmethod
def _unique_id(cls):

Undocumented

Returns
`str`	Undocumented

@staticmethod
def _unpack(data, formatter=None):

Unpack a low level representation of an address to its high level representation.

Parameters
data:`_Union[_reven_api.PhysicalAddress, _reven_api.VirtualAddress]`	Undocumented
formatter:`_Optional[Formatter]`	Undocumented
Returns
`Address`	Undocumented

@staticmethod
def _unpack_segment_register(data):

Undocumented

Parameters
data:`_reven_api.SegmentRegister`	Undocumented
Returns
`_Optional[_register.Register]`	Undocumented

@_abc.abstractmethod
def _address_data(self):

overridden in reven2.address.LinearAddress, reven2.address.LogicalAddress, reven2.address.LogicalAddressSegmentIndex, reven2.address.PhysicalAddress

Undocumented

@_abc.abstractmethod
def _is_comparable(self, other):

overridden in reven2.address.LinearAddress, reven2.address.LogicalAddress, reven2.address.LogicalAddressSegmentIndex, reven2.address.PhysicalAddress

Whether two address objects are comparable or not.

Parameters
other:`_Any`	Undocumented
Returns
`bool`	Undocumented

@_abc.abstractmethod
def _pack(self):

overridden in reven2.address.LinearAddress, reven2.address.LogicalAddress, reven2.address.LogicalAddressSegmentIndex, reven2.address.PhysicalAddress

Pack an address to its high level representation.

Returns
`_Union[_reven_api.PhysicalAddress, _reven_api.VirtualAddress]`	Undocumented

def _repr_html_(self):

Representation used by Jupyter when an instance of the address classes is displayed in a cell.

Returns
`str`	Undocumented

_unique_count: int =

Undocumented

_formatter =

Undocumented

_offset =

Undocumented