Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for ftpconversions (opensolaris section 4)

ftpconversions(4)			   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 directory  of
       the same base name into the format requested, subject to the ftpaccess(4) compress and tar
       capabilities.

       The conversions	and their attributes known by in.ftpd(1M) are stored in an ASCII 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.

       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 directory.
       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  exe-
       cute  the command, it must be present in their chroot'd hierarchy along with any necessary
       dynamic libraries.

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

       T_ASCII	  ASCII transfers are allowed of a file produced by the conversion.

       T_DIR	  Directories can be converted.

       T_REG	  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
       xferlog(4). The following options are supported:

       O_COMPRESS      conversion compresses

       O_TAR	       conversion archives

       O_UNCOMPRESS    conversion uncompresses

       You can specify more than one option by	using  "|"  to	separate  options.  For  example,
       O_TAR|O_COMPRESS 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 directo-
       ries, and the absence of T_ASCII prevents the resulting file  from  being  transferred  in
       ASCII mode.

	 : : :.Z:/usr/bin/compress -c %s:T_REG:O_COMPRESS:COMPRESS

       Example 2  Uncompressing and Transferring in ASCII Mode

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

	 :.Z: : :/usr/bin/compress -cd %s:T_REG|T_ASCII:O_UNCOMPRESS:UNCOMPRESS

FILES
       /etc/ftpd/ftpconversions

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWftpr			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.11				    1 May 2003				ftpconversions(4)


All times are GMT -4. The time now is 08:51 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password