t.p.f.FTP(object, basic.LineReceiver, policies.TimeoutMixin) : class documentation

Called when a connection is made.

This may be considered the initializer of the protocol, because it is called when the connection is completed. For clients, this is called once the connection to the server has been established; for servers, this is called after an accept() call stops blocking and a socket has been received. If you need to send any greeting or initial message, do it here.

Called when the connection is shut down.

Clear any circular references here, and any external references to this Protocol. The connection has been closed.

Called when the connection times out.

Override to define behavior other than dropping the connection.

Override this for when each line is received.

Parameters

line

The line which was received with the delimiter removed. (type: bytes)

Return a port for passive access, using self.passivePortRange attribute.

First part of login. Get the username the peer wants to authenticate as.

Second part of login. Get the password the peer wants to authenticate with.

Request for a passive connection

from the rfc:

   This command requests the server-DTP to "listen" on a data port
   (which is not its default data port) and to wait for a connection
   rather than initiate one upon receipt of a transfer command.  The
   response to this command includes the host and port address this
   server is listening on.

Encode name to be sent over the wire.

This encodes unicode objects as UTF-8 and leaves bytes as-is.

As described by RFC 3659 section 2.2:

   Various FTP commands take pathnames as arguments, or return
   pathnames in responses. When the MLST command is supported, as
   indicated in the response to the FEAT command, pathnames are to be
   transferred in one of the following two formats.

       pathname = utf-8-name / raw
       utf-8-name = <a UTF-8 encoded Unicode string>
       raw = <any string that is not a valid UTF-8 encoding>

   Which format is used is at the option of the user-PI or server-PI
   sending the pathname.

Parameters	name	Name to be encoded. (type: bytes or unicode)
Returns	Wire format of name. (type: bytes)

This command causes a list to be sent from the server to the passive DTP. If the pathname specifies a directory or other group of files, the server should transfer a list of files in the specified directory. If the pathname specifies a file then the server should send current information on the file. A null argument implies the user's current working or default directory.

This command causes a directory listing to be sent from the server to the client. The pathname should specify a directory or other system-specific file group descriptor. An empty path implies the current working directory. If the path is non-existent, send nothing. If the path is to a file, send only the file name.

Parameters	path	The path for which a directory listing should be returned. (type: str)
Returns	a Deferred which will be fired when the listing request is finished. (type: Deferred)

This command causes the content of a file to be sent over the data transfer channel. If the path is to a folder, an error will be raised.

Parameters	path	The path to the file which should be transferred over the data transfer channel. (type: str)
Returns	a Deferred which will be fired when the transfer is done. (type: Deferred)

STORE (STOR)

This command causes the server-DTP to accept the data transferred via the data connection and to store the data as a file at the server site. If the file specified in the pathname exists at the server site, then its contents shall be replaced by the data being transferred. A new file is created at the server site if the file specified in the pathname does not already exist.

File SIZE

The FTP command, SIZE OF FILE (SIZE), is used to obtain the transfer size of a file from the server-FTP process. This is the exact number of octets (8 bit bytes) that would be transmitted over the data connection should that file be transmitted. This value will change depending on the current STRUcture, MODE, and TYPE of the data connection or of a data connection that would be created were one created now. Thus, the result of the SIZE command is dependent on the currently established STRU, MODE, and TYPE parameters.

The SIZE command returns how many octets would be transferred if the file were to be transferred using the current transfer structure, mode, and type. This command is normally used in conjunction with the RESTART (REST) command when STORing a file to a remote server in STREAM mode, to determine the restart point. The server-PI might need to read the partially transferred file, do any appropriate conversion, and count the number of octets that would be generated when sending the file in order to correctly respond to this command. Estimates of the file transfer size MUST NOT be returned; only precise information is acceptable.

http://tools.ietf.org/html/rfc3659

File Modification Time (MDTM)

The FTP command, MODIFICATION TIME (MDTM), can be used to determine when a file in the server NVFS was last modified. This command has existed in many FTP servers for many years, as an adjunct to the REST command for STREAM mode, thus is widely available. However, where supported, the "modify" fact that can be provided in the result from the new MLST command is recommended as a superior alternative.

http://tools.ietf.org/html/rfc3659

REPRESENTATION TYPE (TYPE)

The argument specifies the representation type as described in the Section on Data Representation and Storage. Several types take a second parameter. The first parameter is denoted by a single Telnet character, as is the second Format parameter for ASCII and EBCDIC; the second parameter for local byte is a decimal integer to indicate Bytesize. The parameters are separated by a <SP> (Space, ASCII code 32).

Advertise the features supported by the server.

http://tools.ietf.org/html/rfc2389

Handle OPTS command.

http://tools.ietf.org/html/draft-ietf-ftpext-utf-8-option-00

Call when DTP connection exits