pure-ftpwho(8)

💅 pure-ftpwho(8) — the Pure-FTPd era

okay so first things first, the manual name is pure-ftpwho, it lives in section 8 of the Pure-FTPd manuals, and bestie… this one is a little bop.

✨ NAME ✨

pure-ftpwho — report the FTP sessions that are happening right now 👀

🎀 SYNTAX 🎀

pure-ftpwho [-c] [-h] [-H] [-n] [-p] [-s] [-v] [-w] [-W] [-x]

💖 DESCRIPTION 💖

pure-ftpwho shows you the Pure-FTPd client sessions that are currently live. It's giving backstage pass energy — you get to see who's connected and what's up. 🦋

Only the system administrator may run this, so like… main character privilege, don't abuse it. 🙈

The output can be text (that's the default, slay), HTML, XML data, or parser-optimized. Pick your vibe.

heads up though: the server has to be compiled with --with-ftpwho to support this command. no flag at build time = no ftpwho for you, and that's just how it is. 😭

🔥 OPTIONS 🔥

• -c — the program is being called via a web server (CGI interface). Output is a full HTML page with the initial content-type header, so it's actually a valid web response. This option is automatically enabled if an environment variable called GATEWAY_INTERFACE is found, and that's the default if you run the program from a CGI-enabled web server. ✨
• -h — output help information and exit. the classic "just tell me what to do" move 🫶
• -H — don't resolve host names, and only show IP addresses (faster). no DNS round-trips, no waiting, just numbers. 💅
• -n — a synonym for -H. same energy, different letter. ⭐
• -p — output Mac OSX / GNUStep plist data.
• -s — output only one line per client, with only numeric data, delimited by a | character. It's not very human-readable, but it's designed for easy parsing by shell scripts (cut/sed). | characters in user names or file names are quoted (\|). lowkey iconic for scripting, terrible for your eyes 👑
• -v — output an ASCII table (just like the default mode), with more info. The verbose output includes the local IP, the local port, the total size of transferred files and the current number of transferred bytes. so much data, so little time 🔥
• -w — output a complete HTML page (web mode). full page, header, footer, the whole fit. 🎀
• -W — output an HTML page with no header and no footer. This is an embedded mode, suitable for inline calls from CGI, SSI or PHP scripts. little snippet of a page, no extra baggage 🌸
• -x — output well-formed XML data for post-processing. for the parsers, the machines, the pipeline girlies 💀

🌈 FILES 🌈

• /var/run/pure-ftpd/ — the scoreboard directory. Should always be owned by root and on a lockable filesystem.

fr fr, keep it root-owned and on a filesystem that can lock. this is not the place to get creative. 💜

🧚 ENVIRONMENT VARIABLES 🧚

GATEWAY_INTERFACE

If found, automatically run in CGI mode and output HTML data. it literally just checks if you're being called from a web server and adapts. iykyk 🦋

🌟 AUTHORS 🌟

Frank DENIS <j at pureftpd dot org> — the icon who made this happen 👑

💫 SEE ALSO 💫

ftp(1), pure-ftpd(8), pure-ftpwho(8), pure-mrtginfo(8), pure-uploadscript(8), pure-statsdecode(8), pure-pw(8), pure-quotacheck(8), pure-authd(8), pure-certd(8)

RFC 959, RFC 2389, RFC 2228 and RFC 2428 — yes bestie, go read the RFCs, they're the lore 📚

---

and that's the page!! 🎉 this edition is version 1.0.54, authored by Frank 1.0.54 Denis, and it's dated right there on the 1.0.54 line of the manpage, published under pure-ftpwho(8). mwah, go check your sessions 💋🫶