Manual Pages for UNIX Operating System command usage for man xferlog

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
                              DDD MMM dd hh:mm:ss YYYY, where:

                              DDD     Is the day of the week


                              MMM     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


                              YYYY    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

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | service/network/ftp         |
    |_____________________________|_____________________________|
    | Interface Stability         | Volatile                    |
    |_____________________________|_____________________________|


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