2015-03-13 14:48:53 +08:00
|
|
|
/* ffsparser.h
|
|
|
|
|
2017-12-11 09:56:00 +08:00
|
|
|
Copyright (c) 2017, LongSoft. All rights reserved.
|
2015-03-13 14:48:53 +08:00
|
|
|
This program and the accompanying materials
|
|
|
|
are licensed and made available under the terms and conditions of the BSD License
|
|
|
|
which accompanies this distribution. The full text of the license may be found at
|
|
|
|
http://opensource.org/licenses/bsd-license.php
|
|
|
|
|
|
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
|
|
WITHWARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
*/
|
|
|
|
|
2016-04-09 18:47:19 +08:00
|
|
|
#ifndef FFSPARSER_H
|
|
|
|
#define FFSPARSER_H
|
2015-03-13 14:48:53 +08:00
|
|
|
|
2016-03-01 15:20:44 +08:00
|
|
|
#include <vector>
|
|
|
|
|
2016-10-10 14:05:04 +08:00
|
|
|
#include "basetypes.h"
|
2016-06-26 11:54:21 +08:00
|
|
|
#include "ustring.h"
|
|
|
|
#include "ubytearray.h"
|
2016-02-02 09:08:08 +08:00
|
|
|
#include "treemodel.h"
|
2017-10-12 13:59:23 +08:00
|
|
|
#include "bootguard.h"
|
|
|
|
|
|
|
|
typedef struct BG_PROTECTED_RANGE_
|
|
|
|
{
|
|
|
|
UINT32 Offset;
|
|
|
|
UINT32 Size;
|
|
|
|
UINT8 Type;
|
|
|
|
UByteArray Hash;
|
|
|
|
} BG_PROTECTED_RANGE;
|
|
|
|
|
2017-12-11 09:56:00 +08:00
|
|
|
#define BG_PROTECTED_RANGE_INTEL_BOOT_GUARD_IBB 0x01
|
|
|
|
#define BG_PROTECTED_RANGE_INTEL_BOOT_GUARD_POST_IBB 0x02
|
|
|
|
#define BG_PROTECTED_RANGE_VENDOR_HASH_PHOENIX 0x03
|
|
|
|
#define BG_PROTECTED_RANGE_VENDOR_HASH_AMI_OLD 0x04
|
|
|
|
#define BG_PROTECTED_RANGE_VENDOR_HASH_AMI_NEW 0x05
|
|
|
|
#define BG_PROTECTED_RANGE_VENDOR_HASH_MICROSOFT 0x06
|
|
|
|
|
|
|
|
class NvramParser;
|
|
|
|
class MeParser;
|
2015-03-13 14:48:53 +08:00
|
|
|
|
2016-03-01 15:20:44 +08:00
|
|
|
class FfsParser
|
2015-03-13 14:48:53 +08:00
|
|
|
{
|
|
|
|
public:
|
2017-12-11 09:56:00 +08:00
|
|
|
// Constructor and destructor
|
|
|
|
FfsParser(TreeModel* treeModel);
|
|
|
|
~FfsParser();
|
2015-03-13 14:48:53 +08:00
|
|
|
|
2017-07-09 03:31:57 +08:00
|
|
|
// Obtain parser messages
|
2017-12-11 09:56:00 +08:00
|
|
|
std::vector<std::pair<UString, UModelIndex> > getMessages() const;
|
2017-07-09 03:31:57 +08:00
|
|
|
// Clear messages
|
2016-04-15 02:36:59 +08:00
|
|
|
void clearMessages() { messagesVector.clear(); }
|
2015-03-13 14:48:53 +08:00
|
|
|
|
2017-07-09 03:31:57 +08:00
|
|
|
// Parse firmware image
|
2016-06-26 11:54:21 +08:00
|
|
|
USTATUS parse(const UByteArray &buffer);
|
2016-03-01 15:20:44 +08:00
|
|
|
|
2016-07-15 03:22:51 +08:00
|
|
|
// Obtain parsed FIT table
|
2016-11-03 03:40:38 +08:00
|
|
|
std::vector<std::pair<std::vector<UString>, UModelIndex> > getFitTable() const { return fitTable; }
|
2015-07-07 21:57:41 +08:00
|
|
|
|
2017-10-12 13:59:23 +08:00
|
|
|
// Obtain BootGuardInfo
|
|
|
|
UString getBootGuardInfo() const { return bootGuardInfo; }
|
|
|
|
|
2017-07-09 03:31:57 +08:00
|
|
|
// Obtain offset/address difference
|
|
|
|
UINT64 getAddressDiff() { return addressDiff; }
|
|
|
|
|
2015-03-13 14:48:53 +08:00
|
|
|
private:
|
|
|
|
TreeModel *model;
|
2016-06-26 11:54:21 +08:00
|
|
|
std::vector<std::pair<UString, UModelIndex> > messagesVector;
|
|
|
|
void msg(const UString message, const UModelIndex index = UModelIndex()) {
|
|
|
|
messagesVector.push_back(std::pair<UString, UModelIndex>(message, index));
|
2016-04-18 21:10:07 +08:00
|
|
|
};
|
|
|
|
|
2017-12-11 09:56:00 +08:00
|
|
|
NvramParser* nvramParser;
|
|
|
|
MeParser* meParser;
|
2016-11-03 03:40:38 +08:00
|
|
|
|
2017-10-12 13:59:23 +08:00
|
|
|
UByteArray openedImage;
|
2016-06-26 11:54:21 +08:00
|
|
|
UModelIndex lastVtf;
|
2018-04-30 13:33:19 +08:00
|
|
|
UINT32 imageBase;
|
2017-07-09 03:31:57 +08:00
|
|
|
UINT64 addressDiff;
|
2016-11-03 03:40:38 +08:00
|
|
|
std::vector<std::pair<std::vector<UString>, UModelIndex> > fitTable;
|
2017-10-12 13:59:23 +08:00
|
|
|
|
|
|
|
UString bootGuardInfo;
|
|
|
|
bool bgAcmFound;
|
|
|
|
bool bgKeyManifestFound;
|
|
|
|
bool bgBootPolicyFound;
|
|
|
|
UByteArray bgKmHash;
|
|
|
|
UByteArray bgBpHash;
|
|
|
|
UByteArray bgBpDigest;
|
|
|
|
std::vector<BG_PROTECTED_RANGE> bgProtectedRanges;
|
|
|
|
UINT64 bgFirstVolumeOffset;
|
|
|
|
UModelIndex bgDxeCoreIndex;
|
2016-10-10 14:05:04 +08:00
|
|
|
|
2016-07-15 03:22:51 +08:00
|
|
|
// First pass
|
|
|
|
USTATUS performFirstPass(const UByteArray & imageFile, UModelIndex & index);
|
2015-03-13 14:48:53 +08:00
|
|
|
|
2018-04-30 13:33:19 +08:00
|
|
|
USTATUS parseCapsule(const UByteArray & capsule, UModelIndex & index);
|
|
|
|
USTATUS parseIntelImage(const UByteArray & intelImage, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index);
|
|
|
|
USTATUS parseGenericImage(const UByteArray & intelImage, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index);
|
|
|
|
|
2016-06-26 11:54:21 +08:00
|
|
|
USTATUS parseRawArea(const UModelIndex & index);
|
2016-10-28 00:31:15 +08:00
|
|
|
USTATUS parseVolumeHeader(const UByteArray & volume, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index);
|
2016-06-26 11:54:21 +08:00
|
|
|
USTATUS parseVolumeBody(const UModelIndex & index);
|
2016-10-28 00:31:15 +08:00
|
|
|
USTATUS parseFileHeader(const UByteArray & file, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index);
|
2016-06-26 11:54:21 +08:00
|
|
|
USTATUS parseFileBody(const UModelIndex & index);
|
2016-10-28 00:31:15 +08:00
|
|
|
USTATUS parseSectionHeader(const UByteArray & section, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index, const bool insertIntoTree);
|
2016-06-26 11:54:21 +08:00
|
|
|
USTATUS parseSectionBody(const UModelIndex & index);
|
|
|
|
|
2016-10-28 00:31:15 +08:00
|
|
|
USTATUS parseGbeRegion(const UByteArray & gbe, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index);
|
|
|
|
USTATUS parseMeRegion(const UByteArray & me, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index);
|
|
|
|
USTATUS parseBiosRegion(const UByteArray & bios, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index);
|
|
|
|
USTATUS parsePdrRegion(const UByteArray & pdr, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index);
|
2017-12-11 09:56:00 +08:00
|
|
|
USTATUS parseGenericRegion(const UINT8 subtype, const UByteArray & region, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index);
|
2016-06-26 11:54:21 +08:00
|
|
|
|
|
|
|
USTATUS parsePadFileBody(const UModelIndex & index);
|
2016-10-28 00:31:15 +08:00
|
|
|
USTATUS parseVolumeNonUefiData(const UByteArray & data, const UINT32 localOffset, const UModelIndex & index);
|
2016-06-26 11:54:21 +08:00
|
|
|
|
2016-07-16 13:02:33 +08:00
|
|
|
USTATUS parseSections(const UByteArray & sections, const UModelIndex & index, const bool insertIntoTree);
|
2016-10-28 00:31:15 +08:00
|
|
|
USTATUS parseCommonSectionHeader(const UByteArray & section, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index, const bool insertIntoTree);
|
|
|
|
USTATUS parseCompressedSectionHeader(const UByteArray & section, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index, const bool insertIntoTree);
|
|
|
|
USTATUS parseGuidedSectionHeader(const UByteArray & section, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index, const bool insertIntoTree);
|
|
|
|
USTATUS parseFreeformGuidedSectionHeader(const UByteArray & section, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index, const bool insertIntoTree);
|
|
|
|
USTATUS parseVersionSectionHeader(const UByteArray & section, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index, const bool insertIntoTree);
|
|
|
|
USTATUS parsePostcodeSectionHeader(const UByteArray & section, const UINT32 localOffset, const UModelIndex & parent, UModelIndex & index, const bool insertIntoTree);
|
2016-06-26 11:54:21 +08:00
|
|
|
|
|
|
|
USTATUS parseCompressedSectionBody(const UModelIndex & index);
|
|
|
|
USTATUS parseGuidedSectionBody(const UModelIndex & index);
|
|
|
|
USTATUS parseVersionSectionBody(const UModelIndex & index);
|
|
|
|
USTATUS parseDepexSectionBody(const UModelIndex & index);
|
|
|
|
USTATUS parseUiSectionBody(const UModelIndex & index);
|
|
|
|
USTATUS parseRawSectionBody(const UModelIndex & index);
|
|
|
|
USTATUS parsePeImageSectionBody(const UModelIndex & index);
|
|
|
|
USTATUS parseTeImageSectionBody(const UModelIndex & index);
|
|
|
|
|
|
|
|
USTATUS parseAprioriRawSection(const UByteArray & body, UString & parsed);
|
2018-04-30 13:33:19 +08:00
|
|
|
USTATUS findNextVolume(const UModelIndex & index, const UByteArray & bios, const UINT32 globalOffset, const UINT32 volumeOffset, UINT32 & nextVolumeOffset);
|
2016-06-26 11:54:21 +08:00
|
|
|
USTATUS getVolumeSize(const UByteArray & bios, const UINT32 volumeOffset, UINT32 & volumeSize, UINT32 & bmVolumeSize);
|
2016-07-16 13:02:33 +08:00
|
|
|
UINT32 getFileSize(const UByteArray & volume, const UINT32 fileOffset, const UINT8 ffsVersion);
|
|
|
|
UINT32 getSectionSize(const UByteArray & file, const UINT32 sectionOffset, const UINT8 ffsVersion);
|
2016-06-26 11:54:21 +08:00
|
|
|
|
2016-07-15 03:22:51 +08:00
|
|
|
// Second pass
|
|
|
|
USTATUS performSecondPass(const UModelIndex & index);
|
|
|
|
USTATUS addOffsetsRecursive(const UModelIndex & index);
|
2017-07-09 03:31:57 +08:00
|
|
|
USTATUS addMemoryAddressesRecursive(const UModelIndex & index);
|
2016-07-15 03:22:51 +08:00
|
|
|
USTATUS addFixedAndCompressedRecursive(const UModelIndex & index);
|
2017-10-12 13:59:23 +08:00
|
|
|
USTATUS checkProtectedRanges(const UModelIndex & index);
|
|
|
|
USTATUS markProtectedRangeRecursive(const UModelIndex & index, const BG_PROTECTED_RANGE & range);
|
|
|
|
|
2017-07-09 03:31:57 +08:00
|
|
|
USTATUS parseFit(const UModelIndex & index);
|
2017-10-12 13:59:23 +08:00
|
|
|
USTATUS parseVendorHashFile(const UByteArray & fileGuid, const UModelIndex & index);
|
|
|
|
|
|
|
|
#ifdef U_ENABLE_FIT_PARSING_SUPPORT
|
2017-07-09 03:31:57 +08:00
|
|
|
USTATUS findFitRecursive(const UModelIndex & index, UModelIndex & found, UINT32 & fitOffset);
|
2017-10-12 13:59:23 +08:00
|
|
|
|
|
|
|
// FIT entries
|
|
|
|
USTATUS parseIntelMicrocode(const UByteArray & microcode, const UINT32 localOffset, const UModelIndex & parent, UString & info, UINT32 &realSize);
|
|
|
|
USTATUS parseIntelAcm(const UByteArray & acm, const UINT32 localOffset, const UModelIndex & parent, UString & info, UINT32 &realSize);
|
|
|
|
USTATUS parseIntelBootGuardKeyManifest(const UByteArray & keyManifest, const UINT32 localOffset, const UModelIndex & parent, UString & info, UINT32 &realSize);
|
|
|
|
USTATUS parseIntelBootGuardBootPolicy(const UByteArray & bootPolicy, const UINT32 localOffset, const UModelIndex & parent, UString & info, UINT32 &realSize);
|
2017-11-06 15:10:06 +08:00
|
|
|
USTATUS findNextElement(const UByteArray & bootPolicy, const UINT32 elementOffset, UINT32 & nextElementOffset, UINT32 & nextElementSize);
|
2017-10-12 13:59:23 +08:00
|
|
|
#endif
|
2017-12-11 09:56:00 +08:00
|
|
|
|
|
|
|
#ifdef U_ENABLE_NVRAM_PARSING_SUPPORT
|
|
|
|
friend class NvramParser; // Make FFS parsing routines accessible to NvramParser
|
|
|
|
#endif
|
2015-03-13 14:48:53 +08:00
|
|
|
};
|
|
|
|
|
2016-04-09 18:47:19 +08:00
|
|
|
#endif // FFSPARSER_H
|