-
The project implements simple FTP server and client. The server is implemented by epoll and use passive mode to transform data. The client is just a simple command-line TCP-based interactive program.
-
On client, it supports common shell commands, such as ls, cd. Besides those commands, it also supports basic client commands such as login, get, put and bye.
-
The server is implemented by epoll and administrator can configure usernames, passwords, capabilities and working directories.
-
Only supports Python 2.
Run server before client, or you will get error message like 'Connection refused'. Have fun!
Before logging in, you can use all commands this program support except 'get' and 'put'. Because you are denied to put or get file to and from server as a guest. Users' permissions are set in 'server_config.txt'.
| Permission | explanation |
|---|---|
| r | client can get file from server |
| w | client can put file to server |
| rw | client can get and put file from/to server |
By typing 'll' or 'ls', you can list all files and directories in current directory. Try it!
Change directory. All the same as common shell. For example:
guest@/home/aaron: cd .. # go back to previous directory
guest@/home: cd # go to your working directory specified by 'server_config.txt'
guest@/tmp: guest@/tmp: get a.txt
Error 2: Permission denied # because you are guestYou can download file from server by typing 'get filename'. Make sure the file you want is in your current directory and whether your have the 'get' permission.
aaron@/home/aaron: get a.txt # you have logged in as aaron
Done!If the file you get conflicts with your file. '_get' will be appended to the end of the basename of the file. For example, you want to download 'a.txt' from server, but it already exists in your current directory, this file will be named to 'a_get.txt'.
aaron@/home/aaron: put a.txt # you have logged in as aaron
Done!You can upload file to server by typing 'put filename'. Make sure the file you want to upload already exists and you have the permission to 'put'.
Just like 'get', if filename conflicts, the file you upload will be named to 'a_put.txt'.
Say good bye to server.
The configure file is 'server_config.txt'. Everything is easy to understand and one thing worth explaining is the 'State'.
If the state is 1, the user is able to login. Otherwise the user is not permitted to login. This column is especially useful when you don't want someone to login temporarily.
State | Username | Password | Capabilities | Working Directory
---------------------------------------------------------------
1 | aaron | 12345 | w | /home/
1 | liqin | qqqqq | rw | /home/ftp
1 | Rachel | 1996 | r | /home/
0 | sky | abcd | rw | /tmp