manual/wu-ftpd/original/man5/xferlog.5

   1 .\"
   2 .\" Copyright (c) 1999,2000 WU-FTPD Development Group.
   3 .\" All rights reserved.
   4 .\"
   5 .\" Portions Copyright (c) 1980, 1985, 1988, 1989, 1990, 1991, 1993, 1994
   6 .\" The Regents of the University of California.  Portions Copyright (c)
   7 .\" 1993, 1994 Washington University in Saint Louis.  Portions Copyright
   8 .\" (c) 1996, 1998 Berkeley Software Design, Inc.  Portions Copyright (c)
   9 .\" 1998 Sendmail, Inc.  Portions Copyright (c) 1983, 1995, 1996, 1997 Eric
  10 .\" P. Allman.  Portions Copyright (c) 1989 Massachusetts Institute of
  11 .\" Technology.  Portions Copyright (c) 1997 Stan Barber.  Portions
  12 .\" Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997 Free Software
  13 .\" Foundation, Inc.  Portions Copyright (c) 1997 Kent Landfield.
  14 .\"
  15 .\" Use and distribution of this software and its source code are governed
  16 .\" by the terms and conditions of the WU-FTPD Software License ("LICENSE").
  17 .\"
  18 .\"     $Id: xferlog.5,v 1.5 2000/07/01 17:49:09 wuftpd Exp $
  19 .\"
  20 .TH XFERLOG 5
  21 .SH NAME
  22 xferlog \- FTP server logfile
  23 .SH DESCRIPTION
  24 .LP
  25 The
  26 .B xferlog
  27 file contains logging information from the FTP server daemon,
  28 .BR ftpd (8).
  29 This file usually is found in /usr/adm, but can be located anywhere by using a
  30 option to
  31 .BR ftpd (8).
  32 Each server entry is composed of a single line of the following form,
  33 with all fields being separated by spaces.
  34 .IP
  35 .I
  36 current-time\ \  transfer-time\ \  remote-host\ \  file-size\ \  filename\ \  transfer-type\ \  special-action-flag\ \  direction\ \  access-mode\ \  username\ \  service-name\ \  authentication-method\ \  authenticated-user-id\ \  completion-status
  37 .LP
  38 .TP 20
  39 .I current-time
  40 is the current local time in the form "DDD MMM dd hh:mm:ss YYYY". Where DDD
  41 is the day of the week, MMM is the month, dd is the day of the month,
  42 hh is the hour, mm is the minutes, ss is the seconds, and YYYY is the year.
  43 .TP
  44 .I transfer-time
  45 is the total time in seconds for the transfer.
  46 .TP
  47 .I remote-host
  48 is the remote host name.
  49 .TP
  50 .I file-size
  51 is the size of the transferred file in bytes.
  52 .TP
  53 .I filename
  54 is the name of the transferred file.
  55 .TP
  56 .I transfer-type
  57 is a single character indicating the type of transfer. Can be one of:
  58 .RS
  59 .RS
  60 .PD 0
  61 .TP 10
  62 .B a
  63 for an ascii transfer
  64 .TP
  65 .B b
  66 for a binary transfer
  67 .PD
  68 .RE
  69 .RE
  70 .TP
  71 .I special-action-flag
  72 is one or more single character flags indicating any special action taken.
  73 Can be one or more of:
  74 .RS
  75 .RS
  76 .PD 0
  77 .TP 10
  78 .B C
  79 file was compressed
  80 .TP
  81 .B U
  82 file was uncompressed
  83 .TP
  84 .B T
  85 file was tar'ed
  86 .TP
  87 .B _
  88 no action was taken
  89 .PD
  90 .RE
  91 .RE
  92 .TP
  93 .I direction
  94 is the direction of the transfer. Can be one of:
  95 .RS
  96 .RS
  97 .PD 0
  98 .TP 10
  99 .B o
 100 outgoing
 101 .TP
 102 .B i
 103 incoming
 104 .PD
 105 .RE
 106 .RE
 107 .TP
 108 .I access-mode
 109 is the method by which the user is logged in. Can be one of:
 110 .RS
 111 .RS
 112 .PD 0
 113 .TP 10
 114 .B a
 115 (anonymous) is for an anonymous guest user.
 116 .TP
 117 .B g
 118 (guest) is for an passworded guest user (see the
 119 .BR guestgroup
 120 command in
 121 .BR ftpaccess(5)
 122 ).
 123 .TP
 124 .B r
 125 (real) is for a local authenticated user.
 126 .PD
 127 .RE
 128 .RE
 129 .TP
 130 .I username
 131 is the local username, or if guest, the ID string given.
 132 .TP
 133 .I service-name
 134 is the name of the service being invoked, usually FTP.
 135 .TP
 136 .I authentication-method
 137 is the method of authentication used. Can be one of:
 138 .RS
 139 .RS
 140 .PD 0
 141 .TP 10
 142 .B 0
 143 none
 144 .TP
 145 .B 1
 146 RFC931 Authentication
 147 .PD
 148 .RE
 149 .RE
 150 .TP
 151 .I authenticated-user-id
 152 is the user id returned by the authentication method.
 153 A * is used if an authenticated user id is not available.
 154 .TP
 155 .I completion-status
 156 is a single character indicating the status of the transfer.  Can be one of:
 157 .RS
 158 .RS
 159 .PD 0
 160 .TP 10
 161 .B c
 162 complete transfer
 163 .TP
 164 .B i
 165 incomplete transfer
 166 .PD
 167 .RE
 168 .RE
 169 .SH FILES
 170 .PD 0
 171 .TP 20
 172 .B /usr/adm/xferlog
 173 .SH "SEE ALSO"
 174 .BR ftpd(8),
 175 .BR ftpaccess(5)