Files
2018-05-23 15:59:36 -04:00

437 lines
17 KiB
Python

# fileobjscan.py
# Copyright 2009 Andreas Schuster <a.schuster@yendor.net>
# Copyright (C) 2009-2013 Volatility Foundation
#
# This file is part of Volatility.
#
# Volatility is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# Volatility is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with Volatility. If not, see <http://www.gnu.org/licenses/>.
#
"""
@author: Andreas Schuster
@license: GNU General Public License 2.0
@contact: a.schuster@forensikblog.de
@organization: http://computer.forensikblog.de/en/
"""
import volatility.plugins.common as common
import volatility.obj as obj
import volatility.poolscan as poolscan
import volatility.utils as utils
from volatility.renderers import TreeGrid
from volatility.renderers.basic import Address
class PoolScanFile(poolscan.PoolScanner):
"""Pool scanner for file objects"""
def __init__(self, address_space):
poolscan.PoolScanner.__init__(self, address_space)
self.struct_name = "_FILE_OBJECT"
self.object_type = "File"
self.pooltag = obj.VolMagic(address_space).FilePoolTag.v()
size = 0x98 # self.address_space.profile.get_obj_size("_FILE_OBJECT")
self.checks = [
('CheckPoolSize', dict(condition = lambda x: x >= size)),
('CheckPoolType', dict(paged = False, non_paged = True, free = True)),
('CheckPoolIndex', dict(value = lambda x : x < 5)),
]
class FileScan(common.AbstractScanCommand):
"""Pool scanner for file objects"""
scanners = [PoolScanFile]
# Declare meta information associated with this plugin
meta_info = {}
meta_info['author'] = 'Andreas Schuster'
meta_info['copyright'] = 'Copyright (c) 2009 Andreas Schuster'
meta_info['contact'] = 'a.schuster@forensikblog.de'
meta_info['license'] = 'GNU General Public License 2.0'
meta_info['url'] = 'http://computer.forensikblog.de/en/'
meta_info['os'] = 'WIN_32_XP_SP2'
meta_info['version'] = '0.1'
def render_text(self, outfd, data):
self.table_header(outfd, [(self.offset_column(), '#018x'),
('#Ptr', '>6'),
('#Hnd', '>6'),
('Access', '>6'),
('Name', '')
])
for file in data:
header = file.get_object_header()
self.table_row(outfd,
file.obj_offset,
header.PointerCount,
header.HandleCount,
file.access_string(),
str(file.file_name_with_device() or ''))
def unified_output(self, data):
return TreeGrid([(self.offset_column(), Address),
("Pointers", int),
("Handles", int),
("Access", str),
("Name", str)],
self.generator(data))
def generator(self, data):
for file in data:
header = file.get_object_header()
yield (0, [Address(file.obj_offset),
int(header.PointerCount),
int(header.HandleCount),
str(file.access_string()),
str(file.file_name_with_device() or '')])
class PoolScanDriver(poolscan.PoolScanner):
"""Pool scanner for driver objects"""
def __init__(self, address_space):
poolscan.PoolScanner.__init__(self, address_space)
self.struct_name = "_DRIVER_OBJECT"
self.object_type = "Driver"
# due to the placement of the driver extension, we
# use the top down approach instead of bottom-up.
self.use_top_down = True
self.pooltag = obj.VolMagic(address_space).DriverPoolTag.v()
size = 0xf8 # self.address_space.profile.get_obj_size("_DRIVER_OBJECT")
self.checks = [
('CheckPoolSize', dict(condition = lambda x: x >= size)),
('CheckPoolType', dict(paged = False, non_paged = True, free = True)),
('CheckPoolIndex', dict(value = lambda x : x < 5)),
]
class DriverScan(common.AbstractScanCommand):
"""Pool scanner for driver objects"""
scanners = [PoolScanDriver]
def unified_output(self, data):
return TreeGrid([(self.offset_column(), Address),
("Pointers", int),
("Handles", int),
("Start", Address),
("Size", int),
("Service Key", str),
("Name", str),
("Driver Name", str)],
self.generator(data))
def generator(self, data):
for driver in data:
header = driver.get_object_header()
yield (0, [Address(driver.obj_offset),
int(header.PointerCount),
int(header.HandleCount),
Address(driver.DriverStart),
int(driver.DriverSize),
str(driver.DriverExtension.ServiceKeyName or ''),
str(header.NameInfo.Name or ''),
str(driver.DriverName or '')])
def render_text(self, outfd, data):
self.table_header(outfd, [(self.offset_column(), '#018x'),
('#Ptr', '>8'),
('#Hnd', '>8'),
('Start', '[addrpad]'),
('Size', '[addr]'),
('Service Key', '20'),
('Name', '12'),
('Driver Name', '')
])
for driver in data:
header = driver.get_object_header()
self.table_row(outfd,
driver.obj_offset,
header.PointerCount,
header.HandleCount,
driver.DriverStart,
driver.DriverSize,
str(driver.DriverExtension.ServiceKeyName or ''),
str(header.NameInfo.Name or ''),
str(driver.DriverName or ''))
class PoolScanSymlink(poolscan.PoolScanner):
"""Pool scanner for symlink objects"""
def __init__(self, address_space):
poolscan.PoolScanner.__init__(self, address_space)
self.struct_name = "_OBJECT_SYMBOLIC_LINK"
self.object_type = "SymbolicLink"
self.pooltag = obj.VolMagic(address_space).SymlinkPoolTag.v()
size = 0x48 # self.address_space.profile.get_obj_size("_OBJECT_SYMBOLIC_LINK")
self.checks = [
('CheckPoolSize', dict(condition = lambda x: x >= size)),
('CheckPoolType', dict(paged = True, non_paged = True, free = True)),
]
class SymLinkScan(common.AbstractScanCommand):
"""Pool scanner for symlink objects"""
scanners = [PoolScanSymlink]
def unified_output(self, data):
return TreeGrid([(self.offset_column(), Address),
("Pointers", int),
("Handles", int),
("Creation Time", str),
("Origin", str),
("Target", str)],
self.generator(data))
def generator(self, data):
for link in data:
header = link.get_object_header()
yield (0, [Address(link.obj_offset),
int(header.PointerCount),
int(header.HandleCount),
str(link.CreationTime or ''),
str(header.NameInfo.Name or ''),
str(link.LinkTarget or '')])
def render_text(self, outfd, data):
self.table_header(outfd, [(self.offset_column(), '#018x'),
('#Ptr', '>6'),
('#Hnd', '>6'),
('Creation time', '30'),
('From', '<20'),
('To', '60'),
])
for link in data:
header = link.get_object_header()
self.table_row(outfd,
link.obj_offset,
header.PointerCount,
header.HandleCount,
link.CreationTime or '',
str(header.NameInfo.Name or ''),
str(link.LinkTarget or ''))
class PoolScanMutant(poolscan.PoolScanner):
"""Pool scanner for mutex objects"""
def __init__(self, address_space, **kwargs):
poolscan.PoolScanner.__init__(self, address_space, **kwargs)
self.struct_name = "_KMUTANT"
self.object_type = "Mutant"
self.pooltag = obj.VolMagic(address_space).MutexPoolTag.v()
size = 0x40 # self.address_space.profile.get_obj_size("_KMUTANT")
self.checks = [
('CheckPoolSize', dict(condition = lambda x: x >= size)),
('CheckPoolType', dict(paged = False, non_paged = True, free = True)),
('CheckPoolIndex', dict(value = lambda x : x < 5)),
]
class MutantScan(common.AbstractScanCommand):
"""Pool scanner for mutex objects"""
scanners = [PoolScanMutant]
def __init__(self, config, *args, **kwargs):
common.AbstractScanCommand.__init__(self, config, *args, **kwargs)
config.add_option("SILENT", short_option = 's', default = False,
action = 'store_true',
help = 'Suppress less meaningful results')
def unified_output(self, data):
return TreeGrid([(self.offset_column(), Address),
("Pointers", int),
("Handles", int),
("Signal", str),
("Thread", Address),
("CID", str),
("Name", str)],
self.generator(data))
def generator(self, data):
for mutant in data:
header = mutant.get_object_header()
name = str(header.NameInfo.Name or '')
CID = ""
if mutant.OwnerThread.is_valid():
thread = mutant.OwnerThread.dereference_as('_ETHREAD')
CID = "{0}:{1}".format(thread.Cid.UniqueProcess, thread.Cid.UniqueThread)
if self._config.SILENT and not CID and not name:
continue
yield (0, [Address(mutant.obj_offset),
int(header.PointerCount),
int(header.HandleCount),
str(mutant.Header.SignalState),
Address(mutant.OwnerThread),
str(CID),
name])
def render_text(self, outfd, data):
self.table_header(outfd, [(self.offset_column(), '#018x'),
('#Ptr', '>8'),
('#Hnd', '>8'),
('Signal', '4'),
('Thread', '[addrpad]'),
('CID', '>9'),
('Name', '')
])
for mutant in data:
header = mutant.get_object_header()
name = str(header.NameInfo.Name or '')
CID = ""
if mutant.OwnerThread.is_valid():
thread = mutant.OwnerThread.dereference_as('_ETHREAD')
CID = "{0}:{1}".format(thread.Cid.UniqueProcess, thread.Cid.UniqueThread)
if self._config.SILENT and not CID and not name:
continue
self.table_row(outfd,
mutant.obj_offset,
header.PointerCount,
header.HandleCount,
mutant.Header.SignalState,
mutant.OwnerThread, CID,
name)
class PoolScanProcess(poolscan.PoolScanner):
"""Pool scanner for process objects"""
def __init__(self, address_space, **kwargs):
poolscan.PoolScanner.__init__(self, address_space, **kwargs)
self.struct_name = "_EPROCESS"
self.object_type = "Process"
# this allows us to find terminated processes
self.skip_type_check = True
self.pooltag = obj.VolMagic(address_space).ProcessPoolTag.v()
size = 0x1ae # self.address_space.profile.get_obj_size("_EPROCESS")
self.checks = [
('CheckPoolSize', dict(condition = lambda x: x >= size)),
('CheckPoolType', dict(paged = False, non_paged = True, free = True)),
('CheckPoolIndex', dict(value = lambda x : x < 5)),
]
class PSScan(common.AbstractScanCommand):
"""Pool scanner for process objects"""
scanners = [PoolScanProcess]
# Declare meta information associated with this plugin
meta_info = {}
meta_info['author'] = 'AAron Walters'
meta_info['copyright'] = 'Copyright (c) 2011 Volatility Foundation'
meta_info['contact'] = 'awalters@4tphi.net'
meta_info['license'] = 'GNU General Public License 2.0'
meta_info['url'] = 'https://www.volatilityfoundation.org/'
meta_info['os'] = ['Win7SP0x86', 'WinXPSP3x86']
meta_info['version'] = '0.1'
def calculate(self):
# start with a physical space so we can find processes without a DTB
addr_space = utils.load_as(self._config, astype = 'physical')
meta = addr_space.profile.metadata
win10 = (meta.get("major"), meta.get("minor")) == (6, 4)
# if the user selected virtual space or if we're on win10, switch
# to a virtual kernel space
if self._config.VIRTUAL or win10:
addr_space = utils.load_as(self._config)
return self.scan_results(addr_space)
def render_dot(self, outfd, data):
objects = set()
links = set()
for eprocess in data:
label = "{0} | {1} |".format(eprocess.UniqueProcessId,
eprocess.ImageFileName)
if eprocess.ExitTime:
label += "exited\\n{0}".format(eprocess.ExitTime)
options = ' style = "filled" fillcolor = "lightgray" '
else:
label += "running"
options = ''
objects.add('pid{0} [label="{1}" shape="record" {2}];\n'.format(eprocess.UniqueProcessId,
label, options))
links.add("pid{0} -> pid{1} [];\n".format(eprocess.InheritedFromUniqueProcessId,
eprocess.UniqueProcessId))
## Now write the dot file
outfd.write("digraph processtree { \ngraph [rankdir = \"TB\"];\n")
for link in links:
outfd.write(link)
for item in objects:
outfd.write(item)
outfd.write("}")
def unified_output(self, data):
return TreeGrid([(self.offset_column(), Address),
("Name", str),
("PID", int),
("PPID", int),
("PDB", Address),
("Time Created", str),
("Time Exited", str)],
self.generator(data))
def generator(self, data):
for eprocess in data:
yield (0, [Address(eprocess.obj_offset),
str(eprocess.ImageFileName),
int(eprocess.UniqueProcessId),
int(eprocess.InheritedFromUniqueProcessId),
Address(eprocess.Pcb.DirectoryTableBase),
str(eprocess.CreateTime or ''),
str(eprocess.ExitTime or '')])
def render_text(self, outfd, data):
self.table_header(outfd, [(self.offset_column(), '#018x'),
('Name', '16'),
('PID', '>6'),
('PPID', '>6'),
('PDB', '[addrpad]'),
('Time created', '30'),
('Time exited', '30')
])
for eprocess in data:
self.table_row(outfd,
eprocess.obj_offset,
eprocess.ImageFileName,
eprocess.UniqueProcessId,
eprocess.InheritedFromUniqueProcessId,
eprocess.Pcb.DirectoryTableBase,
eprocess.CreateTime or '',
eprocess.ExitTime or '')