.\" Copyright (c) 1991-98 Lectra-Systemes
.\" $Id: xteld.man,v 1.10 2001/02/11 00:11:35 pierre Exp $
.TH XTELD 8 "Lectra-Systemes" "10/98"
.UC 5
.SH NOM
xteld \- dmon de l'mulateur Minitel XTEL
.SH SYNOPSIS
xteld [-H] [-v]
.SH DESCRIPTION
.I xteld
est lanc par le super-dmon \fIinetd\fP en cas d'utilisation de l'mulateur 
minitel \fIxtel\fP . Si XTEL n'utilise pas le rseau (option NO_NETWORK  la 
compilation), le dmon \fIxteld\fP doit tre lanc lors de l'initialisation du 
systme.
.SH OPTIONS
.TP
.B "\-H"
 HyperTerminal: permet l'utilisation du logiciel HyperTerminal 3.0/4.0 (Private
Edition) comment client  la place de "xtel"

.B "\-v"
 Affiche la version et quitte

.SH UTILISATION
.LP
\fIxteld\fP utilise le fichier \fB"/usr/X11R6/lib/X11/xtel/xtel.services"\fP
(sous Xfree86) qui contient la liste des services disponibles sous la forme :
.sp
.I "[Nom du device,]"
.I "Nom de l'entre du menu"
,
.I "Numero de tlphone du service[:nom_service]"
[,
.I "login1[:login2...]"
]
.sp
 raison d'une ligne par service. Le premier champ (nom du device) dfinit un 
nom symbolique (ou \fIdevice\fP) pour les connexions  un standard donn
(V.23, V32bis, TVR). Chaque
device est associ  une configuration particulire de la ligne physique (vitesse,
nombre de bits, parit) qui sera dfinie dans \fIxtel.lignes\fP. Si le premier
champ a la valeur \fI@pipe\fP, cela signifie que l'accs au service se fait
au travers d'une commande locale (dont le chemin absolu est precis dans le
dernier champ) par \fIpipe\fP Unix. On peut ajouter  cette commande le flag
\fI:crlf\fP qui permet la conversion de CR en LF.
.PP
Si le premier champ a la valeur \fI@tcp\fP, l'accs au service se fait avec
une connexion TCP. Les champs suivant contiennent respectivement le nom de 
l'entre du menu puis le nom Internet du serveur puis le numro de port 
ou le nom de service TCP (spar du nom Internet par le caractre ':')
.sp
.PP
Si le premier champ a la valeur \fI@iminitel\fP, l'accs au service se fait avec
une connexion PPP au numro 3622. Les champs suivant contiennent respectivement le 
nom de 
l'entre du menu puis le nom du script de connexion puis le numro de port 
ou le nom de service TCP (spar du nom Internet par le caractre ':')
.PP
Ce premier champ est \fBoptionnel\fP ce qui permet en particulier de supporter
l'ancienne syntaxe. A ce moment la, les fichier \fIxtel.services\fP et 
\fIxtel.lignes\fP \fBne doivent pas\fP utiliser la nouvelle syntaxe (pas de 
mlange possible).
.PP
Si le dernier champ est absent, la connexion au service est permise  tous
les utilisateurs,
sinon elle est limite  ceux dont les noms de login sont
spcifis sous la forme 'user@machine'. Si la machine n'est pas spcifie, tous
les utilisateurs portant le nom 'user' sont autoriss. La syntaxe '@machine'
permet d'autoriser tous les utilisateur d'une machine donne. Le nom d'utilisateur
est ignor dans le cas des connexion Window$ (\fBHyperTerminal\fP).
On peut utiliser des caractres 8 bits pour le nom du service (1er
champ), si le caractre ne peut tre saisi directement, on pourra le reprsenter
sous la forme d'un code octal \\xyz . Si troisime champ est de la forme
\fInumro:nom_service\fP, cela signifie que l'accs est limit au service donn
(ex: 3615:METEO).
.PP
Si les champs spars pas des ':' sont de la forme :
.sp
.in +10
.nf
user1=delai
.in -10
.fi
cela signifie que l'utilisateur pourra rester connect au service pendant la
dure prcise par le delai (en secondes). Si le nom d'utilisateur n'est pas
prsent, ce delai est alors valable pour tous les utilisateurs. Un dlai de
ce type doit tre precis en \fBavant\fP la dfinition des utilisateurs 
autoriss.
.sp
.B "Exemple :"
.sp
.in +10
.nf
v23,Annuaire lectronique,3611,=180
v23,Tltel1,3613
v23,Tltel2,3614
tvr,Tltel TVR,3623
v23,Tltel3,3615,=60,user1@linuxbox:user2=120:user3:@pcwin
@pipe,Accs ondee,/usr/bin/telnet ondee
@pipe:crlf,Accs sidonie,/usr/bin/telnet sidonie
@tcp,Accs Minitel TCP/IP,minitel.fr:513
@iminitel,Accs I-Minitel,connect_iminitel:7516
v23,Direct,0
.fi
.in -10
.LP
Dans cet exemple le service, le service d'\fIAnnuaire\fP est autoris  tous 
pendant 180 secondes (tant que c'est gratuit !). Le \fITltel3\fP est 
accessible  tous les utilisateurs pendant 60 secondes, l'utilisateur 
\fIuser2\fP y a droit pendant 120 secondes. Les connexions provenant de
'linuxbox' ne sont autorises qu' 'user1'. Tous les utilisateurs de 'pcwin'
ont droit au service.
.PP
La dernire ligne dfinit une possibilit de numro de tlphone 
.I direct
(mot\-cl \fIDirect\fP), l'utilisateur saisira directement le numro lors de la 
composition dans \fIxtel\fP.
.LP
On utilise galement le fichier \fB"/usr/X11R6/lib/X11/xtel/xtel.lignes"\fP
qui dfinit les lignes disponibles et la procdure de composition. Ce fichier est de
la forme :
.sp
.I "[Nom du device,]"
.I "Nom de la ligne[:rtscts]"
,
.I "[Vitesse en bauds,]"
.I "[Nombre de bits,]"
.I "[Parit,]"
.I "chat-script avec le modem"
,
.I "delai maxi de rponse du modem en secondes"
.I "[,temporisation entre commandes en millisecondes.]"
.sp
Et ce pour chaque ligne utilisable. Si le premier champs (nom du device) est rpt
sur plusieurs lignes, cela signifie que plusieurs modem physiques sont associs au
device logique. Le serveur utilisera alors automatiquement le premier modem 
disponible.
.sp
Si la ligne commence par le caractre "/", on considre que l'\fBancienne\fP
syntaxe est utilise. On peut ajouter au nom de la ligne la chaine 
\fI:rtscts\fP qui prcise que cette ligne doit tre configure en controle de
flux hardware \fIRTS/CTS\fP. Cette configuration est gnralement utile si la vitesse 
de ligne est suprieure ou gale a 9600 (cas du TVR par exemple). On \fBdoit\fP alors
configurer le modem (dans le chat-script) afin qu'il gre
correctement le RTS/CTS (en gnral par la commande \fIAT&K3\fP sur un modem
compatible \fIHAYES\fP).
.sp
Les valeurs de vitesse possibles sont :
\fB 50, 75 110, 134, 150, 200, 300, 600, 1200, 1800, 2400, 4800, 9600, 
19200, 38400\fP,
les valeurs de tailles de caractres sont : \fB5, 6, 7, 8\fP, les valeurs de parit
sont : \fBE, O, N\fP.
.sp
Un "chat-script" est une suite de paires chaine_emise/chaine_attendu entre un 
processus et un modem (voir UUCP).
.sp
Si le chat-script est remplace par la chaine \fIminitel2\fP, la ligne est definie
comme utilisant un \fBMinitel 2\fP comme modem.
.sp
Si le chat-script est remplace par la chaine \fIminitel1\fP, la ligne est dfinie
comme utilisant un \fBMinitel 1/1B\fP comme modem. A ce moment la, le menu "Services"
ne sera pas affich dans xtel et l'utilisateur devra composer son numro  la main
(le M1/M1B ne sachant thoriquement pas composer de numro).
.sp
Le champ temporisation est optionnel et peut contenir une dure (en ms)
d'attente entre l'envoi de chaque commande au modem dans la phase
d'initialisation.  Il permet un meilleur support de certains anciens modems qui
n'acceptaient pas de recevoir un flot de commande trop rapide.  S'il n'est pas
prcis, aucune temporisation n'est effectue (c'est le comportement standard de \fIxteld\fP).
.sp 2
.B "Exemples :"
.in +10
.nf
/dev/cua0,\\dat\\r OK atdt\\T\\r CONNECT,30
v23,/dev/cua1,1200,7,E,\\dat\\r OK atdt\\T\\r CONNECT,30,250
tvr,/dev/cua2:rtscts,9600,8,N,\\dat\\r OK atdt\\T\\r CONNECT,30
.fi
.in -10
.sp
Ce fichier dfinit la ligne
.I "/dev/cua0"
sur laquelle on droule le chat-script suivant :
.sp
.in +5
.nf
	\\d			  On attend 1 s pour laisser le modem souffler...  
	at\\r OK		  On emet at + CR et on attend OK
	at\\T\\r CONNECT	  On emet at + le numero + CR et on attend
				  CONNECT
.fi
.in -5
.sp
Le dlai de reponse du modem est de
.I 30
secondes maxi. Si le dlai est dpass, \fIxteld\fP essayera sur la ligne suivante du fichier
jusqu' un succs ou la fin du fichier.
.sp
La ligne
.I v23
dclare aussi une temporisation de
.I 250ms
entre chaque commande transmise au modem.
.sp
.B "Remarques :"
.sp
Le format du chat-script accepte les squences suivantes :
.sp
.in +5
.nf
\\a		BELL
\\n		envoie LF
\\r		envoie CR
\\t		envoie VT
\\d		tempo de 1 s
\\T		envoie le numro de tlphone
\\abc		envoie le caractre cod en DECIMAL par abc (3 digits obligatoires)
\\xab		envoie le caractre cod en HEXADECIMAL par ab (2 digits)
.fi
.in -5
.sp
.PP
Pour certains modems, il faudra \fBOBLIGATOIREMENT\fP prciser une tempo \\d
avant la premier commande \fIat\fP.
.LP
Dans le cas d'un fonctionnement en rseau, \fIxteld\fP utilise  priori le port 
TCP numro 1313 dfini dans le fichier "/etc/services" 
.SH "VOIR AUSSI"
xtel inetd 
.SH FICHIERS
.in +7
.nf
/usr/X11R6/lib/X11/xtel/xtel.lignes
/usr/X11R6/lib/X11/xtel/xtel.services
/usr/X11R6/lib/X11/xtel/xtel.log
/etc/services
/etc/inetd.conf
.fi
.in -7
.SH COPYRIGHT
Copyright 1991-98, LECTRA-SYSTEMES et Pierre Ficheux
.SH AUTEUR
Pierre FICHEUX	  LECTRA-SYSTEMES ZI Marticot 33610 Cestas FRANCE