pure-ftpwho(8)

NAME

pure-ftpwho - Report current FTP sessions

SYNTAX

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

DESCRIPTION

pure-ftpwho shows current Pure-FTPd client sessions. Only the system administrator may run this. Output can be text (default), HTML, XML data and parser-optimized. The server has to be compiled with --with-ftpwho to support this command.

OPTIONS

-c  the program is called via a web server (CGI interface) . Output is a full HTML page with the initial content-type header. This option is automatically enabled if an environment variable called GATEWAY_INTERFACE is found. This is the default if you can the program from a CGI-enabled web server (Apache, Roxen, Caudium, WN, ...) .

-h  Output help information and exit.

-H  Don't resolve host names, and only show IP addresses (faster).

-n  A synonym for -H.

-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 (\|) .

-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 transfered files and the current number of transfered bytes.

-w  Output a complete HTML page (web mode).

-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.

-x  Output well-formed XML data for post-processing.

FILES

/var/run/pure-ftpd/ Scoreboard directory. Should always owned by root and on a lockable filesystem.

ENVIRONMENT VARIABLES

GATEWAY_INTERFACE
    If found, automatically run in CGI mode and output HTML data.

AUTHORS

Frank DENIS <j at pureftpd dot org>

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) RFC 959, RFC 2389, RFC 2228 and RFC 2428.