ftpcd()

The ftpcd() call changes the current working directory on a host.

Syntax

#include <ftpapi.h>

int ftpcd(host, userid, passwd, acct, dir)
char *host;
char *userid;
char *passwd;
char *acct,
char *dir;

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 ftpcd ("server1 1234",...)

ID used for logon.

Password of the user ID.

Account (when needed); can be NULL.

New working directory.

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=ftpcd("conypc","jason","ehgr1",NULL,"mydir");

The current working directory is changed to mydir on the host conypc using the user ID jason and the password ehgr1.