ftpput()

The ftpput() call transfers a file to an FTP server.

Syntax

#include <ftpapi.h>

int ftpput(host, userid, passwd, acct, local, remote,
       transfertype)
char *host;
char *userid;
char *passwd;
char *acct;
char *local;
char *remote;
int transfertype;

Parameters

host

Host running the FTP server.

To specify the port number (other than the well-know port) used by the FTP server, code the host name, followed by a blank, then the port number. For example, specify ftpput ("server1 1234",...)

ID used for logon.

Password of the user ID.

Account (when needed); can be NULL.

Local file name.

Remote file name.

Specifies a binary or ASCII transfer. T_ASCII is for ASCII, T_BINARY is for binary.

Return Values

The value 0 indicates success; the value -1 indicates an error. The value of ftperrno indicates the specific error. See Return Values for a description of the return codes.

Examples

int rc;rc=ftpput("conypc","jason","ehgr1",NULL,"abc.doc","new.doc",T_ASCII);

The system copies the ASCII file abc.doc on the local current working directory to the current working directory of the host conypc as file new.doc. If the file new.doc already exists, the contents of the file abc.doc overwrite the file new.doc.