summaryrefslogtreecommitdiff
path: root/src/VBox/Devices/Serial
diff options
context:
space:
mode:
Diffstat (limited to 'src/VBox/Devices/Serial')
-rw-r--r--src/VBox/Devices/Serial/DevOxPcie958.cpp2
-rw-r--r--src/VBox/Devices/Serial/DevPL011.cpp4
-rw-r--r--src/VBox/Devices/Serial/DrvHostSerial.cpp3
-rw-r--r--src/VBox/Devices/Serial/DrvTCP.cpp1
-rw-r--r--src/VBox/Devices/Serial/UartCore.cpp13
-rw-r--r--src/VBox/Devices/Serial/UartCore.h1
6 files changed, 0 insertions, 24 deletions
diff --git a/src/VBox/Devices/Serial/DevOxPcie958.cpp b/src/VBox/Devices/Serial/DevOxPcie958.cpp
index f5973bed12e..2149397d28c 100644
--- a/src/VBox/Devices/Serial/DevOxPcie958.cpp
+++ b/src/VBox/Devices/Serial/DevOxPcie958.cpp
@@ -211,7 +211,6 @@ typedef CTX_SUFF(PDEVOX958) PDEVOX958CC;
/**
* Update IRQ status of the device.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared OXPCIe958 device instance data.
*/
@@ -290,7 +289,6 @@ static VBOXSTRICTRC ox958UartRegWrite(PPDMDEVINS pDevIns, PDEVOX958 pThis, POX95
/**
* UART core IRQ request callback.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pUart The UART requesting an IRQ update.
* @param iLUN The UART index.
diff --git a/src/VBox/Devices/Serial/DevPL011.cpp b/src/VBox/Devices/Serial/DevPL011.cpp
index 2a9b6e3943b..ad31176e4ec 100644
--- a/src/VBox/Devices/Serial/DevPL011.cpp
+++ b/src/VBox/Devices/Serial/DevPL011.cpp
@@ -379,7 +379,6 @@ static const char *s_aszStopBits[] =
/**
* Updates the IRQ state based on the current device state.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -460,7 +459,6 @@ static VBOXSTRICTRC pl011Xmit(PPDMDEVINS pDevIns, PDEVPL011CC pThisCC, PDEVPL011
/**
* Updates the serial port parameters of the attached driver with the current configuration.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -533,7 +531,6 @@ static void pl011R3ParamsUpdate(PPDMDEVINS pDevIns, PDEVPL011 pThis, PDEVPL011CC
* Reset the transmit/receive related bits to the standard values
* (after a detach/attach/reset event).
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -572,7 +569,6 @@ static void pl011R3XferReset(PPDMDEVINS pDevIns, PDEVPL011 pThis, PDEVPL011CC pT
/**
* Tries to copy the specified amount of data from the active TX queue (register or FIFO).
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
diff --git a/src/VBox/Devices/Serial/DrvHostSerial.cpp b/src/VBox/Devices/Serial/DrvHostSerial.cpp
index b95a4e4c1ed..4e77d902f51 100644
--- a/src/VBox/Devices/Serial/DrvHostSerial.cpp
+++ b/src/VBox/Devices/Serial/DrvHostSerial.cpp
@@ -174,7 +174,6 @@ DECLINLINE(size_t) drvHostSerialReadBufGetRead(PDRVHOSTSERIAL pThis, void **ppv)
/**
* Advances the write position of the read buffer by the given amount of bytes.
*
- * @returns nothing.
* @param pThis The host serial driver instance.
* @param cbAdv Number of bytes to advance.
*/
@@ -190,7 +189,6 @@ DECLINLINE(void) drvHostSerialReadBufWriteAdv(PDRVHOSTSERIAL pThis, size_t cbAdv
/**
* Advances the read position of the read buffer by the given amount of bytes.
*
- * @returns nothing.
* @param pThis The host serial driver instance.
* @param cbAdv Number of bytes to advance.
*/
@@ -595,7 +593,6 @@ static int drvHostSerialIoLoopNormal(PPDMDRVINS pDrvIns, PDRVHOSTSERIAL pThis, P
/**
* The error I/O loop.
*
- * @returns VBox status code.
* @param pThis Host serial driver instance data.
* @param pThread Thread instance data.
*/
diff --git a/src/VBox/Devices/Serial/DrvTCP.cpp b/src/VBox/Devices/Serial/DrvTCP.cpp
index 6f9b8811b80..1bc037d0e85 100644
--- a/src/VBox/Devices/Serial/DrvTCP.cpp
+++ b/src/VBox/Devices/Serial/DrvTCP.cpp
@@ -147,7 +147,6 @@ static int drvTcpPollerKick(PDRVTCP pThis, uint8_t bReason)
/**
* Closes the connection.
*
- * @returns nothing.
* @param pThis The TCP driver instance.
*/
static void drvTcpConnectionClose(PDRVTCP pThis)
diff --git a/src/VBox/Devices/Serial/UartCore.cpp b/src/VBox/Devices/Serial/UartCore.cpp
index 3baf841bcf7..5125bd51800 100644
--- a/src/VBox/Devices/Serial/UartCore.cpp
+++ b/src/VBox/Devices/Serial/UartCore.cpp
@@ -283,7 +283,6 @@ static const char *s_aszStopBits[] =
/**
* Updates the IRQ state based on the current device state.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -420,7 +419,6 @@ DECLINLINE(uint8_t) uartFifoGet(PUARTFIFO pFifo)
/**
* Clears the given FIFO.
*
- * @returns nothing.
* @param pFifo The FIFO to clear.
*/
DECLINLINE(void) uartFifoClear(PUARTFIFO pFifo)
@@ -510,7 +508,6 @@ DECLINLINE(size_t) uartFifoCopyFrom(PUARTFIFO pFifo, void *pvSrc, size_t cbCopy)
* Updates the delta bits for the given MSR register value which has the status line
* bits set.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -537,7 +534,6 @@ static void uartR3MsrUpdate(PPDMDEVINS pDevIns, PUARTCORE pThis, PUARTCORECC pTh
/**
* Updates the serial port parameters of the attached driver with the current configuration.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -609,7 +605,6 @@ static void uartR3ParamsUpdate(PPDMDEVINS pDevIns, PUARTCORE pThis, PUARTCORECC
/**
* Updates the internal device state with the given PDM status line states.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -635,7 +630,6 @@ static void uartR3StsLinesUpdate(PPDMDEVINS pDevIns, PUARTCORE pThis, PUARTCOREC
/**
* Fills up the receive FIFO with as much data as possible.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -689,7 +683,6 @@ static void uartR3RecvFifoFill(PPDMDEVINS pDevIns, PUARTCORE pThis, PUARTCORECC
/**
* Fetches a single byte and writes it to RBR.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -710,7 +703,6 @@ static void uartR3ByteFetch(PPDMDEVINS pDevIns, PUARTCORE pThis, PUARTCORECC pTh
/**
* Fetches a ready data based on the FIFO setting.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -730,7 +722,6 @@ static void uartR3DataFetch(PPDMDEVINS pDevIns, PUARTCORE pThis, PUARTCORECC pTh
* Reset the transmit/receive related bits to the standard values
* (after a detach/attach/reset event).
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -770,7 +761,6 @@ static void uartR3XferReset(PPDMDEVINS pDevIns, PUARTCORE pThis, PUARTCORECC pTh
/**
* Tries to copy the specified amount of data from the active TX queue (register or FIFO).
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -1919,7 +1909,6 @@ DECLHIDDEN(int) uartR3LoadDone(PPDMDEVINS pDevIns, PUARTCORE pThis, PUARTCORECC
/**
* Resets the given UART core instance.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -1998,7 +1987,6 @@ DECLHIDDEN(int) uartR3Attach(PPDMDEVINS pDevIns, PUARTCORE pThis, PUARTCORECC pT
/**
* Detaches any attached driver from the given UART core instance.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared serial port instance data.
* @param pThisCC The serial port instance data for the current context.
@@ -2020,7 +2008,6 @@ DECLHIDDEN(void) uartR3Detach(PPDMDEVINS pDevIns, PUARTCORE pThis, PUARTCORECC p
/**
* Destroys the given UART core instance freeing all allocated resources.
*
- * @returns nothing.
* @param pDevIns The device instance.
* @param pThis The shared UART core instance data..
*/
diff --git a/src/VBox/Devices/Serial/UartCore.h b/src/VBox/Devices/Serial/UartCore.h
index f286a2d19bb..3b63bc03862 100644
--- a/src/VBox/Devices/Serial/UartCore.h
+++ b/src/VBox/Devices/Serial/UartCore.h
@@ -71,7 +71,6 @@ typedef struct UARTCORE *PUARTCORE;
/**
* UART core IRQ request callback to let the core instance raise/clear interrupt requests.
*
- * @returns nothing.
* @param pDevIns The owning device instance.
* @param pThis The shared UART core instance data.
* @param iLUN The LUN associated with the UART core.