Page MenuHomeFreeBSD

libusb: implement zlp flag in libusb transfer
ClosedPublic

Authored by aokblast on Aug 6 2025, 12:58 PM.
Tags
Referenced Files
F166902056: D51759.id179613.diff
Mon, Aug 17, 3:45 PM
Unknown Object (File)
Sun, Aug 16, 7:34 AM
Unknown Object (File)
Wed, Aug 12, 12:02 AM
Unknown Object (File)
Sun, Aug 9, 4:17 PM
Unknown Object (File)
Sun, Aug 9, 5:57 AM
Unknown Object (File)
Sun, Aug 9, 4:49 AM
Unknown Object (File)
Sat, Aug 8, 6:40 PM
Unknown Object (File)
Fri, Aug 7, 6:11 PM
Subscribers

Details

Summary

The USB protocol defines a Zero-Length Packet (ZLP) to signal the end of
a transfer when the data size is an exact multiple of the Maximum Packet
Size (MPS). Without a ZLP in such cases, the device may not be able to
determine that the transfer has completed.

This flag is added to libusb to allow the user send a ZLP in the end
of libusb_xfer.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 66093
Build 62976: arc lint + arc unit

Event Timeline

Send packet only the multiple of packet

defer zlp check until we can find the xfer

lwhsu added inline comments.
lib/libusb/libusb10.c
1633

should we use libusb20_tr_get_max_packet_length() or libusb20_tr_get_max_total_length()?

This implemented is problematic since the correct way is to append a zero size TRB in TD instead of creating new TD. However, I think I am unable to make it work before 15.0 release. Therefore, I will modify it to at least we won't break any ABI for 15 if we want to merge later.

adrian added a reviewer: USB.
adrian added a project: USB.
This revision is now accepted and ready to land.Jun 18 2026, 5:11 AM