sclp_ftp_cmd(9)

💅 sclp_ftp_cmd(9) — the Kernel API Manual, bestie edition 🎀

okay so real talk, this is a page from the Kernel API Manual and it's about one (1) very specific little function. she's niche, she's s390-coded, and she is not here to be called from twelve places at once. let's get into it ✨

---

🌸 NAME 🌸

sclp_ftp_cmd — literally executes a HMC related SCLP Diagnose (ET7) FTP command. that's the whole vibe. no cap. 💅

---

🦋 SYNOPSIS 🦋

ssize_t sclp_ftp_cmd (const struct hmcdrv_ftp_cmdspec *ftp , size_t
*fsize );

copy it exactly bestie, spacing and all, she's sensitive about her formatting 🫶

---

🎀 ARGUMENTS 🎀

• ftp — pointer to FTP command specification. it's giving "here's the plan, go do the thing" 📋
• fsize — return of file size (or NULL if undesirable). so like, if you don't care about the file size, just pass NULL and she'll respect that boundary 🙈

---

💖 DESCRIPTION 💖

⚠️ Attention: Notice that this function is not reentrant — so the caller must ensure locking. 🔒

this is the main character warning of the whole page, ok? she is not reentrant. do NOT let two threads roll up on her at the same time thinking it's a party. the caller is responsible for the locking. that's you. yes, you. lock it down or it's gonna be a whole situation 😭💀

---

🔥 RETURN 🔥

she returns the number of bytes read/written, or a (negative) error code. so if the number is negative? that's not a byte count bestie, that's an error — read the vibe check accordingly ⭐

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/s390/char/sclp_ftp.c — the source file herself, go say hi 👑
• sclp_ftp_txcb(9)
• sclp_ftp_rxcb(9)
• sclp_ftp_et7(9)
• sclp_ftp_startup(9)
• sclp_ftp_shutdown(9)

the whole friend group fr fr, go read them all 🧚💜

---

and that's the page!! sign-off time: this beauty lives in ./drivers/s390/char, she's dated October 2026, and she goes by sclp_ftp_cmd(9). obsessed with her honestly. slay, sclp_ftp_cmd, slay 🍓✨