pure-uploadscript(8) | Pure-FTPd | pure-uploadscript(8) |
pure-uploadscript - Automatically run an external program after a successful upload
pure-uploadscript [-p </path/to/pidfile>] [-B] [-g <gid>] [-h] -r <program to run> [-u <uid>]
If Pure-FTPd is compiled with --with-uploadscript (default
in binary distributions), and if the -o (or --uploadscript) is
passed to the server, a named pipe called
/var/run/pure-ftpd.upload.pipe is created. You will also notice an
important file called /var/run/pure-ftpd.upload.lock, used for
locking.
After a successful upload, the file name is written to the pipe.
pure-uploadscript reads this pipe to automatically run any program or
script to process the newly uploaded file.
When the upload script is run, the name of the newly uploaded file is the first argument passed to the script (referenced as $1 by most shells) . Some environment variables are also filled by useful info about the file. UPLOAD_SIZE The size of the file, in bytes. UPLOAD_PERMS The permissions, as an octal integer. UPLOAD_UID The numerical UID of the owner. UPLOAD_GID The numerical GID of the owner. UPLOAD_USER The login of the owner. UPLOAD_GROUP The group name the files belongs to. UPLOAD_VUSER The full user name, or the virtual user name (127 chars max) .
/var/run/pure-ftpd.upload.pipe /var/run/pure-ftpd.upload.lock /var/run/pure-uploadscript.pid
pure-ftpd and pure-uploadscript are trying to limit security implications of such a feature.
A sample script could be:
#! /bin/sh
echo "$1 uploaded" | /usr/bin/mutt -s "New upload: $1" \
ftpadmin@dom.ai.n
Never forget to quote ("variable") all variables in all your shell scripts to avoid security flaws.
Frank DENIS <j at pureftpd dot org>
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 2228, RFC 2389 and RFC 2428.
1.0.50 | Frank Denis |