diff options
Diffstat (limited to 'src/VBox/VMM')
40 files changed, 5 insertions, 99 deletions
diff --git a/src/VBox/VMM/VMMAll/APICAll.cpp b/src/VBox/VMM/VMMAll/APICAll.cpp index e4d7aeca7fe..8ef82239ea2 100644 --- a/src/VBox/VMM/VMMAll/APICAll.cpp +++ b/src/VBox/VMM/VMMAll/APICAll.cpp @@ -3428,7 +3428,6 @@ VMM_INT_DECL(bool) APICGetHighestPendingInterrupt(PVMCPUCC pVCpu, uint8_t *pu8Pe /** * Posts an interrupt to a target APIC, Hyper-V interface. * - * @returns true if the interrupt was accepted, false otherwise. * @param pVCpu The cross context virtual CPU structure. * @param uVector The vector of the interrupt to be posted. * @param fAutoEoi Whether this interrupt has automatic EOI diff --git a/src/VBox/VMM/VMMAll/CPUMAllRegs.cpp b/src/VBox/VMM/VMMAll/CPUMAllRegs.cpp index c60dc8274eb..3504668df8b 100644 --- a/src/VBox/VMM/VMMAll/CPUMAllRegs.cpp +++ b/src/VBox/VMM/VMMAll/CPUMAllRegs.cpp @@ -1727,7 +1727,6 @@ VMMDECL(bool) CPUMIsHyperDebugStateActive(PVMCPU pVCpu) /** * Mark the guest's debug state as inactive. * - * @returns boolean * @param pVCpu The cross context virtual CPU structure of the calling EMT. * @todo This API doesn't make sense any more. */ diff --git a/src/VBox/VMM/VMMAll/DBGFAllTracer.cpp b/src/VBox/VMM/VMMAll/DBGFAllTracer.cpp index 4b004819e24..b9279f4675c 100644 --- a/src/VBox/VMM/VMMAll/DBGFAllTracer.cpp +++ b/src/VBox/VMM/VMMAll/DBGFAllTracer.cpp @@ -189,7 +189,6 @@ DECLHIDDEN(int) dbgfTracerR3EvtPostSingle(PVMCC pVM, PDBGFTRACERINSCC pThisCC, D /** * Copies the given MMIO value into the event descriptor based on the given size. * - * @returns nothing. * @param pEvtMmio Pointer to the MMIO event descriptor to fill. * @param pvVal The value to copy. * @param cbVal Size of the value in bytes. @@ -219,7 +218,6 @@ static void dbgfTracerEvtMmioCopyVal(PDBGFTRACEREVTMMIO pEvtMmio, const void *pv /** * Copies the given I/O port value into the event descriptor based on the given size. * - * @returns nothing. * @param pEvtIoPort Pointer to the I/O port read/write event descriptor to fill. * @param pvVal The value to copy. * @param cbVal Size of the value in bytes. diff --git a/src/VBox/VMM/VMMAll/HMAll.cpp b/src/VBox/VMM/VMMAll/HMAll.cpp index 387bedae57b..f4f17f6898b 100644 --- a/src/VBox/VMM/VMMAll/HMAll.cpp +++ b/src/VBox/VMM/VMMAll/HMAll.cpp @@ -388,7 +388,6 @@ VMMDECL(bool) HMCanExecuteGuest(PVMCC pVM, PVMCPUCC pVCpu, PCCPUMCTX pCtx) /** * Queues a guest page for invalidation. * - * @returns VBox status code. * @param pVCpu The cross context virtual CPU structure. * @param GCVirt Page to invalidate. */ diff --git a/src/VBox/VMM/VMMAll/IEMAll.cpp b/src/VBox/VMM/VMMAll/IEMAll.cpp index 035c36a68b1..62413a937e1 100644 --- a/src/VBox/VMM/VMMAll/IEMAll.cpp +++ b/src/VBox/VMM/VMMAll/IEMAll.cpp @@ -566,7 +566,6 @@ static VBOXSTRICTRC iemInitDecoderAndPrefetchOpcodes(PVMCPUCC pVCpu, bool fBypas * * This is called internally as well as by PGM when moving GC mappings. * - * @returns * @param pVCpu The cross context virtual CPU structure of the calling * thread. */ @@ -6775,7 +6774,6 @@ VBOXSTRICTRC iemMemCommitAndUnmapPostponeTroubleToR3(PVMCPUCC pVCpu, void *pvMem * * The caller shall only call this after checking cActiveMappings. * - * @returns Strict VBox status code to pass up. * @param pVCpu The cross context virtual CPU structure of the calling thread. */ void iemMemRollback(PVMCPUCC pVCpu) RT_NOEXCEPT diff --git a/src/VBox/VMM/VMMAll/PGMAll.cpp b/src/VBox/VMM/VMMAll/PGMAll.cpp index c5b2fa10fe1..978abc0bdb9 100644 --- a/src/VBox/VMM/VMMAll/PGMAll.cpp +++ b/src/VBox/VMM/VMMAll/PGMAll.cpp @@ -3857,7 +3857,6 @@ int pgmLock(PVMCC pVM, bool fVoid) /** * Release the PGM lock. * - * @returns VBox status code * @param pVM The cross context VM structure. */ void pgmUnlock(PVMCC pVM) diff --git a/src/VBox/VMM/VMMAll/PGMAllHandler.cpp b/src/VBox/VMM/VMMAll/PGMAllHandler.cpp index 749b8c3060f..73bec70cb6d 100644 --- a/src/VBox/VMM/VMMAll/PGMAllHandler.cpp +++ b/src/VBox/VMM/VMMAll/PGMAllHandler.cpp @@ -986,8 +986,6 @@ void pgmHandlerPhysicalResetAliasedPage(PVMCC pVM, PPGMPAGE pPage, RTGCPHYS GCPh /** * Resets ram range flags. * - * @returns VBox status code. - * @retval VINF_SUCCESS when shadow PTs was successfully updated. * @param pVM The cross context VM structure. * @param pCur The physical handler. * diff --git a/src/VBox/VMM/VMMAll/PGMAllPhys.cpp b/src/VBox/VMM/VMMAll/PGMAllPhys.cpp index 76e74ebad44..85a193b66bc 100644 --- a/src/VBox/VMM/VMMAll/PGMAllPhys.cpp +++ b/src/VBox/VMM/VMMAll/PGMAllPhys.cpp @@ -1210,8 +1210,6 @@ int pgmPhysRecheckLargePage(PVMCC pVM, RTGCPHYS GCPhys, PPGMPAGE pLargePage) /** * Deal with a write monitored page. * - * @returns VBox strict status code. - * * @param pVM The cross context VM structure. * @param pPage The physical page tracking structure. * @param GCPhys The guest physical address of the page. diff --git a/src/VBox/VMM/VMMR0/CPUMR0.cpp b/src/VBox/VMM/VMMR0/CPUMR0.cpp index 83581062f39..98bdff74cbf 100644 --- a/src/VBox/VMM/VMMR0/CPUMR0.cpp +++ b/src/VBox/VMM/VMMR0/CPUMR0.cpp @@ -772,7 +772,6 @@ VMMR0_INT_DECL(void) CPUMR0LoadGuestDebugState(PVMCPUCC pVCpu, bool fDr6) /** * Lazily sync in the hypervisor debug state * - * @returns VBox status code. * @param pVCpu The cross context virtual CPU structure of the calling EMT. * @param fDr6 Whether to include DR6 or not. * @thread EMT(pVCpu) diff --git a/src/VBox/VMM/VMMR0/DBGFR0Bp.cpp b/src/VBox/VMM/VMMR0/DBGFR0Bp.cpp index bc10af3644e..90ceff6b624 100644 --- a/src/VBox/VMM/VMMR0/DBGFR0Bp.cpp +++ b/src/VBox/VMM/VMMR0/DBGFR0Bp.cpp @@ -56,7 +56,6 @@ /** * Used by DBGFR0InitPerVM() to initialize the breakpoint manager. * - * @returns nothing. * @param pGVM The global (ring-0) VM structure. */ DECLHIDDEN(void) dbgfR0BpInit(PGVM pGVM) diff --git a/src/VBox/VMM/VMMR0/HMSVMR0.cpp b/src/VBox/VMM/VMMR0/HMSVMR0.cpp index 4825f6f9858..f0415e62035 100644 --- a/src/VBox/VMM/VMMR0/HMSVMR0.cpp +++ b/src/VBox/VMM/VMMR0/HMSVMR0.cpp @@ -1733,7 +1733,6 @@ static int hmR0SvmExportGuestControlRegs(PVMCPUCC pVCpu, PSVMVMCB pVmcb) /** * Exports the guest (or nested-guest) segment registers into the VMCB. * - * @returns VBox status code. * @param pVCpu The cross context virtual CPU structure. * @param pVmcb Pointer to the VM control block. * @@ -5606,7 +5605,6 @@ static void hmR0SvmPreRunGuestDebugStateApply(PSVMTRANSIENT pSvmTransient, PSVMR * Restores VMCB fields that were changed by hmR0SvmPreRunGuestDebugStateApply * for re-entry next time around. * - * @returns Strict VBox status code (i.e. informational status codes too). * @param pSvmTransient The SVM-transient structure. * @param pDbgState The debug state. */ diff --git a/src/VBox/VMM/VMMR0/HMVMXR0.cpp b/src/VBox/VMM/VMMR0/HMVMXR0.cpp index 751ad8aeb30..51d31abc6cb 100644 --- a/src/VBox/VMM/VMMR0/HMVMXR0.cpp +++ b/src/VBox/VMM/VMMR0/HMVMXR0.cpp @@ -939,7 +939,6 @@ static int hmR0VmxAllocVmcsInfo(PVMCPUCC pVCpu, PVMXVMCSINFO pVmcsInfo, bool fIs /** * Free all VT-x structures for the VM. * - * @returns IPRT status code. * @param pVM The cross context VM structure. */ static void hmR0VmxStructsFree(PVMCC pVM) @@ -1603,7 +1602,6 @@ static void hmR0VmxCheckAutoLoadStoreMsrs(PVMCPUCC pVCpu, PCVMXVMCSINFO pVmcsInf /** * Flushes the TLB using EPT. * - * @returns VBox status code. * @param pVCpu The cross context virtual CPU structure of the calling * EMT. Can be NULL depending on @a enmTlbFlush. * @param pVmcsInfo The VMCS info. object. Can be NULL depending on @a @@ -1640,7 +1638,6 @@ static void hmR0VmxFlushEpt(PVMCPUCC pVCpu, PCVMXVMCSINFO pVmcsInfo, VMXTLBFLUSH /** * Flushes the TLB using VPID. * - * @returns VBox status code. * @param pVCpu The cross context virtual CPU structure of the calling * EMT. Can be NULL depending on @a enmTlbFlush. * @param enmTlbFlush Type of flush. @@ -4392,7 +4389,6 @@ static void hmR0VmxReportWorldSwitchError(PVMCPUCC pVCpu, int rcVMRun, PVMXTRANS * If offsetting is not possible, cause VM-exits on RDTSC(P)s. Also sets up the * VMX-preemption timer. * - * @returns VBox status code. * @param pVCpu The cross context virtual CPU structure. * @param pVmxTransient The VMX-transient structure. * @param idCurrentCpu The current CPU number. diff --git a/src/VBox/VMM/VMMR0/PGMR0.cpp b/src/VBox/VMM/VMMR0/PGMR0.cpp index 6e228fa57d1..d9c477f86a0 100644 --- a/src/VBox/VMM/VMMR0/PGMR0.cpp +++ b/src/VBox/VMM/VMMR0/PGMR0.cpp @@ -165,7 +165,6 @@ VMMR0_INT_DECL(int) PGMR0InitVM(PGVM pGVM) /** * Called at the end of the ring-0 initialization to seal access handler types. * - * @returns VBox status code. * @param pGVM Pointer to the global VM structure. */ VMMR0_INT_DECL(void) PGMR0DoneInitVM(PGVM pGVM) diff --git a/src/VBox/VMM/VMMR3/CFGM.cpp b/src/VBox/VMM/VMMR3/CFGM.cpp index 0afb2a29997..9b2c98ddffb 100644 --- a/src/VBox/VMM/VMMR3/CFGM.cpp +++ b/src/VBox/VMM/VMMR3/CFGM.cpp @@ -120,7 +120,6 @@ static void *cfgmR3MemAlloc(PVM pVM, MMTAG enmTag, size_t cb) /** * Free wrapper. * - * @returns Pointer to the allocated memory, NULL on failure. * @param pVM The cross context VM structure, if the tree * is associated with one. * @param pv The memory block to free. @@ -154,7 +153,6 @@ static char *cfgmR3StrAlloc(PVM pVM, MMTAG enmTag, size_t cbString) /** * String free wrapper. * - * @returns Pointer to the allocated memory, NULL on failure. * @param pVM The cross context VM structure, if the tree * is associated with one. * @param pszString The memory block to free. diff --git a/src/VBox/VMM/VMMR3/CPUM-armv8.cpp b/src/VBox/VMM/VMMR3/CPUM-armv8.cpp index 5d0d654ce86..a3f94b054c2 100644 --- a/src/VBox/VMM/VMMR3/CPUM-armv8.cpp +++ b/src/VBox/VMM/VMMR3/CPUM-armv8.cpp @@ -306,7 +306,6 @@ VMMR3DECL(void) CPUMR3ResetCpu(PVM pVM, PVMCPU pVCpu) /** * Resets the CPU. * - * @returns VINF_SUCCESS. * @param pVM The cross context VM structure. */ VMMR3DECL(void) CPUMR3Reset(PVM pVM) @@ -631,7 +630,6 @@ VMMR3DECL(void) CPUMR3LogCpuIdAndMsrFeatures(PVM pVM) /** * Marks the guest debug state as active. * - * @returns nothing. * @param pVCpu The cross context virtual CPU structure. * * @note This is used solely by NEM (hence the name) to set the correct flags here @@ -648,7 +646,6 @@ VMMR3_INT_DECL(void) CPUMR3NemActivateGuestDebugState(PVMCPUCC pVCpu) /** * Marks the hyper debug state as active. * - * @returns nothing. * @param pVCpu The cross context virtual CPU structure. * * @note This is used solely by NEM (hence the name) to set the correct flags here diff --git a/src/VBox/VMM/VMMR3/CPUM.cpp b/src/VBox/VMM/VMMR3/CPUM.cpp index 0c973d2e958..64a7fd92849 100644 --- a/src/VBox/VMM/VMMR3/CPUM.cpp +++ b/src/VBox/VMM/VMMR3/CPUM.cpp @@ -2497,7 +2497,6 @@ VMMR3DECL(void) CPUMR3ResetCpu(PVM pVM, PVMCPU pVCpu) /** * Resets the CPU. * - * @returns VINF_SUCCESS. * @param pVM The cross context VM structure. */ VMMR3DECL(void) CPUMR3Reset(PVM pVM) @@ -4601,7 +4600,6 @@ VMMR3DECL(void) CPUMR3LogCpuIdAndMsrFeatures(PVM pVM) /** * Marks the guest debug state as active. * - * @returns nothing. * @param pVCpu The cross context virtual CPU structure. * * @note This is used solely by NEM (hence the name) to set the correct flags here @@ -4618,7 +4616,6 @@ VMMR3_INT_DECL(void) CPUMR3NemActivateGuestDebugState(PVMCPUCC pVCpu) /** * Marks the hyper debug state as active. * - * @returns nothing. * @param pVCpu The cross context virtual CPU structure. * * @note This is used solely by NEM (hence the name) to set the correct flags here diff --git a/src/VBox/VMM/VMMR3/DBGF.cpp b/src/VBox/VMM/VMMR3/DBGF.cpp index cb60bdf1473..85b60124051 100644 --- a/src/VBox/VMM/VMMR3/DBGF.cpp +++ b/src/VBox/VMM/VMMR3/DBGF.cpp @@ -228,7 +228,6 @@ VMMR3_INT_DECL(int) DBGFR3Term(PVM pVM) /** * This is for tstCFGM and others to avoid trigger leak detection. * - * @returns VBox status code. * @param pUVM The user mode VM structure. */ VMMR3DECL(void) DBGFR3TermUVM(PUVM pUVM) diff --git a/src/VBox/VMM/VMMR3/DBGFR3Bp.cpp b/src/VBox/VMM/VMMR3/DBGFR3Bp.cpp index 6c8d208aa20..25b4a4de923 100644 --- a/src/VBox/VMM/VMMR3/DBGFR3Bp.cpp +++ b/src/VBox/VMM/VMMR3/DBGFR3Bp.cpp @@ -781,7 +781,6 @@ static int dbgfR3BpAlloc(PUVM pUVM, DBGFBPOWNER hOwner, void *pvUser, DBGFBPTYPE /** * Frees the given breakpoint handle. * - * @returns nothing. * @param pUVM The user mode VM handle. * @param hBp The breakpoint handle to free. * @param pBp The internal breakpoint state pointer. @@ -977,7 +976,6 @@ static int dbgfR3BpL2TblEntryAlloc(PUVM pUVM, uint32_t *pidxL2Tbl, PDBGFBPL2ENTR /** * Frees the given breakpoint handle. * - * @returns nothing. * @param pUVM The user mode VM handle. * @param idxL2Tbl The L2 table index to free. * @param pL2TblEntry The L2 table entry pointer to free. @@ -1004,7 +1002,6 @@ static void dbgfR3BpL2TblEntryFree(PUVM pUVM, uint32_t idxL2Tbl, PDBGFBPL2ENTRY /** * Sets the enabled flag of the given breakpoint to the given value. * - * @returns nothing. * @param pBp The breakpoint to set the state. * @param fEnabled Enabled status. */ diff --git a/src/VBox/VMM/VMMR3/DBGFR3Flow.cpp b/src/VBox/VMM/VMMR3/DBGFR3Flow.cpp index f218eb2ab09..af1c8d79c3e 100644 --- a/src/VBox/VMM/VMMR3/DBGFR3Flow.cpp +++ b/src/VBox/VMM/VMMR3/DBGFR3Flow.cpp @@ -342,7 +342,6 @@ dbgfR3FlowBranchTblCreate(PDBGFFLOWINT pThis, PDBGFADDRESS pAddrStart, uint8_t i /** * Destroys a control flow graph. * - * @returns nothing. * @param pThis The control flow graph to destroy. */ static void dbgfR3FlowDestroy(PDBGFFLOWINT pThis) @@ -375,7 +374,6 @@ static void dbgfR3FlowDestroy(PDBGFFLOWINT pThis) /** * Destroys a basic block. * - * @returns nothing. * @param pFlowBb The basic block to destroy. * @param fMayDestroyFlow Flag whether the control flow graph container * should be destroyed when there is nothing referencing it. @@ -399,7 +397,6 @@ static void dbgfR3FlowBbDestroy(PDBGFFLOWBBINT pFlowBb, bool fMayDestroyFlow) /** * Destroys a given branch table. * - * @returns nothing. * @param pFlowBranchTbl The flow branch table to destroy. */ static void dbgfR3FlowBranchTblDestroy(PDBGFFLOWBRANCHTBLINT pFlowBranchTbl) @@ -431,7 +428,6 @@ static uint32_t dbgfR3FlowBbReleaseInt(PDBGFFLOWBBINT pFlowBb, bool fMayDestroyF /** * Links the given basic block into the control flow graph. * - * @returns nothing. * @param pThis The control flow graph to link into. * @param pFlowBb The basic block to link. */ @@ -445,7 +441,6 @@ DECLINLINE(void) dbgfR3FlowLink(PDBGFFLOWINT pThis, PDBGFFLOWBBINT pFlowBb) /** * Links the given branch table into the control flow graph. * - * @returns nothing. * @param pThis The control flow graph to link into. * @param pBranchTbl The branch table to link. */ @@ -498,7 +493,6 @@ DECLINLINE(PDBGFFLOWBRANCHTBLINT) dbgfR3FlowBranchTblFindByAddr(PDBGFFLOWINT pTh /** * Sets the given error status for the basic block. * - * @returns nothing. * @param pFlowBb The basic block causing the error. * @param rcError The error to set. * @param pszFmt Format string of the error description. @@ -2133,7 +2127,6 @@ VMMR3DECL(int) DBGFR3FlowItCreate(DBGFFLOW hFlow, DBGFFLOWITORDER enmOrder, PDBG /** * Destroys a given control flow graph iterator. * - * @returns nothing. * @param hFlowIt The control flow graph iterator handle. */ VMMR3DECL(void) DBGFR3FlowItDestroy(DBGFFLOWIT hFlowIt) @@ -2271,7 +2264,6 @@ VMMR3DECL(int) DBGFR3FlowBranchTblItCreate(DBGFFLOW hFlow, DBGFFLOWITORDER enmOr /** * Destroys a given control flow graph branch table iterator. * - * @returns nothing. * @param hFlowBranchTblIt The control flow graph branch table iterator handle. */ VMMR3DECL(void) DBGFR3FlowBranchTblItDestroy(DBGFFLOWBRANCHTBLIT hFlowBranchTblIt) diff --git a/src/VBox/VMM/VMMR3/DBGFR3FlowTrace.cpp b/src/VBox/VMM/VMMR3/DBGFR3FlowTrace.cpp index 17c1864b3ff..a8102ef336a 100644 --- a/src/VBox/VMM/VMMR3/DBGFR3FlowTrace.cpp +++ b/src/VBox/VMM/VMMR3/DBGFR3FlowTrace.cpp @@ -281,7 +281,6 @@ static PDBGFFLOWTRACERECORDINT dbgfR3FlowTraceRecordCreate(PDBGFFLOWTRACEMODPROB /** * Destroys the given record. * - * @returns nothing. * @param pRecord The record to destroy. */ static void dbgfR3FlowTraceRecordDestroy(PDBGFFLOWTRACERECORDINT pRecord) @@ -317,7 +316,6 @@ static PDBGFFLOWTRACEREPORTINT dbgfR3FlowTraceReportCreate(PUVM pUVM, uint32_t c /** * Destroys the given report releasing all references hold to the containing records. * - * @returns nothing. * @param pReport The report to destroy. */ static void dbgfR3FlowTraceReportDestroy(PDBGFFLOWTRACEREPORTINT pReport) @@ -410,7 +408,6 @@ static int dbgfR3FlowTraceModProbeResolveIndirectAddr(PUVM pUVM, VMCPUID idCpu, /** * Destroys the given flow trace module freeing all allocated resources. * - * @returns nothing. * @param pThis The flow trace module instance data. */ static void dbgfR3FlowTraceModDestroy(PDBGFFLOWTRACEMODINT pThis) @@ -964,7 +961,6 @@ static PDBGFFLOWTRACEMODPROBELOC dbgfR3TraceModGetProbeLocAtAddr(PDBGFFLOWTRACEM /** * Cleans up any allocated resources for each entry in the given probe for the given range. * - * @returns nothing. * @param pProbe The probe instance. * @param idxStart Start index to clean up. * @param cEntries How many entries to clean up. @@ -1013,7 +1009,6 @@ static void dbgfR3ProbeEntryCleanup(PDBGFFLOWTRACEPROBEINT pProbe, uint32_t idxS /** * Destroys the given flow trace probe freeing all allocated resources. * - * @returns nothing. * @param pProbe The flow trace probe instance data. */ static void dbgfR3FlowTraceProbeDestroy(PDBGFFLOWTRACEPROBEINT pProbe) @@ -1150,7 +1145,6 @@ static int dbgfR3ProbeEntryDup(PUVM pUVM, PDBGFFLOWTRACEPROBEENTRY pDst, PCDBGFF /** * Recalculates the size occupied by the data of this probe for each invocation. * - * @returns nothing. * @param pProbe The probe instance. */ static void dbgfR3ProbeRecalcSize(PDBGFFLOWTRACEPROBEINT pProbe) diff --git a/src/VBox/VMM/VMMR3/DBGFR3SampleReport.cpp b/src/VBox/VMM/VMMR3/DBGFR3SampleReport.cpp index db15c87f8b7..31da3b52d19 100644 --- a/src/VBox/VMM/VMMR3/DBGFR3SampleReport.cpp +++ b/src/VBox/VMM/VMMR3/DBGFR3SampleReport.cpp @@ -262,7 +262,6 @@ static void dbgfR3SampleReportInfoHlpDelete(PDBGFSAMPLEREPORTINFOHLP pHlp) /** * Frees the given frame and all its descendants. * - * @returns nothing. * @param pFrame The frame to free. */ static void dbgfR3SampleReportFrameFree(PDBGFSAMPLEFRAME pFrame) @@ -278,7 +277,6 @@ static void dbgfR3SampleReportFrameFree(PDBGFSAMPLEFRAME pFrame) /** * Destroys the given sample report freeing all allocated resources. * - * @returns nothing. * @param pThis The sample report instance data. */ static void dbgfR3SampleReportDestroy(PDBGFSAMPLEREPORTINT pThis) @@ -363,7 +361,6 @@ static DECLCALLBACK(int) dbgfR3SampleReportFrameSortCmp(void const *pvElement1, /** * Dumps a single given frame to the release log. * - * @returns nothing. * @param pHlp The debug info helper used for printing. * @param pUVM The usermode VM handle. * @param pFrame The frame to dump. @@ -410,7 +407,6 @@ static void dbgfR3SampleReportDumpFrame(PCDBGFINFOHLP pHlp, PUVM pUVM, PCDBGFSAM * Worker for dbgfR3SampleReportTakeSample(), doing the work in an EMT rendezvous point on * each VCPU. * - * @returns nothing. * @param pThis Pointer to the sample report instance. */ static DECLCALLBACK(void) dbgfR3SampleReportSample(PDBGFSAMPLEREPORTINT pThis) diff --git a/src/VBox/VMM/VMMR3/DBGFR3Tracer.cpp b/src/VBox/VMM/VMMR3/DBGFR3Tracer.cpp index 9dccb95cc26..fb69f4fd1d2 100644 --- a/src/VBox/VMM/VMMR3/DBGFR3Tracer.cpp +++ b/src/VBox/VMM/VMMR3/DBGFR3Tracer.cpp @@ -1045,7 +1045,6 @@ DECLHIDDEN(int) dbgfR3TracerInit(PVM pVM) /** * Terminates any configured tracer for the given VM instance. * - * @returns nothing. * @param pVM The cross context VM structure. */ DECLHIDDEN(void) dbgfR3TracerTerm(PVM pVM) diff --git a/src/VBox/VMM/VMMR3/DBGFR3Type.cpp b/src/VBox/VMM/VMMR3/DBGFR3Type.cpp index 2e196ae85b7..3c8c25648c9 100644 --- a/src/VBox/VMM/VMMR3/DBGFR3Type.cpp +++ b/src/VBox/VMM/VMMR3/DBGFR3Type.cpp @@ -1226,7 +1226,6 @@ VMMR3DECL(int) DBGFR3TypeQueryValByType(PUVM pUVM, PCDBGFADDRESS pAddress, const * Frees all acquired resources of a value previously obtained with * DBGFR3TypeQueryValByType(). * - * @returns nothing. * @param pVal The value to free. */ VMMR3DECL(void) DBGFR3TypeValFree(PDBGFTYPEVAL pVal) diff --git a/src/VBox/VMM/VMMR3/GCM.cpp b/src/VBox/VMM/VMMR3/GCM.cpp index 2fbf971305f..e2077d1eee5 100644 --- a/src/VBox/VMM/VMMR3/GCM.cpp +++ b/src/VBox/VMM/VMMR3/GCM.cpp @@ -249,7 +249,6 @@ VMMR3_INT_DECL(void) GCMR3Relocate(PVM pVM, RTGCINTPTR offDelta) * * Do whatever fixer-specific resetting that needs to be done. * - * @returns VBox status code. * @param pVM The cross context VM structure. */ VMMR3_INT_DECL(void) GCMR3Reset(PVM pVM) diff --git a/src/VBox/VMM/VMMR3/GIM.cpp b/src/VBox/VMM/VMMR3/GIM.cpp index 622d1e8e786..145765ba212 100644 --- a/src/VBox/VMM/VMMR3/GIM.cpp +++ b/src/VBox/VMM/VMMR3/GIM.cpp @@ -417,7 +417,6 @@ VMMR3_INT_DECL(void) GIMR3Relocate(PVM pVM, RTGCINTPTR offDelta) * For the GIM component this means unmapping and unregistering MMIO2 regions * and other provider-specific resets. * - * @returns VBox status code. * @param pVM The cross context VM structure. */ VMMR3_INT_DECL(void) GIMR3Reset(PVM pVM) diff --git a/src/VBox/VMM/VMMR3/GMM.cpp b/src/VBox/VMM/VMMR3/GMM.cpp index bf2105bccf3..a92c70e6e41 100644 --- a/src/VBox/VMM/VMMR3/GMM.cpp +++ b/src/VBox/VMM/VMMR3/GMM.cpp @@ -174,7 +174,6 @@ GMMR3DECL(int) GMMR3FreePagesPrepare(PVM pVM, PGMMFREEPAGESREQ *ppReq, uint32_t /** * Re-prepares a GMMR0FreePages request. * - * @returns VINF_SUCCESS or VERR_NO_TMP_MEMORY. * @param pVM The cross context VM structure. * @param pReq A request buffer previously returned by * GMMR3FreePagesPrepare(). diff --git a/src/VBox/VMM/VMMR3/MM.cpp b/src/VBox/VMM/VMMR3/MM.cpp index a2e5c0d8659..863464e495a 100644 --- a/src/VBox/VMM/VMMR3/MM.cpp +++ b/src/VBox/VMM/VMMR3/MM.cpp @@ -535,7 +535,6 @@ VMMR3DECL(int) MMR3Term(PVM pVM) * Termination means cleaning up and freeing all resources, * the VM it self is at this point powered off or suspended. * - * @returns VBox status code. * @param pUVM Pointer to the user mode VM structure. */ VMMR3DECL(void) MMR3TermUVM(PUVM pUVM) diff --git a/src/VBox/VMM/VMMR3/NEMR3Native-darwin-armv8.cpp b/src/VBox/VMM/VMMR3/NEMR3Native-darwin-armv8.cpp index 24b61201ede..11d4e00ebc8 100644 --- a/src/VBox/VMM/VMMR3/NEMR3Native-darwin-armv8.cpp +++ b/src/VBox/VMM/VMMR3/NEMR3Native-darwin-armv8.cpp @@ -805,7 +805,6 @@ DECLINLINE(size_t) nemR3DarwinGetByteCountFromSas(uint8_t uSas) /** * Sets the given general purpose register to the given value. * - * @returns nothing. * @param pVCpu The cross context virtual CPU structure of the * calling EMT. * @param uReg The register index. diff --git a/src/VBox/VMM/VMMR3/NEMR3Native-darwin.cpp b/src/VBox/VMM/VMMR3/NEMR3Native-darwin.cpp index a4922ef081b..b3f8dd13e73 100644 --- a/src/VBox/VMM/VMMR3/NEMR3Native-darwin.cpp +++ b/src/VBox/VMM/VMMR3/NEMR3Native-darwin.cpp @@ -3389,7 +3389,6 @@ void nemR3NativeResetCpu(PVMCPU pVCpu, bool fInitIpi) /** * Dumps the VMCS in response to a faild hv_vcpu_run{_until}() call. * - * @returns nothing. * @param pVCpu The cross context virtual CPU structure. */ static void nemR3DarwinVmcsDump(PVMCPU pVCpu) diff --git a/src/VBox/VMM/VMMR3/PDMAsyncCompletion.cpp b/src/VBox/VMM/VMMR3/PDMAsyncCompletion.cpp index 20fb3740bca..e88067324da 100644 --- a/src/VBox/VMM/VMMR3/PDMAsyncCompletion.cpp +++ b/src/VBox/VMM/VMMR3/PDMAsyncCompletion.cpp @@ -786,7 +786,6 @@ bool pdmacEpIsTransferAllowed(PPDMASYNCCOMPLETIONENDPOINT pEndpoint, uint32_t cb /** * Called by the endpoint if a task has finished. * - * @returns nothing * @param pTask Pointer to the finished task. * @param rc Status code of the completed request. * @param fCallCompletionHandler Flag whether the completion handler should be called to @@ -940,7 +939,6 @@ int pdmR3AsyncCompletionEpClassInit(PVM pVM, PCPDMASYNCCOMPLETIONEPCLASSOPS pEpC /** * Worker terminating all endpoint classes. * - * @returns nothing * @param pEndpointClass Pointer to the endpoint class to terminate. * * @remarks This method ensures that any still open endpoint is closed. @@ -977,7 +975,6 @@ static void pdmR3AsyncCompletionEpClassTerminate(PPDMASYNCCOMPLETIONEPCLASS pEnd /** * Records the size of the request in the statistics. * - * @returns nothing. * @param pEndpoint The endpoint to register the request size for. * @param cbReq Size of the request. */ @@ -1020,7 +1017,6 @@ static void pdmR3AsyncCompletionStatisticsRecordSize(PPDMASYNCCOMPLETIONENDPOINT /** * Records the required processing time of a request. * - * @returns nothing. * @param pEndpoint The endpoint. * @param cNsRun The request time in nanoseconds. */ @@ -1233,7 +1229,6 @@ static int pdmR3AsyncCompletionStatisticsRegister(PPDMASYNCCOMPLETIONENDPOINT pE /** * Deregisters advanced statistics for one endpoint. * - * @returns nothing. * @param pEndpoint The endpoint to deregister the advanced statistics for. */ static void pdmR3AsyncCompletionStatisticsDeregister(PPDMASYNCCOMPLETIONENDPOINT pEndpoint) @@ -1286,7 +1281,6 @@ int pdmR3AsyncCompletionTerm(PVM pVM) /** * Resume worker for the async completion manager. * - * @returns nothing. * @param pVM The cross context VM structure. */ void pdmR3AsyncCompletionResume(PVM pVM) @@ -1373,7 +1367,6 @@ static PPDMASYNCCOMPLETIONTASK pdmR3AsyncCompletionGetTask(PPDMASYNCCOMPLETIONEN /** * Puts a task in one of the caches. * - * @returns nothing. * @param pEndpoint The endpoint the task belongs to. * @param pTask The task to cache. */ @@ -1511,7 +1504,6 @@ VMMR3DECL(int) PDMR3AsyncCompletionEpCreateForFile(PPPDMASYNCCOMPLETIONENDPOINT /** * Closes a endpoint waiting for any pending tasks to finish. * - * @returns nothing. * @param pEndpoint Handle of the endpoint. */ VMMR3DECL(void) PDMR3AsyncCompletionEpClose(PPDMASYNCCOMPLETIONENDPOINT pEndpoint) diff --git a/src/VBox/VMM/VMMR3/PDMAsyncCompletionFile.cpp b/src/VBox/VMM/VMMR3/PDMAsyncCompletionFile.cpp index f26da9a9e45..8f3e9ad8ccd 100644 --- a/src/VBox/VMM/VMMR3/PDMAsyncCompletionFile.cpp +++ b/src/VBox/VMM/VMMR3/PDMAsyncCompletionFile.cpp @@ -106,7 +106,6 @@ static const DBGCCMD g_aCmds[] = /** * Frees a task. * - * @returns nothing. * @param pEndpoint Pointer to the endpoint the segment was for. * @param pTask The task to free. */ @@ -516,7 +515,6 @@ int pdmacFileAioMgrCreate(PPDMASYNCCOMPLETIONEPCLASSFILE pEpClass, PPPDMACEPFILE /** * Destroys a async I/O manager. * - * @returns nothing. * @param pEpClassFile Pointer to globals for the file endpoint class. * @param pAioMgr The async I/O manager to destroy. */ diff --git a/src/VBox/VMM/VMMR3/PDMAsyncCompletionFileNormal.cpp b/src/VBox/VMM/VMMR3/PDMAsyncCompletionFileNormal.cpp index 7e336bc2bc4..5d9d1520038 100644 --- a/src/VBox/VMM/VMMR3/PDMAsyncCompletionFileNormal.cpp +++ b/src/VBox/VMM/VMMR3/PDMAsyncCompletionFileNormal.cpp @@ -260,7 +260,6 @@ static bool pdmacFileAioMgrNormalIsBalancePossible(PPDMACEPFILEMGR pAioMgr) * Creates a new I/O manager and spreads the I/O load of the endpoints * between the given I/O manager and the new one. * - * @returns nothing. * @param pAioMgr The I/O manager with high I/O load. */ static void pdmacFileAioMgrNormalBalanceLoad(PPDMACEPFILEMGR pAioMgr) @@ -542,7 +541,6 @@ static RTFILEAIOREQ pdmacFileAioMgrNormalRequestAlloc(PPDMACEPFILEMGR pAioMgr) /** * Frees a async I/O request handle. * - * @returns nothing. * @param pAioMgr The I/O manager. * @param hReq The I/O request handle to free. */ diff --git a/src/VBox/VMM/VMMR3/PDMBlkCache.cpp b/src/VBox/VMM/VMMR3/PDMBlkCache.cpp index b501b71a874..79993f94b07 100644 --- a/src/VBox/VMM/VMMR3/PDMBlkCache.cpp +++ b/src/VBox/VMM/VMMR3/PDMBlkCache.cpp @@ -97,7 +97,6 @@ static bool pdmBlkCacheAddDirtyEntry(PPDMBLKCACHE pBlkCache, PPDMBLKCACHEENTRY p /** * Add message to the VM trace buffer. * - * @returns nothing. * @param pBlkCache The block cache. * @param pszFmt The format string. * @param ... Additional parameters for the string formatter. @@ -117,7 +116,6 @@ DECLINLINE(void) pdmBlkCacheR3TraceMsgF(PPDMBLKCACHE pBlkCache, const char *pszF /** * Decrement the reference counter of the given cache entry. * - * @returns nothing. * @param pEntry The entry to release. */ DECLINLINE(void) pdmBlkCacheEntryRelease(PPDMBLKCACHEENTRY pEntry) @@ -129,7 +127,6 @@ DECLINLINE(void) pdmBlkCacheEntryRelease(PPDMBLKCACHEENTRY pEntry) /** * Increment the reference counter of the given cache entry. * - * @returns nothing. * @param pEntry The entry to reference. */ DECLINLINE(void) pdmBlkCacheEntryRef(PPDMBLKCACHEENTRY pEntry) @@ -195,7 +192,6 @@ DECLINLINE(void) pdmBlkCacheListSub(PPDMBLKLRULIST pList, uint32_t cbAmount) /** * Checks consistency of a LRU list. * - * @returns nothing * @param pList The LRU list to check. * @param pNotInList Element which is not allowed to occur in the list. */ @@ -229,7 +225,6 @@ static void pdmBlkCacheCheckList(PPDMBLKLRULIST pList, PPDMBLKCACHEENTRY pNotInL /** * Unlinks a cache entry from the LRU list it is assigned to. * - * @returns nothing. * @param pEntry The entry to unlink. */ static void pdmBlkCacheEntryRemoveFromList(PPDMBLKCACHEENTRY pEntry) @@ -284,7 +279,6 @@ static void pdmBlkCacheEntryRemoveFromList(PPDMBLKCACHEENTRY pEntry) * Adds a cache entry to the given LRU list unlinking it from the currently * assigned list if needed. * - * @returns nothing. * @param pList List to the add entry to. * @param pEntry Entry to add. */ @@ -320,7 +314,6 @@ static void pdmBlkCacheEntryAddToList(PPDMBLKLRULIST pList, PPDMBLKCACHEENTRY pE /** * Destroys a LRU list freeing all entries. * - * @returns nothing * @param pList Pointer to the LRU list to destroy. * * @note The caller must own the critical section of the cache. @@ -621,8 +614,8 @@ static int pdmBlkCacheEntryReadFromMedium(PPDMBLKCACHEENTRY pEntry) /** * Initiates a write I/O task for the given entry. * - * @returns nothing. - * @param pEntry The entry to read the data from. + * @returns VBox status code. + * @param pEntry The entry to read the data from. */ static int pdmBlkCacheEntryWriteToMedium(PPDMBLKCACHEENTRY pEntry) { @@ -685,7 +678,6 @@ static int pdmBlkCacheRequestPassthrough(PPDMBLKCACHE pBlkCache, PPDMBLKCACHEREQ /** * Commit a single dirty entry to the endpoint * - * @returns nothing * @param pEntry The entry to commit. */ static void pdmBlkCacheEntryCommit(PPDMBLKCACHEENTRY pEntry) @@ -700,7 +692,6 @@ static void pdmBlkCacheEntryCommit(PPDMBLKCACHEENTRY pEntry) /** * Commit all dirty entries for a single endpoint. * - * @returns nothing. * @param pBlkCache The endpoint cache to commit. */ static void pdmBlkCacheCommit(PPDMBLKCACHE pBlkCache) @@ -757,7 +748,6 @@ static void pdmBlkCacheCommit(PPDMBLKCACHE pBlkCache) /** * Commit all dirty entries in the cache. * - * @returns nothing. * @param pCache The global cache instance. */ static void pdmBlkCacheCommitDirtyEntries(PPDMBLKCACHEGLOBAL pCache) @@ -1611,7 +1601,6 @@ static PPDMBLKCACHEENTRY pdmBlkCacheGetCacheEntryByOffset(PPDMBLKCACHE pBlkCache /** * Return the best fit cache entries for the given offset. * - * @returns nothing. * @param pBlkCache The endpoint cache. * @param off The offset. * @param ppEntryAbove Where to store the pointer to the best fit entry above @@ -1727,12 +1716,10 @@ DECLINLINE(bool) pdmBlkCacheEntryFlagIsSetClearAcquireLock(PPDMBLKCACHE pBlkCach * Adds a segment to the waiting list for a cache entry * which is currently in progress. * - * @returns nothing. * @param pEntry The cache entry to add the segment to. * @param pWaiter The waiter entry to add. */ -DECLINLINE(void) pdmBlkCacheEntryAddWaiter(PPDMBLKCACHEENTRY pEntry, - PPDMBLKCACHEWAITER pWaiter) +DECLINLINE(void) pdmBlkCacheEntryAddWaiter(PPDMBLKCACHEENTRY pEntry, PPDMBLKCACHEWAITER pWaiter) { pWaiter->pNext = NULL; diff --git a/src/VBox/VMM/VMMR3/PDMNetShaper.cpp b/src/VBox/VMM/VMMR3/PDMNetShaper.cpp index 7c01015996b..d1326f3fe3c 100644 --- a/src/VBox/VMM/VMMR3/PDMNetShaper.cpp +++ b/src/VBox/VMM/VMMR3/PDMNetShaper.cpp @@ -399,7 +399,6 @@ static DECLCALLBACK(void) pdmR3NsUnchokeTimer(PVM pVM, TMTIMERHANDLE hTimer, voi /** * Terminate the network shaper, groups, lock and everything. * - * @returns VBox error code. * @param pVM The cross context VM structure. */ void pdmR3NetShaperTerm(PVM pVM) diff --git a/src/VBox/VMM/VMMR3/PDMQueue.cpp b/src/VBox/VMM/VMMR3/PDMQueue.cpp index ac0bb1bc81e..87acc363966 100644 --- a/src/VBox/VMM/VMMR3/PDMQueue.cpp +++ b/src/VBox/VMM/VMMR3/PDMQueue.cpp @@ -861,7 +861,6 @@ static DECLCALLBACK(void) pdmR3QueueTimer(PVM pVM, TMTIMERHANDLE hTimer, void *p /** * Terminate the queues, freeing any resources still allocated. * - * @returns nothing. * @param pVM The cross-context VM structure. */ DECLHIDDEN(void) pdmR3QueueTerm(PVM pVM) diff --git a/src/VBox/VMM/VMMR3/PGMPhys.cpp b/src/VBox/VMM/VMMR3/PGMPhys.cpp index bfa9cac6817..04b5888ea1f 100644 --- a/src/VBox/VMM/VMMR3/PGMPhys.cpp +++ b/src/VBox/VMM/VMMR3/PGMPhys.cpp @@ -5210,7 +5210,6 @@ static DECLCALLBACK(VBOXSTRICTRC) pgmR3PhysChangeMemBalloonRendezvous(PVM pVM, P /** * Frees a range of ram pages, replacing them with ZERO pages; helper for PGMR3PhysFreeRamPages * - * @returns VBox status code. * @param pVM The cross context VM structure. * @param fInflate Inflate or deflate memory balloon * @param cPages Number of pages to free @@ -5684,7 +5683,6 @@ static DECLCALLBACK(VBOXSTRICTRC) pgmR3PhysUnmapChunkRendezvous(PVM pVM, PVMCPU /** * Unmap a chunk to free up virtual address space (request packet handler for pgmR3PhysChunkMap) * - * @returns VBox status code. * @param pVM The cross context VM structure. */ static DECLCALLBACK(void) pgmR3PhysUnmapChunk(PVM pVM) diff --git a/src/VBox/VMM/VMMR3/TM.cpp b/src/VBox/VMM/VMMR3/TM.cpp index 26e19ad9c1f..a18b38a5ebe 100644 --- a/src/VBox/VMM/VMMR3/TM.cpp +++ b/src/VBox/VMM/VMMR3/TM.cpp @@ -3571,8 +3571,8 @@ VMMR3DECL(int) TMR3GetCpuLoadPercents(PUVM pUVM, VMCPUID idCpu, uint64_t *pcMsIn #ifndef VBOX_WITHOUT_NS_ACCOUNTING /** - * Helper for tmR3CpuLoadTimer. - * @returns + * Helper for tmR3CpuLoadTimer. + * * @param pState The state to update. * @param cNsTotal Total time. * @param cNsExecuting Time executing. diff --git a/src/VBox/VMM/include/DBGFInline.h b/src/VBox/VMM/include/DBGFInline.h index 65207773be7..6904f7bb25f 100644 --- a/src/VBox/VMM/include/DBGFInline.h +++ b/src/VBox/VMM/include/DBGFInline.h @@ -35,7 +35,6 @@ /** * Initializes the given L2 table entry with the given values. * - * @returns nothing. * @param pL2Entry The L2 entry to intialize. * @param hBp The breakpoint handle. * @param GCPtr The GC pointer used as the key (only the upper 6 bytes are used). @@ -61,7 +60,6 @@ DECLINLINE(void) dbgfBpL2TblEntryInit(PDBGFBPL2ENTRY pL2Entry, DBGFBP hBp, RTGCP /** * Updates the given L2 table entry with the new pointers. * - * @returns nothing. * @param pL2Entry The L2 entry to update. * @param idxL2Left The new left L2 table index. * @param idxL2Right The new right L2 table index. @@ -82,7 +80,6 @@ DECLINLINE(void) dbgfBpL2TblEntryUpdate(PDBGFBPL2ENTRY pL2Entry, uint32_t idxL2L /** * Updates the given L2 table entry with the left pointer. * - * @returns nothing. * @param pL2Entry The L2 entry to update. * @param idxL2Left The new left L2 table index. * @param iDepth The new depth of the tree. @@ -102,7 +99,6 @@ DECLINLINE(void) dbgfBpL2TblEntryUpdateLeft(PDBGFBPL2ENTRY pL2Entry, uint32_t id /** * Updates the given L2 table entry with the right pointer. * - * @returns nothing. * @param pL2Entry The L2 entry to update. * @param idxL2Right The new right L2 table index. * @param iDepth The new depth of the tree. diff --git a/src/VBox/VMM/include/IEMInternal-armv8.h b/src/VBox/VMM/include/IEMInternal-armv8.h index 7164f0d70fc..ff883f3df0f 100644 --- a/src/VBox/VMM/include/IEMInternal-armv8.h +++ b/src/VBox/VMM/include/IEMInternal-armv8.h @@ -741,7 +741,6 @@ typedef struct IEM /** Hint to IEMAllInstructionPython.py that this macro should be skipped. */ #define IEMOPHINT_SKIP_PYTHON RT_BIT_32(31) -/** @} */ /** @def IEM_DECL_IMPL_TYPE * For typedef'ing an instruction implementation function. diff --git a/src/VBox/VMM/testcase/tstPDMAsyncCompletionStress.cpp b/src/VBox/VMM/testcase/tstPDMAsyncCompletionStress.cpp index b8f041191d8..ebd72f2272d 100644 --- a/src/VBox/VMM/testcase/tstPDMAsyncCompletionStress.cpp +++ b/src/VBox/VMM/testcase/tstPDMAsyncCompletionStress.cpp @@ -531,7 +531,6 @@ static int tstPDMACStressTestFileOpen(PVM pVM, PPDMACTESTFILE pTestFile, unsigne /** * Closes a test file. * - * @returns nothing. * @param pTestFile Pointer to the test file. */ static void tstPDMACStressTestFileClose(PPDMACTESTFILE pTestFile) |