Perl in a Nutshell

Name

FTP

Synopsis

$inet ->FTP($ftpobject, server, username, pwd, [port, pasv, context])

$inet ->FTP($ftpobject, $hashref)

Description

Opens an FTP connection to server, logging in with the given username and password. The new connection object is saved to ftpobject. The parameters and their values are:

server

The server to connect to.

username

The username used to log in to the server. Default is anonymous.

pwd

The password used to log in to the server. Default is none.

port

The port of the FTP service on the server. Default is 21.

pasv

If it is a value other than 0, use passive transfer mode. Otherwise, it is taken from the parent Internet connection object; you can set this value with the Pasv method.

context

A number to identify this operation if it is asynchronous. See SetStatusCallback and GetStatusCallback for more info on asynchronous operations.

If you pass a hash reference, the following values are taken from the hash:

%hash=(
  "server"   => "server",
  "username" => "username",
  "password" => "password",
  "port"     => port,
  "pasv"     => pasv,
  "context"  => context,
);

The FTP method returns undef if the connection failed, a number otherwise. You can then call any of the FTP functions as methods of the newly-created FTP object.