Merge branch 'main' into sb/zen-helpsb/zen-help

- Combine HelpCommand (this branch) with HistoryCommand (main) in zen CLI dispatcher
- Keep filter-aware TuiPickOne rewrite; adopt main's ASCII arrow glyphs in doc comment

1 files changed, 55 insertions, 0 deletions

diff --git a/thirdparty/raw_pdb/src/PDB.cpp b/thirdparty/raw_pdb/src/PDB.cpp
new file mode 100644
index 000000000..0bbd3a7e9
--- /dev/null
+++ b/thirdparty/raw_pdb/src/PDB.cpp
@@ -0,0 +1,55 @@
+// Copyright 2011-2022, Molecular Matters GmbH <[email protected]>
+// See LICENSE.txt for licensing details (2-clause BSD License: https://opensource.org/licenses/BSD-2-Clause)
+
+#include "PDB_PCH.h"
+#include "PDB.h"
+#include "PDB_Types.h"
+#include "PDB_Util.h"
+#include "PDB_RawFile.h"
+#include "Foundation/PDB_PointerUtil.h"
+#include "Foundation/PDB_CRT.h"
+
+
+// ------------------------------------------------------------------------------------------------
+// ------------------------------------------------------------------------------------------------
+PDB_NO_DISCARD PDB::ErrorCode PDB::ValidateFile(const void* data, size_t size) PDB_NO_EXCEPT
+{
+	// validate whether there is enough size for the super block
+	if (size < sizeof(SuperBlock))
+	{
+		return ErrorCode::InvalidDataSize;
+	}
+	// validate the super block
+	const SuperBlock* superBlock = Pointer::Offset<const SuperBlock*>(data, 0u);
+	{
+		// validate header magic
+		if (memcmp(superBlock->fileMagic, SuperBlock::MAGIC, sizeof(SuperBlock::MAGIC)) != 0)
+		{
+			return ErrorCode::InvalidSuperBlock;
+		}
+
+		// validate whether enough size is provided for the PDB file
+		// blockCount * blockSize is the size of the PDB file on disk
+		if (size < superBlock->blockCount * superBlock->blockSize)
+		{
+			return ErrorCode::InvalidDataSize;
+		}
+
+		// validate free block map.
+		// the free block map should always reside at either index 1 or 2.
+		if (superBlock->freeBlockMapIndex != 1u && superBlock->freeBlockMapIndex != 2u)
+		{
+			return ErrorCode::InvalidFreeBlockMap;
+		}
+	}
+
+	return ErrorCode::Success;
+}
+
+
+// ------------------------------------------------------------------------------------------------
+// ------------------------------------------------------------------------------------------------
+PDB_NO_DISCARD PDB::RawFile PDB::CreateRawFile(const void* data) PDB_NO_EXCEPT
+{
+	return RawFile(data);
+}