def iter_subkeys(self):
if not self.header.subkey_count:
return None
# Go to the offset where the subkey list starts (+4 is because of the cell header)
target_offset = REGF_HEADER_SIZE + 4 + self.header.subkeys_list_offset
self._stream.seek(target_offset)
# Read the signature
try:
signature = Bytes(2).parse_stream(self._stream)
except StreamError as ex:
raise RegistryParsingException(
f'Bad subkey at offset {target_offset}: {ex}')
# LF, LH and RI contain subkeys
if signature in [
HASH_LEAF_SIGNATURE, FAST_LEAF_SIGNATURE, LEAF_INDEX_SIGNATURE
]:
yield from self._parse_subkeys(self._stream, signature=signature)
# RI contains pointers to arrays of subkeys
elif signature == INDEX_ROOT_SIGNATURE:
ri_record = RIRecord(self._stream)
if ri_record.header.element_count > 0:
for element in ri_record.header.elements:
# We skip 6 because of the signature as well as the cell header
element_target_offset = REGF_HEADER_SIZE + 4 + element.subkey_list_offset
self._stream.seek(element_target_offset)
yield from self._parse_subkeys(self._stream)
def _parse_subkeys(stream, signature=None):
"""
Parse an LI , LF or LH Record
:param stream: A stream at the header of the LH or LF entry, skipping the signature
:return:
"""
if not signature:
signature = stream.read(2)
if signature in [HASH_LEAF_SIGNATURE, FAST_LEAF_SIGNATURE]:
subkeys = LF_LH_SK_ELEMENT.parse_stream(stream)
elif signature == LEAF_INDEX_SIGNATURE:
subkeys = INDEX_LEAF.parse_stream(stream)
else:
raise RegistryParsingException(
f'Expected a known signature, got: {signature} at offset {stream.tell()}'
)
for subkey in subkeys.elements:
stream.seek(REGF_HEADER_SIZE + subkey.key_node_offset)
# This cell should always be allocated, therefor we expect a negative size
cell_size = Int32sl.parse_stream(stream) * -1
# We read to this offset and skip 2 bytes, because that is the cell size we just read
nk_cell = Cell(cell_type='nk',
offset=stream.tell() + 2,
size=cell_size)
nk_record = NKRecord(cell=nk_cell, stream=stream)
yield nk_record
def iter_values(self, as_json=False, max_len=MAX_LEN):
"""
Get the values of a subkey. Will raise if no values exist
:param as_json: Whether to normalize the data as JSON or not
:param max_len: Max length of value to return
:return: List of values for the subkey
"""
if not self.values_count:
return
# Get the offset of the values key. We skip 4 because of Cell Header
target_offset = REGF_HEADER_SIZE + 4 + self.header.values_list_offset
self._stream.seek(target_offset)
for _ in range(self.values_count):
is_corrupted = False
try:
vk_offset = Int32ul.parse_stream(self._stream)
except StreamError:
logger.info(
f'Skipping bad registry VK at {self._stream.tell()}')
raise RegistryParsingException(
f'Bad registry VK at {self._stream.tell()}')
with boomerang_stream(self._stream) as substream:
actual_vk_offset = REGF_HEADER_SIZE + 4 + vk_offset
substream.seek(actual_vk_offset)
try:
vk = VALUE_KEY.parse_stream(substream)
except (ConstError, StreamError):
logger.error(
f'Could not parse VK at {substream.tell()}, registry hive is probably corrupted.'
)
return
value = self.read_value(vk, substream)
if vk.name_size == 0:
value_name = '(default)'
else:
value_name = vk.name.decode(errors='replace')
# If the value is bigger than this value, it means this is a DEVPROP structure
# https://doxygen.reactos.org/d0/dba/devpropdef_8h_source.html
# https://sourceforge.net/p/mingw-w64/mingw-w64/ci/668a1d3e85042c409e0c292e621b3dc0aa26177c/tree/
# mingw-w64-headers/include/devpropdef.h?diff=dd86a3b7594dadeef9d6a37c4b6be3ca42ef7e94
# We currently do not support these, but also wouldn't like to yield this as binary data
# This int casting will always work because the data_type is construct's EnumIntegerString
# TODO: Add actual parsing
if int(vk.data_type) > 0xffff0000:
data_type = int(vk.data_type) & 0xffff
continue
# Skip this unknown data type, research pending :)
# TODO: Add actual parsing
if int(vk.data_type) == 0x200000:
continue
data_type = str(vk.data_type)
if data_type in ['REG_SZ', 'REG_EXPAND', 'REG_EXPAND_SZ']:
if vk.data_size >= 0x80000000:
# data is contained in the data_offset field
value.size -= 0x80000000
actual_value = vk.data_offset
elif vk.data_size > 0x3fd8 and value.value[:2] == b'db':
data = self._parse_indirect_block(substream, value)
actual_value = try_decode_binary(data, as_json=as_json)
else:
actual_value = try_decode_binary(value.value,
as_json=as_json)
elif data_type in ['REG_BINARY', 'REG_NONE']:
if vk.data_size >= 0x80000000:
# data is contained in the data_offset field
actual_value = vk.data_offset
elif vk.data_size > 0x3fd8 and value.value[:2] == b'db':
try:
actual_value = self._parse_indirect_block(
substream, value)
actual_value = try_decode_binary(
actual_value,
as_json=True) if as_json else actual_value
except ConstError:
logger.error(f'Bad value at {actual_vk_offset}')
continue
else:
# Return the actual data
actual_value = binascii.b2a_hex(value.value).decode(
)[:max_len] if as_json else value.value
elif data_type == 'REG_SZ':
actual_value = try_decode_binary(value.value,
as_json=as_json)
elif data_type == 'REG_DWORD':
# If the data size is bigger than 0x80000000, data is actually stored in the VK data offset.
actual_value = vk.data_offset if vk.data_size >= 0x80000000 else Int32ul.parse(
value.value)
elif data_type == 'REG_QWORD':
actual_value = vk.data_offset if vk.data_size >= 0x80000000 else Int64ul.parse(
value.value)
elif data_type == 'REG_MULTI_SZ':
parsed_value = GreedyRange(CString('utf-16-le')).parse(
value.value)
# Because the ListContainer object returned by Construct cannot be turned into a list,
# we do this trick
actual_value = [x for x in parsed_value if x]
# We currently dumps this as hex string or raw
# TODO: Add actual parsing
elif data_type in [
'REG_RESOURCE_REQUIREMENTS_LIST', 'REG_RESOURCE_LIST'
]:
actual_value = binascii.b2a_hex(value.value).decode(
)[:max_len] if as_json else value.value
else:
actual_value = try_decode_binary(value.value,
as_json=as_json)
yield Value(name=value_name,
value_type=str(value.value_type),
value=actual_value,
is_corrupted=is_corrupted)