Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Documented FTP.set_pasv().

This commit is contained in:
Fred Drake 1999-03-18 16:08:54 +00:00
parent f3963b1269
commit 596766772e
1 changed files with 15 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
Doc/lib/libftplib.tex
View File

@ -1,19 +1,17 @@
\section{\module{ftplib} --- \section{\module{ftplib} ---
FTP protocol client.} FTP protocol client}
\declaremodule{standard}{ftplib} \declaremodule{standard}{ftplib}
\modulesynopsis{FTP protocol client (requires sockets).} \modulesynopsis{FTP protocol client (requires sockets).}
\indexii{FTP}{protocol}
This module defines the class \class{FTP} and a few related items. This module defines the class \class{FTP} and a few related items.
The \class{FTP} class implements the client side of the FTP protocol. The \class{FTP} class implements the client side of the FTP
You can use this to write Python programs that perform a variety of protocol.\indexii{FTP}{protocol} You can use this to write Python
automated FTP jobs, such as mirroring other ftp servers. It is also programs that perform a variety of automated FTP jobs, such as
used by the module \module{urllib} to handle URLs that use FTP. For mirroring other ftp servers. It is also used by the module
more information on FTP (File Transfer Protocol), see Internet \refmodule{urllib} to handle URLs that use FTP. For more information
\rfc{959}. on FTP (File Transfer Protocol), see Internet \rfc{959}.
Here's a sample session using the \module{ftplib} module: Here's a sample session using the \module{ftplib} module:
@ -71,8 +69,7 @@ not begin with a digit in the range 1--5.
\end{excdesc} \end{excdesc}
\subsection{FTP Objects} \subsection{FTP Objects \label{ftp-objects}}
\label{ftp-objects}
\class{FTP} instances have the following methods: \class{FTP} instances have the following methods:
@ -104,7 +101,7 @@ information that may be relevant to the user.)
Log in as the given \var{user}. The \var{passwd} and \var{acct} Log in as the given \var{user}. The \var{passwd} and \var{acct}
parameters are optional and default to the empty string. If no parameters are optional and default to the empty string. If no
\var{user} is specified, it defaults to \code{'anonymous'}. If \var{user} is specified, it defaults to \code{'anonymous'}. If
\var{user} is \code{anonymous}, the default \var{passwd} is \var{user} is \code{'anonymous'}, the default \var{passwd} is
\samp{\var{realuser}@\var{host}} where \var{realuser} is the real user \samp{\var{realuser}@\var{host}} where \var{realuser} is the real user
name (glanced from the \envvar{LOGNAME} or \envvar{USER} environment name (glanced from the \envvar{LOGNAME} or \envvar{USER} environment
variable) and \var{host} is the hostname as returned by variable) and \var{host} is the hostname as returned by
@ -151,6 +148,11 @@ with the trailing CRLF stripped. The default \var{callback} prints
the line to \code{sys.stdout}. the line to \code{sys.stdout}.
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}{set_pasv}{boolean}
Enable ``passive'' mode if \var{boolean} is true, other disable
passive mode.
\end{methoddesc}
\begin{methoddesc}{storbinary}{command, file, blocksize} \begin{methoddesc}{storbinary}{command, file, blocksize}
Store a file in binary transfer mode. \var{command} should be an Store a file in binary transfer mode. \var{command} should be an
appropriate \samp{STOR} command, i.e.\ \code{"STOR \var{filename}"}. appropriate \samp{STOR} command, i.e.\ \code{"STOR \var{filename}"}.