SSH_PACKET_PRIORITY(9)
π SSH_PACKET_PRIORITY(9) β the kernel API manual, but make it make sense
okay so bestie, we're in the Kernel API Manual today and this little macro is genuinely iconic β it's the whole "who goes first" of the Surface Aggregator packet world π
β¨ NAME β¨
SSH_PACKET_PRIORITY β literally computes the packet priority for you, out of the base priority plus how many tries it's had πΈ
π¦ SYNOPSIS π¦
SSH_PACKET_PRIORITY (base , try );
no cap, that's the whole vibe π
π ARGUMENTS π
baseβ the base priority, given as the suffix ofenum ssh_packet_base_priority, likeFLUSH,DATA,ACK, orNAK. iykyk π₯tryβ the number of tries. and bestie, listen: it must be less than 16 π that's not a suggestion, that's the rule.
π DESCRIPTION π
so it computes the combined packet priority, right? and the way it works is that the combined priority is dominated by the base priority π β like, base priority is the main character here.
meanwhile the number of (re-)tries decides the precedence of packets that have the same base priority. and the packets that already have more tries? they get higher priority. periodt π
β RETURN β
returns the computed priority as a value that fits inside a u8 π«Ά and remember: a higher number means a higher priority. higher number = more important, no cap π
π SEE ALSO π
okay this list is a journey, buckle up π§
- Kernel file
./include/linux/surface_aggregator/serial_hub.h enum ssh_frame_type(9)struct ssh_frame(9)enum ssh_payload_type(9)struct ssh_command(9)SSH_MESSAGE_LENGTH(9)SSH_COMMAND_MESSAGE_LENGTH(9)SSH_MSGOFFSET_FRAME(9)SSH_MSGOFFSET_COMMAND(9)ssh_crc(9)ssh_rqid_next_valid(9)ssh_rqid_to_event(9)ssh_rqid_is_event(9)ssh_tc_to_rqid(9)ssh_tid_to_index(9)ssh_tid_is_valid(9)struct ssam_span(9)enum ssam_ssh_tid(9)enum ssh_packet_base_priority(9)ssh_packet_priority_get_try(9)ssh_packet_priority_get_base(9)struct ssh_packet_ops(9)struct ssh_packet(9)ssh_packet_set_data(9)struct ssh_request_ops(9)struct ssh_request(9)to_ssh_request(9)ssh_request_get(9)ssh_request_put(9)ssh_request_set_data(9)
and that's the page, bestie π sign-off time: this one comes from ./include/linux/surface_aggreg... and it's dated October 2026 β SSH_PACKET_PRIORITY(9), ate and left no crumbs πβ¨
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms