Read Me

                                 
                                 FTP-SSL
                                 
                                verze 0.1
                                 
                        http://ftp-ssl.sourceforge.net
    
Autoři:
        Martin Dušek    dusekm1@fel.cvut.cz
        Martin Fúsek    fusekm1@fel.cvut.cz
        Josef Vlček     vlcekj2@fel.cvut.cz

Projekt je semestrální práce z předmětu Programové rozhraní operačních systémů
(X36API) na ČVUT-FEL LS-2005.
        
--------------------------------------------------------------------------------

Vlastnosti FTP serveru:
-----------------------
+ SSL
+ OS Windows a Linux
+ webová administrace
+ implementace ACL na adresáře
+ podpora pro virtuální adresáře a cesty

Licence:
--------
Program je šířen podle licence GNU/GPL verze 2, která se nachází v souboru 
"COPYING".

Požadavky:
----------
+ knihovna Pthread
  * Windows
    - http://sourceware.org/pthreads-win32/
    - všechny potřebné soubory jsou součástí distribuce serveru, knihovnu není 
      nutné stahovat
  * Linux 
    - POSIXová vlákna jsou součástí systému
  
+ knihovna OpenSSL
  * Windows 
    - http://www.slproweb.com/products/Win32OpenSSL.html 
    - všechny soubory potřebné pro překlad jsou součástí distribuce serveru
    - pro běh jsou vyžadovány knihovny ssleay32.dll a libeay32.dll, které bývají 
      často v systému nainstalovány
    - použitá verze: je 0.9.8a
  * Linux
    - http://www.openssl.org
    - knihovnu lze přeložit ze zdrojových kódů
    - nebo použít příslušný balíček openssl-devel a openssl pro Vaši distribuci  

Instalace:
----------
Přeložení aplikace na OS Windows a Linux je popsáno v souboru "INSTALL".
Nastavení serveru se provádí pomocí webového rozhraní nebo editací souboru
ftp.ini. Popis a příklad ini souboru je v ftp_ini.txt.

Spuštění:
---------
"ftp.exe [ip:port] [ftp.ini]"
* ip:port je explicitně zadaná adresa serveru. Port je číslo na kterém server
  bude naslouchat (standardně 21). IP adresu posílá server klientům jako odpověď 
  na příkaz PASV, tj. žádost o pasivní spojení. Pokud ip není zadána použije se 
  autodetekce adresy. Adresu je vhodné zadat v případě  umístění serveru za NAT.
* ftp.ini je umístění souboru s konfigurací serveru (cesta a jméno).

příklad: "ftp.exe 192.168.0.1:21"
Spustí server na portu 21 s explicitně nastavenou IP adresou na 192.168.0.1

Pro ukončení serveru je nutné zadat "q" + enter do okna (konzole) serveru.

Administrace:
-------------
Administrace serveru se provádí pomocí webového rozhraní, které musíte spustit 
na vašem http serveru (soubory se nachází v adresáři "web"). Pro aplikaci 
úprav je nutné server restartovat (vypnout a znovu zapnout).