FTP Messages
FTP messages are now stored in files only, all settings in the config file
regarding server messages have been removed. The messages must be stored under
the msg subdirectory in the standard tree. User and group specific
messages must be stored under msg/usr and msg/grp. User specific
messages are preferred over group specific, and group specific over default.
The following messages are supported:
file name | event |
cdup | directory up |
chdir | change directory |
download | file downloaded |
goodbye | logout |
list | directory listed |
mkdir | directory created |
rmdir | directory removed |
startup | message before login |
toomany | login failed, because max number of users reached |
upload | file uploaded |
welcome | successful login |
The following variables can be used in all FTP messages.
- %a = number of anonymous users logged in
- %A = maximum number of anonymous users to log in at the same time
- %c = user's credit
- %d = number of bytes downloaded in the current session
- %D = download size of all sessions
- %h = the name of the host from where the user is logged in
- %i = the IP address from which the user is logged in
- %k = last speed of the user's upload/download (kb/s)
- %l = date and time of last login
- %L = the download limit of the user
- %n = number of users logged in (anonymous and registered)
- %N = maximum number of anonymous and registered users
- %p = number of bytes uploaded in the current session
- %P = upload size of all sessions
- %q = upload*100/download ratio of current session
- %Q = upload*100/download ratio of all sessions
- %r = download/upload ratio of current session
- %R = download/upload ratio of all sessions
- %s = depends on the message type:
chdir/list-messages: directory name
upload/download-messages: filename
startup/welcome/goodbye-messages: user name
- %S = name of logged in user
- %t = current date and time
- %u = number of registered users logged in
- %U = maximum number of registerd users to log in at the same time
- %% = percent character
- %T<n>[<w>]dn = Top ten list, name of downloader (n=rank, 1=1st, 2=2nd, 0=10th) (w=what: w=week, m=month, y=year, t=total, default is t)
- %T<n>[<w>]da = downloaded amount
- %T<n>[<w>]di = user information of downloader
- %T<n>[<w>]dm = user name and user information of downloader
- %T<n>[<w>]e<c> = the same for list of users with best ratios
- %T<n>[<w>]l<c> = the same for list of users with worst ratios
- %T<n>[<w>]u<c> = the same for list of uploaders
- %#!<program> <arguments> =
runs program with arguments, arguments can contain variables, too. This
variable is valid only when it appears at the beginning of a line.
The following Color Control Codes can be used in all FTP messages.
(Thanks to bleachboy for enabling this standard)
- !a = black
- !b = red
- !c = green
- !d = brown
- !e = blue
- !f = magenta
- !g = cyan
- !h = light gray
- !A = dark grey
- !B = bright red
- !C = bright green
- !D = yellow
- !E = bright blue
- !F = bright magenta
- !G = bright cyan
- !H = white
- !1 = background black
- !2 = background red
- !3 = background green
- !4 = background yellow
- !5 = background blue
- !6 = background magenta
- !7 = background cyan
- !8 = background white
- !0 = all attributes off (important: use it at the end of each line that uses colors )
- !X = flashing