<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY ktalkd "<application>ktalkd</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="fr">
<bookinfo>
<title>Le manuel de ktalkd</title>
<authorgroup>
<author>
<firstname>David</firstname>
<surname>Faure</surname>
<affiliation>
<address><email><ulink url="mailto:David.Faure@insa-lyon.fr">David.Faure@insa-lyon.fr</ulink></email></address>
</affiliation>
</author>
</authorgroup>
<date>Version 0.9.0, 14 novembre 1998</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>Ce manuel décrit ktalkd version 0.9.0</para>
<para>Le manuel de KTalkD</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>ktalkd</keyword>
<keyword>talk</keyword>
<keyword>otalk</keyword>
<keyword>ntalk</keyword>
<keyword>discussion</keyword>
<keyword>avis</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para><literal remap="tt">ktalkd</literal> est un démon de discussion amélioré - le programme qui traite les demandes de discussion
entrantes, les annonce et vous permet d'y répondre à l'aide d'un client de discussion.
GLOSSAIRE : Dans ces pages, vous êtes désigné comme l' "appelé" lorsqu'une personne désire vous parler.</para>

<para><literal remap="tt">ktalkd</literal> a les caractéristiques suivantes :</para>

<para><variablelist>
<varlistentry>
<term>Indépendance face à KDE</term>
<listitem>
<para>KDE or not KDE, that is the question. :) Plus sérieusement, cela signifie que <literal remap="tt">ktalkd</literal> peut être compilé
avec ou sans les bibliothèques KDE. Pour l'utiliser sans KDE, la phase de compilation détecte si X ou Qt ou
KDE ne sont pas installés, ou vous pouvez imposer la création d'un démon non-KDE grâce à l'option de
configuration '--without-X'.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Répondeur téléphonique</term>
<listitem>
<para>Si l'appelé n'est pas connecté ('login'), ou ne répond pas après le second avis, un répondeur automatique
est lancé, prend le message, et l'envoie sous forme de mél à l'appelé.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Son</term>
<listitem>
<para>Si c'est souhaité, un son est joué en même temps que l'avis est affiché.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Avis X</term>
<listitem>
<para>Si ktalkd est compilé alors que KDE est installé, ktalkd utilisera <emphasis remap="bf">ktalkdlg</emphasis>, un dialogue KDE,
pour afficher l'avis. Si <emphasis remap="bf">ktalk</emphasis> tourne, c'est à lui qu'on demandera de faire
l'annonce. (Nouveau depuis la version 0.8.8).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Avis multi-écrans</term>
<listitem>
<para>Si vous êtes connecté à distance (par exemple via une commande <literal remap="tt">"export DISPLAY=..."</literal>), l'avis
X sera également fait sur cet écran. Répondez sur celui que vous voulez !
Si vous êtes également connecté sur un terminal de texte, et si vous n'utilisez PAS xterm
(restriction interne), alors vous verrez également une annonce textuelle, si toutefois vous
êtes en train d'utiliser le terminal de texte au moment de l'annonce.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Transmission   <emphasis remap="it">(Nouveau depuis la version 0.8.0)</emphasis></term>
<listitem>
<para>Vous pouvez définir une transmission vers un autre usager même sur une autre machine hôte si vous êtes
absent. Il y a trois méthodes différentes pour faire passer l'information. Rapportez-vous à la section
'Usage' de cette documentation.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Configuration</term>
<listitem>
<para>Si le logiciel est compilé pour KDE, il lit sa configuration dans le fichier de configuration KDE,
celui qui s'applique à l'ensemble du site ($KDEDIR/share/config/ktalkdrc) ou celui qui est spécifique
à l'utilisateur, dans son répertoire maison. Le fichier général doit être édité à la main par l'administrateur,
mais il y a à présent un dialogue de configuration pour celui de l'utilisateur.
Il s'appelle <emphasis remap="bf">kcmktalkd</emphasis> et peut être trouvé dans le centre de contrôle KDE après avoir installé
<literal remap="tt">ktalkd</literal>. Sur les systèmes non-KDE, <literal remap="tt">ktalkd</literal> lit /etc/talkd.conf.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Internationalisation</term>
<listitem>
<para>Sous KDE, l'avis sera fait dans votre langue à condition de l'avoir réglé dans les menus
de KDE et que quelqu'un ait traduit <emphasis remap="bf">ktalkdlg</emphasis> dans votre langue.Il en va de même pour le
dialogue de configuration, <emphasis remap="bf">kcmktalkd</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Support de otalk et de ntalk   <emphasis remap="it">(Nouveau depuis la version 0.8.1)</emphasis></term>
<listitem>
<para>ktalkd supporte à présent les deux protocoles, même pour les transmissions. Il en va de même de ktalk.</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>J'espère que vous aurez du plaisir à utiliser ce démon de discussion,</para>

<para>David Faure</para>

<para><ulink url="mailto:faure@kde.org">faure@kde.org</ulink></para>
</chapter>

<chapter id="plate-formes-supportes">
<title>Plate-formes supportées</title>

<para><variablelist>
<varlistentry>
<term>RedHat Linux 5.x</term>
<listitem>
<para>Ma plate-forme de développement. Testé à fond dessus.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Autres distributions Linux, BSD</term>
<listitem>
<para>Devrait se compiler et fonctionner correctement.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Solaris</term>
<listitem>
<para>Ne fonctionnera pas avant que quelqu'un ait écrit de quoi remplacer snprintf. Bien entendu,
on devrait pouvoir installer une autre libc pour résoudre ce problème...</para>
</listitem>
</varlistentry>
<varlistentry>
<term>AIX</term>
<listitem>
<para>J'ai entendu parler de problèmes liés aux fonctions localtime, ctime et consorts.</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>Je serais heureux de recevoir des avis concernant la compilation et l'exécution de
<literal remap="tt">ktalkd</literal> sur ces systèmes et sur les autres systèmes.</para>
</chapter>

<chapter id="installation">
<title>Installation</title>

<sect1 id="comment-obtenir-ktalkd">
<title>Comment obtenir ktalkd</title>

<para><literal remap="tt">ktalkd</literal> est à présent une application centrale du projet KDE 
<ulink url="http://www.kde.org">http://www.kde.org</ulink>, faisant partier du package <emphasis remap="bf">kdenetwork</emphasis>.</para>

<para>Mais vous pouvez toujours télécharger <literal remap="tt">ktalkd</literal> depuis le site principal du projet KDE,
<ulink url="ftp://ftp.kde.org/pub/kde">ftp://ftp.kde.org/pub/kde</ulink> et depuis ses sites miroirs. Il se trouve
d'habitude dans <ulink url="ftp://ftp.kde.org/pub/kde/stable/latest/apps/network">ftp://ftp.kde.org/pub/kde/stable/latest/apps/network</ulink>.</para>
</sect1>

<sect1 id="configuration-ncessaire">
<title>Configuration nécessaire</title>

<para>Il vous faut les dernières versions des bibliothèques KDE ainsi que la librairie C++ Qt pour compiler
<literal remap="tt">ktalkd</literal> avec succès. Toutes les librairies nécessaires ainsi que ktalkd lui-même peuvent être
trouvés sur <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>.</para>
</sect1>

<sect1 id="compilation-et-installation">
<title>Compilation et installation</title>

<para>Pour compiler et installer <literal remap="tt">ktalkd</literal> sur votre système, tapez les commandes suivantes
dans le répertoire de base de la distribution de <literal remap="tt">ktalkd</literal> :
<screen>% ./configure
% make
% make install
</screen>
</para>

<para>Comme <literal remap="tt">ktalkd</literal> est un démon, <literal remap="tt">make install</literal> aura besoin des privilèges de l'utilisateur 'root'.</para>

<para>N'oubliez pas de mettre à jour /etc/inetd.conf.
Par exemple, sur un système linux, si kde se trouve dans /opt/kde, changez les lignes concernant 
talk et ntalk en :
<screen>talk   dgram   udp     wait    root    /usr/sbin/tcpd  /opt/kde/bin/kotalkd
ntalk  dgram   udp     wait    root    /usr/sbin/tcpd  /opt/kde/bin/ktalkd
</screen>

Un script permettant d'effectuer les modifications nécessaires automatiquement est fourni.
Mettez à jour votre fichier inetd.conf en exécutant simplement : 
<screen>% ./post-install.sh
</screen>

Quelle que soit la méthode choisie, vous devrez <emphasis remap="bf">redémarrer inetd</emphasis> ensuite.
Sur la plupart des systèmes Linux, faites :
<screen>% killall -HUP inetd
</screen>
</para>

<para>Veuillez m'informer de toute modification que vous auriez eue à accomplir pour réussir à compiler
<literal remap="tt">ktalkd</literal> sur votre plate-forme.</para>
</sect1>
</chapter>

<chapter id="utilisation">
<title>Utilisation</title>

<para>Pour utiliser ktalkd, il vous faut un logiciel client de discussion.
Le logiciel en mode texte <literal remap="tt">talk</literal> est disponible sur la majorité des systèmes Unix.
Essayez <literal remap="tt">talk votre&lowbar;nom&lowbar;d&lowbar;utilisateur</literal> pour voir ce qui se passe lorsque vous recevez une requête
de discussion.
Vous pouvez également tester la fonction "répondeur automatique" de la même façon : vous démarrez une
discussion avec vous-même, vous ignorez l'avis à deux reprises, et vous verrez le répondeur automatique
se mettre en route.</para>

<para>Il existe un client de discussion en mode graphique pour KDE qui s'appelle <literal remap="tt">ktalk</literal>.
Il n'est pas encore distribué avec les packages KDE, mais vous pouvez le trouver sur le serveur
ftp://ftp.kde.org. Il se trouve normalement dans le répertoire
<ulink url="ftp://ftp.kde.org/pub/kde/stable/latest/apps/network">ftp://ftp.kde.org/pub/kde/stable/latest/apps/network</ulink></para>

<para>La boîte de dialogue de l'avis de discussion est triviale: répondre ou ignorer.</para>

<para>Le dialogue de configuration devrait être plutôt trivial, mis à part le réglage de la transmission vers 
un autre utilisateur (ou vers un autre site).</para>

<sect1 id="choix-dune-mthode-de-transmission">
<title>Choix d'une méthode de transmission</title>

<para>Aucune d'entre elles n'est parfaite, elles ont toutes leurs avantages (+) et leurs inconvénients (-).</para>

<para><emphasis remap="bf">FWA</emphasis> : Transmission de l'avis seulement. Connexion directe. Déconseillé.
<itemizedlist>
<listitem>
<para>       (+) Vous savez qui est l'appelant, mais</para>
</listitem>
<listitem>
<para>       (-) L'appelant devra répondre à un avis provenant de vous. Ennuyeux.</para>
</listitem>
<listitem>
<para>       (-) Ne pas utiliser si vous avez un répondeur sur votre emplacement distant.
(Le répondeur ne peut pas afficher un avis, cela serait troublant!)</para>
</listitem>
</itemizedlist>
</para>

<para><emphasis remap="bf">FWR</emphasis> : Transmission de toutes les requêtes, en changeant l'information quand c'est nécessaire.
Connexion directe.
<itemizedlist>
<listitem>
<para>       (+) L'appelant ne saura pas que vous êtes ailleurs, mais</para>
</listitem>
<listitem>
<para>       (-) Vous ne savez pas réellement qui est l'appelant - vous ne connaissez que son nom d'utilisateur,
(vous pourriez voir "message provenant de Wintalk@my&lowbar;host")</para>
</listitem>
</itemizedlist>
</para>

<para><emphasis remap="bf">FWT</emphasis> : Transmission de toutes les requêtes et acceptation de l'appel. Pas de connexion directe.
<itemizedlist>
<listitem>
<para>       (+) Comme ci-dessus, mais fonctionne également si vous et l'appelant n'êtes pas
en contact direct l'un avec l'autre (par exemple si vous êtes séparés par un pare-feu).</para>
</listitem>
<listitem>
<para>       (+) Vous savez qui vous parle réellement quand vous acceptez l'appel</para>
</listitem>
<listitem>
<para>       (-) Mais comme dans le cas précédent, vous ne voyez pas le nom de sa machine dans l'avis</para>
</listitem>
</itemizedlist>
</para>

<para>Pour résumer, utilisez <emphasis remap="bf">FWT</emphasis> si vous voulez l'utiliser derrière un pare-feu (et si ktalkd
a accès aux deux réseaux), et <emphasis remap="bf">FWR</emphasis> dans le cas contraire.</para>
</sect1>
</chapter>

<chapter id="questions-et-rponses">
<title>Questions et réponses</title>

<sect1 id="pourquoi-root-ne-peut-il-pas-recevoir-les-av">
<title>Pourquoi root ne peut-il pas recevoir les avis KDE ?</title>

<para>Car ce serait une faille dans la sécurité, avec le système de détection d'utilisateur actuel. Vous
pouvez passer outre cette limitation en ajoutant deux lignes dans les fichiers de configuration de xdm
(qui sont également ceux de kdm).
Note : la distribution S.u.S.E de Linux contient ces lignes par défaut.</para>

<para>Ces fichiers de configuration se trouvent dans un répertoire du type /etc/X11/xdm,
ou /usr/X11R6/lib/X11/xdm sur d'autres systèmes. Ce qui suit suppose qu'ils sont dans /etc/X11/xdm,
vous devrez donc adapter les commandes dans le cas d'un autre répertoire.</para>

<para>Voici ce qu'il faut faire :
Editez le fichier Xstartup, ou créez-le, (dans le répertoire de configuration de xdm) de telle sorte
qu'on y trouve :
<screen>#!/bin/sh
/etc/X11/xdm/GiveConsole
sessreg -a -l $DISPLAY -x /etc/X11/xdm/Xservers $USER
</screen>
</para>

<para>ainsi que le fichier Xreset afin qu'on y trouve :
<screen>#!/bin/sh
/etc/X11/xdm/TakeConsole
sessreg -d -l $DISPLAY $USER
</screen>
</para>

<para>Assurez-vous que <emphasis remap="bf">xdm-config</emphasis> fasse référence à ces deux fichiers :
<screen>DisplayManager._0.startup:      /etc/X11/xdm/Xstartup
DisplayManager._0.reset:        /etc/X11/xdm/Xreset 
</screen>
</para>

<para>Cela amènera kdm (ou xdm) à connecter l'utilisateur dans utmp, ce qui est correct.
Il ne revient pas à kvt, pas plus qu'à xterm, de connecter l'utilisateur, mais à xdm et à kdm, à mon avis.
Quoi qu'il en soit, cela évite de connecter l'utilisateur comme un utilisateur de X quand on utilise 
startx... Y a-t'il des remarques à ce sujet ?</para>
</sect1>

<sect1 id="pourquoi-ne-reois-je-pas-alors-que-je-suis-u">
<title>Pourquoi ne reçois-je pas, alors que je suis un utilisateur normal, des avis KDE?</title>

<para>Si vous utilisez un système Linux (avec /proc actif), c'est qu'il y a une bogue. Veuillez
m'en envoyer une description afin que je puisse la corriger.</para>

<para>Si vous utilisez Linux version 2.0.35, c'est une bogue connue du noyau qui empêche root de lire /proc.
La solution est la même que dans la section 5.1, dans la mesure où vous passez par kdm ou par xdm
pour vous connecter à X.
Une autre solution est de mettre votre système à jour!</para>

<para>Si vous n'êtes pas dans ce cas, c'est normal : ktalkd ne peut pas trouver l'utilisateur, car KDE
ne le connecte pas dans utmp et la détection basée sur linux (/proc) est désactivé.
La solution est la même que dans la section 5.1, dans la mesure où vous passez par kdm ou par xdm
pour vous connecter à X.
Une autre solution est de vous assurer que vous avez toujours un terminal xterm ouvert.</para>
</sect1>

<sect1 id="comment-obtenir-des-informations-de-dbogage-">
<title>Comment obtenir des informations de débogage de ktalkd ?</title>

<para>Comme il s'agit d'un démon, il n'y a pas d'affichage de débogage sur la sortie standard.
Pour obtenir des informations de débogage (par exemple avant de soumettre un rapport d'erreur !),
modifiez les lignes de inetd.conf qui servent à lancer ktalkd et kotalkd pour en faire :
<screen>talk   dgram   udp     wait    root    /usr/sbin/tcpd  /opt/kde/bin/kotalkd -d
ntalk  dgram   udp     wait    root    /usr/sbin/tcpd  /opt/kde/bin/ktalkd -d
</screen>

(remarquez l'option <emphasis remap="bf">-d</emphasis>)</para>

<para>Editez ensuite /etc/syslog.conf afin d'ajouter la ligne suivante :
<screen>*.*         /var/log/all_messages
</screen>
</para>

<para>Pour que ça marche, vous devez redémarrer inetd et syslogd :
<screen>% killall -HUP inetd
% killall -HUP syslogd
</screen>

Pour finir, lancez une session de discussion et allez voir les résultats dans /var/log/all&lowbar;messages</para>

<para>Quand vous soumettez un rapport d'erreur, n'oubliez pas d'inclure non seulement les informations de
débogage, mais également le numéro de version de ktalkd et la sortie de l'instruction "./configure".
Merci.</para>
</sect1>
</chapter>

<chapter id="copyright">
<title>Copyright</title>

<para>ktalkd est maintenu et amélioré par David Faure, David.Faure@insa-lyon.fr</para>

<para>Le programme originel a été écrit par Robert Cimrman, cimrman3@students.zcu.cz</para>

<para><screen>ktalkd est protégé par Copyright 1997,1998 David Faure David.Faure@insa-lyon.fr

Ce programme est un logiciel libre; vous pouvez le redistribuer et/ou le modifier
conformément aux termes de la Licence Générale Publique GNU (General Public License) telle
qu'elle est publiée par la Free Software Foundation; soit la version 2 de la Licence, soit
(à votre choix) toute version ultérieure.

Ce programme est distribué en espérant qu'il s'avère utile,
mais SANS AUCUNE GARANTIE; sans même la garantie implicite de POSSIBILITE DE COMMERCIALISATION
ou d'ADEQUATION A UN BUT DONNE. Reportez-vous à la Licence Générale Publique GNU
pour plus de détails.

Vous devriez avoir reçu une copie de la Licence Générale Publique GNU en même temps que
ce programme; si tel n'est pas le cas, écrivez à :
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

</screen>
</para>

<para>Traduction française: 
<ulink url="mailto:e.bischoff@noos.fr">Eric Bischoff</ulink></para>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
