unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

xferlog(4)                       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 capability to  change  the
       location of the log file. See ftpaccess(4).

       By  default, each server entry is composed of a single line of the fol-
       lowing 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



                               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 indi-
                               cate any special  action  taken.  The  special-
                               action-flag can have one of more of the follow-
                               ing values:


                               C        File was compressed




                               U        File was uncompressed



                               T        File was  archived,  for  example,  by
                                        using tar(1)



                               _ (underbaNro)action was taken.



       direction               The  direction  of  the transfer. direction can
                               have one of the following values:


                               o        Outgoing




                               i        Incoming



       access-mode             The method by which  the  user  is  logged  in.
                               access-mode  can have one of the following val-
                               ues:


                               a        For an anonymous user.




                               g        For a passworded guest user.  See  the
                                        description of the guestgroup capabil-
                                        ity in ftpaccess(4).



                               r        For a real, locally authenticated 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. authentica-
                               tion-method can have one of the following  val-
                               ues:


                               0        None




                               1        RFC 931 authentication



       authenticated-user-id   The  user  ID  returned  by  the authentication
                               method. A * is used if an authenticated user ID
                               is not available.



       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 trans-
                               fer was restarted (0 when no restart offset was
                               specified).



FILES
       /var/log/xferlog

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


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE  VALUE   AvailabilitySUNWftpr
       Interface StabilityExternal


SEE ALSO
       tar(1), in.ftpd(1M), ftpaccess(4), ftpconversions(4), attributes(5)

       StJohns,  Mike.  RFC 931, Authentication Server. Network Working Group.
       January 1985.



SunOS 5.10                        25 Apr 2003                       xferlog(4)