.\" Set up \*(lq, \*(rq if -man hasn't already set it up.
.if @@\*(lq@ \{\
.	ds lq "
.	if t .ds lq ``
.	if !@@\(lq@ .ds lq "\(lq
.\}
.if @@\*(rq@ \{\
.	ds rq "
.	if t .ds rq ''
.	if !@@\(rq@ .ds rq "\(rq
.\}
.de Id
.ds Rv \\$3
.ds Dt \\$4
..
.de Sp
.if n .sp
.if t .sp 0.4
..
.TH IFCICO 8 "24 septembre 1998" "2.14" "Agent FTN"
.UC 4
.SH NOM
.B	ifcico
\- tablit des connections avec d'autres noeuds FTN.
.PP
.br
.SH SYNOPSIS
.B	ifcico
.RB [ -h ]
.RB [ -x "<verbosit>]"
.RB [ -I "<fichier>]"
.RB [ -r0 "|" 1 "]"
.RB [ -n  "<tlphone>]"
.RB [ -l "<priphrique\-terminal>]"
.B noeud
.PP
.B      ifcico
.RB [ -h ]
.RB [ -x "<verbosit>]"
.RB [ -I "<fichier>]"
.RB [ -r0 "|" 1 "]"
.RB [ -t0 "|" 1 "]"
.RB "" -a "<addresse internet>[:<porte>]"
.B noeud
.PP
.B	ifcico tsync
|
.B yoohoo
|
.B **EMSI_INQC816
.br
(ceci implique le mode esclave)
.SH DESCRIPTION
.B Ifcico
signifie "Internet - Fidonet Copy In / Copy Out" (Internet - copies
entre/sortie pour Fidonet), c'est un agent de transport de courrier
compatible avec FidoNet(r).  Actuellement il supporte les protocoles
FTS-0001, YooHoo/2U2 et EMSI, ainsi que Xmodem (non test), Telink (non
test), Modem7 (non test), SEAlink avec "overdrive" et reprise en cas
d'erreurs, les requtes et demandes de mise  jour de fichiers selon le
protocole "Bark", et les protocoles "WaZOO" : DietIFNA, Zmodem pur
(aussi nomm ZedZip, le flag EMSI "ZMO"), ZedZap et Hydra, les requtes et
demandes de mise  jour de fichiers WaZOO (il faut le flag XA dans la
liste des noeuds).  Les requtes protges par mot de passe ne sont pas
implmentes.  Il y a des plans pour l'implmentation du protocole Janus
 l'avenir.
.PP
Il y a aussi un protocole particulier, optimis pour l'utilisation sur
une connection TCP/IP, qui est une contribution de Stanislav Voronyi
<stas@uanet.kharkov.ua>.  Ce protocole est identifi par le code
EMSI "TCP" (qui n'est pas enregistr officiellement).
.PP
La structure du rpertoire du courrier sortant est compatible avec
BinkleyTerm, avec des sous-rpertoires pour les domaines et les points
(entirement 5D).  Il y a des rpertoires entrants spars pour les
noeuds "lists" et "protgs", utiliss respectivement pour les appels
entrants de noeuds prsents dans les listes de noeuds d'une part, et de
noeuds ayant un mot de passe assign d'autre part.  Les fichiers reus
pendant un appel sortant sont toujours placs dans le rpertoire
"protg". (Seul le rpertoire "protg" est pris en considration par
ifunpack, par dfaut).
.PP
Les requtes de fichier pour les noms "magiques" sont traites par des
fichiers excutables dans le rpertoire "magic".  Si une requte arrive
pour un fichier dont le nom correspond  un fichier de ce rpertoire, le
programme est excut et sont flot de sortie (stdout) est envoy au
demandeur.  L'adresse complte de celui-ci, sous la forme "Jean Dupont
of 2:345/67.89" est transmise au programme dans la ligne de commande.
Voir "misc/FILES" pour un exemple de processeur de requtes magiques.
Les fichiers non excutables dans le rpertoire "magic" sont des
"rfrences".  Si une requte arrive pour un fichier portant ce nom, le
fichier est lu ligne par ligne, et la requte est rexcute pour le nom
de fichier trouv dans chaque ligne.  On autorise une rcursivit
jusqu' 5 niveaux.
.PP
Pour lancer ifcico en mode "matre", vous devez rgler les permissions
des priphriques ncessaires  l'appel pour permettre  ifcico de les
lire et d'y crire, _et_ galement le rpertoire o sont crs vos
smaphores uucp (habituellement /var/lock/).
.PP
Pour faire travailler ifcico en mode rponse, vous aurez besoin d'un
getty connaissant FTN.  Le "standard" Linux getty_ps 2.0.7d, et le
mgetty .17 de Gert Doering (du paquetage mgetty+sendfax) et les versions
ultrieures supportent Fidonet.  Le getty doit distinguer les appels
entrant de type Fidonet, et dmarrer ifcico avec un paramtre:
.PP
.TS
tab (@);
l l.
FTS-0001 call:@"ifcico tsync"
FTS-0006 call:@"ifcico yoohoo"
EMSI call:@"ifcico **EMSI_....."
.TE
.PP
(dans ce dernier cas le paquet EMSI reu doit tre pass sans le CR
final).
.PP
Si vous utilisez getty_ps, n'oubliez pas de crer le fichier
/etc/default/uugetty, avec un contenu similaire  ce qui suit (sensible
 la casse) :
.PP
FIDO=/usr/local/lib/fnet/ifcico
.br
EMSI=yes
.PP
Lorsqu'on l'appelle sans paramtres, ifcico tourne en mode esclave et
dtermine le type de session entrante lui-mme.  Ce mode peut tre
utilis quand ifcico tourne en dmon internet ou ISDN.
.PP
Pour qu'ifcico parcoure le courrier en attente de sortie et qu'il fasse
les appels ncessaires, dmarrez-le avec l'option "-r1".  Pour forcer le
polling de noeuds spcifiques, indiquez ces noeuds dans la ligne de
commande (les adresses doivent tre dans la notation domaniale,
par exemple "ifcico f23.n5020 f155.n5020"). Ceci implique le mode
"matre" (-r1).  Notez que les paquets et fichiers en "hold", ainsi que
les requtes de fichiers, ne provoquent pas le poll d'un noeud.
.PP
Le rpertoire entrant est cr automatiquement s'il n'existe pas, ainsi
que le sous-rpertoire "tmp".  Ce dernier est utilis pendant la
rception de fichiers.  Aprs une rception sans erreur, les fichiers
sont dplacs dans le rpertoire d'entre.  Les rpertoires
"protinbound" et "listinbound" reoivent respectivement les fichiers
reus pendant les sessions protges par mot de passe et d'autre part
ceux des sessions avec des noeuds prsents dans les listes de noeuds.
.PP
Ifcico peut utiliser les listes de noeuds en format texte dans leur
forme d'origine (MS/DOS) avec des <CR><LF>, ainsi que dans la forme UNIX,
avec seulement des <LF>.  Quand vous recevez une nouvelle liste de
noeuds, ou si vous modifiez les instructions "nodelist" dans le fichier
de configuration, vous devez reconstruire l'index avec le programme
"ifindex".
.PP
Pour les appels sortants, des fichiers d'tat sont crs pour les
noeuds, avec l'extension ".sts".  Ces fichiers sont en format ASCII et
contiennent trois nombres dcimaux dans une seule ligne:
.PP
.B heure essais code
.PP
.B heure	
.br
c'est l'heure de la dernire tentative d'appel (les tentatives avortes
avec le message "retry time not reached" ne comptent pas).  C'est un
"unsigned long" reprsentant le nombre de secondes depuis l'"epoch".
.PP
.B essais	
.br
c'est le nombre de tentatives d'appel conscutives qui se sont termines
par "call failed" ou "could not establish session".  Ce champ est mis 
zro lorsque l'appel russit.
.PP
.B code	
.br
c'est le code retour du dernier appel.
.PP
le programme nlpatch compile une nouvelle version de la liste des noeuds
 partir de l'ancienne liste et d'un fichier "nodediff".
.PP
.SH OPTIONS
.B \-h
.br
	Affiche un court message d'aide
.PP
.B \-x Verbosit
.br
	Spcifie le niveau de messages de dbogage. 
.B Verbosit	
peut tre un nombre de 0  32 pour 'allumer' les bits de 1  la valeur
spcifie, ou bien des lettres (avec 'a' = bit 1, 'b' = bit 2, etc.
jusqu' 'z' = bit 26.
.PP
.B \-I Fichier
.br
	Utilise le fichier de configuration spcifique
.B Fichier.
.PP
.B \-r Role
.br
	1 - matre, 0 - esclave. Le dfaut est 0 (mode esclave) si on
spcifie un
.B noeud
; sinon le dfaut est 1 (mode matre).
.PP
.B \-a Adresse_Internet
.br
	Donne une adresse internet
.B Adresse_Internet
pour tablir une connection via TCP/IP.  Une porte spcifique peut tre
demande (
.B \-a Adresse_Internet:Porte
).
La valeur par dfaut est celle donne pour le service
.B fido
dans
.B /etc/services.
.PP
.B \-t Mode
.br
	0 - TCP, 1 - Telnet-Vmodem. Indique le mode  utiliser pour les
connections TCP/IP, le dfaut tant le mode TCP (-t0).
.PP
.B \-n Numro de tlphone
.br
        Pour les connections par modem, ce paramtre remplace le numro
donn dans la nodelist.
.PP
.B \-l PriphriqueTTY
.br
        Pour les connections par modem, ceci remplace la valeur du TTY
spcifie dans le fichier config.
.PP
.B Noeud
.br
	Ceci est l'adresse FTN du noeud  appeller.  Cette adresse doit
tre au format "[pNN.]fNN.nNN[.zNN[.domain]]".
.PP
.B tsync
|
.B yoohoo
|
.B **EMSI_INQC816
.br
	Ces valeurs sont typiquement donnes par un getty compatible FTN (
.B mgetty
ou
.B getty_ps
), elles dterminent le type de protocole FTN  utiliser.  Elles
impliquent le mode esclave.
.PP
.SH "CODES DE RETOUR"
.PP
ifcico renvoie le code retour maximal de tous les appels qu'il a tents.
Les codes sont les suivants:
.PP
.TS
tab (@);
l l.
0@Appel russi
1@Port d'appel indisponible
2@Numrotation avorte (pas de "CONNECT" ou erreur lors de la connection TCP)
3@Impossible de rinitialiser le modem (pas de "OK")
4@Systme bloqu
5@Temps de raissai non atteint
6@Erreur fatale lors de la recherche dans la liste des noeuds
7@Appel interdit par des options de configuration
8@Numro de tlphone non disponible
9@Pas de port convenable dfini
10@Inutilis
>10@Erreurs lors des sessions (pas encore dfinies)
30@Impossible d'tablir la session
.TE
.SH FICHIERS
.TP
.B $IFLIBDIR/config
	Fichier de configuration actif.
.TP
.B /etc/services
	Dtermine le numro de port par defaut pour
.B fido,
le port utilis par
.I ifcico
pour les connections TCP.
.TP
.B nodelist.???
	Une liste des noeuds dans un rseau FTN. 
.I ifcico
l'utilise en la compilant avec
.I ifindex
.TP
.B $BINDIR/ifindex
	compile une liste de noeuds afin que
.I ifcico
puisse l'utiliser.
.TP
.B $BINDIR/ifstat
	montre les statistiques concernant les appels, etc.
.TP

.SH VOIR AUSSI
ifmail(8), ifpack(8), ifunpack(8), iftoss(8), mgetty(8), getty(1)
.PP
.SH REMERCIEMENTS
Certaines ides ont t reprises au paquetage Fidogate/RFmail, crit par
Teemu Torma et hack par Martin Junius.
.br
Une partie du code TCP a t repris de la version JE, crite par Tsuneo
Tanaka <ttan@twics.com>
.br
Support du protocole Hydra par Christof Meerwald <cmeerw@htl.fh-sbg.ac.at>
.PP
 1993, 1994 Eugene Crosser. 
.PP
Ceci est un logiciel libre.  Vous pouvez en faire ce que vous voulez du
moment que cette notice de copyright est laisse intacte.
.PP
Page de manuel crite par Pablo Saratxaga <srtxg@chanae.alphanet.ch>
.br
Traduction franaise de la page de manuel par Luc Moreau
1997.