TITAN(1)

🦋 TITAN(1) — the general commands manual, but make it cute 🦋

okay so bestie, this is titan, from the General Commands Manual, and it's literally the Titan client. she's slaying in section 1 and she's here to get your files uploaded 💅

---

✨ NAME ✨

titan — Titan client. that's it, that's the whole vibe 🎀

✨ SYNOPSIS ✨

titan [-C cert] [-K key] [-m mime] [-t token] url [file]

✨ DESCRIPTION ✨

so titan lets you upload data to a Titan server, no cap. if you don't hand her a file on the command line, she just reads from standard input like the flexible icon she is 🫶

the options are as follows, and yes we're going through every single one:

• -C cert — specify the TLS client certificate to use 🔐
• -K cert — specify the TLS client certificate key to use. defaults to -C if that one was provided. (yes, the flag arg is literally labeled cert up there, we don't make the rules 😭)
• -m mime — specify the mime of the content being sent. unset by default 🌸
• -t token — specify the token for the transaction. unset by default ⭐

and here's the iconic part: titan alters the passed url to include the parameter for the file size, plus the MIME and the token if -m or -t were given. so your url comes out looking a little different than it went in, iykyk 💖

✨ EXIT STATUS ✨

the titan utility exits with one of these values, and each one is telling you a whole story:

• 0 — the trasaction completed successfully and the response code was in the 2x or 3x range 👑 (spelling straight from the manpage bestie, we don't edit, we respect 💀)
• 1 — an error occurred 😭
• 2 — the response code was not in the 2x or 3x range. so like, it ran, but the server said no 💀

✨ SEE ALSO ✨

ftp(1), gg(1) — go give the neighbors a lil visit 🦋

✨ STANDARDS ✨

titan implements the “Titan Specification” 🔥

gemini://transjovian.org/titan/page/The%20Titan%20Specification

✨ AUTHORS ✨

the titan utility was written by Omar Polo <op@omarpolo.com> — thank you king 🫶👑

✨ CAVEATS ✨

real talk, bestie: titan doesn't perform TOFU (Trust On First Use) or any X.509 certificate validation beyond the name verification. so she's not doing a full vibe check on that cert, just the name part. keep that in mind 🙈

---

and that's the whole page!!! 💖✨🎀🦋🌸

cute lil sign-off: this came from Debian, dated October 20, 2023 — and that's the TITAN(1) footer, babes. periodt 💅