Simple FTP

About

A simple server/client program for transferring raw data files over TCP, with some extensions. This does not follow the FTP protocols, but rather implements a simplified version of FTP.

Dependencies

• A version of gcc with C99 and POSIX 2008 compliance
• GNU make

Compilation

To compile the executables, run make in the project root. The executables are placed in the build directory. The following environment variables are used by the Makefile:

• DEBUG: If defined, debugging symbols are included in the executables.
• PORT (optional): The port to have the server listen on. Defaults to 49999.

Running

After compiling, run mftpserve to start the server. To connect to the server, run mktp SERVER, where SERVER is the address of the server, either in dotted-decimal form or as a conventional host address. The following commands are available to the client:

Command	Argument	Description
cd	PATH	Change the client's working directory to PATH
rcd	PATH	Change the server's working directory to PATH
ls	(None)	List the files in the client's working directory
rls	(None)	List the files in the server's working directory
get	PATH	Store the server file at PATH in the client's working directory
show	PATH	Display the contents of the server file at PATH to the client's stdout
put	PATH	Store the client file at PATH in the server's working directory
exit	(None)	Exit the client

Server/Client Protocol

The messages sent from the client to the server are in the following format:

<CMD><ARG>\n

<CMD> is a single character that indicates which command to execute. <ARG> is the argument to the given command, and may be omitted in certain commands. The list of available commands is as follows:

Command	Argument	Requires Data Connection	Description
D	(None)	No	Establish a data connection with the server
C	PATH	No	Change the server's working directory to PATH
L	(None)	Yes	Send a list of files in the server's working directory to the client over the data connection
G	PATH	Yes	Send the server file at PATH to the client over the data connection
P	PATH	Yes	Send the client file at PATH to the server over the data connection
Q	(None)	No	Close the connection with the client