Installation d'un noyau "2.4.3" � partir du noyau "2.2.17-21mdk"
Ce texte remplace le pr�c�dent du m�me auteur d�crivant l'installation d'un
noyau "2.4.2"
I - Introduction
Apr�s quelques essais de mise en jambes avec un noyau 2.4.2 j'ai lanc� la
proc�dure d'installation du noyau 2.4.3-5mdk en partant d'une distribution
Mandrake Power Pack 7.2 dot� du noyau "2.2.17-21mdk"
II - Avertissement
Contrairement � ce qui est dit dans de nombreux ouvrages sp�cialis�s
l'installation d'un noyau en parall�le � un noyau existant n'est pas une
proc�dure sans danger. Si chacun de ces noyaux va utiliser ses propres
modules plac�s dans "/lib/modules/le_noyau en_question" on ne peut en dire
autant des autres composants syst�mes qui eux restent des ressources
partag�es. J'en veux pour preuve quelques fichiers essentiels au boot d'un
noyau Linux :
- "fstab" qui d�crit les diff�rentes partitions et syst�mes de fichiers
� installer,
- "modules.conf" qui fournit des informations relatives aux modules �
installer,
- "auto.misc" qui fournit des informations relatives aux p�riph�riques �
monter.
Dans une proc�dure d'installation on est amen� � �diter chacun de ces
fichiers qui devront �tre compatibles avec tous les noyaux. "fstab" peut, de
plus, �tre modifi� par l'un des noyaux au moment du boot (voir commentaires
plus loin concernant le module "supermount"). Dans ce cas pr�cis les choses
qui marchaient avec le noyau initial ne seront pas forc�ment conserv�es si on
opte � nouveau pour ce noyau !
III - Pr�paration des op�rations / Pr�-�dition du fichier "lilo.conf"
Je suppose ici que LILO est le chargeur retenu. Je propose tout d'abord un
grand nettoyage de liens inutiles dans l'installation initiale pour apporter
une meilleure compr�hension � la lecture du fichier "lilo.conf". Ainsi pour
tous les noyaux propos�s, on remplace syst�matiquement les fichiers liens
propos�s par les fichiers r�ellement point�s. Par exemple pour le fichier
"vmlinuz" pointant vers le fichier "vmlinuz-2.2.17-21mdk" et bien on
pr�f�rera l'�criture suivante :
image=/boot/.../vmlinuz-2.2.17-21mdk
On fera la m�me chose pour les fichiers du type "*initrd.img". On pourra
aussi ajouter des lignes de commentaires. Voici un exemple de section
bootable :
# Section Linux 2.2.17-21mdk secure
image=/boot/vmlinuz-2.2.17-21mdksecure
label=linux-sec
root=/dev/hdb5
initrd=/boot/initrd-2.2.17-21mdksecure.img
vga=788
read-only
Notes :
- les lignes d�cal�es ont un caract�re TAB et pas d'espaces.
- "linux" est le nom du noyau boot� par d�faut. Cette option appara�t avec
une ast�risque "*" quand on ex�cute la commande :
$ lilo
Maintenant dans le dossier "/boot", m�me peine, m�me punition ! : on supprime
tous les liens d�sormais inutiles puisque plus jamais appel�s. Cette
op�ration bien faite ne doit conduire � aucun changement pour les noyaux
pr�install�s par la distribution. Un nouveau boot apr�s ex�cution de :
$ lilo
doit le prouver. Attention si une erreur appara�t ici c'est que le fichier
"lilo.conf" n'est pas correct. Il faudra alors le r�-�diter avant toute
intention de red�marrage, sinon c'est d�finitivement compromis.
Dans "/usr/src" on d�compacte le nouveau noyau qui va s'appeler � l'issue de
cette op�ration "linux". On le rebaptise "linux-2.4.3" et on cr�e un lien
d'un dossier "linux" vers le dossier "linux-2.4.3" en ex�cutant dans
"/usr/src" :
$ ln -s linux-2.4.3 linux
Voil� c'est pr�t. On peut d�sormais s'int�resser � la compilation.
IV - Installation du noyau et de ses modules
Tout ce qui est dit dans cette section se passe dans "linux".
a) Choix de l'application de pr�paration des param�tres du noyau
J'ai personnellement pr�f�r� l'utilitaire d'installation graphique qui se
lance avec "make xconfig". Il pr�pare un fichier ".config" n�cessaire �
l'installation du nouveau noyau qui implicitement se sauvegarde dans
"linux-2.4.3". A la fin des op�rations si tout s'est bien d�roul� on aura :
- dans "/lib/modules" : un nouveau dossier "2.4.3" avec tous les modules
n�cessaires au bon fonctionnement du noyau.
- dans "/boot" :
. un fichier "vmlinuz" pointant vers "vmlinuz-2.4.3",
. un fichier "System.map" pointant vers "System.map-2.4.3",
. et �ventuellement un fichier "initrd.img" (nom arbitrairement choisi par
l'utilisateur ; voir plus bas) pointant vers le fichier "initrd-2.4.3.img".
b) Options module "m" ou noyau "y"
Que choisir dans les propositions pour chaque option entre "y" et "m" ? : il
n'y a pas de r�gle puisque c'est une question de philosophie. Si le choix
d'une installation modulaire avec l'option "m" permet apr�s coup des mises �
jour par simple recompilation des sources de ces m�mes modules, cette option
s'av�re toujours plus d�licate dans sa mise en oeuvre au moment de la
compilation du noyau. Elle aura en g�n�ral un impact sur le fichier
"modules.conf" avec ajout d'une ligne du type :
alias char .... nom_du_module
sauf si l'option devfs est retenue car celle-ci tendrait � remplacer
l'approche "char device" apparaissant dans le fichier "modules.conf" (voir
plus bas). De plus, cerise sur le g�teau, ces lignes pour le noyau "2.4.3"
pourraient �tre diff�rentes de leurs �quivalentes pour le noyau
"2.2.17-21mdk".
Par bonheur, il semblerait que chacun puisse retrouver sans probl�me la ligne
qui le concerne parmi celles qui coexistent. De mon point de vue l'option "m"
autorise une bien meilleure compr�hension de ce qui est mis en oeuvre.
Avec l'option "y" le noyau int�gre directement sans aucune forme de proc�s
les parties n�cessaires � son bon fonctionnement.
C�t� rapidit� je ne ferai aucun commentaire sur l'impact de chacune des
options "y" ou "m" ignorant la r�ponse.
c) Quelques param�tres particuliers
Pour une premi�re installation (suppos�e ici), on ne peut pas b�n�ficier de
l'ancien fichier de configuration ".config" du noyau "2.2.17-21mdk". Il
s'agit donc l� d'un s�rieux handicap. En cons�quence, il faut �tre
relativement inspir� pour se positionner correctement pour chaque option pas
toujours explicite pour les d�butants. Si heureusement des options par d�faut
sont propos�es, elles ne sont pas n�cessairement judicieuses, et en outre
la configuration hardware n'est jamais prise en compte � ce niveau, ce qui est
tout � fait anomalique. Je conseille d'utiliser le fichier ".config" de
quelqu'un poss�dant une configuration semblable qui fonctionne. Le fichier de
d�part ".config" plac� dans le dossier "2.4.3", est �videmment pr�cieusement
conserv�.
i) CONFIG_MODVERSION
# CONFIG_MODVERSION is not set : tout ce qui est d�crit ci-dessous correspond
� ce choix.
ii) Power down
CONFIG_APM=y
# CONFIG_SPM is not set
Ces 2 options fixent d�finitivement le probl�me du Power down �teignant
l'ordinateur sur "arr�t".
Note :
- attention le seul choix de :
CONFIG_APM=y
(option d�crite par erreur comme seulement applicable aux portables) ne
suffit
pas car l'option :
CONFIG_SPM=y
l'annulerait !
iii) Impression
Si choix suivants :
CONFIG_PARPORT=m
CONFIG_PARPORT_PC=m
il faut modifier le fichier "modules.conf" ainsi :
alias parport_lowlevel parport_pc
options parport_pc io=0x378,0x278 irq=7,auto
car la ligne :
pre-install plip modprobe parport_pc ; echo 7 > /proc/parport/0/irq
ne fonctionne que pour le noyau "2.2.17-21mdk". On conservera cette ligne
pour ce m�me noyau jusqu'� son abandon d�finitif.
iv) Carte son PCI
CONFIG_SOUND=y
Si choix support OSS par exemple avec carte Soundblaster Live! PCI
CONFIG_SOUND_EMU10K1=m
CONFIG_SOUND_OSS=m
Le fichier "modules.conf" sera modifi� en suivant les recommandations du site
Lea.
Si choix support ALSA avec la m�me carte son
# CONFIG_SOUND_EMU10K1 is not set
CONFIG_SOUND_OSS=m
et compilation des supports ALSA et modification du fichier "modules.conf" en
suivant les recommandations du site Lea.
Note :
- Le hardware install� n'�tant pas pris en compte le fichier "misc" cr�� par
cette proc�dure dans le dossier "/lib/modules/2.4.3/..." contiendra tous les
modules des cartes support�es. Un grand m�nage de printemps s'imposera en
supprimant tout ce qui est inutile. Enfin je conseille de rebaptiser
ce dossier "alsa", noblesse oblige, puis de le d�placer dans le dossier
"sound" o� il aurait du �tre. Pas de soucis, il sera retrouv� !
v) Interface USB
CONFIG_USB=y
CONFIG_USB_UHCI_ALT=m
avec la ligne suivante dans le fichier "modules.conf" :
alias usb-interface usb-uhci
N'ayant pas de p�riph�rique connect� sur ce port, je n'en dirai pas plus.
vi) Support video
CONFIG_FB=y
CONFIG_DUMMY_CONSOLE=y
CONFIG_FB_VESA=y
CONFIG_FB_VGA16=y
CONFIG_VIDEO_SELECT=y
Avec carte graphique Voodo 3Dfx
CONFIG_FB_3DFX=m
CONFIG_FBCON_ADVANCED=y
CONFIG_FBCON_MFB=y
CONFIG_FBCON_CFB2=y
CONFIG_FBCON_CFB4=y
CONFIG_FBCON_CFB8=y
CONFIG_FBCON_CFB16=y
CONFIG_FBCON_CFB24=y
CONFIG_FBCON_CFB32=y
CONFIG_FBCON_VGA_PLANES=y
CONFIG_FBCON_VGA=y
CONFIG_FONT_8x8=y
CONFIG_FONT_8x16=y
Notes :
- Le module qui s'appelait "3dfx.o" dans le noyau "2.2.17-21mdk" s'appelle
d�sormais "tdfxfb.o" dans le noyau "2.4.3". On ajoutera donc la ligne
suivante
dans le fichier "modules.conf" :
alias char-major-107 tdfxfb
en laissant l'ancienne qui s'applique toujours au noyau "2.2.17-21mdk"
- Il est possible que parmi ces options certaines ne soient pas n�cessaires.
- L'option:
CONFIG_VIDEO_SELECT=y
permet entre autres dans le fichier "lilo.conf" de demander un mode graphique
avec "ask" (pas essay�).
vii) Support SCSI
CONFIG_SCSI=y
CONFIG_BLK_DEV_SD=y
CONFIG_SD_EXTRA_DEVS=40
CONFIG_BLK_DEV_SR=y
CONFIG_SD_EXTRA_DEVS=2
CONFIG_CHR_DEV_SG=m
CONFIG_SCSI_DEBUG_QUEUES=y
CONFIG_SCSI_MULTI_LUN=y
CONFIG_SCSI_CONSTANTS=y
Avec ma carte Tekram DC 395 UW/F le driver n'est pas fourni ! J'ai donc
parall�lement compil� un package charg� sur le site d'un d�veloppeur et j'ai
plac� le driver obtenu nomm� "dc395x_trm.o" dans "/lib/modules/2.4.3/../scsi".
Notes :
- Les lignes suivantes plac�es dans le fichier "modules.conf" :
alias block-major-11 scsi_hostadapter
alias scsi_hostadapter dc395x_trm
sont valables pour les 2 noyaux "2.2.17-21mdk" et "2.4.3".
D�sol� si �a fait un peu bricolage, mais �a marche avec, et pas sans, ou avec
le fichier du m�me nom du noyau "2.2.17-21mdk" recopi� !
- L'option :
CONFIG_CHR_DEV_SG=m
est vraisemblablement inutile car elle n'est pas rappel�e dans le fichier
"modules.conf" (� v�rifier).
viii) Support tun/tap pour pengaol (communication avec AOL)
CONFIG_TUN=m
avec ajout dans "modules.conf" de la ligne :
alias char-major-10-200 tun
Malheureusement l'interface de pengaol version 0.49 avec ce noyau ne
fonctionne pas ! (toujours en cours d'investigation).
ix) Support joystick connect� au port midi / joystick de la carte son PCI
J'ai enfin r�ussi � faire fonctionner mon joystick. Un article sp�cial sera
prochainement publi� sur ce point particulier.
x) Optimisation HD IDE avec DMA
Avec le noyau "2.2.17-21mdk" j'avais ajout� la s�quence suivante dans le
fichier "rc.local" situ� dans "/etc/rcd" :
# Optimization transfer speed on IDE HD (added on 23/04/2001)
echo 'Set high transfer mode for ide HD '
hdparm -c1 -d1 -k1 /dev/hda
hdparm -c1 -d1 -k1 /dev/hdb
# End Optimization transfer speed
Cela devient inutile avec le noyau "2.4.3" o� il suffit de choisir les
options suivantes :
CONFIG_BLK_DEV_IDEDMA_PCI=y
CONFIG_IDEDMA_PCI_AUTO=y
CONFIG_BLK_DEV_IDEDMA=y
Notes :
- La derni�re option doit �tre d�pendente des 2 autres car elle n'appara�t
pas comme s�lectionnable dans "make xconfig" !
- Si on laisse la s�quence d'optimisation des vitesses de transfert dans le
fichier "rc.local", on obtient une performance inf�rieure � celle ainsi
obtenue � travers la compilation du noyau "2.4.3" avec les nouveaux choix
(jusqu'� 15 Mb/sec).
xi) Protocole PPP
Si on opte pour les options suivantes :
CONFIG_PPP=m
CONFIG_PPP_MULTILINK=y
CONFIG_PPP_ASYNC=m
CONFIG_PPP_SYNC_TTY=m
CONFIG_PPP_DEFLATE=m
CONFIG_PPP_BSDCOMP=m
CONFIG_PPPOE=m
Il faut modifier le fichier "modules.conf" ainsi :
#ppp protocole
alias char-major-108 ppp_generic
alias /dev/ppp ppp_generic
alias tty-ldisc-3 ppp_async
alias tty-ldisc-14 ppp_synctty
alias ppp-compress-21 bsd_comp
alias ppp-compress-24 ppp_deflate
alias ppp-compress-26 ppp_deflate
Notes :
- Je n'ai pas trouv� les s�quences des protocoles slip et plip si l'option
"m" est retenue.
- Le module plip est utilis� pour le port parall�le.
xii) Supermount ou automount pour m�dia amovibles
Le module "supermount.o" n'existe pas dans le nouveau noyau "2.4.3". Aussi �
la premi�re compilation du noyau "2.4.3" le fichier "fstab" est modifi� avec
remplacement des lignes "supermount" par des lignes sans option "supermount"
pour d�sormais les 2 noyaux "2.2.17-21mdk" et "2.4.3" !
Sur recommandation d'une des personnes de la liste j'ai activ� l'option
"automount" avec choix des options suivantes :
# CONFIG_AUTOFS_FS is not set
CONFIG_AUTOFS4_FS=y
avec �dition en ce qui me concerne du fichier "auto.misc" situ� dans le
dossier "/etc" ainsi :
#installed on 06/05/2001
cdrom -fstype=iso9660,ro,nosuid,nodev :/dev/hdd
floppy -fstype=auto,nosuid,nodev :/dev/fd0
zip -fstype=auto,ro,nosuid,nodev :/dev/sdb4
Le fichier "mtab" situ� dans le dossier "/etc" est dynamiquement mis � jour
avec des lignes du type suivant toutes relatives au dossier "/misc" :
automount(pid429) /misc autofs rw,fd=8,pgrp=429,minproto=2,maxproto=4 0 0
/dev/sdb4 /misc/zip vfat ro,nosuid,nodev 0 0
/dev/hdd /misc/cdrom iso9660 ro,nosuid,nodev 0 0
/dev/fd0 /misc/floppy vfat rw,nosuid,nodev 0 0
cela en fonction des op�rations effectu�es par l'utilisateur.
Enfin pour un acc�s ais� � chaque m�dium j'ai modifi� les ic�nes de mon
bureau en rempla�ant les URL de type "/mnt/le_m�dium_en_question"
par "/misc/le_m�dium_en_question", compromettant ainsi les manipulations
sous noyau "2.2.17-21mdk"
Notes :
- Il ne faut jamais toucher au fichier "mtab".
- autofs4 est une version plus r�cente d'autofs.
- Les diff�rents m�dias deviennent aussi accessibles en ouvrant les dossiers
"/misc/cdrom", "/misc/zip" et /misc/floppy" et �videmment les dossiers de
m�me nom qui apparaissent sous "/mnt" sont inutilisables. On les conservera
en attendant des jours meilleurs !
- Pour retirer l'un de ces m�dia, 2 cas :
. Il est encours d'utilisation dans une fen�tre par exemple : op�ration
impossible sauf pour lecteur de disquettes de par son syst�me purement
m�canique.
. Il n'est pas en cours d'utilisation : faut alors attendre au moins une
minute pour le lecteur CDrom et Zip Iomega, ce qui est inexplicable !
xiii) Option Devfs
# CONFIG_DEVFS_FS is not set
Devfs est sens� � terme remplacer les "char devices" apparaissant dans le
fichier "modules.conf" si j'ai bien compris. Je n'ai pas choisi cette option.
xiv) Option SysVIPC
CONFIG_SYSVIPC=y
Pour le noyau 2.4.2 cette option avait �t� n�cessaire pour quelques
applications. J'ai ajout� la ligne suivante dans le fichier "fstab" :
none /dev/shm shm defaults 0 0
mais j'ai une ligne d'erreur au boot disant que "/dev/shm" n'existe pas (en
cours d'investigation)
Je pense inutile d'aller plus dans le d�tail car la lecture d'un fichier
".config" d'une installation r�ussie est beaucoup plus riche d'enseignement.
En fin de param�trage l'option "Save and Exit" cr�e le fameux fichier
".config" ou le met � jour.
d) Utilisation d'un script pour l'installation
Pour une op�ration it�rative (voir plus bas) l'utilisation d'un script
regroupant les commandes importantes est conseill�. Chez moi le script
s'appelle "Install_kernel". Il est plac� dans le dossier "linux-2.4.3" comme
le fichier ".config", le voici :
#!/bin/bash
#
# Ce script se lance dans le source du noyau � installer en mode root
#
echo Phase de nettoyage
make dep && make clean
echo Phase de compilation
make bzImage && make modules && make modules_install
echo Phase installation noyau
# make install
echo Phase initrd
# mkinitrd -f -v /boot/initrd-2.4.2.img 2.4.2
Notes :
- Je n'ai pas inclus les 2 derni�res lignes dans le script car je fais une
op�ration manuelle de mise � jour du module SCSI et des modules ALSA avant
l'ex�cution de ces commandes (voir plus bas).
- Je pense qu'il est possible ex�cuter la commande "make install" avant
changement quelconque dans "/lib/modules/2.4.3/..." (non encore v�rifi�).
Apr�s ex�cution de ce script avec la commande :
$ ./install_kernel
on retrouve :
- un dossier "2.4.3" dans "/lib/modules" contenant les modules,
- les fichiers "vmlinuz" et "vmlinuz-2.4.3", le premier pointant vers le
second, et les fichiers "System.map" et "System.map2.4.3" le premier pointant
vers le second dans "/boot".
Note :
- Le fichier "System.map" se remet automatiquement � jour pour pointer sur le
bon fichier au boot d'un noyau donn�, l'ancien noyau "2.2.17-21mdk" par
exemple.
V - Fichier "initrd*.img" dans le dossier "/boot"
Tout au d�but de la proc�dure de boot on peut choisir de stocker en ram les
modules n�cessaires pour le syst�me de fichiers de la partition root (drivers
de la carte SCSI, modules du syst�me de fichiers, etc.). Pour cela on utilise
la commande :
mkinitrd -f -v initrd-2.4.3.img 2.4.3
en �tant plac� dans "/boot"
ou :
mkinitrd -f -v /boot/initrd-2.4.3.img 2.4.3
Notes :
- Le premier nom "initrd-2.4.3.img" est arbitraire alors que le second est
impos�.
- Cette commande utilise les fichiers "modules.conf", "fstab" et "mtab" pour
y lire des information relatives aux syst�mes de fichiers et au support SCSI.
- Cette commande a un impact sur le fichier "lilo.conf" (voir plus bas).
- J'ai pu booter avec ou sans un fichier "*.img" au moins chez moi
avec les options choisies dans ".config" contrairement � ce qui a �t� dit
pour le noyau "2.4.2". Il serait bon de clarifier d�finitivement l'int�r�t
d'une telle option toujours pas tr�s claire dans mon esprit.
VI - �dition fichier "lilo.conf"
Pour pouvoir choisir ce nouveau noyau au moment du boot il faut ajouter la
nouvelle section suivante :
# Section noyau Linux-2.4.3
image=/boot/vmlinuz
label=linux-2.4.3
root=/dev/hdb5
initrd=/boot/initrd-2.4.3.img
vga=788
read-only
Puis ex�cuter :
$ lilo
Notes :
- La ligne "label=linux-2.4.3" affiche le nom du noyau dans les choix.
- La ligne "linitrd=/boot/initrd-2.4.3.img" fournit le chemin pour charger le
fichier "initrd-2.4.3.img" en ram.
- La ligne "vga=788" doit �tre en relation avec l'option :
CONFIG_VIDEO_SELECT=y
et il doit �tre possible de remplacer "788" par "ask" pour un choix
interactif. Encore faut-il savoir quoi r�pondre !
VII - Processus de compilation it�ratif
On peut affiner la construction du noyau "2.4.3" dans un processus it�ratif
de par les choix faits au niveau des divers liens. On proc�dera ainsi :
- dans le dossier "/usr/src/" on cr�e une copie du fichier "linux-2.4.3" en
"linux-2.4.3_commentaire" pour le conserver. Il contient donc les
fichiers ".config" et "install_kernel" qui vont servir � la compilation.
- dans le dossier "/lib/modules" on cr�e une copie du fichier "2.4.3" en
"2.4.3_commentaire" pour pouvoir revenir en arri�re.
- dans le dossier "/boot"on rebaptise les fichiers "vmlinuz-2.4.3",
"initrd-2.4.3.img" et "System.map-2.4.3" respectivement en
"vmlinuz-2.4.3_commentaire", "initrd-2.4.3.img_commentaire" et
"System.map-2.4.3_commentaire".
o� "commentaire" est un texte court du type "noprinter" si par exemple
l'impression est impossible.
On peur relancer la compilation avec la m�me proc�dure. Les compilations
ult�rieures auront �videmment lieu sous le noyau "2.4.3" (de plus en plus
fort !). Apr�s ex�cution du script "install_kernel" on fait directement les
mise � jour de "/lib/modules/2.4.3" par copie des ajouts d�j� faits dans le
dossier "/lib/modules/2.4.3"_commentaire" pour gagner du temps. Il n'est donc
plus n�cessaire par exemple de recompiler les modules ajout�s comme ALSA. De
m�me il n'est plus n�cessaire de mettre � jour LILO qui pointe toujours vers
les derniers �l�ments du dossier "/boot" cr��s, de par la m�thode choisie.
Note :
- Avec le noyau "2.4.2" la commande "mkinitrd" plantait ! Aucun probl�me ici.
VIII - Conclusions
Ce qui est au-dessus r�sume l'ensemble des op�rations d'installation du noyau
"2.4.3" r�alis�es ces jours derniers. Je suis toujours convaincu qu'une telle
proc�dure qui vise � d�crire manuellement les composants du syst�me est
absurde et manque indubitablement de pragmatisme. Une description pr�alable
du mat�riel mettant automatiquement � jour certains param�tres du fichier
".config" serait bien accueillie.
Vos commentaires constructifs seront �videmment appr�ci�s.
--
Daniel Moyne (ARMada French fan Club)
Software : Mandrake Power Pack 7.2 w/kernel 2.2.17-21mdk et 2.4.3 being tested
Hardware : PC Celeron 400 Mhz 128 Mo Ram Lecteur CD 40X Ide
Carte graphique AGP 3Dfx Lecteur Zip Iomega SCSI
HD Ide (M) 4 Go + (S) 20 Go \\|// Modem OLITEC Speed Voice 56000
Carte SCSI Tekram DC-395UW / --- \ Imprimante DeskJet HP 850C
Vision Master 17" Iiyama Monitor (' o-o ') Scanner UMAX Astra 1220S SCSI
--------------------------------oOO-(_)-OOo------------------------------------
