From 6c3cc38da9ddd16fee23744cc9181404c4417b4d Mon Sep 17 00:00:00 2001 From: Pauli Virtanen Date: Tue, 15 Jul 2025 13:35:29 +0300 Subject: [PATCH] doc: explain SCO BT_SK_PKT_STATUS socket option --- doc/sco.rst | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/doc/sco.rst b/doc/sco.rst index 766a1bf1e..1d840c989 100644 --- a/doc/sco.rst +++ b/doc/sco.rst @@ -185,6 +185,38 @@ Example: return 1; } +BT_PKT_STATUS (since Linux 5.9) +------------------------------- + +Enable reporting packet status via `BT_SCM_PKT_STATUS` CMSG on +received packets. Possible values: + +.. csv-table:: + :header: "Value", "Description" + :widths: auto + + **0**, Disable (default) + **1**, Enable + + +:BT_SCM_PKT_STATUS: + + Level ``SOL_BLUETOOTH`` CMSG with data:: + + uint8_t pkt_status; + + The values are equal to the "Packet_Status_Flag" defined in + Core Specification v6.0 Sec. 5.4.3 pp. 1877: + + .. csv-table:: + :header: "pkt_status", "Description" + :widths: auto + + **0x0**, Correctly received data + **0x1**, Possibly invalid data + **0x2**, No data received + **0x3**, Data partially lost + BT_PHY (since Linux 5.10) ------------------------- -- 2.47.3