talitos_submit(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… talitos_submit(9) β€” like, the actual kernel API manual, bestie πŸŽ€

okay so real talk: this page lives in the Kernel API Manual section 9 (the kernel-functions girlies), and the page is literally called talitos_submit. Say it with me: ta-li-tos. Iconic name, no notes. ✨


🌸 NAME 🌸

talitos_submit β€” submits a descriptor to the device for processing 🫢

like, you hand the device a descriptor and it goes and does the thing. that's the whole vibe.


⭐ SYNOPSIS ⭐

int talitos_submit (struct device *dev , int ch , struct talitos_desc
*desc , void (*callback)(struct device *dev, struct talitos_desc *desc,
void *context, int error) , void *context );

ngl that callback signature is a whole paragraph of its own and it ate. πŸ”₯


πŸ¦‹ ARGUMENTS πŸ¦‹

  • dev β€” the SEC device to be used. this is your main character device, the one doing the work πŸ’–
  • ch β€” the SEC device channel to be used. yes babes, there are channels. pick one. πŸ”₯
  • desc β€” the descriptor to be processed by the device. the little guy carrying the actual instructions πŸŽ€
  • callback β€” whom to call when processing is complete. it's giving "i'll ring you when it's done" ✨
  • context β€” a handle for use by caller (optional). your little personal item you get to keep, optional bestie 🫢

πŸ’… DESCRIPTION πŸ’…

okay so <pink>desc</pink> must contain valid dma-mapped (bus physical) address pointers. like, not virtual, not vibes β€” bus physical. if those pointers aren't properly dma-mapped, that's a you problem and it's not a cute one 😭

and <pink>callback</pink> must check err and feedback in the descriptor header for device processing status. yes bestie, you have to actually check. don't just assume it worked, the descriptor header is telling you things and you need to listen πŸ‘‘πŸ’€

no cap: the manual says must for both of these. not "should", not "it'd be nice" β€” must. treat it like the group chat rule. periodt. 🌸

🌈 SEE ALSO 🌈

  • Kernel file ./drivers/crypto/talitos.c β€” the source, the origin story, the blueprint 🧚

and that's the page!! πŸ¦‹βœ¨ so much love to ./drivers/crypto, dated October 2026, home of the one and only talitos_submit(9) β€” mwah, go submit some descriptors responsibly πŸ’œπŸŽ€

πŸ“¦ where this page comes from