ftpls()

The ftpls() call gets directory information in short format from a remote host and writes it to a local file.

Syntax

#include <ftpapi.h>

int ftpls(host, userid, passwd, acct, local, pattern)
char *host;
char *userid;
char *passwd;
char *acct;
char *local;
char *pattern;

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

ID used for logon.

Password of the user ID.

Account (when needed); can be NULL.

Local file into which the information is placed.

The file name or pattern of the files to be listed on the foreign host. Patterns are any combination of ASCII characters. The following two characters have special meaning:
• Shows that any character or group of characters can occupy that position in the pattern.

• Shows that any single character can occupy that position in the pattern.

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=ftpls("conypc","jason","ehgr1",NULL,"conypc.dir","*.c");

ftpls() gets a directory of *.c files in short format and stores the names in the local file conypc.dir.