CSS 432
Final Project: Network Application
Instructor: Joe McCarthy
Due date: See the syllabus
The program should be invoked with ftp [hostname]. If invoked with the optional argument, it will establish a control connection to the remote hostname server using the default port 21 and be able to transfer files over a data connection in passive mode. If no argument is given, the client program should not establish any connection until it receives an open hostname port command (See below).
| ftp client interface | RFC959 command(s) | Description |
| open hostname port | N/A | Establish a TCP connection to hostname on the specified port |
| name: user_name | USER user_name | Send a user_name identifier to the server |
| password: user_password | PASS user_password SYST |
Send the user_password to the server |
| cd subdir | CWD subdir | Change the server's current working directory to subdir |
| ls | PASV LIST |
Ask the server to send a list of its current directory contents (through the data connection) |
| get filename | PASV RETR filename |
Get a copy of filename from the current remote directory on the server (through the data connection) |
| put filename | PASV STOR filename |
Store a copy of filename into the current remote directory on the server (through the data connection) |
| close | QUIT | Close the connection but do not quit ftp |
| quit | QUIT (if not closed) | Close the connection and quit ftp |
Note the server responds to a PASV command by sending back a 6-tuple of numbers on the control TCP connection (via port 21), in which
Run your client program on a Linux Lab (uw1-320-lab.uwb.edu) machine and connect to the ftp.tripod.com server. Your client program must be able to execute the following ftp operations and commands:
The password for css432 can be found in the file ~css432/ftp/passwd on the uw1-320-lab network.
In the sample session below, prompts from the ftp client are shown in bold; user input is shown in bold blue.
The session starts with the user launching a local executable version of ftp - referenced by explicitly including the local directory, ./ftp - rather than the default ftp program on the Linux Lab network - which would be invoked if the local directory were not referenced.
[mfukuda@uw1-320-20]$ ./ftp ftp.tripod.com 220 Welcome to Tripod FTP. Name (ftp.tripod.com:mfukuda): css432 331 Username set to css432. Now enter your password. Password: ********* 230- ============================================================ 230- IMPORTANT NOTICE 230- ============================================================ 230- 230- Powerful building tools. Traffic-generating, money-making 230- programs. It's all waiting for you at the new Tripod. 230- 230- httpd://www.tripod.com/ 230- 230- ============================================================ 230- 230- Tripod offers a cgi-bin to all members! For more 230- information, visit our CGI tutorial. 230- 230- httpd://www.tripod.lycos.com/build/module_library/tutorial/ 230- 230- ============================================================ 230- 230- Got a great idea for a website? Then don't 230- wait, get your own web address today! 230- 230- httpd://tripod.domains.lycos.com/ 230- 230- ============================================================ 230- 230- Visit Tripod's Script Library, with free, easy-to-use, 230- customizable CGI and JavaScripts available to all members. 230- 230- httpd://build.tripod.com/tools/script_library 230- 230- ============================================================ 230- 230- We heard you loud and clear! You love your site, but 230- you don't like the ads. Remove those pesky popups 230- forever with Tripod Plus! 230- 230- httpd://www.tripod.lycos.com/host/plus.html 230- 230- ============================================================ 230 User 'css432' logged on. 215 UNIX Type: L8 ftp> ls 227 Entering Passive Mode (209,202,240,80,206,212) 150 Opening ASCII mode data connection for LIST. drwxr-xr-x 1 css432 Tripod 0 Sep 15 21:22 cgi-bin -rw-r--r-- 1 css432 Tripod 26169 Sep 16 18:28 ttcp.c -rw-r--r-- 1 css432 Tripod 8236 Sep 15 21:22 index.htm drwxr-xr-x 1 css432 Tripod 0 Sep 15 21:22 _private drwxr-xr-x 1 css432 Tripod 0 Sep 16 18:32 project 226 Transfer complete. ftp> get ttcp.c 227 Entering Passive Mode (209,202,240,80,206,221) 200 Type set to 'I' (IMAGE aka BINARY). 150 Opening BINARY mode data connection for 'ttcp.c'. 226 Transfer complete. (26169 bytes sent.) ftp> cd project 250 Directory set to '/project'. ftp> ls 227 Entering Passive Mode (209,202,240,80,206,229) 150 Opening ASCII mode data connection for LIST. 226 Transfer complete. ftp> put (local-file) data (remote-file) MFukuda.txt 227 Entering Passive Mode (209,202,240,80,206,248) 200 Type set to 'I' (IMAGE aka BINARY). 150 Opening BINARY mode data connection for 'MFukuda.txt'. 226 Transfer complete. (26169 bytes sent.) ftp> ls 227 Entering Passive Mode (209,202,240,80,206,252) 150 Opening ASCII mode data connection for LIST. -rw-r--r-- 1 css432 Tripod 26169 Sep 16 18:33 MFukuda.txt 226 Transfer complete. ftp> close 221 Goodbye... ftp> quit [mfukuda@uw1-320-20]$
NOTE: please do not overwrite any files in the css432@ftp.tripod.com home directory.
Put any of your files in the project subdirectory in order to test your ftp client's put command. Your ftp client program may indicate a password on your computer display, although the above example hides the css432 account password with *********.
Your final project will be graded with the following criteria:
| Criteria | Weight |
| Documentation of your implementations including explanations and illustrations in details | 29pts(29%) |
| (1) client's interface in terms of OPEN, PASS/SYST, and QUIT | 5pts |
| (2) client's get function in terms of PASV, RETR, and local file options (O_CREAT | O_WRONLY and S_IRUSR | S_IWUSR |S_IRGRP | S_IROTH) | 5pts |
| (3) client's cd function (i.e., CWD in RFC 959) | 4pts |
| (4) client's ls function in terms of PASV, LIST, and file output to stdout | 5pts |
| (5) client's put function in terms of PASV, STOR, and local file option (O_RDONLY) | 5pts |
| (6) limitations (how much you complied with RFC 959) | 5pts |
| Source code that reflects good modularization, coding style, and an appropriate amount of comments. | 29pts(29%) |
| (1) the correctness of client's interface (USER/PASS/SYST/QUIT) including authentication | 5pts |
| (2) the correctness of client's get (PASV/RETR) function | 5pts |
| (3) the correctness of client's cd (CWD) function | 4pt |
| (4) the correctness of client's ls (PASV/LIST) function | 5pts |
| (5) the correctness of client's put (PASV/STOR) function | 5pts |
| (6) comments/coding style | 5pts |
| Execution output showing the output for each command, similar to what is shown above. You can use the script program suggested for the first programming assignment to create the output file, project.output. | 30pts(30%) |
| (1) client's connection establishment | 6pts |
| (2) client's get function | 6pts |
| (3) client's cd function | 6pts |
| (4) client's ls function (to stdout) | 6pts |
| (5) client's put function | 6pts |
| Performance evaluation that compares the difference in elapsed time between your ./ftp client program and the standard distribution ftp on the Linux Lab network, when executing a get command. | 4pts(4%) |
| Discussion of possible functional extensions of your own program and/or the Linux Lab ftp. You should also describe the difference in performance between your own program and the Linux Lab ftp. | 8pts(8%) |
| Total | 100pts(100%) |
| Extra credits will be given if you have implemented addtional ftp commands or functionality. Be sure to carefully document any of these additional commands or functions. | 5pts(5%) |