README Guinness-Server



Guinness-server est un ensemble de deux logiciels (guinnessd et guinness) qui
permettent de communiquer entre clients (guinness) du serveur (guinnessd).



INSTALLATION

   PAR COMPILATION :

   L'installation se déroule comme suit...

   1. Configuration de la compilation :
        Éditer le Makefile afin d'y spécifier le répertoire où l'on souhaite
        faire l'installation (par défaut /usr/local avec ses sous répertoires
        bin et man/man1).
        ATTENTION : Utilisateurs de Solaris et de FreeBSD, il est important de
        regarder plus bas dans le Makefile au niveau des bibliothèques pour
        linker les programmes. En effet ces systèmes nécessitent de petites
        modifications. QUI NE FONCTIONNENT PLUS MAINTENANT :( Si quelqu'un
        voulait bien déboguer :)
        Les utilisateurs d'OpenBSD pourront jeter un coup d'oeil au Makefile
        BSD : il faudra certainement redefinir le chemin où trouver getopt.h !

   2. Copie du fichier de page man :
        Il y a deux versions du manuel : une version normale et une version
        7 bits dans laquelle tous les accents ont été supprimés. La version
        normale est celle par défaut, dans ce cas il n'y a rien à faire. Si
        vous devez utiliser la version sans accents faites :
        cp -f guinness-server-7bits.1 guinness-server.1

   3. Compilation :
        $ make
        Il est possible de spécifier un répertoire d'installation en faisant :
        $ make PREFIX=/chemin/souhaité
        les fichiers s'installeront donc dans /chemin/souhaité/bin,
        /chemin/souhaité/man/man1 et /chemin/souhaité/share/guinness-server/...
        eg. :
        $ make PREFIX=/opt/guinness-server
        $ make PREFIX=/usr
        etc...

        Cela influera sur le répertoire de stockage des boissons (par défaut
        PREFIX/share/guinness-server/boissons/)


   4. Installation :
        - Si vous avez accès au mot de passe root
        $ su -c "make install"
        - Sinon
        $ make install

   5. Configuration (optionnelle) du client :
        La configuration du client se fait en créant le fichier ~/.guinnessrc
        et en y mettant celles des trois lignes suivantes qui vous interessent
        le plus :
        user=nom-d-utilisateur
        server=machine
        port=port-du-serveur
        pref=bière-préférée
        cmdchr=caractère-de-commande
        logout=message-de-déconnexion

   6. Lancement du serveur :
        Aller dans le réperdoire d'installation du binaire et lancez :
        guinnessd
        Il est possible (et même conseillé) de lire tout de même l'aide
        concernant les options. En voici la description :
           -h         : aide sur les paramètres
           -v         : affiche la version
           -b         : détache le serveur du terminal
           -a adresse : spécifie l'adresse du serveur
           -p port    : spécifie le numéro du port
           -s passwd  : spécifie le mot de passe d'aministration
           -d chemin  : indique le chemin où se trouvent les ascii-arts
           -l fichier : fichier de logging

        Un ascii-art de flûte de champagne ainsi qu'un verre de pastis sont
        fournis dans le répertoire boissons/ libre à vous de le mettre là où
        vous voulez (voire dans /usr/local/share/guinness-server/boissons, le
        répertoire par défaut où les installe le Makefile).


    LE PAQUETAGE DES BINAIRES :

    Les fichiers du paquetage des binaires s'installent dans /usr/local
    (bin, man/man1 et share/guinness-server).


INFORMATIONS

        Pour toute information, lisez en priorité la page man. Sinon, pour
        tout le reste, vous pouvez m'écrire à l'adresse suivante :
        tnemeth@free.fr

        Le site web où trouver ce programme est :
        http://tnemeth.free.fr/projets/guinness-server.html