STRUCT QAIC_PERF_STATS_ENTRY(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… NAME

struct qaic_perf_stats_entry β€” literally just defines a BO perf info, that's it, that's the whole vibe ✨

So quick context bestie: this is a kernel API manual page (the "Kernel API Manual" one, iykyk), and this struct is your little ticket to getting performance stats on a BO πŸŽ€


🌸 SYNOPSIS

struct qaic_perf_stats_entry {
    __u32 handle;
    __u32 queue_level_before;
    __u32 num_queue_element;
    __u32 submit_latency_us;
    __u32 device_latency_us;
    __u32 pad;
 };

Like, that's the whole struct. Six __u32s. Nothing scary, promise 🫢


✨ Members ✨

  • handle β€” In. It's the GEM handle of the BO you want perf stats for. You're handing it over so it can look up the right BO, k? πŸ’–
  • queue_level_before β€” Out. Number of elements that were chilling in the queue before this BO got submitted. Lowkey a little snapshot of the queue's vibe at that moment πŸ“Έ
  • num_queue_element β€” Out. Number of elements that got added to the queue in order to submit this BO. So how much queue it actually took up 🧚
  • submit_latency_us β€” Out. Time taken by the driver to submit this BO. That's the driver's shift, not the hardware's, okay? πŸ‘‘
  • device_latency_us β€” Out. Time taken by the device to execute this BO. The actual hardware doing the actual work, we love to see it πŸ”₯
  • pad β€” Structure padding. Must be 0. No cap, it has to be zero, don't be cute about it πŸ™ˆ

πŸ¦‹ SEE ALSO

Kernel file ./include/uapi/drm/qaic_accel.h struct:

  • qaic_manage_trans_hdr(9)
  • struct qaic_manage_trans_passthrough(9)
  • struct qaic_manage_trans_dma_xfer(9)
  • struct qaic_manage_trans_activate_to_dev(9)
  • struct qaic_manage_trans_activate_from_dev(9)
  • struct qaic_manage_trans_deactivate(9)
  • struct qaic_manage_trans_status_to_dev(9)
  • struct qaic_manage_trans_status_from_dev(9)
  • struct qaic_manage_msg(9)
  • struct qaic_create_bo(9)
  • struct qaic_mmap_bo(9)
  • struct qaic_sem(9)
  • struct qaic_attach_slice_entry(9)
  • struct qaic_attach_slice_hdr(9)
  • struct qaic_attach_slice(9)
  • struct qaic_execute_entry(9)
  • struct qaic_partial_execute_entry(9)
  • struct qaic_execute_hdr(9)
  • struct qaic_execute(9)
  • struct qaic_wait(9)
  • struct qaic_perf_stats_hdr(9)
  • struct qaic_perf_stats(9)
  • struct qaic_detach_slice(9)

Bestie, that's the whole friend group, go say hi to all of them πŸ’œ


Okay so fr fr, this page lives at ./include/uapi/drm, it's dated October 2026, and it's filed under struct qaic_..._stats_entry(9). Slay, that's the sign-off, mwah πŸ’‹πŸ’–
πŸ“¦ where this page comes from