Changeset 108215 in vbox for trunk/src/VBox/Runtime/include

Timestamp:

Feb 13, 2025 6:24:31 PM (2 months ago)

Author:

vboxsync

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

167535

Message:

Runtime/RTAcpi*: Treat External delcarations differently so that they can be properly dumped to the AML code. With this RTIasl is capable of producing AML code for vbox-tpm.dsl matching that generated by iasl, bugref:10733

File:

• trunk/src/VBox/Runtime/include/internal/acpi.h (modified) (3 diffs)

trunk/src/VBox/Runtime/include/internal/acpi.h

@@ -237 +237 @@
 
 
+/**
+ * External declaration.
+ */
+typedef struct RTACPIASLEXTERNAL
+{
+    /** List node for the list of externals. */
+    RTLISTNODE              NdExternal;
+    /** The object type. */
+    RTACPIOBJTYPE           enmObjType;
+    /** For methods this will hold the argument count. */
+    uint32_t                cArgs;
+    /** The name as parsed from the source file. */
+    const char              *pszName;
+    /** Size of the full name path in characters excluding the terminating zero. */
+    size_t                  cchNamePath;
+    /** The name path - variable in size. */
+    char                    szNamePath[1];
+} RTACPIASLEXTERNAL;
+/** Pointer to an external declaration. */
+typedef RTACPIASLEXTERNAL *PRTACPIASLEXTERNAL;
+/** Pointer to a const external declaration. */
+typedef const RTACPIASLEXTERNAL *PCRTACPIASLEXTERNAL;
+
+
+
 /** Pointer to an ACPI namespace entry. */
 typedef struct RTACPINSENTRY *PRTACPINSENTRY;
@@ -252 +277 @@
     /** The name segment identifying the entry. */
     char                    achNameSeg[4];
-    /** The AST node associated with this namespace entry. */
-    PCRTACPIASTNODE         pAstNd;
+    /** Flag whether this points to an AST node or an external. */
+    bool                    fAstNd;
+    /** Type dependent data. */
+    union
+    {
+        /** The AST node associated with this namespace entry. */
+        PCRTACPIASTNODE     pAstNd;
+        /** Pointer to the external declaration. */
+        PCRTACPIASLEXTERNAL pExternal;
+    };
     /** Bit offset for resource fields. */
     uint32_t                offBits;
@@ -358 +391 @@
 
 /**
+ * Adds a new namespace entry to the given name space - resource field.
+ *
+ * @returns IPRT status code.
+ * @param   pNsRoot             The namespace root to add the entry to.
+ * @param   pszNameString       An ACPI NameString (either segment or path).
+ * @param   offBits             Bit offset from the beginning of the resource.
+ * @param   cBits               NUmber of bits this resource field has.
+ */
+DECLHIDDEN(int) rtAcpiNsAddEntryExternal(PRTACPINSROOT pNsRoot, const char *pszNameString, PCRTACPIASLEXTERNAL pExternal);
+
+
+/**
+ * Queries the name path for the given name string based on the current scope.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_NOT_FOUND if the name string can't be resolved to a name path with the given namespace.
+ * @retval  VERR_BUFFER_OVERFLOW if the buffer for holding the name path is too small. pcchNamePath will
+ *                               hold the required number of characters, excluding the zero temrinator.
+ * @param   pNsRoot             The namespace root.
+ * @param   pszNameString       The name string to query the name path for.
+ * @param   pachNamePath        Where to store the name path (including zero terminator), or NULL if the size is queried.
+ * @param   pcchNamePath        Holds the size of the name path buffer on input, on successful return
+ *                              holds the actual length of the name path excluding the zero terminator.
+ */
+DECLHIDDEN(int) rtAcpiNsQueryNamePathForNameString(PRTACPINSROOT pNsRoot, const char *pszNameString, char *pachNamePath, size_t *pcchNamePath);
+
+
+/**
  * Pops the current name space entry from the stack and returns to the previous one.
  *