Changeset 100909 in vbox for trunk/include/iprt

Timestamp:

Aug 19, 2023 2:58:26 AM (20 months ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

158846

Message:

IPRT: Added a virtual file system view of PDB files.

Location:

trunk/include/iprt

Files:

• formats/pdb.h (added)
• fsvfs.h (modified) (1 diff)
• mangling.h (modified) (1 diff)

trunk/include/iprt/fsvfs.h

@@ -197 +197 @@
 
 
+/** @name RTFSPDB_F_XXX - PDB mount flags.
+ * @{ */
+/** Don't provide module names, just plain stream numbering. */
+#define RTFSPDB_F_NO_NAMES          RT_BIT_32(0)
 /** @} */
 
+/**
+ * Opens an PDB container volume.
+ *
+ * The program database container files are used by the Microsoft Visual C++
+ * toolchain for storing debug information (.pdb), intermediate compiler state
+ * (.idb) and possibly other things.  They are supposedly a win9x alternative to
+ * using NTFS file streams, so the container contains "streams" rather than
+ * "files".
+ *
+ * The streams are numbered and can all be opened by their number, e.g. "1" will
+ * open the PDB metadata header stream.  If the stream is special or have an
+ * name map entry, the name will be appended to the stream number together with
+ * a dash. So, stream "1" can also be accessed as "1-Pdb".
+ *
+ * The PDB version can be obtained by querying RTVFSQIEX_VOL_LABEL_ALT, which
+ * will return "pdb-v2" or "pdb-v7"
+ *
+ * @returns IPRT status code.
+ * @param   hVfsFileIn      The file or device backing the volume.
+ * @param   fFlags          RTFSPDB_F_XXX.
+ * @param   phVfs           Where to return the virtual file system handle.
+ * @param   pErrInfo        Where to return additional error information.
+ */
+RTDECL(int) RTFsPdbVolOpen(RTVFSFILE hVfsFileIn, uint32_t fFlags, PRTVFS phVfs, PRTERRINFO pErrInfo);
+
+/** @} */
+
 RT_C_DECLS_END
 

trunk/include/iprt/mangling.h

@@ -1115 +1115 @@
 # define RTFsIsoMakerCmdEx                              RT_MANGLER(RTFsIsoMakerCmdEx)
 # define RTFsNtfsVolOpen                                RT_MANGLER(RTFsNtfsVolOpen)
+# define RTFsPdbVolOpen                                 RT_MANGLER(RTFsPdbVolOpen)
 # define RTFtpServerCreate                              RT_MANGLER(RTFtpServerCreate)
 # define RTFtpServerDestroy                             RT_MANGLER(RTFtpServerDestroy)