1xferlog(4)                       File Formats                       xferlog(4)
2
3
4

NAME

6       xferlog - FTP Server transfer log file
7

SYNOPSIS

9       /var/log/xferlog
10
11

DESCRIPTION

13       The  xferlog  file  contains  transfer logging information from the FTP
14       Server, in.ftpd(1M). You can use the logfile capability to  change  the
15       location of the log file. See ftpaccess(4).
16
17
18       By  default, each server entry is composed of a single line of the fol‐
19       lowing form. All fields are separated by spaces.
20
21         current-time  transfer-time    remote-host  bytes-transferred  \
22                 filename
23         transfer-type  special-action-flag  direction access-mode  username
24         service-name  authentication-method  authenticated-user-id \
25                  completion-status
26
27
28
29       The xferlog format capability can be used to customize the transfer log
30       file  format  used. In addition to those in the default format, it also
31       supports chroot-filename, file-size,  and  restart-offset  fields.  See
32       ftpaccess(4).
33
34
35       The fields are defined as follows:
36
37       current-time             The  current local time in the form DDD MMM dd
38                                hh:mm:ss YYYY, where:
39
40                                DDD     Is the day of the week
41
42
43                                MMM     Is the month
44
45
46                                dd      Is the day of the month
47
48
49                                hh      Is the hour
50
51
52                                mm      Is the minutes
53
54
55                                ss      Is the seconds
56
57
58                                YYYY    Is the year
59
60
61
62       transfer-time            The total time in seconds for the transfer
63
64
65       remote-host              The remote host name
66
67
68       bytes-transferred        The number of bytes transferred
69
70
71       filename                 The absolute pathname of the transferred file
72
73
74       transfer-type            A single  character  indicating  the  type  of
75                                transfer:
76
77                                a    Indicates an ascii transfer
78
79
80                                b    Indicates a binary transfer
81
82
83
84       special-action-flag      One  or more single character flags that indi‐
85                                cate any special action  taken.  The  special-
86                                action-flag  can  have one of more of the fol‐
87                                lowing values:
88
89                                C               File was compressed
90
91
92                                U               File was uncompressed
93
94
95                                T               File was archived,  for  exam‐
96                                                ple, by using tar(1)
97
98
99                                _ (underbar)    No action was taken.
100
101
102
103       direction                The  direction  of the transfer. direction can
104                                have one of the following values:
105
106                                o    Outgoing
107
108
109                                i    Incoming
110
111
112
113       access-mode              The method by which the  user  is  logged  in.
114                                access-mode can have one of the following val‐
115                                ues:
116
117                                a    For an anonymous user.
118
119
120                                g    For a  passworded  guest  user.  See  the
121                                     description  of the guestgroup capability
122                                     in ftpaccess(4).
123
124
125                                r    For a real, locally authenticated user
126
127
128
129       username                 The local username, or if  anonymous,  the  ID
130                                string given
131
132
133       service-name             The name of the service invoked, usually ftp
134
135
136       authentication-method    The method of authentication used. authentica‐
137                                tion-method can have one of the following val‐
138                                ues:
139
140                                0    None
141
142
143                                1    RFC 931 authentication
144
145
146
147       authenticated-user-id    The  user  ID  returned  by the authentication
148                                method. A * is used if an  authenticated  user
149                                ID is not available.
150
151
152       completion-status        A  single  character  indicating the status of
153                                the transfer. completion-status can  have  one
154                                of the following values:
155
156                                c    Indicates complete transfer
157
158
159                                i    Indicates incomplete transfer
160
161
162
163       chroot-filename          The  pathname of the transferred file relative
164                                to the chroot point. This will differ from the
165                                filename field for anonymous and guest users.
166
167
168       file-size                The size, in bytes, of the file on the server.
169
170
171       restart-offset           The offset, in bytes, at which the file trans‐
172                                fer was restarted (0 when  no  restart  offset
173                                was specified).
174
175

FILES

177       /var/log/xferlog
178

ATTRIBUTES

180       See attributes(5) for descriptions of the following attributes:
181
182
183
184
185       ┌─────────────────────────────┬─────────────────────────────┐
186       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
187       ├─────────────────────────────┼─────────────────────────────┤
188       │Availability                 │SUNWftpr                     │
189       ├─────────────────────────────┼─────────────────────────────┤
190       │Interface Stability          │External                     │
191       └─────────────────────────────┴─────────────────────────────┘
192

SEE ALSO

194       tar(1), in.ftpd(1M), ftpaccess(4), ftpconversions(4), attributes(5)
195
196
197       StJohns,  Mike.  RFC 931, Authentication Server. Network Working Group.
198       January 1985.
199
200
201
202SunOS 5.11                        25 Apr 2003                       xferlog(4)
Impressum