Source code for volatility3.plugins.mac.ifconfig

# This file is Copyright 2019 Volatility Foundation and licensed under the Volatility Software License 1.0
# which is available at
from volatility3.framework import exceptions, renderers
from volatility3.framework.configuration import requirements
from volatility3.framework.interfaces import plugins
from volatility3.framework.objects import utility
from volatility3.framework.symbols import mac

[docs]class Ifconfig(plugins.PluginInterface): """Lists network interface information for all devices""" _required_framework_version = (2, 0, 0)
[docs] @classmethod def get_requirements(cls): return [ requirements.ModuleRequirement( name="kernel", description="Kernel module for the OS", architectures=["Intel32", "Intel64"], ), requirements.VersionRequirement( name="macutils", component=mac.MacUtilities, version=(1, 0, 0) ), ]
def _generator(self): kernel = self.context.modules[self.config["kernel"]] try: list_head = kernel.object_from_symbol(symbol_name="ifnet_head") except exceptions.SymbolError: list_head = kernel.object_from_symbol(symbol_name="dlil_ifnet_head") for ifnet in mac.MacUtilities.walk_tailq(list_head, "if_link"): name = utility.pointer_to_string(ifnet.if_name, 32) unit = ifnet.if_unit prom = ifnet.if_flags & 0x100 == 0x100 # IFF_PROMISC sock_addr_dl = ifnet.sockaddr_dl() if sock_addr_dl is None: mac_addr = renderers.UnreadableValue() else: mac_addr = str(sock_addr_dl) for ifaddr in mac.MacUtilities.walk_tailq(ifnet.if_addrhead, "ifa_link"): ip = ifaddr.ifa_addr.get_address() yield (0, (f"{name}{unit}", ip, mac_addr, prom))
[docs] def run(self): return renderers.TreeGrid( [ ("Interface", str), ("IP Address", str), ("Mac Address", str), ("Promiscuous", bool), ], self._generator(), )