1.1. Origine et remerciements

Ce guide s'inspire largement du document Usage Instructions qui a �t� inclus dans le paquet ATM on Linux jusqu'� la version 0.79. Werner Almesberger <wa@almsesberger.net> l'a r�dig� pendant son s�jour au Institute for computer Communications and Applications (ICA).

Richard Jones <rjones@imcl.com> est � l'origine de la partie Emploi de deux adaptateurs ATM directement connect�s.

1.2. Droits d'utilisation

Le texte ci-dessous est la version fran�aise de la licence de ce document. Seule la version originale de cette licence, pr�sent�e dans la section suivante, fait foi.

La version originale de ce document a �t� r�alis� par la soci�t� IBM Corporation en 2001.

Vous avez le droit de copier, distribuer et modifier la version originale de ce document selon les termes de la licence de documentation libre GNU (GFDL) version 1.1 ou ult�rieures, telle que publi�e par la Free Software Foundation�; sans section invariante, sans texte de premi�re de couverture ni texte de quatri�me de couverture. Une copie de la licence est disponible sur http://www.gnu.org/copyleft/fdl.html.

Une partie importante de ce document provient du guide Usage Instructions, inclus dans le paquet ATM on Linux jusqu'� la version 0.79, qui a �t� disponible sous les licences BSD, GNU General Public License (GPL) et GNU Lesser General Public License (LGPL).

La version fran�aise de document a �t� r�alis�e par Fran�ois Romieu et Fr�d�ric Delanoy. La version fran�aise de ce guide pratique est publi�e en accord avec les termes de la licence de documentation libre GNU (GFDL)�; sans section invariante, sans texte de premi�re de couverture ni texte de quatri�me de couverture. Une copie de la licence est disponible sur http://www.gnu.org/copyleft/fdl.html. Une version fran�aise non officielle de cette licence est disponible sur http://cesarx.free.fr/gfdlf.html.

1.3. Copyright

Le texte ci-dessous est la licence de ce document. Ce texte fait foi. Il est compos� de la licence en anglais du document orignal, suivi de la licence en fran�ais de sa traduction.

Copyright 2001 IBM Corporation.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license can be found at http://www.gnu.org/copyleft/fdl.html.

A large portion of this document is derived from the Usage Instructions included with the ATM on Linux distribution up to version 0.79 which was released under the BSD License, GNU General Public License (GPL), and GNU Lesser General Public License (LGPL).

La version fran�aise de document a �t� r�alis�e par Fran�ois Romieu et Fr�d�ric Delanoy. La version fran�aise de ce guide pratique est publi�e en accord avec les termes de la licence de documentation libre GNU (GFDL)�; sans section invariante, sans texte de premi�re de couverture ni texte de quatri�me de couverture. Une copie de la licence est disponible sur http://www.gnu.org/copyleft/fdl.html.

1.4. Liste de diffusion

Il existe une liste de diffusion pour discuter d'ATM sous Linux. Pour faire part de remarques, poser des questions ou vous impliquer, n'h�sitez pas � rejoindre cette liste. Vous pouvez vous y abonner (subscribe) et vous en d�sabonner (unsubscribe) � l'adresse http://lists.sourceforge.net/lists/listinfo/linux-atm-general.

La liste de diffusion est archiv�e sur http://www.geocrawler.com/lists/3/SourceForge/6487/0/.

1.5. Acc�s CVS

Il est conseill� aux utilisateurs d'employer les publications stables plut�t que de r�cup�rer la derni�re version depuis le r�f�rentiel CVS. Voici n�anmoins la marche � suivre pour les amateurs de sensations fortes.

Commencez par vous connecter de fa�on anonyme�:

% cvs -d:pserver:anonymous@cvs.linux-atm.sourceforge.net.:/cvsroot/linux-atm login

Appuyez sur Entr�e � l'invite du mot de passe. R�cup�rez ensuite l'arborescence�:

% cvs -z6 -d:pserver:anonymous@cvs.linux-atm.sourceforge.net.:/cvsroot/linux-atm co -P linux-atm

Il est possible de sp�cifier une branche particuli�re�:

% cvs -z6 -d:pserver:anonymous@cvs.linux-atm.sourceforge.net.:/cvsroot/linux-atm co -r V2_5_0 linux-atm

Dans tous les cas, un r�pertoire ��linux-atm�� contenant la derni�re version des sources est cr��. Une fois � l'int�rieur de ce r�pertoire, l'option ��-d�� de CVS n'est plus n�cessaire. Par exemple, tapez�:

% cvs -z6 up -d

pour obtenir les modifications apport�es au r�f�rentiel (l'option ��-d�� de l'exemple se rapporte � la sous-commande ��up�� et n'a rien � voir avec le param�tre ��-d�� employ� pour sp�cifier l'emplacement de la racine CVS).

Apr�s avoir r�cup�r� l'arborescence, ex�cutez le script autotools dans le r�pertoire de plus haut niveau avant d'entamer la configuration, la compilation et l'installation.

# ./autotools 
Running aclocal...
Running autoconf...
Running autoheader...
Running automake...
automake: configure.in: installing `./install-sh'
automake: configure.in: installing `./mkinstalldirs'
automake: configure.in: installing `./missing'
configure.in: 26: required file `./ltconfig' not found
automake: Makefile.am: installing `./INSTALL'
automake: configure.in: installing `src/lane/ylwrap'
Finished...  Now run './configure' and 'make'...

Pour construire un paquet .tar.gz ou un RPM, ex�cutez respectivement make dist ou make rpm. Le fichier .tar.gz se trouvera dans le r�pertoire de plus haut niveau de l'arborescence tandis que le RPM sera plac� dans le r�pertoire src/extra/RPMS.

Une interface web permet de visualiser le contenu du r�f�rentiel CVS�: http://cvs.linux-atm.sourceforge.net/cgi-bin/viewcvs.cgi/linux-atm/linux-atm/.

Enfin, si vous souhaitez recevoir un courrier �lectronique pour chaque modification apport�e au r�f�rentiel, abonnez-vous � la liste de diffusion���linux-atm-commits���: http://lists.sourceforge.net/lists/listinfo/linux-atm-commits.

Cette liste de diffusion est en lecture seule et aucune discussion ni question n'y est autoris�e (idem pour les patches). Les discussions ont lieu sur la liste de diffusion linux-atm-general.

2.1. Les binaires RPM

Si vous ne souhaitez pas extraire et compiler les sources vous-m�me, les utilitaires ATM existent �galement sous forme de paquet RPM installable comme suit�:

rpm -ivh linux-atm-x.x.x-x.rpm

2.2. L'arborescence des sources

Commencez par d�compacter le paquet ATM pour Linux�:

tar xzvf linux-atm-x.x.x.tar.gz

Ceci cr�e une arborescence de racine linux-atm-x.x.x/. On notera les r�pertoires suivants�:

2.3. Configuration du noyau

Si vous n'avez pas l'habitude de compiler et d'installer un nouveau noyau, reportez-vous au guide pratique du noyau Linux (Linux Kernel HOWTO).

Apr�s avoir d�compact� le paquet du noyau, ex�cutez la commande habituelle au sommet de l'arborescence des sources du noyau�: make config, make menuconfig ou make xconfig. Activez ensuite�:

Prompt for development and/or incomplete code/drivers
  (CONFIG_EXPERIMENTAL)

Les options suivantes doivent apparaitre�:

Asynchronous Transfer Mode (ATM, EXPERIMENTAL) (CONFIG_ATM)
  Use "new" skb structure (CONFIG_ATM_SKB)
  Classical IP over ATM (CONFIG_ATM_CLIP)
    Do NOT send ICMP if no neighbour (CONFIG_ATM_CLIP_NO_ICMP)
  LAN Emulation (LANE) support (CONFIG_ATM_LANE)
    Multi-Protocol Over ATM (MPOA) support (CONFIG_ATM_MPOA)
ATM over TCP (CONFIG_ATM_TCP)
Efficient Networks ENI155P (CONFIG_ATM_ENI)
  Enable extended debugging (CONFIG_ATM_ENI_DEBUG)
  Fine-tune burst settings (CONFIG_ATM_ENI_TUNE_BURST)
    Enable 16W TX bursts (discouraged) (CONFIG_ATM_ENI_BURST_TX_16W)
    Enable 8W TX bursts (recommended) (CONFIG_ATM_ENI_BURST_TX_8W)
    Enable 4W TX bursts (optional) (CONFIG_ATM_ENI_BURST_TX_4W)
    Enable 2W TX bursts (optional) (CONFIG_ATM_ENI_BURST_TX_2W)
    Enable 16W RX bursts (discouraged) (CONFIG_ATM_ENI_BURST_RX_16W)
    Enable 8W RX bursts (discouraged) (CONFIG_ATM_ENI_BURST_RX_8W)
    Enable 4W RX bursts (recommended) (CONFIG_ATM_ENI_BURST_RX_4W)
    Enable 2W RX bursts (optional) (CONFIG_ATM_ENI_BURST_RX_2W)
ZeitNet ZN1221/ZN1225 (CONFIG_ATM_ZATM)
  Enable extended debugging (CONFIG_ATM_ZATM_DEBUG)
  Enable usec resolution timestamps (CONFIG_ATM_ZATM_EXACT_TS)
IDT 77201 (NICStAR) (CONFIG_ATM_NICSTAR)
  Use suni PHY driver (155Mbps) (CONFIG_ATM_NICSTAR_USE_SUNI)
  Use IDT77015 PHY driver (25Mbps) (CONFIG_ATM_NICSTAR_USE_IDT77105)
Madge Ambassador (Collage PCI 155 Server) (CONFIG_ATM_AMBASSADOR)
  Enable debugging messages (CONFIG_ATM_AMBASSADOR_DEBUG)
Madge Horizon [Ultra] (Collage PCI 25 and Collage PCI 155 Client)
  Enable debugging messages (CONFIG_ATM_HORIZON_DEBUG)
Interphase ATM PCI x575/x525/x531 (CONFIG_ATM_IA)
  Enable debugging messages (CONFIG_ATM_IA_DEBUG)

Les param�tres ��burst�� du gestionnaire ENI sont ajustables. Les modifier peut s'av�rer n�cessaire si le positionnement par d�faut provoque des �puisements de tampons m�moire lors des transferts PCI. On se reportera � la documentation en ligne relative � ��CONFIG_ATM_ENI_TUNE_BURST�� pour une explication d�taill�e de l'impact de ce param�tre.

Le fichier drivers/atm/nicstar.h contient les variables sur lesquelles on peut jouer pour le pilote IDT 77201.

Les gestionnaires peuvent �tre employ�s avec certaines cartes compatibles. La r�f�rence la plus � jour pour ces derni�res se trouve sur la page d'information relative � ATM on Linux.

Recompilez ensuite le noyau et red�marrez.

2.4. Messages des gestionnaires de p�riph�riques

Si vous avez activ� le pilote ENI155p-MF, deux lignes semblables aux suivantes devraient appara�tre (512kB pour la version -C, 2048kB pour la version -S)�:

eni(itf 0): rev.0,base=0xff400000,irq=10,mem=512kB (00-20-EA-00-07-56)
eni(itf 0): FPGA,MMF

Si vous avez activ� le pilote ZN1221�/ ZN1225, il appara�t des messages du genre�:

zatm(itf 0): rev.3,base=0xf800,irq=11,mem=128kB,MMF (00-20-D4-10-2A-80)
zatm(itf 0): uPD98401 0.5 at 30.024 MHz
zatm(itf 0): 16 shapers, 32 pools, 2048 RX, 3958 VCs

Notez qu'une carte de r�vision 3 ou plus est n�cessaire pour une carte-m�re �quip�e d'un jeu de composants Triton.

Si vous n'avez activ� que le pilote ATM au-dessus de TCP, aucun message n'appara�t au d�marrage parce que les p�riph�riques correspondants ne sont cr��s qu'au moment de l'invocation de la commande atmtcp.

2.5. D�bogage m�moire

Si on d�sire analyser d'�ventuels probl�mes relatifs aux allocations m�moire, il est n�cessaire d'installer MPR avant de compiler les outils ATM.

Si vous r�cup�rez un paquet RPM binaire, MPR s'installe comme suit�:

rpm -ivh mpr-x.x-x.rpm

Si vous partez des sources, d�compactez mpr-x.x.tar.gz ainsi�:

tar xzvf mpr-x.x.tar.gz

Puis ex�cutez les commandes suivantes�:

cd mpr-x.x
./configure x86-linux
make
make install

Une d�tection automatique de certains usages erron�s des fonctions malloc et free aura alors lieu automatiquement si les utilitaires ont �t� compil�s apr�s installation de MPR. Le suivi des allocations est activ� en positionnant MPRPC et MPRFI. Reportez-vous aux fichiers doc/mpr.html et doc/mpr.ps dans le paquet MPR pour davantage de d�tails.

Bien que le d�bogage des allocations n'implique qu'un l�ger surco�t � l'ex�cution, ces variables d'environnement ne sont pas positionn�es par d�faut.

2.6. Utilitaires ATM

Pour finir, configurez et compilez les outils ATM. La configuration n'est requise que si votre commutateur utilise UNI 3.1 ou 4.0 ou s'il pr�sente certains dysfonctionnements. Les options de configuration sont activ�es par passage au script ./configure du paquet linux-atm.

Ex�cutez ./configure --help � partir de la racine de l'arborescence linux-atm pour visualiser toutes les options disponibles.

Les commandes suivantes compilent les utilitaires ATM�:

cd linux-atm-x.x.x
./configure
make
make install

Sauf sp�cification particuli�re lors de l'invocation de la commande ./configure, make install installera les ex�cutables dans les r�pertoires /usr/local/bin et /usr/local/sbin. � l'exception du fichier hosts.atm (qui est install� dans le r�pertoire /etc), les fichiers de configuration se situeront en /usr/local/etc. Les biblioth�ques et les fichiers d'en-t�te sont respectivement copi�s dans /usr/local/lib et /usr/local/include. Les pages de manuel se retrouvent dans /usr/local/man.

2.7. Paquets suppl�mentaires

Certains programmes reposent sur des paquets de grande taille qui ne sont pas contr�l�s par linux-atm. Pour d'autres, des patches sont fournis dans le paquet ATM-Linux. Ils se trouvent dans le r�pertoire src/extra de la distribution ATM-Linux.

Les paquets suivants sont disponibles�:

Notez que text2atm emploie automatiquement ANS s'il est disponible, et que celui-ci ne doit d�s lors �tre install� que sur les syst�mes qui fournissent le service de r�solution de noms ou lorsque des outils de maintenance au fait d'ATM sont requis (nslookup, …).

Le script hosts2ans.pl dans le r�pertoire src/extra/ANS/ convertit un fichier /etc/hosts.atm en un fichier de zone ANS. Son utilisation est d�crite en t�te de fichier.

3.1. ATM au-dessus de TCP

En l'absence de v�ritable mat�riel ATM, vous pouvez utiliser l'API par l'interm�diaire du gestionnaire ATM au-dessus de TCP. Il �mule des p�riph�riques ATM qui sont directement connect�s les uns aux autres � distance (c.-�-d. sans manipulation de paires VPI/VCI).

Pour �tablir un lien (bidirectionnel) entre deux syst�mes, devenez root sur chacun d'entre eux (ou ex�cutez les deux commandes sur le m�me syst�me pour connecter deux interfaces) et ex�cutez la commande suivante sur l'un d'eux (que l'on d�signera par ��a��)�:

# atmtcp virtual listen

Puis, sur l'autre syst�me (��b��)�:

# atmtcp virtual connect adresse_de_a

Les utilitaires atmtcp �mettront des messages au fur et � mesure de leur avancement. Par exemple�:

Link 0: virtual interface 2
Link 1: incoming ATMTCP connection from 127.0.0.1

et

Link 0: virtual interface 3
Link 1: ATMTCP connection to localhost

On notera que la commande atmtcp s'ex�cute en permanence et que l'interrompre brise le lien virtuel.

Une m�me machine peut accepter plusieurs liens en sp�cifiant des num�ros de port diff�rents (2812 par d�faut). Aucun traitement AAL n'est effectu� et il n'est par cons�quent pas possible d'employer une couche d'adaptation diff�rente (p.ex. AAL0) de celle utilis�e � l'�mission.

3.2. ZN1221�/ ZN1225

Les cartes ZeitNet ZN1221 et ZN1225 emploient des r�serves de m�moire allou�es � l'avance pour la r�ception. D�s qu'un circuit virtuel d'une certaine SDU est activ� en r�ception, la r�serve correspondante est remplie de tampons vides par le gestionnaire. La carte consomme les tampons lors de la r�ception et, lorsque leur nombre passe en dessous d'une certaine limite, le gestionnaire alloue � nouveau la r�serve.

Les limites inf�rieures et sup�rieures du nombre de tampons libres ainsi que la valeur limite pour l'adaptation � un nouveau d�calage de donn�es (voir ci-dessous) sont ajustables gr�ce au programme zntune. Emploi�:

zntune [-l marque_basse] [-h marque_haute] [-t seuil] interface [r�serve]

Les modifications sont appliqu�es � toutes les r�serves si aucun indice de r�serve n'est sp�cifi�. La r�serve 2 stocke les paquets de 64 octets, la r�serve 3 les paquets de 128 octets, etc. Les r�serves 0 et 1 ne sont pour l'instant pas utilis�es.

La configuration courante ainsi que des statistiques d'utilisation peuvent �tre obtenues en invoquant la commande zntune sans param�tre suppl�mentaire�:

zntune [-z] interface [r�serve]

La colonne ��Size�� indique la taille de tampon m�moire en octets. La colonne ��Ref�� correspond au nombre de VC ouverts qui emploient cette r�serve. La colonne ��Alarm�� indique combien de fois le nombre de tampons m�moire disponibles a franchi la limite basse depuis la derni�re remise � z�ro des compteurs. De m�me, la colonne ����Under���� fournit le nombre d'unit�s de donn�es de protocole (PDU, Protocol Data Unit) jet�es � cause d'un manque de m�moire.

Les colonnes ��Offs��, ��NxOf��, ��Count�� et ��Thres�� indiquent l'�tat d'alignement. ��Offs�� est le d�calage des donn�es utiles dans les PDU attendues. Dans le cas d'une copie simple, les tampons de r�ception sont align�s de telle sorte que les donn�es soient re�ues � partir de fronti�res de page. ��NxOf�� correspond au d�calage des donn�es utiles de la derni�re PDU re�ue pour laquelle le d�calage diff�re de celui attendu. ��Count�� indique le nombre de PDU re�ues cons�cutivement avec un d�calage de ��NxOf��. Enfin, lorsque ��Count�� atteint ��Thres��, ��NxOf�� devient la nouvelle valeur de d�calage.

L'option -z permet de remettre � z�ro les compteurs ��Alarm�� et ��Under��.

3.3. Fichiers du r�pertoire /proc/net/atm/

Des informations sur l'�tat du syst�me ATM sont accessibles via les fichiers du r�pertoire /proc/net/atm/. /proc/net/atm/arp contient des informations propres � CLIP (Classical IP over ATM), cf. CLIP.

Les p�riph�riques ATM actifs sont �num�r�s dans le fichier /proc/net/atm/devices. Chaque entr�e comprend le num�ro de l'interface, son type, l'identifiant ESI (End System Identifier) ainsi que des compteurs d'usage. Ces derniers correspondent � ceux fournis par l'utilitaire atmdiag.

Les p�riph�riques ATM peuvent d�clarer des enregistrements de la forme type:indice (par exemple eni:0).

Les fichiers /proc/net/atm/pvc et /proc/net/atm/svc �num�rent les sockets de type PVC et SVC. L'interface et la paire d'indices VPI, VCI est donn�e pour chaque socket. Dans le cas des PVC, cette information est suivie du type d'AAL, de la classe de trafic et du PCR en r�ception et en �mission. Pour les SVC, on trouve l'�tat du SVC et l'adresse du correspondant. Les SVC de num�ro d'interface 999 sont destin�s � des mesures de contr�le particuli�res comme indiqu� dans la colonne ��State��.

Enfin, le fichier /proc/net/atm/vc comprend les tailles de tampon m�moire et d'autres donn�es internes pour les sockets ATM.

3.4. Diagnostic ATM

L'utilitaire atmdiag permet de r�cup�rer divers compteurs d'usage des gestionnaires de p�riph�riques ATM. Reportez-vous � la page de manuel associ�e pour davantage de d�tails.

3.5. Diagnostic SONET

L'outil de diagnostic SONET peut s'employer pour surveiller l'�tat du lien et pour simuler des erreurs. Pour obtenir les compteurs d'usage SONET, invoquez-le avec l'indice de l'interface ATM en argument. Par exemple�:

% sonetdiag 0

L'option -z remet les compteurs � z�ro�:

# sonetdiag -z 0

Les erreurs suivantes peuvent �tre simul�es[1] �:

Une erreur est activ�e par ajout du mot-cl� correspondant � la ligne de commande. L'erreur est d�sactiv�e en pr�fixant le mot-cl� par un signe n�gatif, par exemple�:

a# sonetdiag -z 0 >/dev/null
b# sonetdiag -z 0 >/dev/null
a# sonetdiag 0 los
a# sonetdiag 0 -los
b# sonetdiag 0 | grep BIP
Section BIP errors:      56200
Line BIP errors:           342
Path BIP errors:           152
a# sonetdiag 0 | grep FEBE
Line FEBE:                 342
Path FEBE:                 152

Si des insertions d'erreurs sont demand�es, leurs identifiants sont indiqu�s lorsque les compteurs sont relev�s via sonetdiag. On notera que le mat�riel peut spontan�ment d�sactiver certaines insertions d'erreur.

4.1. Outils de g�n�ration de trafic

aread/awrite et br/bw sont des programmes �lementaires donnant acc�s � l'API ATM. awrite transmet la cha�ne de texte donn�e en deuxi�me argument via une PDU AAL5. aread re�oit une PDU AAL5 et l'affiche en hexad�cimal. Ces deux programmes affichent �galement la valeur de retour des appels syst�me correspondants ainsi que celle de errno.

bw transmet le contenu de son entr�e standard ou un flux de donn�es arbitraires (si on lui passe un nombre en quatri�me argument). Les donn�es transitent dans des PDU AAL5 de 8 Ko. br re�oit les PDU AAL5 et les affiche sur sa sortie standard.

Le premier argument des commandes aread, awrite, br et bw correspond � l'adresse du circuit permanent, � savoir le num�ro de l'interface ATM, le VPI et le VCI s�par�s � chaque fois par un point. Le num�ro de l'interface peut �tre omis s'il est nul. Par exemple�:

% awrite 1.0.42 hi

Certains mat�riels ne supportent qu'un VPI nul. Par ailleurs, la plage des VCI peut �tre limit�e, p.ex. entre 0 et 1023. Le num�ro de l'interface ATM s'obtient � partir des messages d'initialisation du gestionnaire ATM concern�. atm0 correspond � l'interface 0, atm1 correspond � l'interface 1, etc. Dans un syst�me muni d'un v�ritable p�riph�rique ATM (autre que atmtcp donc), celui-ci se situe normalement en atm0.

L'utilitaire aping �met et re�oit de petites PDU AAL5 via un PVC. Il s'attend � ce que les messages soient renvoy�s en �cho � l'autre extr�mit� ou � ce qu'une application similaire y �mette un flux de messages. aping signale une erreur si rien n'est re�u pendant une certaine dur�e. Il s'invoque comme aread, en sp�cifiant le PVC.

Pour des tests plus pouss�s, servez-vous de la version modifi�e de ttcp incluse dans le paquet. La version originale est disponible � l'adresse�: ftp://ftp.sgi.com/sgi/src/ttcp/. Les options suivantes ont �t� ajout�es�:

Exemples�:

%a ttcp_atm -r -a -s 0.90
%b ttcp_atm -t -a -s 0.90

4.2. Acc�s direct aux cellules

Les cellules peuvent �tre form�es et analys�es avec l'utilitaire atmdump pour les p�riph�riques dont le gestionnaire permet les acc�s directs aux cellules (mode AAL0). Par exemple�:

a% sleep 10; date | ./atmdump -t 1 -c 0.51
b% ./atmdump 0.51
825079645.192480: VPI=0 VCI=51, GFC=0x0, CLP=1, Data SDU 1 (PTI 1)
   46 72 69 20 46 65 62 20 32 33 20 31 32 3a 34 37 
   3a 32 35 20 47 4d 54 20 31 39 39 36 0a 00 00 00 
   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

5.1. Fichier des h�tes ATM

Les adresses ATM �tant peu pratiques � manipuler, la plupart des outils ATM acceptent �galement des noms au lieu des adresses num�riques. La conversion entre les noms et les adresses s'effectue via le fichier /etc/hosts.atm dont la structure est analogue � celle du fichier /etc/hosts�:

adresse_num�rique nom(s)

Par exemple�:

47.0005.80FFE1000000F21A26D8.0020EA000EE0.00 pc2-a.fqdn pc2-a
47.0005.80FFE1000000F21A26D8.0020D4102A80.00 pc3-a.fqdn pc3-a

L'adresse num�rique est sp�cifi�e dans un des formats d�crits dans [api]. L'adresse d'un syst�me Linux peut �tre d�termin�e avec la commande atmaddr -n (voir �galement la section Configuration manuelle d'adresse).

De nombreux outils ATM tentent �galement d'obtenir le nom qui correspond � une adresse lorsqu'ils affichent cette derni�re. Le premier nom qui appara�t dans le fichier en regard d'une adresse est alors utilis�.

Outre les adresses ATM pour les SVC, les adresses des PVC peuvent �galement �tre stock�es dans le fichier /etc/hosts.atm. Lorsque diff�rents types d'adresses correspondent au m�me nom d'h�te, la premi�re dont le type convient est employ�e. Ainsi, lorsqu'une application ne demande que des adresses de SVC, celles des PVC sont ignor�es.

5.2. ANS

Si vous avez acc�s au service de nom ATM (ATM Name Service), par exemple parce que vous avez install� l'option ANS, vous pouvez l'employer en remplacement ou en compl�ment du fichier de noms en sp�cifiant le nom de l'h�te qui h�berge le service ANS dans le fichier /etc/resolv.conf.

La liste des codes t�l�phoniques doit �tre connue pour effectuer la r�solution inverse des adresses E.164. Cette liste se trouve sur le site de l'ITU-T (International Telecommunications Union). La liste des codes E.164 nationaux assign�s par l'ITU-T est disponible aux formats PDF et Word.

Si l'URL venait � changer, le document devrait �tre facilement localis� en utilisant le moteur de recherche du site.

Le script src/lib/pdf2e164_cc.pl du paquet atm-linux permet de cr�er un tableau des codes nationaux E.164 � partir de la version PDF. Par exemple�:

perl pdf2e164_cc.pl e164_xxx.pdf >/etc/e164_cc

Le script s'appuie sur l'utilitaire pdftotext. Celui-ci est disponible avec l'application xpdf.

5.3. D�mon de signalisation

Pages de manuel�: atmsigd(8) atmsigd.conf(4)

Notez que la prise en charge point-�-multipoint d'atmsigd est tr�s limit�e�: seul l'emploi en tant que feuille d'un arbre point-�-multipoint fonctionne.

Par d�faut, atmsigd est configur� pour se conformer � la version d'UNI choisie dynamiquement. Il peut �tre compil� pour UNI 3.0, 3.1 ou 4.0 en employant l'argument --with-uni=VERSION du script ./configure au sommet des sources du paquet linux-atm.

Notez que la configuration de atmsigd est assez contraignante. Il s'arr�te souvent en cas d'anomalie. Ceci devrait changer dans le futur.

atmsigd cherche un fichier de configuration � l'emplacement sp�cifi� via l'option -c. /usr/local/etc/atmsigd.conf correspond � l'emplacement par d�faut.

5.4. D�mon ILMI

ILMI offre un m�canisme de configuration automatique des adresses. En l'absence de commutateur ou si celui-ci ne g�re pas ILMI, les adresses ATM doivent �tre renseign�es manuellement (se reporter � la section Configuration manuelle d'adresse). On notera que le d�mon ILMI ne doit pas �tre employ� avec des interfaces pour lesquelles les adresses sont positionn�es manuellement.

Le d�mon ILMI est invoqu� comme suit�:

ilmid [-b] [-d] [-i ip_locale] [-l fichier_journal] [-q qos] [-u version_uni] [-v] [-x] [itf]

En l'absence de num�ro d'interface, ilmid se sert de l'interface 0. La commande atmaddr permet de v�rifier le succ�s de l'enregistrement d'adresse.

L'agent ne supporte que les proc�dures d'enregistrement d'adresse sp�cifi�es dans la section 5.8 des sp�cification UNI 3.1 d'ATM Forum. Ces proc�dures impliquent l'enregistrement du pr�fixe r�seau de l'h�te par le commutateur tandis que l'h�te enregistre en retour l'adresse finale aupr�s du commutateur. L'h�te y parvient en ajoutant un identificateur de syst�me (ESI/End System Identifier) et un octet s�lecteur nul au pr�fixe r�seau enregistr� par le commutateur. L'identificateur correspond � l'adresse physique ou MAC de l'interface ATM.

5.5. Configuration manuelle d'adresse

Si votre commutateur ne prend pas en charge ILMI, vous devez positionner manuellement l'adresse ATM au niveau du commutateur et de l'ordinateur. V�rifiez au pr�alable qu'ilmid est d�sactiv� et utilisez la commande atmaddr pour sp�cifier la ou les adresses.

Page de manuel�: atmaddr(8)

La configuration du commutateur d�pend de son mod�le. Par exemple, pour un Fore ASX-200�:

conf nsap route new adresse_nsap 152 port vpi

c'est-�-dire

conf nsap route new 47000580ffe1000000f21510650020ea000ee000 152 1a2 0
                    |<---- pr�fixe NSAP ---->||<--ESI--->|^^
                                                          SEL

La longueur de l'adresse NSAP compl�te doit toujours �tre de 40 chiffres hexad�cimaux. Il est possible d'employer des adresses avec un pr�fixe diff�rent et un ESI diff�rent de ceux des p�riph�riques. La valeur de l'octet de s�lection (SEL) est ignor�e.

5.6. Emploi de deux adaptateurs ATM directement connect�s

Il est �galement possible d'utiliser deux cartes ATM directement connect�es sans avoir besoin de commutateur. Ceci est tr�s pratique pour des environnements de test simples.

Un c�blage ad�quat est n�cessaire si vous employez du c�ble UTP ou STP-5. Nos essais avec des c�bles crois�s standard 100Base-T n'ont rien donn�. Le c�blage est diff�rent comme indiqu� sur la figure suivante�:

RJ45                            RJ45
   1        ------------        7
   2        ------------        8

   7        ------------        1
   8        ------------        2

Les broches 3, 4, 5, 6 ne sont pas connect�es.

Les couleurs aux extr�mit�s des connecteurs RJ45 permettent de mieux illustrer ce montage. Le premier connecteur utilise le c�blage ci-dessous�:

RJ45-1
   1 - marron
   2 - blanc/marron
   3 - non connect�
   4 - non connect�
   5 - non connect�
   6 - non connect�
   7 - orange
   8 - blanc/orange

Et le second connecteur le c�blage suivant�:

RJ45-2
   1 - orange
   2 - blanc/orange
   3 - non connect�
   4 - non connect�
   5 - non connect�
   6 - non connect�
   7 - marron
   8 - blanc/marron

Un c�blage 1 -- 7 et 2 -- 8 fournit une boucle des plus �conomiques.

On consid�rera par la suite deux machines nomm�es ��virgil�� et ��nestor��.

Une extr�mit� de la connexion ATM doit activer le d�mon r�seau atmsigd tandis que l'autre se sert de la version utilisateur usuelle. On ex�cute sur nestor la commande�:

atmsigd -b -m network

et sur virgil�:

atmsigd -b

ILMI n'est pas utilisable sans commutateur ATM. Cr�ez un fichier /etc/hosts.atm avec deux adresses bidon, par exemple�:

47.0005.80FFE1000000F21A26D8.0020EA000EE0.00    nestor-atm
47.0005.80FFE1000000F21A26D8.0020D4102A80.00    virgil-atm

Ces adresses sont compl�tement fantaisistes mais cela n'a pas grande importance tant qu'on n'est pas connect� � un r�seau ATM public ou priv�. Les adresses sont transmises aux gestionnaires de p�riph�riques via (sur virgil)�:

atmaddr -a virgil-atm

et (sur nestor)�:

atmaddr -a nestor-atm

D�marrez � pr�sent atmarpd sur les deux machines de la fa�on habituelle. Vous devriez (en principe) disposer d'un syst�me ATM op�rationnel. Pour activer IP au-dessus d'ATM, suivez les instructions donn�es � la section IP au-dessus d'ATM.

5.7. Analyseur-producteur de messages Q.2931

Le compilateur de messages Q.2931 g�n�re �galement un embellificateur pour les messages Q.2931. L'ex�cutable se nomme q.dump et se trouve dans le r�pertoire src/qgen. Notez que la commande make install ne le copiera nulle part.

q.dump attend une suite d'octets sous forme de chiffres hexad�cimaux s�par�s par des espaces sur l'entr�e standard et affiche la structure du message si celui-ci est analysable. Exemple�:

% echo 09 03 80 00 05 5A 80 00 06 08 80 00 02 81 83 00 48 \
  00 00 08 | ./q.dump
_pdsc = 9 "Q.2931 user-network call/connection control message"
_cr_len = 3
call_ref = 8388613 (0x800005)
msg_type = 0x5a "RELEASE COMPLETE"
_ext = 1
_flag = 0 "instruction field not significant"
_action_ind = 0 "clear call"
msg_len = 6 (0x6)
  _ie_id = 0x08 "Cause"
    _ext = 1
    cause_cs = 0 "ITU-T standardized"
    _flag = 0 "instruction field not significant"
    _action_ind = 0 "clear call"
    _ie_len = 2 (0x2)
      _ext = 1
      location = 1 "private network serving the local user"
      _ext = 1
      cause = 3 "no route to destination"

6.1. CLIP

Un d�mon g�re la g�n�ration et l'analyse des requ�tes ARP. Le noyau ne maintient qu'une petite table de recherche avec des informations partielles.

Pages de manuel�: atmarpd(8), atmarp(8)

atmsigd et ilmid doivent �tre d�marr�s avant atmarpd. Utilisez l'option -b pour �tre s�r que ces d�mons sont correctement synchronis�s. Par exemple�:

#!/bin/sh
atmsigd -b
ilmid -b
atmarpd -b
...

Le script suivant ne fonctionnera par contre que rarement�:

#!/bin/sh
atmsigd &
ilmid &
atmarpd &
...

atmarp permet de configurer ATMARP. Une fois atmsigd, ilmid et atmarpd d�marr�s, cr�ez une interface et configurez-la�:

# atmarp -c nom_interface
# ifconfig atm0 adresse_locale options_suppl�mentaires_�ventuelles up

Par exemple�:

# atmarp -c atm0
# ifconfig atm0 10.0.0.3 up

Dans le cas o� seuls des PVC sont employ�s, on peut les cr�er avec�:

# atmarp -s 10.0.0.4 0.0.70

L'encapsulation est de type NULL si le mot clef null est pass� en argument. Notez qu'ARP demande une encapsulation de type LLC/SNAP. Le type NULL est donc limit� aux PVC.

L'usage de SVC peut n�cessiter davantage de configuration. Si l'h�te joue le r�le de serveur ATMARP sur ce sous-r�seau IP logique (LIS, Logical IP Subnet), aucune autre op�ration n'est n�cessaire. Sinon, l'adresse ATM du serveur ARP doit �tre renseign�e. Ceci s'effectue en cr�ant une entr�e avec l'option arpsrv. Par exemple�:

# atmarp -s \
  10.0.0.0 47.0005.80.ffe100.0000.f215.1065.0020EA000756.00 \
  arpsrv

Le serveur ATMARP doit �tre op�rationnel en pr�alable � la configuration des clients.

La table ATMARP du noyau peut se lire via /proc/net/atm/arp. La table utilis�e par atmarpd est r�guli�rement affich�e sur la sortie standard lorsque le d�mon a �t� invoqu� avec l'option -d. Sans cette option de configuration, la table est �crite dans le fichier atmarpd.table du r�pertoire de sortie (par d�faut /var/run, modifiable avec l'option -D). La commande atmarp -a permet de la lire.

6.2. �mulation de LAN

Outre CLIP, LANE (Lan Emulation) convoie du trafic IP au-dessus d'ATM. LANE �mule le comportement d'un (ancien) r�seau local, par exemple dans son aspect diffusion des messages. Le serveur LANE est d�crit dans le fichier src/lane/USAGE du paquet linux-atm.

Pages de manuel�: bus(8), lecs(8), les(8) et zeppelin(8)

Si vous comptez utiliser plusieurs clients ou services LANE, chaque d�mon doit disposer de sa propre adresse ATM locale. Tous les d�mons emploient la m�me prise d'acc�s (SAP, Service Access Point) et la distinction entre connexions s'effectue donc avec les adresses ATM.

Tout comme CLIP, LANE se compose d'un processus d�mon en espace utilisateur, zeppelin, qui g�re le protocole LANE, et d'une partie noyau qui s'occupe du cache ARP LANE.

atmsigd et ilmid doivent �tre lanc�s avant zeppelin. Le noyau cr�e une nouvelle interface au d�marrage de zeppelin. Celle-ci peut alors �tre configur�e�:

# zeppelin options_suppl�mentaires_�ventuelles &
# ifconfig lec0 adresse_locale options_suppl�mentaires_�ventuelles up

Dans l'exemple suivant, deux clients LANE sont d�marr�s. Le premier client utilise l'interface par d�faut lec0, l'adresse d'�coute par d�faut et se connecte au pseudo-r�seau par d�faut. Le second client LANE se voit attribuer l'interface lec2, s'attache � l'adresse locale ma_machine3, essaie de joindre le pseudo-r�seau mon_r�seau et fait office de pont entre le pseudo-r�seau et le segment Ethernet. L'adresse ma_machine3 est sp�cifi�e dans le fichier /etc/hosts.atm. Le reste du fonctionnement du pont est d�crit dans le mini-HOWTO correspondant, [bridge-howto].

# zeppelin &
# ifconfig lec0 10.1.1.42 netmask 255.255.255.0 \
                          broadcast 10.1.1.255 up
#
# zeppelin -i 2 -l ma_machine3 -n mon_r�seau -p &
# ifconfig lec2 10.1.2.42 netmask 255.255.255.0 \
                          broadcast 10.1.2.255 up

zeppelin emploie l'interface lec0 par d�faut et s'attache � une adresse ATM dont l'octet de s�lection est � z�ro. Il essaie de contacter le LECS (LAN Emulation Configuration Server) � l'adresse standard et de joindre le pseudo-r�seau sp�cifi� par ce dernier. zeppelin utilise la MTU d�finie par le LES et n'agit pas en tant que proxy LEC (LAN Emulation Client). Ce param�trage est modifiable avec les options de ligne de commandes d�finies dans zeppelin(8).

zeppelin rejoint automatiquement tout pseudo-r�seau dont la MTU d�passe les 1516 octets de MTU par d�faut. La MTU de l'interface LANE s'ajuste en fonction de la MTU du pseudo-r�seau courant.

L'�tat du cache ARP LANE est accessible via le fichier /proc/net/atm/lec. Les adresses MAC, ATM et l'�tat de chaque entr�e sont affich�s. Les identifiants de connexion pour les enregistrement actifs sont �galement pr�sents.

Le service LANE (lecs(8), les(8) et bus(8)) se configure au moyen de fichiers. La syntaxe des fichiers de configuration est d�crite dans les pages de manuel respectives.

Une description plus d�taill�e des services LANE de Linux se trouve dans le m�moire d'�tudes de Marko Kiiskil� [kiis].

6.3. MPOA

Le client MPOA de Linux s'inscrit dans la tradition des services ATM divis�s en un d�mon utilisateur et un service noyau. Le d�mon mpcd traite les paquets de contr�le MPOA tandis que le noyau tient � jour les caches entrant et sortant et effectue le renvoi des paquets.

Page de manuel�: mpcd(8)

atmsigd et ilmid doivent �tre lanc�s avant mpcd. Puisque MPOA d�tecte les flux IP � partir du trafic LANE, zeppelin doit �tre d�marr� au pr�alable. L'ordre de lancement des d�mons zeppelin et mpcd n'est toutefois pas fix�. Ils peuvent �tre arr�t�s et red�marr�s ind�pendamment l'un de l'autre. La m�thode la plus simple pour d�sactiver MPOA consiste � envoyer un signal au d�mon mpcd.

Ci-dessous se trouve un exemple tir� de la section �mulation de LAN qui d�marre deux clients LANE. La configuration a �t� enrichie de deux clients MPOA aliment�s par les clients LANE�:

# zeppelin &
# ifconfig lec0 10.1.1.42 netmask 255.255.255.0 \
                          broadcast 10.1.1.255 up
# mpcd -s ma_machine1 -l ma_machine2 &
#
# zeppelin -i 2 -l ma_machine3 -n mon_r�seau -p &
# ifconfig lec2 10.1.2.42 netmask 255.255.255.0 \
                          broadcast 10.1.2.255 up
# mpcd -i 2 -s ma_machine4 -l ma_machine5 &

Le d�mon MPOA a besoin de deux adresses ATM locales qu'il emploie pour initialiser et recevoir les connexions de contr�le et de donn�es. Les adresses peuvent �tre les m�mes que pour zeppelin, par exemple, mais elles doivent diff�rer entre d�mons mpcd. Par d�faut, mpcd ne r�cup�re pas les informations de configuration du LECS. Les options de ligne de commande et un exemple d'emploi de LECS se trouvent dans la page de manuel de mpcd.

Le contenu des caches entrant et sortant de MPOA peut �tre contr�l� via le fichier /proc/net/atm/mpc.

Le client MPOA Linux accepte la classe de trafic CBR pour les SVC directs au lieu de la classe par d�faut UBR. La QoS des SVC � venir est modifiable par l'interm�diaire de /proc/net/atm/mpc.

# echo add 130.230.54.146 tx=80000,1600 rx=tx > /proc/net/atm/mpc
#             # cr�er assez de trafic pour d�clencher un raccourci
# cat /proc/net/atm/mpc 
QoS entries for shortcuts:
IP address
  TX:max_pcr pcr     min_pcr max_cdv max_sdu
  RX:max_pcr pcr     min_pcr max_cdv max_sdu
130.230.54.146  
     80000   0       0       0       1600   
     80000   0       0       0       1600   

Interface 2:

Ingress Entries:
IP address      State     Holding time  Packets fwded  VPI VCI
130.230.4.3     invalid   1160          0           
130.230.54.146  resolved  542           151            0   109
...

Le raccourci avec l'adresse IP 130.230.54.146 a �t� �tabli avec les param�tres ci-dessus. Des patches �tendent la d�tection de flux � un support complet de niveau�4. Les flux de niveau 4 sont exprim�s sous la forme d'un quintuplet (protocole, adresse locale, port local, adresse distance, port distant). Ils identifient des flux applicatifs.