![]() |
||||
The following variables can be inserted into anywhere in the RaidenFTPD events message files (message/*.msg) , and the physical path , virtual path , owner , group columns in the virtual filesystem files (*.vfs) , or even can be inserted into event triggers lines in the *.ftpd file , ex: onFileUploaded= | ||||
user
information variables
|
||||
var
|
description
|
.msg
|
.vfs
|
|
%S | name of logged in user |
Y
|
Y
|
|
%z | name of logged in user (left aligned with padding spaces up to 14 chars , do not use in *.vfs) |
Y
|
N
|
|
%g | user's group (primary) |
Y
|
Y
|
|
%/ | user's group (all groups , if user is in multi groups) |
Y
|
N
|
|
%Z | user's group (left aligned with padding spaces up to 14 chars , do not use in *.vfs) |
Y
|
N
|
|
%Y | user's tag line ( comment line , all spaces are replaced by %20 , do not use in *.vfs) |
Y
|
N
|
|
%T | user's tag line ( comment line , left aligned with padding spaces up to 25 chars , do not use in *.vfs) |
Y
|
N
|
|
%d | number of bytes downloaded in the current session |
Y
|
N
|
|
%p | number of bytes uploaded in the current session |
Y
|
N
|
|
%v | last download speed (kb/sec) |
Y
|
N
|
|
%V | last upload speed (kb/sec) |
Y
|
N
|
|
%x | history downloaded mega bytes |
Y
|
N
|
|
%X | history uploaded mega bytes |
Y
|
N
|
|
%w | history downloaded kilo bytes |
Y
|
N
|
|
%W | history uploaded kilo bytes |
Y
|
N
|
|
%C | user's credit (mega bytes) |
Y
|
N
|
|
%c | user's credit (kilo bytes) |
Y
|
N
|
|
%i | the IP address from which the user is logged in |
Y
|
N
|
|
%D | the user's idle time |
Y
|
N
|
|
%E | user's ratio (1:x or unlimited) |
Y
|
N
|
|
%e | current directory |
Y
|
N
|
|
%P | password of anonymous user (usually email address) , this will be empty value for normal users |
Y
|
N
|
|
%$ | the user's leve , 0-4 0=root , 1=super , 2=normal , 3=guest |
Y
|
N
|
|
system
information variables
|
||||
var
|
description
|
.msg
|
.vfs
|
|
%h | server's name |
Y
|
N
|
|
%u | server's up time ( HH : MM : SS ) format |
Y
|
N
|
|
%y | string of today ( ex: 0707 for July 7th ) |
Y
|
Y
|
|
%U | server's startup time ( YYYY/MM/DD HH:MM ) |
Y
|
N
|
|
%t | current date and time |
Y
|
N
|
|
%N | maximum number of anonymous and registered users |
Y
|
N
|
|
%n | number of users logged in (anonymous and registered) |
Y
|
N
|
|
%f | free disk space under current virtual path ( not including virtual mount points ) |
Y
|
N
|
|
%I | max allowed connections from the same IP |
Y
|
N
|
|
%o | server output byte status |
Y
|
N
|
|
%l | server input byte status |
Y
|
N
|
|
%b | success files count in current *.sfv or *.md5 lists |
Y
|
N
|
|
%> | the current uploaded file's crc32 value (only available for onSfvSuccess/onSfvFailed events) |
Y
|
N
|
|
%R | files count in *.sfv or *.md5 files |
Y
|
N
|
|
%^ | the current physical path where the client is staying inside |
Y
|
N
|
|
%H | the virtual dir/file name which the client just accessed (or accessing)by RETR/STOR/MKD/RMD and site nuke , however all space characters are converted to %20 |
Y
|
N
|
|
%r | the virtual dir/file name which the client just accessed (or accessing)by RETR/STOR/MKD/RMD and site nuke/move |
Y
|
N
|
|
%m | the full physical dir/file name which the client just accessed (or accessing)by RETR/STOR/MKD/RMD and site move |
Y
|
N
|
|
%G | the full physical dir/file name which the client just accessed (or accessing)by RETR/STOR/MKD/RMD , however all space characters are converted to %20 |
Y
|
N
|
|
%q | the full physical path name (short path name) which the client just accessed (or accessing) by RETR/STOR command |
Y
|
N
|
|
%= | the filename (short path name) which the client just accessed (or accessing) by RETR/STOR command |
Y
|
N
|
|
%Q | the filename (short path name) which the client just accessed (or accessing) by RETR/STOR command |
Y
|
N
|
|
%- | the filepath (short path name) which the client just accessed (or accessing) by RETR/STOR command , without the file name |
Y
|
N
|
|
%+ | the file extension of the file which the client just accessed (or accessing) by RETR/STOR command |
Y
|
N
|
|
%M | the filesize (in kilobytes) of the file which the client just accessed (or accessing) by RETR/STOR , or the target directory size for site move command |
Y
|
N
|
|
%F | the reason of the directory just got nuked by site nuke command |
Y
|
N
|
|
%j | the multiplier of the directory just got nuked by site nuke command |
Y
|
N
|
|
%O | the reason of the file being marked as a dupe file (a file that already existed in this virtual file system) |
Y
|
N
|
|
%L | Mp3 ID3 tag's song title , if the last file being uploaded is a mp3 file (30 chars with space appended) |
Y
|
N
|
|
%k | Mp3 ID3 tag's artist name , if the last file being uploaded is a mp3 file (30 chars with space appended) |
Y
|
N
|
|
%K | Mp3 ID3 tag's album name , if the last file being uploaded is a mp3 file (30 chars with space appended) |
Y
|
N
|
|
%a | Mp3 header's bit rate , if the last file being uploaded is a mp3 file (10 chars with space appended) |
Y
|
N
|
|
%J | Mp3 ID3 tag's year , if the last file being uploaded is a mp3 file (4 chars with space appended) |
Y
|
N
|
|
%A | Mp3 header's sampling frequency , if the last file being uploaded is a mp3 file (8 chars with space appended) |
Y
|
N
|
|
%B | Mp3 ID3 tag's genre , if the last file being uploaded is a mp3 file (32 chars with space appended) |
Y
|
N
|
|
%s | Mp3 ID3 tag's genre , if the last file being uploaded is a mp3 file (32 chars with space appended) , however all space characters are converted to %20 |
Y
|
N
|
|
%! | Whole string for site command , not including 'site' itself , this variable is for use with onSiteCmd event only |
Y
|
N
|
|
%~ | user's domain name (maybe empty) |
Y
|
N
|
|
%* | nuked user when executing site nuke command |
Y
|
N
|
|
%@ | Global unique client ID , a 32 bit number translated to string , can be used to identify ftp client object , see here |
Y
|
N
|
|
%& | number of online people downloading , evaluated on RETR/STOR/APPE commands |
Y
|
N
|
|
%( | number of online people uploading , evaluated on RETR/STOR/APPE commands |
Y
|
N
|
|
%) | number of logins downloading under this user name , evaluated on RETR/STOR/APPE commands |
Y
|
N
|
|
%_ | number of logins uploading under this user name , evaluated on RETR/STOR/APPE commands |
Y
|
N
|
|
%| | number of logins downloading under this group name , evaluated on RETR/STOR/APPE commands |
Y
|
N
|
|
%\ | number of logins uploading under this group name , evaluated on RETR/STOR/APPE commands |
Y
|
N
|
|
system
functions ( must be placed in the beginning of a line )
|
||||
var
|
description
|
.msg
|
.vfs
|
|
%0 | output the latest 10 directories made on this server |
Y
|
N
|
|
%1 | output the top 10 uploaders on this server |
Y
|
N
|
|
%2 | output the top 10 downloaders on this server |
Y
|
N
|
|
%3 | output the current user's detail information |
Y
|
N
|
|
%4 | output the currently online users list |
Y
|
N
|
|
%5 | output the directory info of the current virtual directory , the directory info contains files , total file size , uploaders/groups information of the current virtual directory |
Y
|
N
|
|
%# |
output another *.msg file in /message dir , ex : %#site-help.msg , this will include the content of /message/site-help.msg into current *.msg file |
Y
|
N
|
|
other
variables
|
||||
var
|
description
|
.msg
|
.vfs
|
|
%% | percent character |
Y
|
N
|
Copyright © RaidenFTPD TEAM , ALL RIGHT RESERVED
REVISION 2.2 , 2002/06/12