Files

295 lines
11 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 = 0)),
]
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 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 = 0)),
]
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 '')])
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 '')])
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 = 0)),
]
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()
if mutant.OwnerThread.is_valid():
thread = mutant.OwnerThread.dereference_as('_ETHREAD')
CID = "{0}:{1}".format(thread.Cid.UniqueProcess, thread.Cid.UniqueThread)
else:
CID = ""
yield (0, [Address(mutant.obj_offset),
int(header.PointerCount),
int(header.HandleCount),
str(mutant.Header.SignalState),
Address(mutant.OwnerThread),
str(CID),
str(header.NameInfo.Name or '')])
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 = 0)),
]
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):
if self._config.VIRTUAL:
addr_space = utils.load_as(self._config)
else:
addr_space = utils.load_as(self._config, astype = 'physical')
return self.scan_results(addr_space)
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 '')])