-*------------------------------------------------------------------------+-

       SAMBA - Visualisation des ressources: Application Qtsmbstatus

       http://qtsmbstatus.free.fr/
       Daniel ROCHER - ADELLA <daniel.rocher@adella.org>

-*------------------------------------------------------------------------+-

Ce programme est distribu selon les termes de la General Public License version 2 


QtSmbstatus permet de visualiser en temps rel, les ressources utilises sur un serveur samba. Il s'agit d'une GUI (interface utilisateur) pour smbstatus.

Cette application a un fonctionnement client/serveur. Les connexions sont scurises via une couche SSL et une authentification est requise pour se connecter au serveur.

1/ Compilation  partir des sources
2/ Options en ligne de commande
3/ Dmarrage et arrt du serveur
4/ Fonctionnement du client sous X11 (Unix/Linux)
5/ Fonctionnement du client sous Windows
6/ Configuration du client

-------------------------------------------------------------
1/ Compilation  partir des sources:
-------------------------------------------------------------
         Pour installer le serveur:
         **************************
                  Vrifier les dpendances: pam-devel, ssl-devel et qt3-devel>=3.1
                  cd server
                  qmake
                  make
                  puis en tant tant que root:
                  make install


         Pour installer le client:
         *************************
                  vrifier les dpendances: ssl-devel et qt3-devel>=3.1
                  cd client
                  qmake
                  make
                  puis en tant tant que root:
                  make install

-------------------------------------------------------------
2/ Options en ligne de commande:
-------------------------------------------------------------
         Des options peuvent tre passes au serveur ainsi qu'au client, pour les connatres:

                  qtsmbstatusd --help (pour le serveur)
                  qtsmbstatus --help (pour le client)


-------------------------------------------------------------
3/ Dmarrage et arrt du serveur:
-------------------------------------------------------------
         Dmarrage du serveur:
                  /etc/init.d/qtsmbstatusd start
              ou 
                  service qtsmbstatusd start
         
                  Port par dfaut: 4443

         Arrt du serveur:
                  /etc/init.d/qtsmbstatusd stop
              ou
                  service qtsmbstatusd stop

         Les fichiers de configuration du serveur se trouvent sur:
                  /etc/qtsmbstatusd/

         contenu:
                  -rw-r----- 1 root root 1751 oct 5 22:22 privkey.pem
                  -rw-r----- 1 root root 583 oct 5 22:22 qtsmbstatusd.conf
                  -rw-r----- 1 root root  5 oct 5 22:22 qtsmbstatusd.users
                  -rw-r----- 1 root root 1619 oct 5 22:22 server.pem

         privkey.pem : cl priv (attention aux droits: 640 ! )
                  pour crer la votre: openssl genrsa -des3 -out privkey.pem 2048

         server.pem : certificat autosign avec la cl privkey.pem
                  pour crer le votre:
                  openssl req -new -x509 -key privkey.pem -out server.pem -days 10000

         Les options sont enregistres dans: qtsmbstatusd.conf
                port :                   Port TCP cout par le serveur 
                private_key :            Cl priv
                certificat :             Certificat ssl
                ssl_password :           mot de passe pour le certificat
                permit_disconnect_user : autorise un client  dconnecter un utilisateur
                                         Vous pouvez autoriser un client  dconnecter un utilisateur.
                                         Utilisez son Username ou 'all' pour autoriser tous les clients.
                permit_send_msg :        Autorise un client  envoyer un message
                                         Vous pouvez autoriser un utilisateur  envoyer un message.
                                         Utilisez son Username ou 'all' pour autoriser tous les clients.



         Les utilisateurs autoriss  se connecter sont dans: qtsmbstatusd.users
         (root par dfaut)

-------------------------------------------------------------
4/ Fonctionnement du client sous X11 (Unix/Linux) :
-------------------------------------------------------------
         Executez sous X11: qtsmbstatus
         Rentrez l'adresse IP du serveur, connectez et authentifiez-vous
 
         Clic droit sur un utilisateur pour lui envoyer un message ou le dconnecter
         (smbclient est ncessaire pour les popupwindows)

-------------------------------------------------------------
5/ Fonctionnement du client sous Windows :
-------------------------------------------------------------
         Installez qtsmbstatus-client.X.X.X.exe
         Executez qtsmbstatus.exe
 
         Rentrez l'adresse IP du serveur, connectez et authentifiez-vous
 
         Clic droit sur un utilisateur pour lui envoyer un message ou le dconnecter
         (smbclient est ncessaire pour les popupwindows)

------------------------------------------------------------- 
6/ Configuration du client :
------------------------------------------------------------- 
         Le fichier de configuration du client se trouve dans le rpertoire personnel : .qtsmbstatus.conf
                port :                Port de destination
                interval :            Intervalle, en secondes, entre chaques requtes envoyes  smbstatus
                host_address :        adresse du serveur par dfaut
                username :            Username par dfaut
                autoconnect :         Autoconnexion lors du dmarrage de qtsmbstatus client

