Display
FilesProFTPD supports a number of configuration directives that specify a file whose contents should be displayed to connected clients at various times:
DisplayConnect
DisplayLogin
USER
and PASS
commands
DisplayChdir
DisplayGoAway
Class
has been reached
DisplayFileTransfer
DisplayQuit
QUIT
command
Note the subtle difference between DisplayConnect
and
DisplayLogin
. A DisplayConnect
file will be
displayed to all clients; this makes it suitable for server banners,
messages of the day, etc. A DisplayLogin
file will only
be displayed once the client has logged in.
The configured file paths can be either relative or absolute (except in the
case of DisplayConnect
, which always requires absolute paths).
In the case of a relative path, the file is assumed to be in the starting
directory a user, i.e. the <Anonymous>
directory
for anonymous logins, and the user's home directory for non-anonymous logins.
Note: If DefaultRoot
is in effect, then the file
must reside inside the chroot
ed directory. If the
configured file cannot be found or accessed, no error occurs and nothing is
logged or displayed to the client.
Display
Variables
The following table contains the variables that can be used in
Display
files. Be aware that not all of these may have a rational
value, depending on the context in which they are used (e.g.,
%u
if IdentLookups
are off).
Other contrib
modules may provide additional variables for use
as well; please consult their documentation for more information.
Variable | Meaning |
%C | Current working directory |
%E | Server admin's email address |
%F | Available space on file system, in bytes |
%f | Available space on file system, with units |
%i | The number of files uploaded (input) in this session |
%K | Total number of bytes transferred |
%k | Total number of bytes transferred, in units |
%L | Local hostname |
%M | Maximum number of connections |
%N | Current number of connections |
%o | The number of files downloaded (output) in this session |
%R | Remote hostname |
%T | Current time |
%t | The number of files transferred (uploaded and downloaded) in this session |
%U | Username originally used to login |
%u | Username reported by ident protocol |
%V | ServerName of virtual host, if any |
%x | The name of the user's Class , if any |
%y | Current number of connections from the user's Class |
%z | Maximum number of connections from the user's Class |
%{total_bytes_in} | The number of bytes uploaded (input) in this session |
%{total_bytes_out} | The number of bytes downloaded (output) in this session |
%{total_bytes_xfer} | The number of bytes transferred (uploaded and downloaded) in this session |
%{total_files_in} | The number of files uploaded (input) in this session |
%{total_files_out} | The number of files downloaded (output) in this session |
%{total_files_xfer} | The number of files transferred (uploaded and downloaded) in this session |