ftpdStartSrv(3FTPD)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | OPTIONS | RETURN VALUES | ATTRIBUTES

NAME

ftpdStartSrv- Initialize the FTP service

SYNOPSIS

$(OS_DIR)/lib/libftpd.a
#include <arpa/ftpd/ftpd.h>

int ftpdStartSrv(int portNb, int argc, char *argv[], char **envp);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

DESCRIPTION

This function:

• Interprets the command-line arguments.

• Creates a socket.

• Binds the socket to portNb.

• Listens to the socket using listen(2POSIX).

The FTPD server can be made to recognize the same command line as a BSD FTPD server, as follows:

• If the application and BSD FTP server accept the same arguments, set argc, argv and envp to the values of the application's main routine parameters.

• If the application and BSD FTP server do not accept the same arguments, build a count and vector for the arguments that must be passed to the FTPD library.

During normal operation, no arguments are required. If argc is set to 0, argv and envp are ignored, ftpdStartSrv behaves as though argv[0] points to the string "ftpd" and argc is 1. The arguments are defined as follows:

OPTIONS

-d

Debugging information is logged to the application-defined log mechanism.

-l

Each FTP session is logged to the application-defined log mechanism.

-t timeout

The inactivity timeout period is set to timeout seconds. The maximum is two hours, the default is 15 minutes.

RETURN VALUES

The file descriptor of the created socket, or -1 if unsuccessful.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | OPTIONS | RETURN VALUES | ATTRIBUTES