systemChdir(3FTPD)

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

NAME

systemChdir- Change the current directory for a given connection

SYNOPSIS

#include <arpa/ftpd/systemFilesys.h>

int systemChdir(FtpConn *conn, char *name);

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

For the given connection, this function changes the current directory to that specified by name.

If the server is servicing only one connection, the directory change can be implemented by changing the global current directory of the server.

If the server is servicing several connections simultaneously, the directory change can be associated to the given connection in two ways:

• As a string pointed to by conn->dir. Whatever is put into this string will be reported to the user as the current directory.

• As application-dependent data in the application-dependent part of the connection structure.

If the server does not support directories, the routine will not work and an error will be reported.

RETURN VALUES

Returns 0 if the current directory was changed successfully, -1 otherwise.

NOTES

All application side functions that accept a pathname parameter are assumed to interpret it in the context of the connection's current directory, according to application semantics. This is not emphasized in the other manual pages; all pathname arguments are simply referred to as "the file name", or "the directory name".

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 | RETURN VALUES | NOTES | ATTRIBUTES