ct_ftp(3)

NAME
ct_ftp - FTP client module (based on the ftp application).

DESCRIPTION

DATA TYPES

connection() :: handle() | ct:target_name().

    Reference to opened FTP connection associated to either a handle or target_name.
handle() :: ct:handle().

    Handle for a specific FTP connection, see module ct.

FUNCTIONS

cd(Connection, Dir) -> ok | {error, Reason} when Connection :: connection(), Dir :: file:filename(), Reason :: term().

    Deprecated: ct_ftp:cd/2 is deprecated; Legacy protocol support will be dropped in OTP-30

    Changes directory on remote host.
close(Connection) -> ok | {error, Reason} when Connection :: connection(), Reason :: term().

    Deprecated: ct_ftp:close/1 is deprecated; Legacy protocol support will be dropped in OTP-30

    Closes the FTP connection.
delete(Connection, File) -> ok | {error, Reason} when Connection :: connection(), File :: file:filename(), Reason :: term().

    Deprecated: ct_ftp:delete/2 is deprecated; Legacy protocol support will be dropped in OTP-30

    Deletes a file on remote host.
get(KeyOrName, RemoteFile, LocalFile) -> ok | {error, Reason} when KeyOrName :: ct:key_or_name(), RemoteFile :: file:filename(), LocalFile :: file:filename(), Reason :: term().

    Deprecated: ct_ftp:get/3 is deprecated; Legacy protocol support will be dropped in OTP-30

    Opens an FTP connection and fetches a file from the remote host.

    RemoteFile and LocalFile must be absolute paths.

    The configuration file must be as for ct_ftp:put/3.

    See also ct:require/2.
ls(Connection, Dir) -> {ok, Listing} | {error, Reason} when Connection :: connection(), Dir :: file:filename(), Listing :: string(), Reason :: term().

    Deprecated: ct_ftp:ls/2 is deprecated; Legacy protocol support will be dropped in OTP-30

    Lists directory Dir.
open(KeyOrName) -> {ok, Handle} | {error, Reason} when KeyOrName :: ct:key_or_name(), Handle :: handle(), Reason :: term().

    Deprecated: ct_ftp:open/1 is deprecated; Legacy protocol support will be dropped in OTP-30

    Opens an FTP connection to the specified node.

    You can open a connection for a particular Name and use the same name as reference for all following subsequent operations. If you want the connection to be associated with Handle instead (if you, for example, need to open multiple connections to a host), use Key, the configuration variable name, to specify the target. A connection without an associated target name can only be closed with the handle value.

    For information on how to create a new Name, see ct:require/2.
put(KeyOrName, LocalFile, RemoteFile) -> ok | {error, Reason} when KeyOrName :: ct:key_or_name(), LocalFile :: file:filename(), RemoteFile :: file:filename(), Reason :: term().

    Deprecated: ct_ftp:put/3 is deprecated; Legacy protocol support will be dropped in OTP-30

    Opens an FTP connection and sends a file to the remote host.

    LocalFile and RemoteFile must be absolute paths.

    If the target host is a "special" node, the FTP address must be specified in the configuration file as follows:

        {node,[{ftp,IpAddr}]}.

    If the target host is something else, for example, a UNIX host, the configuration file must also include the username and password (both strings):

        {unix,[{ftp,IpAddr},
               {username,Username},
               {password,Password}]}.

    See also ct:require/2.
recv(Connection, RemoteFile) -> ok | {error, Reason} when Connection :: connection(), RemoteFile :: file:filename(), Reason :: term().

    Deprecated: ct_ftp:recv/2 is deprecated; Legacy protocol support will be dropped in OTP-30

    Fetches a file over FTP.

    The file gets the same name on the local host.

    See also ct_ftp:recv/3.
recv(Connection, RemoteFile, LocalFile) -> ok | {error, Reason} when Connection :: connection(), RemoteFile :: file:filename(), LocalFile :: file:filename(), Reason :: term().

    Deprecated: ct_ftp:recv/3 is deprecated; Legacy protocol support will be dropped in OTP-30

    Fetches a file over FTP.

    The file is named LocalFile on the local host.
send(Connection, LocalFile) -> ok | {error, Reason} when Connection :: connection(), LocalFile :: file:filename(), Reason :: term().

    Deprecated: ct_ftp:send/2 is deprecated; Legacy protocol support will be dropped in OTP-30

    Sends a file over FTP.

    The file gets the same name on the remote host.

    See also ct_ftp:send/3.
send(Connection, LocalFile, RemoteFile) -> ok | {error, Reason} when Connection :: connection(), LocalFile :: file:filename(), RemoteFile :: file:filename(), Reason :: term().

    Deprecated: ct_ftp:send/3 is deprecated; Legacy protocol support will be dropped in OTP-30

    Sends a file over FTP.

    The file is named RemoteFile on the remote host.
type(Connection, Type) -> ok | {error, Reason} when Connection :: connection(), Type :: ascii | binary, Reason :: term().

    Deprecated: ct_ftp:type/2 is deprecated; Legacy protocol support will be dropped in OTP-30

    Changes the file transfer type.