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.