STRUCT DWC3_REQUEST(9)

💖 struct dwc3_request(9) — Kernel API Manual 💖

🌸 NAME 🌸

struct dwc3_request — bestie, this is literally the representation of a transfer request. That’s the whole vibe. 💅

✨ SYNOPSIS ✨

okay so here’s the struct in all its glory, no cap:

struct dwc3_request {
    struct usb_request      request;
    struct list_head        list;
    struct dwc3_ep          *dep;
    struct scatterlist      *start_sg;
    unsigned int            num_pending_sgs;
    unsigned int            remaining;
    unsigned int            status;
  #define DWC3_REQUEST_STATUS_QUEUED              0;
  #define DWC3_REQUEST_STATUS_STARTED             1;
  #define DWC3_REQUEST_STATUS_DISCONNECTED        2;
  #define DWC3_REQUEST_STATUS_DEQUEUED            3;
  #define DWC3_REQUEST_STATUS_STALLED             4;
  #define DWC3_REQUEST_STATUS_COMPLETED           5;
  #define DWC3_REQUEST_STATUS_UNKNOWN             -1;
    u8 epnum;
    struct dwc3_trb         *trb;
    dma_addr_t trb_dma;
    unsigned int            num_trbs;
    unsigned int            direction:1;
    unsigned int            mapped:1;
};

🎀 Members 🎀

every field has a job, and none of them are doing too much:

• request — the struct usb_request that’s actually getting transferred 🫶
• list — a list_head used for request queueing
• dep — the struct dwc3_ep that owns this request
• start_sg — pointer to the sg which should be queued next
• num_pending_sgs — counter to pending sgs
• remaining — amount of data remaining
• status — internal dwc3 request status tracking; the DWC3_REQUEST_STATUS_* defines up in the synopsis are its whole personality
• epnum — endpoint number to which this request refers
• trb — pointer to struct dwc3_trb
• trb_dma — DMA address of trb
• num_trbs — number of TRBs used by this request
• direction — IN or OUT direction flag
• mapped — true when the request has been dma-mapped

🦋 SEE ALSO 🦋

go read these next, bestie — same kernel-file energy:

• Kernel file ./drivers/usb/dwc3/core.h
• struct dwc3_event_buffer(9)
• struct dwc3_ep(9)
• struct dwc3_trb(9)
• struct dwc3_hwparams(9)
• struct dwc3_glue_ops(9)
• struct dwc3(9)
• struct dwc3_event_depevt(9)
• struct dwc3_event_devt(9)
• struct dwc3_event_gevt(9)
• union dwc3_event(9)
• struct dwc3_gadget_ep_cmd_params(9)
• dwc3_mdwidth(9)

okay bye bestie 🫶 — this page came from ./drivers/usb/dwc3, dated October 2026, and it’s struct dwc3_request(9). periodt. 💅