Changeset 58127 in vbox for trunk/src/VBox/VMM/include

Timestamp:

Oct 8, 2015 10:09:23 PM (9 years ago)

Author:

vboxsync

Message:

VMM: No more doxygen warnings here.

Location:

trunk/src/VBox/VMM/include

Files:

• EMHandleRCTmpl.h (modified) (1 diff)
• GIMKvmInternal.h (modified) (1 diff)
• IEMInternal.h (modified) (2 diffs)
• PDMBlkCacheInternal.h (modified) (1 diff)
• PGMInline.h (modified) (9 diffs)

trunk/src/VBox/VMM/include/EMHandleRCTmpl.h

@@ -35 +35 @@
  * @param   pVM     The cross context VM structure.
  * @param   pVCpu   The cross context virtual CPU structure.
+ * @param   pCtx    Pointer to the guest CPU context.
  * @param   rc      The return code.
- * @param   pCtx    Pointer to the guest CPU context.
  */
 #ifdef EMHANDLERC_WITH_PATM
 int emR3RawHandleRC(PVM pVM, PVMCPU pVCpu, PCPUMCTX pCtx, int rc)
-#elif defined(EMHANDLERC_WITH_HM)
+#elif defined(EMHANDLERC_WITH_HM) || defined(DOXYGEN_RUNNING)
 int emR3HmHandleRC(PVM pVM, PVMCPU pVCpu, PCPUMCTX pCtx, int rc)
 #endif

trunk/src/VBox/VMM/include/GIMKvmInternal.h

@@ -197 +197 @@
     /**  CPUID features: Basic. */
     uint32_t                    uBaseFeat;
-    /** Whether GIM needs to trap #UD exceptions. */
+    /** Whether GIM needs to trap \#UD exceptions. */
     bool                        fTrapXcptUD;
     /** Disassembler opcode of hypercall instruction native for this host CPU. */

trunk/src/VBox/VMM/include/IEMInternal.h

@@ -44 +44 @@
  *    defined(IEM_VERIFICATION_MODE) && !defined(IEM_VERIFICATION_MODE_MINIMAL)
  */
-#if defined(IEM_VERIFICATION_MODE) && !defined(IEM_VERIFICATION_MODE_MINIMAL) && !defined(IEM_VERIFICATION_MODE_FULL)
+#if (defined(IEM_VERIFICATION_MODE) && !defined(IEM_VERIFICATION_MODE_MINIMAL) && !defined(IEM_VERIFICATION_MODE_FULL)) \
+  || defined(DOXYGEN_RUNNING)
 # define IEM_VERIFICATION_MODE_FULL
 #endif
@@ -631 +632 @@
  * Indicates that one of the verfication modes are enabled.
  */
-#if (defined(IEM_VERIFICATION_MODE_FULL) || defined(IEM_VERIFICATION_MODE_MINIMAL)) && !defined(IEM_VERIFICATION_MODE)
+#if (defined(IEM_VERIFICATION_MODE_FULL) || defined(IEM_VERIFICATION_MODE_MINIMAL)) && !defined(IEM_VERIFICATION_MODE) \
+ || defined(DOXYGEN_RUNNING)
 # define IEM_VERIFICATION_MODE
 #endif

trunk/src/VBox/VMM/include/PDMBlkCacheInternal.h

@@ -60 +60 @@
     /** Cache the entry belongs to. */
     PPDMBLKCACHE                    pBlkCache;
-    /** Flags for this entry. Combinations of PDMACFILECACHE_* #defines */
+    /** Flags for this entry. Combinations of PDMACFILECACHE_* \#defines */
     volatile uint32_t               fFlags;
     /** Reference counter. Prevents eviction of the entry if > 0. */

trunk/src/VBox/VMM/include/PGMInline.h

@@ -225 +225 @@
  * @param   HCPhys      The physical address of the page.
  * @param   ppv         Where to store the mapping address.
+ * @param   SRC_POS     The source location of the caller.
  */
 DECLINLINE(int) pgmRZDynMapHCPageInlined(PVMCPU pVCpu, RTHCPHYS HCPhys, void **ppv RTLOG_COMMA_SRC_POS_DECL)
@@ -264 +265 @@
  * @param   GCPhys      The guest physical address of the page.
  * @param   ppv         Where to store the mapping address.
+ * @param   SRC_POS     The source location of the caller.
  */
 DECLINLINE(int) pgmRZDynMapGCPageV2Inlined(PVM pVM, PVMCPU pVCpu, RTGCPHYS GCPhys, void **ppv RTLOG_COMMA_SRC_POS_DECL)
@@ -324 +326 @@
  * @param   GCPhys      The guest physical address of the page.
  * @param   ppv         Where to store the mapping address.
+ * @param   SRC_POS     The source location of the caller.
  */
 DECLINLINE(int) pgmRZDynMapGCPageInlined(PVMCPU pVCpu, RTGCPHYS GCPhys, void **ppv RTLOG_COMMA_SRC_POS_DECL)
@@ -337 +340 @@
  * @returns VBox status code, see pgmRZDynMapGCPageCommon for details.
  * @param   pVCpu       The cross context virtual CPU structure.
- * @param   HCPhys      The physical address of the page.
+ * @param   GCPhys      The guest physical address of the page.
  * @param   ppv         Where to store the mapping address. The offset is
  *                      preserved.
+ * @param   SRC_POS     The source location of the caller.
  */
 DECLINLINE(int) pgmRZDynMapGCPageOffInlined(PVMCPU pVCpu, RTGCPHYS GCPhys, void **ppv RTLOG_COMMA_SRC_POS_DECL)
@@ -401 +405 @@
  * @param   pVM         The cross context VM structure.
  * @param   pPage       The page.
+ * @param   SRC_POS     The source location of the caller.
  */
 DECLINLINE(void *) pgmPoolMapPageInlined(PVM pVM, PPGMPOOLPAGE pPage RTLOG_COMMA_SRC_POS_DECL)
@@ -422 +427 @@
  * @param   pVCpu       The cross context virtual CPU structure.
  * @param   pPage       The page.
+ * @param   SRC_POS     The source location of the caller.
  */
 DECLINLINE(void *) pgmPoolMapPageV2Inlined(PVM pVM, PVMCPU pVCpu, PPGMPOOLPAGE pPage RTLOG_COMMA_SRC_POS_DECL)
@@ -1073 +1079 @@
  * @returns Pointer to the shadow PD.
  * @param   pVCpu       The cross context virtual CPU structure.
+ * @param   pPdpt       Pointer to the page directory pointer table.
  * @param   GCPtr       The address.
  */
@@ -1398 +1405 @@
  * Locks a page to prevent flushing (important for cr3 root pages or shadow pae pd pages).
  *
- * @param   pVM         The cross context VM structure.
+ * @param   pPool       The pool.
  * @param   pPage       PGM pool page
  */
@@ -1411 +1418 @@
  * Unlocks a page to allow flushing again
  *
- * @param   pVM         The cross context VM structure.
+ * @param   pPool       The pool.
  * @param   pPage       PGM pool page
  */