File Formats xferlog(4)
NAME
xferlog - FTP Server transfer log file
SYNOPSIS
/var/log/xferlog
DESCRIPTION
The xferlog file contains transfer logging information from
the FTP Server, in.ftpd(1M). You can use the logfile capa-
bility to change the location of the log file. See ftpac-
cess(4).
By default, each server entry is composed of a single line
of the following form. All fields are separated by spaces.
current-time transfer-time remote-host bytes-transferred \
filename
transfer-type special-action-flag direction access-mode username
service-name authentication-method authenticated-user-id \
completion-status
The xferlog format capability can be used to customize the
transfer log file format used. In addition to those in the
default format, it also supports chroot-filename, file-size,
and restart-offset fields. See ftpaccess(4).
The fields are defined as follows:
current-time The current local time in the form
D M dd hh:mm:ss Y, where:
D Is the day of the week
M Is the month
dd Is the day of the month
hh Is the hour
mm Is the minutes
SunOS 5.11 Last change: 25 Apr 2003 1
File Formats xferlog(4)
ss Is the seconds
Y Is the year
transfer-time The total time in seconds for the
transfer
remote-host The remote host name
bytes-transferred The number of bytes transferred
filename The absolute pathname of the
transferred file
transfer-type A single character indicating the
type of transfer:
a Indicates an ascii transfer
b Indicates a binary transfer
special-action-flag One or more single character flags
that indicate any special action
taken. The special-action-flag can
have one of more of the following
values:
C File was compressed
U File was
uncompressed
T File was archived,
for example, by
using tar(1)
(underbar) No action was
taken.
SunOS 5.11 Last change: 25 Apr 2003 2
File Formats xferlog(4)
direction The direction of the transfer.
direction can have one of the fol-
lowing values:
o Outgoing
i Incoming
access-mode The method by which the user is
logged in. access-mode can have one
of the following values:
a For an anonymous user.
g For a passworded guest user.
See the description of the
guestgroup capability in
ftpaccess(4).
r For a real, locally authenti-
cated user
username The local username, or if
anonymous, the ID string given
service-name The name of the service invoked,
usually ftp
authentication-method The method of authentication used.
authentication-method can have one
of the following values:
0 None
1 RFC 931 authentication
authenticated-user-id The user ID returned by the authen-
tication method. A * is used if an
authenticated user ID is not avail-
able.
SunOS 5.11 Last change: 25 Apr 2003 3
File Formats xferlog(4)
completion-status A single character indicating the
status of the transfer.
completion-status can have one of
the following values:
c Indicates complete transfer
i Indicates incomplete transfer
chroot-filename The pathname of the transferred
file relative to the chroot point.
This will differ from the filename
field for anonymous and guest
users.
file-size The size, in bytes, of the file on
the server.
restart-offset The offset, in bytes, at which the
file transfer was restarted (0 when
no restart offset was specified).
FILES
/var/log/xferlog
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWftpr
Interface Stability External
SEE ALSO
tar(1), in.ftpd(1M), ftpaccess(4), ftpconversions(4), attri-
butes(5)
SunOS 5.11 Last change: 25 Apr 2003 4
File Formats xferlog(4)
StJohns, Mike. RFC 931, Authentication Server. Network Work-
ing Group. January 1985.
SunOS 5.11 Last change: 25 Apr 2003 5
|