File Formats                                    ftpconversions(4)



NAME
     ftpconversions - FTP Server conversions database

SYNOPSIS
     /etc/ftpd/ftpconversions


DESCRIPTION
     When the FTP  Server,  in.ftpd(1M),  receives  the  retrieve
     (RETR)  command,  if  the  specified file does not exist, it
     looks for a conversion to change an existing file or  direc-
     tory  of  the same base name into the format requested, sub-
     ject to the ftpaccess(4) compress and tar capabilities.


     The conversions  and their attributes known  by  in.ftpd(1M)
     are  stored  in  an ASCI file of the following format. Each
     line in the file provides a description for a single conver-
     sion. The fields in this file are separated by colons (:).

       %s:%s:%s:%s:%s:%s:%s:%s
        1  2  3  4  5  6  7  8




     The fields are described as follows:

     1    Strip prefix.


     2    Strip postfix.


     3    Addon prefix.


     4    Addon postfix.


     5    External command.


     6    Types.


     7    Options.


     8    Description.





SunOS 5.11           Last change: 1 May 2003                    1






File Formats                                    ftpconversions(4)



     The Strip prefix and Addon prefix fields are  not  currently
     supported.


     The Strip postfix and addon postfix fields are extensions to
     be  added  to  or  removed  from  the  requested filename in
     attempting to produce the name of an existing file or direc-
     tory.  When  the  attempt  succeeds, the FTP Server runs the
     external command associated with the conversion.  The  magic
     cookie %s in the argument is passed to the command, replaced
     with the name of the existing file or directory.


     External command is the absolute pathname of  a  command  to
     run  followed  by  the  appropriate options to carry out the
     conversion. The standard output of the command is sent  back
     in  response  to  the RETR (retrieve) command. For anonymous
     and guest users to be able to execute the command,  it  must
     be present in their chroot'd hierarchy along with any neces-
     sary dynamic libraries.


     Types specifies the conversion type.  The  following  values
     are recognized:

     TASCI    ASCI transfers are allowed of a file produced by
                the conversion.


     TDIR      Directories can be converted.


     TREG      Regular files can be converted.



     Options are checked against the  ftpaccess(4)  compress  and
     tar capabilities and are recorded in the special-action-flag
     field that is written to the FTP Server logfile.  See  xfer-
     log(4). The following options are supported:

     OCOMPRES      conversion compresses


     OTAR           conversion archives


     OUNCOMPRES    conversion uncompresses







SunOS 5.11           Last change: 1 May 2003                    2






File Formats                                    ftpconversions(4)



     You can specify  more  than  one  option  by  using  ""  to
     separate  options.  For  example, OTAROCOMPRES specifies
     that the conversion archives and compresses.


      Description is a one word  description  of  the  conversion
     that is used in error messages returned to the FTP client.


     Lines that begin with a # sign are treated as comment  lines
     and are ignored.

EXAMPLES
     Example 1 Compressing a Regular File for Transfer


     The following example specifies a conversion which generates
     filename.Z  by  compressing  an  existing file filename. The
     conversion can only be applied to regular files, not  direc-
     tories,  and  the  absence of TASCI prevents the resulting
     file from being transferred in ASCI mode.


       : : :.Z:/usr/bin/compress -c %s:TREG:OCOMPRES:COMPRES


     Example 2  Uncompressing and Transferring in ASCI Mode


     The following example  specifies  a  conversion  that  takes
     filename.Z  and  uncompresses  it to produce filename, which
     then can be transferred in ASCI mode.


       :.Z: : :/usr/bin/compress -cd %s:TREGTASCI:OUNCOMPRES:UNCOMPRES


FILES
     /etc/ftpd/ftpconversions


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











SunOS 5.11           Last change: 1 May 2003                    3






File Formats                                    ftpconversions(4)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWftpr                    
    


SEE ALSO
     ldd(1), in.ftpd(1M), ftpaccess(4), xferlog(4), attributes(5)














































SunOS 5.11           Last change: 1 May 2003                    4