xs_tcp_tls_setup_socket(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xs_tcp_tls_setup_socket(9) — like, the TLS-on-TCP glow-up, bestie ✨

okay so this is a page from the Kernel API Manual, and it's about xs_tcp_tls_setup_socket — the function that literally gets a TLS session up and running on a TCP socket 🎀 ngl it's kind of iconic.

🌸 NAME 🌸

xs_tcp_tls_setup_socket — establish a TLS session on a TCP socket 💖

✨ SYNOPSIS ✨

void xs_tcp_tls_setup_socket (struct work_struct *work );

🫶 ARGUMENTS 🫶

  • work — the queued work item, bestie. that's it. that's the whole argument 🩷

🔥 DESCRIPTION 🔥

Okay so picture this: this function gets invoked by a work queue tasklet. very demure, very scheduled 💅

Now for RPC-with-TLS, there's a two-stage connection process — yes, two stages, it's giving main character energy with a plot twist ✨

The "upper-layer xprt" is the one visible to the RPC consumer 👀 Once it's been marked connected, the consumer knows that a TCP connection and a TLS session have both been established. slay 💖

Then there's a "lower-layer xprt" — created right here in this function — and it handles all the mechanics: connecting the TCP socket, performing the RPC_AUTH_TLS probe, and then driving the TLS handshake 🌈 Once all of that is complete? The upper-layer xprt gets marked connected. periodt. 🔥

no cap, the lower-layer xprt is the one doing all the heavy lifting behind the scenes. it's giving backstage crew at the awards show 🎀

👑 SEE ALSO 👑

Kernel file ./net/sunrpc/xprtsock.c — and the whole friend group 🫶:

okay that's the whole page, bestie — go forth and handshake 💅💖

with love from ./net/sunrpc, dated October 2026, on behalf of xs_tcp_tls_setup_socket(9) — mwah 🎀✨

📦 where this page comes from