<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&ktalkd;">
  <!ENTITY % addindex "IGNORE"
> 
  <!ENTITY % French "INCLUDE"
> <!-- change language only here -->   
]>

<book lang="&language;">

<bookinfo>
<title
>Manuel de &ktalkd;</title>
<authorgroup>
<author
><firstname
>David</firstname
> <surname
>Faure</surname
> <affiliation
> <address
><email
>faure@kde.org</email
></address>
</affiliation>
</author>

&traducteurEricBischoff; 
</authorgroup>

<legalnotice>
&FDLNotice;
</legalnotice>

<copyright>
<year
>2001</year>
<holder
>David Faure</holder>
</copyright>

<date
>2001-05-02</date>
<releaseinfo
>1.05.02</releaseinfo>

<abstract>
<para
>&ktalkd; 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. </para
> 

</abstract>
<keywordset>
<keyword
>KTALKD</keyword>
<keyword
>talk</keyword>
<keyword
>talkd</keyword>
<keyword
>otalk</keyword>
<keyword
>ntalk</keyword>
<keyword
>ktalkdlg</keyword>
<keyword
>kcmktalkd</keyword>
</keywordset>
</bookinfo>

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

<para
>&ktalkd; 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. </para>

<important>
<para
>Veuillez remarquer que &ktalkd; a été conçu pour fonctionner sur une station de travail avec un seul utilisateur, et ne devrait pas être utilisé sur une machine avec plusieurs utilisateurs : comme il se base sur les fichiers de configurations propres aux utilisateurs, les utilisateurs peuvent demander  à <command
>talk</command
> de lancer n'importe quelle commande, ce qui est particulièrement dangereux. N'utilisez pas &ktalkd; si vous créez des comptes utilisateur sur votre machine au profit de gens en lesquels vous n'avez pas une confiance totale. </para>
</important>

<para
>Dans ces pages, vous êtes désigné comme l' <quote
>appelé</quote
> lorsqu'une personne désire vous parler. </para>

<para
>&ktalkd; a les caractéristiques suivantes :</para>

<variablelist>
<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 courrier électronique à 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 <command
>ktalkdlg</command
>, une boîte de dialogue &kde;, pour afficher l'avis. Si &ktalk; fonctionne, 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 (&pex; via une commande <userinput
><command
>export</command
> <envar
>DISPLAY</envar
>=<replaceable
>...</replaceable
></userinput
>), 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 <emphasis
>pas</emphasis
> xterm (restriction interne), alors vous verrez également une annonce textuelle, si vous êtes en train d'utiliser le terminal de texte au moment de l'annonce. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Transmission <emphasis
>(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 si vous êtes absent. Il y a trois méthodes différentes pour faire passer l'information. Reportez-vous à la section <link linkend="usage"
>Utilisation</link
> de cette documentation. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Configuration</term>
<listitem>
<para
>Si le logiciel &ktalkd; est compilé pour &kde;, il lit sa configuration dans les fichiers de configuration &kde;, celui qui s'applique à l'ensemble du site (<filename
>$<envar
>KDEDIR</envar
>/share/config/ktalkdrc</filename
>) ou celui qui est spécifique à l'utilisateur, dans son dossier personnel. Le fichier général doit être modifié à la main par l'administrateur, mais il y a à présent une boîte de dialogue de configuration pour celui de l'utilisateur. Il s'appelle <command
>kcmktalkd</command
> et se trouve dans le &centreConfiguration; après avoir installé &ktalkd;. Sur les systèmes non-&kde;, &ktalkd; lit <filename
>/etc/talkd.conf</filename
>. </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 <command
>ktalkdlg</command
> dans votre langue. Il en va de même pour la boîte de dialogue de configuration, <command
>kcmktalkd</command
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Support de <command
>otalk</command
> et de <command
>ntalk</command
> <emphasis
>(Nouveau depuis la version 0.8.1)</emphasis
></term>
<listitem>
<para
>ktalkd supporte à présent les deux protocoles, même pour les transmissions. &ktalk; supporte lui aussi les deux protocoles. </para>
</listitem>
</varlistentry>
</variablelist>

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

<para
>David Faure <email
>faure@kde.org</email
></para>

</chapter>

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

<para
>Pour utiliser &ktalkd;, il vous faut un client <command
>talk</command
>. Le client en mode texte <command
>talk</command
> est disponible sur la majorité des systèmes &UNIX;. Essayez <userinput
><command
>talk</command
> <replaceable
>votre&lowbar;nom&lowbar;d&lowbar;utilisateur</replaceable
></userinput
> pour voir ce qui se passe quand vous recevez une requête <command
>talk</command
>. </para>

<para
>Vous pouvez également tester le répondeur automatique de la même façon : lancez une session <command
>talk</command
> talk avec vous-même, ignorez l'avertissement deux fois, et vous verrez le répondeur automatique fonctionner. </para>

<para
>Il existe un client de discussion en mode graphique pour KDE qui s'appelle <command
>ktalk</command
>. Il n'est pas encore distribué avec les paquetages &kde;, mais vous pouvez le trouver sur le serveur ftp://ftp.kde.org. Il se trouve normalement dans le dossier <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 : <guibutton
>répondre</guibutton
> ou <guibutton
>ignorer</guibutton
>. </para>

<para
>La boîte de 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="choosing-a-forwarding-method">
<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>

<variablelist>
<varlistentry>
<term
><acronym
>FWA</acronym
> - Transmission de requêtes seulement.</term>
<listitem>
<para
>Connexion directe. Non recommandé. </para>
<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 <quote
>distant</quote
>. (Le répondeur ne peut pas afficher un avis, cela serait troublant !) </para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term
><acronym
>FWR</acronym
> - transmission de toutes les requêtes, en changeant l'information quand c'est nécessaire</term>
<listitem>
<para
>Connexion directe </para>
<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 <computeroutput
>message provenant de Wintalk@my_host</computeroutput
>) </para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term
><acronym
>FWT</acronym
> - transmission de toutes les requêtes et acceptation de l'appel.</term>
<listitem>
<para
>Pas de connexion directe.</para>

<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 (&pex; 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 <acronym
>FWR</acronym
>, vous ne voyez pas le nom de sa machine dans l'avis </para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>

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

</sect1>
</chapter>

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

<qandaset>
<qandaentry>
<question>
<para
>Pourquoi est-ce que <systemitem class="username"
>root</systemitem
> ne reçoit pas les avis &kde; ? </para>
</question>

<answer>
<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 <command
>xdm</command
> (qui sont également ceux de &kdm;). </para>

<note>
<para
>La distribution S.u.S.E. de &Linux; contient ces lignes par défaut. </para>
</note>

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

<para
>Voici ce qu'il faut faire :</para>

<procedure>
<step>
<para
>éditez le fichier <filename
>Xstartup</filename
>, ou créez-le, (dans le dossier de configuration de <command
>xdm</command
>) de telle sorte qu'on y trouve : </para
> 
<screen
>#!/bin/sh
/etc/X11/xdm/GiveConsole
sessreg -a -l $DISPLAY -x /etc/X11/xdm/Xservers $USER</screen>
</step>
<step>
<para
>ainsi que le fichier <filename
>Xreset</filename
> afin qu'on y trouve : </para>
<screen
>#!/bin/sh
/etc/X11/xdm/TakeConsole
sessreg -d -l $DISPLAY $USER</screen>
</step>
<step>
<para
>Assurez-vous que <filename
>xdm-config</filename
> fait référence à ces deux fichiers : </para>
<screen
>DisplayManager._0.startup:      /etc/X11/xdm/Xstartup
DisplayManager._0.reset:        /etc/X11/xdm/Xreset </screen>
</step>
</procedure>

<para
>Cela amènera &kdm; (ou <command
>xdm</command
>) à connecter l'utilisateur dans utmp, ce qui est la bonne façon de procéder. Il ne revient pas à &konsole;, pas plus qu'à <command
>xterm</command
>, de connecter l'utilisateur, mais à <command
>xdm</command
> et à &kdm;, à mon avis. Quoi qu'il en soit, cela évite de connecter l'utilisateur comme un utilisateur de X quand on utilise <command
>startx</command
>... Y a-t-il des remarques à ce sujet ? </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Pourquoi ne reçois-je pas, alors que je suis un utilisateur normal, des avis &kde; ? </para>
</question>

<answer>
<para
>Si vous utilisez un système &Linux; (avec <filename class="directory"
>/proc</filename
> 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 <systemitem class="username"
>root</systemitem
> de lire <filename class="directory"
>/proc</filename
>. La solution est la même que dans la question précédente, dans la mesure où vous passez par &kdm; ou par <command
>xdm</command
> 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; (<filename class="directory"
>/proc</filename
>) est désactivée. La solution est la même que dans la question précédente, dans la mesure où vous passez par <acronym
>kdm</acronym
> ou <acronym
>xdm</acronym
> pour vous connecter à X. Une autre solution est de vous assurer que vous avez toujours un terminal <application
>xterm</application
> ouvert. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Comment obtenir des informations de débogage de &ktalkd; ? </para>
</question>

<answer>
<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 <filename
>inetd.conf</filename
> qui servent à lancer &ktalkd; et &kotalkd; pour en faire : </para>
 
<screen
>talk   dgram   udp     wait    root    /usr/sbin/tcpd  /opt/kde/bin/ktalkd -d
ntalk  dgram   udp     wait    root    /usr/sbin/tcpd  /opt/kde/bin/ktalkd -d</screen>

<para
>Remarquez l'option <option
>-d</option
>. </para>

<para
>Éditez ensuite <filename
>/etc/syslog.conf</filename
> afin d'ajouter la ligne suivante : </para>

<screen
>*.*         /var/log/all_messages</screen>

<para
>Pour le faire fonctionner, vous devez ensuite redémarrer <command
>inetd</command
> et <command
>syslogd</command
> :</para>

<screen
><prompt
>%</prompt
> <userinput
><command
>killall</command
> <option
>-HUP inetd</option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>killall</command
> <option
>-HUP syslogd</option
></userinput
></screen>

<para
>Enfin, lancez une session <command
>talk</command
> et allez voir le résultat dans <filename
>/var/log/all&lowbar;messages</filename
> </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 <command
>./configure</command
>. Merci.</para>

</answer>
</qandaentry>
</qandaset>

</chapter>

<chapter id="copyright-and-license">
<title
>Copyright et licences</title>

<para
>ktalkd est maintenu et amélioré par David Faure, <email
>faure@kde.org</email
> </para>

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

<para
>traduction française par &EricBischoff;</para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="how-to-obtain-ktalkd">
<title
>Comment obtenir &ktalkd;</title>

<para
>&ktalkd; est à présent une application de base du projet &kde; <ulink url="http://www.kde.org"
>http://www.kde.org</ulink
>, faisant partie du paquetage kdenetwork. </para>

<para
>Mais vous pouvez toujours télécharger la dernière version de &ktalkd; depuis le site &FTP; 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="requirements">
<title
>Configuration nécessaire</title>

<para
>Pour compiler avec succès &ktalkd;, il vous faut les dernières versions des bibliothèques &kde; ainsi que la librairie C++ &Qt;. Toutes les librairies nécessaires ainsi que ktalkd lui-même se trouvent à l'adresse <ulink url="ftp://ftp.kde.org/pub/kde/"
>ftp://ftp.kde.org/pub/kde/</ulink
>. </para>
</sect1>

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

<para
>Pour compiler et installer &ktalkd; sur votre système, saisissez les commandes suivantes dans le dossier de base de la distribution de &ktalkd; : </para>

<screen
><prompt
>%</prompt
> <userinput
><command
>./configure</command
></userinput>
<prompt
>%</prompt
> <userinput
><command
>make</command
></userinput
> 
<prompt
>%</prompt
> <userinput
><command
>make</command
> <option
>install</option
></userinput
></screen>

<para
>Comme &ktalkd; est un démon, <userinput
><command
>make</command
> <option
>install</option
></userinput
> suppose les privilèges de <systemitem class="username"
>root</systemitem
>.</para>

<para
>N'oubliez pas de mettre à jour <filename
>/etc/inetd.conf</filename
>. Par exemple, sur une système &Linux;, si &kde; se trouve dans <filename class="directory"
>/opt/kde</filename
>, changez les lignes concernant <command
>talk</command
> et <command
>ntalk</command
> en : </para>

<screen
>talk   dgram   udp     wait    root    /usr/sbin/tcpd  /opt/kde/bin/ktalkd
ntalk  dgram   udp     wait    root    /usr/sbin/tcpd  /opt/kde/bin/ktalkd</screen>

<para
>Un script est fourni pour effectuer les changements nécessaires automatiquement. Mettez à jour votre fichier <filename
>/etc/inetd.conf</filename
> en saisissant simplement</para>

<screen
><prompt
>%</prompt
> <userinput
><command
>./post-install.sh</command
></userinput
></screen>

<para
>Dans tous les cas, vous devrez <emphasis
>redémarrer inetd</emphasis
> par la suite. Sur la plupart des systèmes &Linux;, tapez : </para>

<screen
><prompt
>%</prompt
> <userinput
><command
>killall</command
> <option
>-HUP inetd</option
></userinput
></screen>

<para
>Sur les systèmes récents qui utilisent <command
>xinetd</command
>, il n'y a plus de fichier <filename
>/etc/inetd.conf</filename
>, et vous devriez éditer ou créer <filename
>/etc/xinetd.d/talk</filename
> à la place, avec les lignes suivantes : </para>

<screen
>service talk
{
        socket_type = dgram
        wait = yes
        user = root
        server = /usr/bin/ktalkd
}

service ntalk
{
        socket_type = dgram
        wait = yes
        user = root
        server = /usr/bin/ktalkd
}</screen>

<para
>puis redémarrez <command
>inetd</command
>. </para>

<para
>Veuillez m'informer de toute modification que vous auriez eu à accomplir pour réussir à compiler ou à faire fonctionner &ktalkd; sur votre plate-forme. </para>
</sect1>

</appendix>

</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=0:sw=2:tw=78:noet
-->