[PATCH BlueZ] doc: explain SCO BT_SK_PKT_STATUS socket option

[PATCH BlueZ] doc: explain SCO BT_SK_PKT_STATUS socket option

[Pauli Virtanen]

---
 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.50.1

RE: [BlueZ] doc: explain SCO BT_SK_PKT_STATUS socket option

[bluez.test.bot]

[-- Attachment #1: Type: text/plain, Size: 1261 bytes --]

This is automated email and please do not reply to this email!

Dear submitter,

Thank you for submitting the patches to the linux bluetooth mailing list.
This is a CI test results with your patch series:
PW Link:https://patchwork.kernel.org/project/bluetooth/list/?series=982465

---Test result---

Test Summary:
CheckPatch                    PENDING   0.34 seconds
GitLint                       PENDING   0.23 seconds
BuildEll                      PASS      20.10 seconds
BluezMake                     PASS      2502.10 seconds
MakeCheck                     PASS      20.03 seconds
MakeDistcheck                 PASS      182.97 seconds
CheckValgrind                 PASS      234.59 seconds
CheckSmatch                   PASS      303.93 seconds
bluezmakeextell               PASS      127.88 seconds
IncrementalBuild              PENDING   0.24 seconds
ScanBuild                     PASS      918.81 seconds

Details
##############################
Test: CheckPatch - PENDING
Desc: Run checkpatch.pl script
Output:

##############################
Test: GitLint - PENDING
Desc: Run gitlint
Output:

##############################
Test: IncrementalBuild - PENDING
Desc: Incremental build with the patches in the series
Output:



---
Regards,
Linux Bluetooth

Re: [PATCH BlueZ] doc: explain SCO BT_SK_PKT_STATUS socket option

[patchwork-bot+bluetooth]

Hello:

This patch was applied to bluetooth/bluez.git (master)
by Luiz Augusto von Dentz <luiz.von.dentz@intel.com>:

On Tue, 15 Jul 2025 13:35:29 +0300 you wrote:
> ---
>  doc/sco.rst | 32 ++++++++++++++++++++++++++++++++
>  1 file changed, 32 insertions(+)

Here is the summary with links:
  - [BlueZ] doc: explain SCO BT_SK_PKT_STATUS socket option
    https://git.kernel.org/pub/scm/bluetooth/bluez.git/?id=6c3cc38da9dd

You are awesome, thank you!
-- 
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html