iscsi_tcp_segment_recv(9)

📦 version 7.3.1, in nixpkgs unstable

💅 iscsi_tcp_segment_recv(9) — the Kernel API Manual, bestie edition ✨

Okay so this is a page from the Kernel API Manual (yes, that manual, the kernel one, we're fancy now 🎀) and it's about one little function that copies data into a segment. Baby function. Big job. Let's get into it 🦋

✨ NAME ✨

iscsi_tcp_segment_recv — copy data to segment 💖

🌸 SYNOPSIS 🌸

int iscsi_tcp_segment_recv (struct iscsi_tcp_conn *tcp_conn , struct
iscsi_segment *segment , const void *ptr , unsigned int len );

Like, that's the whole signature, character for character, no notes 💅

🫶 ARGUMENTS 🫶

  • tcp_conn — the iSCSI TCP connection, the main character of this whole vibe 🌈
  • segment — the buffer to copy to, aka where the data's gonna live
  • ptr — data pointer, literally just a pointer to the data 👑
  • len — amount of data available, so you know how much we're working with

🦋 DESCRIPTION 🦋

So what this function does is copy up to len bytes into the given buffer, and then it returns the number of bytes actually consumed — and yeah, lowkey that number can genuinely be less than len. Not a bug, just how it is 💀

If CRC is enabled, the function will update the CRC while copying. Like, doing both things at once 🧚

And the manpage is very honest about this part: combining these two operations doesn't buy us a lot (yet), but in the future we could implement combined copy+crc, just the way we do for network layer checksums. So it's giving "we left room for a glow-up" ✨

Real talk though: the "returns less than len" thing is for real, so bestie, don't assume you got everything you asked for — check what it actually handed back 🙈

💜 SEE ALSO 💜

Kernel file ./drivers/scsi/libiscsi_tcp.c — and while you're there, go peek at all these siblings, they're iconic:

That's the whole page, no skips, no cuts, we ate and left no crumbs 🍓 Coming to you from ./drivers/scsi, dated October 2026 — mwah, periodt 💋🌷

📦 where this page comes from