summaryrefslogtreecommitdiffstats
path: root/host
diff options
context:
space:
mode:
authorJosh Blum <josh@joshknows.com>2013-07-19 12:50:57 -0700
committerJosh Blum <josh@joshknows.com>2013-07-19 12:50:57 -0700
commite7642d44d5fb0a168c1da620e3463c68e4df68f9 (patch)
tree9cb5366f6778682d9046028c7b64249db9323d43 /host
parenteb3f43c5485dd264c4310417f19313bf65dc6e34 (diff)
downloaduhd-e7642d44d5fb0a168c1da620e3463c68e4df68f9.tar.gz
uhd-e7642d44d5fb0a168c1da620e3463c68e4df68f9.tar.bz2
uhd-e7642d44d5fb0a168c1da620e3463c68e4df68f9.zip
uhd: update the docs for the D discontinuity indication
Diffstat (limited to 'host')
-rw-r--r--host/docs/general.rst4
1 files changed, 3 insertions, 1 deletions
diff --git a/host/docs/general.rst b/host/docs/general.rst
index fc2735c46..b116ba816 100644
--- a/host/docs/general.rst
+++ b/host/docs/general.rst
@@ -125,7 +125,7 @@ Overflow notes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
When receiving, the device produces samples at a constant rate.
Overflows occurs when the host does not consume data fast enough.
-When UHD software detects the overflow, it prints an "O" to stdout,
+When UHD software detects the overflow, it prints an "O" or "D" to stdout,
and pushes an inline message packet into the receive stream.
**Network-based devices**:
@@ -133,12 +133,14 @@ The host does not back-pressure the receive stream.
When the kernel's socket buffer becomes full, it will drop subsequent packets.
UHD software detects the overflow as a discontinuity in the packet's sequence numbers,
and pushes an inline message packet into the receive stream.
+In this case the character "D" is printed to stdout as an indication.
**Other devices**:
The host back-pressures the receive stream.
Therefore, overflows always occur in the device itself.
When the device's internal buffers become full, streaming is shut off,
and an inline message packet is sent to the host.
+In this case the character "O" is printed to stdout as an indication.
If the device was in continuous streaming mode,
the UHD software will automatically restart streaming.