Attachment 23459 Details for Bug 36917 – hb-working-rcscripts.xml

hb-working-rcscripts.xml

hb-working-rcscripts.xml (text/plain), 18.53 KB, created by Xavier Neys (RETIRED) on 2004-01-09 05:40:26 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Xavier Neys (RETIRED)

Created: 2004-01-09 05:40:26 UTC

Size: 18.53 KB

patch

obsolete

><?xml version='1.0' encoding='UTF-8'?>
><!DOCTYPE sections SYSTEM "/dtd/book.dtd">
>
>
>
>
>
>
><sections>
><section>
><title>Les runlevels</title>
><subsection>
><title>DÃ©marrer votre systÃ¨me</title>
><body>
>
>
>Quand vous dÃ©marrez votre systÃ¨me, vous voyez pas mal de texte dÃ©filer sur
>votre Ã©cran. Vous remarquerez aussi que ce texte est le mÃªme Ã  chaque
>dÃ©marrage. La sÃ©quence d'actions qui se dÃ©roule devant vos yeux s'appelle la
><e>sÃ©quence de dÃ©marrage</e> et elle est dÃ©finie de faÃ§on plus ou moins
>statique.
>
>
>
>D'abord, votre chargeur de dÃ©marrage charge l'image du noyau que vous avez
>dÃ©finie dans son fichier de configuration et ensuite, il exÃ©cute ce noyau. Ce
>dernier s'initialise, dÃ©marre les tÃ¢ches spÃ©cifiques au noyau et lance le
>processus <c>init</c>.
>
>
>
>Ce processus monte les systÃ¨mes de fichiers dÃ©finis dans
><path>/etc/fstab</path> et exÃ©cute quelques scripts placÃ©s dans le rÃ©pertoire
><path>/etc/init.d</path> qui, Ã  leur tour, dÃ©marrent les services nÃ©cessaires
>au bon fonctionnement du systÃ¨me.
>
>
>
>Finalement, quand tous les scripts ont Ã©tÃ© exÃ©cutÃ©s, <c>init</c> active les
>terminaux (en gÃ©nÃ©ral, les consoles virtuelles que vous obtenez avec les
>touches <c>Alt-F1</c>, <c>Alt-F2</c>, etc.) et attache un processus appelÃ©
><c>agetty</c> Ã  chacun. Ce processus vous permet de vous identifier sur ces
>terminaux avec <c>login</c>.
>
>
></body>
></subsection>
><subsection>
><title>Les scripts d'initialisation</title>
><body>
>
>
>En fait, <c>init</c> n'exÃ©cute pas les scripts du rÃ©pertoire
><path>/etc/init.d</path> n'importe comment. De plus, il n'exÃ©cute pas non plus
>tous les scripts, mais seulement ceux qui doivent l'Ãªtre. Les scripts Ã 
>exÃ©cuter sont dÃ©finis dans <path>/etc/runlevels</path>.
>
>
>
>Le processus <c>init</c> exÃ©cute d'abord les scripts de
><path>/etc/init.d</path> vers lesquels un lien symbolique existe dans
><path>/etc/runlevels/boot</path>. Les scripts sont gÃ©nÃ©ralement exÃ©cutÃ©s par
>ordre alphabÃ©tique, mais certains contiennent des dÃ©pendances qui indiquent
>quels scripts doivent d'abord Ãªtre exÃ©cutÃ©s.
>
>
>
>Quand tous les scripts liÃ©s dans <path>/etc/runlevels/boot</path> ont Ã©tÃ©
>exÃ©cutÃ©s, <c>init</c> poursuit avec ceux liÃ©s dans
><path>/etc/runlevels/default</path>. Ici aussi, les scripts sont gÃ©nÃ©ralement
>exÃ©cutÃ©s par ordre alphabÃ©tique, sauf quand ils contiennent des informations
>sur des dÃ©pendances qui spÃ©cifient une sÃ©quence d'exÃ©cution correcte.
>
>
></body>
></subsection>
><subsection>
><title>Comment init fonctionne-t-il ?</title>
><body>
>
>
>Ãvidemment, <c>init</c> ne dÃ©cide pas tout seul de ce qu'il doit faire. Il a
>besoin d'un fichier de configuration qui lui indique quelles actions il doit
>effectuer. Ce fichier est <path>/etc/inittab</path>.
>
>
>
>Dans la sÃ©quence de dÃ©marrage que nous venons d'expliquer, nous avons dit que
>la premiÃ¨re action de <c>init</c> Ã©tait de monter les systÃ¨mes de fichiers. La
>ligne du fichier <path>/etc/inittab</path> qui provoque cela est la
>suivante&nbsp;:
>
>
><pre caption="La ligne d'initialisation du systÃ¨me dans /etc/inittab">
>si::sysinit:/sbin/rc sysinit
></pre>
>
>
>En fait, cette ligne indique Ã  <c>init</c> qu'il doit exÃ©cuter <c>/sbin/rc
>sysinit</c> pour initialiser le systÃ¨me. C'est le script <path>/sbin/rc</path>
>qui fait vraiment le travail d'initialisation et pas <c>init</c> qui ne fait
>que dÃ©lÃ©guer les tÃ¢ches.
>
>
>
>Ensuite, <c>init</c> exÃ©cute tous les scripts vers lesquels un lien symbolique
>est dÃ©fini dans <path>/etc/runlevels/boot</path>. La ligne suivante provoque
>cela&nbsp;:
>
>
><pre caption="L'initialisation du systÃ¨me, suite">
>rc::bootwait:/sbin/rc boot
></pre>
>
>
>Encore une fois, le script <c>rc</c> fait le travail. Remarquez que l'option
><e>boot</e> passÃ©e au script <c>rc</c> correspond au nom du sous-rÃ©pertoire qui
>se trouve dans <path>/etc/runlevels</path>.
>
>
>
>Ensuite, <c>init</c> lit son fichier de configuration pour savoir quel
><e>runlevel</e> il doit exÃ©cuter (NdT: un Â«runlevelÂ», ou niveau d'exÃ©cution,
>correspond Ã  l'Ã©tat dans lequel il faut amener la machine). La ligne suivante
>dÃ©finit le runlevel&nbsp;:
>
>
><pre caption="La ligne initdefault">
>id:3:initdefault:
></pre>
>
>
>Dans ce cas (la majoritÃ© des utilisateurs de Gentoo sont dans ce cas), le
><e>runlevel</e> a le numÃ©ro 3. Avec ce numÃ©ro, <c>init</c> trouve ce qu'il doit
>exÃ©cuter pour lancer le <e>runlevel 3</e>&nbsp;:
>
>
><pre caption="Les dÃ©finitions des runlevels">
>l0:0:wait:/sbin/rc shutdown
>l1:S1:wait:/sbin/rc single
>l2:2:wait:/sbin/rc nonetwork
>l3:3:wait:/sbin/rc default
>l4:4:wait:/sbin/rc default
>l5:5:wait:/sbin/rc default
>l6:6:wait:/sbin/rc reboot
></pre>
>
>
>La ligne qui dÃ©finit le niveau 3 utilise Ã  nouveau le script <c>rc</c> pour
>dÃ©marrer les services, cette fois avec le paramÃ¨tre <e>default</e>. Remarquez
>que, encore une fois, le paramÃ¨tre correspond au nom du sous-rÃ©pertoire dans
><path>/etc/runlevels</path>.
>
>
>
>Quand le script <c>rc</c> a terminÃ©, <c>init</c> trouve la liste des consoles
>virtuelles Ã  activer et quelles commandes il doit utiliser dans son fichier de
>configuration&nbsp;:
>
>
><pre caption="La dÃ©finition des consoles virtuelles">
>c1:12345:respawn:/sbin/agetty 38400 tty1 linux
>c2:12345:respawn:/sbin/agetty 38400 tty2 linux
>c3:12345:respawn:/sbin/agetty 38400 tty3 linux
>c4:12345:respawn:/sbin/agetty 38400 tty4 linux
>c5:12345:respawn:/sbin/agetty 38400 tty5 linux
>c6:12345:respawn:/sbin/agetty 38400 tty6 linux
></pre>
>
>
></body>
></subsection>
><subsection>
><title>Qu'est-ce qu'un runlevel ?</title>
><body>
>
>
>Vous avez constatÃ© que <c>init</c> numÃ©rote les <e>runlevels</e> qu'il doit
>activer. Un <e>runlevel</e> dÃ©finit un Ã©tat dans lequel votre systÃ¨me se trouve
>et contient les scripts nÃ©cessaires pour entrer dans ou quitter cet Ã©tat.
>
>
>
>Dans Gentoo, sept <e>runlevels</e> sont dÃ©finis&nbsp;:trois internes et quatre
>dÃ©finis par l'utilisateur. Les runlevels internes sont <e>sysinit</e>,
><e>shutdown</e> et <e>reboot</e> et sont utilisÃ©s respectivement pour
>initialiser, Ã©teindre et redÃ©marrer le systÃ¨me.
>
>
>
>Les runlevels dÃ©finis par l'utilisateur sont ceux qui correspondent Ã  un
>sous-rÃ©pertoire dans <path>/etc/runlevels</path>&nbsp;: <path>boot</path>,
><path>default</path>, <path>nonetwork</path> et <path>single</path>. Le
>runlevel <path>boot</path> est utilisÃ© pour dÃ©marrer tous les services systÃ¨me
>utilisÃ©s par les autres runlevels. Les autres runlevels se diffÃ©rencient par
>les services qu'ils activent&nbsp;: <path>default</path> est utilisÃ© en temps
>normal, <path>nonetwork</path> est utilisÃ© quand aucune connexion rÃ©seau n'est
>souhaitÃ©e et <path>single</path> est utilisÃ© quand des problÃ¨mes du systÃ¨me
>doivent Ãªtre rÃ©solus.
>
>
></body>
></subsection>
><subsection>
><title>Utiliser les scripts d'initialisation</title>
><body>
>
>
>Les scripts que <c>rc</c> exÃ©cute sont appelÃ©s des <e>scripts
>d'initialisation</e>. Chaque script peut Ãªtre exÃ©cutÃ© avec les options
><e>start</e>, <e>stop</e>, <e>restart</e>, <e>pause</e>, <e>zap</e>,
><e>status</e>, <e>ineed</e>, <e>iuse</e>, <e>needsme</e>, <e>usesme</e> ou
><e>broken</e>.
>
>
>
>Pour dÃ©marrer, arrÃªter ou relancer un service (et les autres services
>nÃ©cessaires Ã©ventuels), utilisez <c>start</c>, <c>stop</c> et <c>restart</c>.
>
>
><pre caption="DÃ©marrer postfix">
># /etc/init.d/postfix start
></pre>
>
><note>
>Seuls les services qui ont <e>besoin</e> du service spÃ©cifiÃ© sont arrÃªtÃ©s ou
>redÃ©marrÃ©s. Les autres services qui l'<e>utilisent</e> ne sont pas affectÃ©s.
></note>
>
>
>Pour stopper un service sans toucher aux services qui l'utilisent, utilisez
>l'option <c>pause</c>&nbsp;:
>
>
><pre caption="Stopper postfix sans toucher aux services qui l'utilisent">
># /etc/init.d/postfix pause
></pre>
>
>
>Pour afficher le statut d'un service (dÃ©marrÃ©, arrÃªtÃ©, en pause), utilisez
>l'option <c>status</c>&nbsp;:
>
>
><pre caption="Afficher le statut du service postfix">
># /etc/init.d/postfix status
></pre>
>
>
>Si le systÃ¨me vous affiche qu'un service est actif, mais que vous savez qu'il
>ne l'est pas, utilisez l'option <c>zap</c> pour rÃ©initialiser son statut Ã 
>Â«arrÃªtÃ©Â».
>
>
><pre caption="RÃ©initialiser le statut de postfix">
># /etc/init.d/postfix zap
></pre>
>
>
>Vous pouvez aussi faire afficher les services dont un service a besoin avec les
>options <c>iuse</c> ou <c>ineed</c>. Avec l'option <c>ineed</c>, les services
>rÃ©ellement nÃ©cessaires sont affichÃ©s, mais, avec <c>iuse</c>, les services qui
>peuvent Ãªtre utilisÃ©s sans Ãªtre indispensables sont affichÃ©s.
>
>
><pre caption="Afficher la liste des services dont Postfix a besoin">
># /etc/init.d/postfix ineed
></pre>
>
>
>De la mÃªme faÃ§on, vous pouvez faire afficher la liste des services qui ont
>besoin (<c>needsme</c>) ou qui utilisent (<c>usesme</c>) un service
>particulier&nbsp;:
>
>
><pre caption="Afficher la liste des services qui ont besoin de Postfix">
># /etc/init.d/postfix needsme
></pre>
>
>
>Enfin, vous pouvez aussi demander la liste des services requis qui
>manquent&nbsp;:
>
>
><pre caption="Afficher la liste des services manquants dont Postfix a besoin">
># /etc/init.d/postfix broken
></pre>
>
></body>
></subsection>
></section>
><section>
><title>Utiliser rc-update</title>
><subsection>
><title>Qu'est-ce que rc-update ?</title>
><body>
>
>
>Gentoo construit un arbre de dÃ©pendances pour dÃ©terminer l'ordre d'exÃ©cution
>des services. Cela est loin d'Ãªtre trivial et nous avons donc crÃ©Ã© des outils
>qui facilitent l'administration des runlevels et des scripts d'initialisation.
>
>
>
>La commande <c>rc-update</c> permet d'ajouter ou d'enlever un script d'un
>runlevel. Cette commande utilise automatiquement le script <c>depscan.sh</c>
>qui reconstruit l'arbre des dÃ©pendances.
>
>
></body>
></subsection>
><subsection>
><title>Ajouter et enlever des services</title>
><body>
>
>
>Vous avez dÃ©jÃ  ajoutÃ© des scripts d'initialisation au runlevel "default"
>pendant l'installation de Gentoo. Vous ignoriez alors la signification de
>"default", mais maintenant, vous savez. Le script <c>rc-update</c> a besoin
>d'un second argument qui spÃ©cifie l'action Ã  effectuer&nbsp;: <e>add</e>,
><e>del</e> ou <e>show</e> pour respectivement ajouter, supprimer ou afficher.
>
>
>
>Pour ajouter ou supprimer un service, ajoutez simplement <c>add</c> ou
><c>del</c> Ã  la commande <c>rc-update</c> et spÃ©cifiez ensuite le nom du script
>d'initialisation et le runlevel. Par exemple&nbsp;:
>
>
><pre caption="Ajouter Postfix au runlevel Â«defaultÂ»">
># rc-update del postfix default
></pre>
>
>
>La commande <c>rc-update show</c> affiche la liste des scripts d'initialisation
>disponibles et les runlevels dans lesquels ils ont Ã©tÃ© ajoutÃ©s&nbsp;:
>
>
><pre caption="Afficher la liste des scripts d'initialisation">
># rc-update show
></pre>
>
></body>
></subsection>
></section>
><section>
><title>Configurer les services</title>
><subsection>
><title>Pourquoi encore configurer ?</title>
><body>
>
>
>Les scripts d'initialisation peuvent Ãªtre complexes. Il vaut donc mieux Ã©viter
>que les utilisateurs ne doivent les modifier et Ã©viter ainsi bien des
>problÃ¨mes. Cependant, les services ont parfois besoin d'Ãªtre configurÃ©s ou de
>recevoir certaines options.
>
>
>
>Une autre raison pour sÃ©parer les scripts de leur configuration est de pouvoir
>les mettre Ã  jour sans modifier votre configuration.
>
>
></body>
></subsection>
><subsection>
><title>Le rÃ©pertoire /etc/conf.d</title>
><body>
>
>
>Gentoo offre un systÃ¨me facile pour configurer les services. Chaque script
>d'initialisation qui peut Ãªtre configurÃ© a un fichier de configuration dans le
>rÃ©pertoire <path>/etc/conf.d</path>. Par exemple, le script d'initialisation
>d'apache2 (<path>/etc/init.d/apache2</path>) a un fichier de configuration
><path>/etc/conf.d/apache2</path> qui contient les options Ã  passer au serveur
>Apache&nbsp;2 quand il est lancÃ©.
>
>
><pre caption="Variables dÃ©finies dans /etc/conf.d/apache2">
>APACHE2_OPTS="-D PHP4"
></pre>
>
>
>Un tel fichier de configuration ne contient <e>que</e> des dÃ©finitions de
>variables (tout comme <path>/etc/make.conf</path>), ce qui permet de configurer
>facilement un service. Cela permet aussi de fournir des explications sur ces
>options sous forme de commentaires.
>
>
></body>
></subsection>
></section>
><section>
><title>Ãcrire un script d'initialisation</title>
><subsection>
><title>Dois-je faire cela ?</title>
><body>
>
>
>Non. RÃ©diger un tel script d'initialisation n'est gÃ©nÃ©ralement pas nÃ©cessaire
>puisque Gentoo fournit des scripts complets pour tous les services supportÃ©s.
>Cependant, si vous avez installÃ© un service sans l'aide de Portage, vous devrez
>sans doute en Ã©crire un.
>
>
>
>N'utilisez pas le script fourni avec le logiciel Ã  moins qu'il ne soit Ã©crit
>spÃ©cifiquement pour Gentoo, car les scripts d'initialisation de Gentoo ne sont
>pas compatibles avec ceux des autres distributions.
>
>
></body>
></subsection>
><subsection>
><title>Structure</title>
><body>
>
>
>La structure de base d'un script d'initialisation est dÃ©crite ci-dessous.
>
>
><pre caption="Structure de base d'un script d'initialisation">
>#!/sbin/runscript
>
>depend() {
> <comment>(Information sur les dÃ©pendances)</comment>
>}
>
>start() {
> <comment>(Commandes Ã  exÃ©cuter pour dÃ©marrer le service)</comment>
>}
>
>stop() {
> <comment>(Commandes Ã  exÃ©cuter pour arrÃªter le service)</comment>
>}
>
>restart() {
> <comment>(Commandes Ã  exÃ©cuter pour redÃ©marrer le service)</comment>
>}
></pre>
>
>
>La partie <c>start()</c> est <e>indispensable</e>, les autres sont
>facultatives.
>
>
></body>
></subsection>
><subsection>
><title>DÃ©pendances</title>
><body>
>
>
>Il existe deux types de dÃ©pendances&nbsp;: <c>use</c> et <c>need</c>. Comme
>mentionnÃ© prÃ©cÃ©demment, la dÃ©pendance <c>need</c> est plus stricte que
><c>use</c>. Vous devez faire suivre le type de dÃ©pendance par le nom du service
>dont votre service dÃ©pend, ou par une dÃ©pendance <e>virtuelle</e>.
>
>
>
>Une dÃ©pendance <e>virtuelle</e> est une mÃªme dÃ©pendance fournie par plusieurs
>services diffÃ©rents. Par exemple, votre service pourrait dÃ©pendre du systÃ¨me de
>log qui peut Ãªtre fourni par plusieurs services diffÃ©rents (metalogd,
>syslog-ng, sysklogd...) Ãtant donnÃ© que votre service ne peut pas dÃ©pendre de
>tous ces services (on ne peut installer qu'un seul systÃ¨me de log), nous avons
>dÃ©fini une seule dÃ©pendance virtuelle que chacun de ces services fournit.
>
>
>
>Jetons un Åil aux dÃ©pendances du service postfix.
>
>
><pre caption="DÃ©pendances de Postfix">
>depend() {
> need net
> use logger dns
> provide mta
>}
></pre>
>
>
>Comme vous pouvez le voir, postfix :
>
>
><ul>
> <li>
> a besoin de la dÃ©pendance virtuelle <c>net</c> qui est fournie par
> <path>/etc/init.d/net.eth0</path>, par exemple&nbsp;;
> </li>
> <li>
> utilise un systÃ¨me de log (dÃ©pendance virtuelle <c>logger</c>) qui est
> foruni par <path>/etc/init.d/syslog-ng</path>, par exemple&nbsp;;
> </li>
> <li>
> utilise le service (virtuel) <c>dns</c> qui est fourni par
> <path>/etc/init.d/named</path>, par exemple&nbsp;;
> </li>
> <li>
> fournit le service virtuel <c>mta</c> qui indique qu'un serveur de courrier
> est disponible.
> </li>
></ul>
>
></body>
></subsection>
><subsection>
><title>Ordonner la sÃ©quence d'exÃ©cution</title>
><body>
>
>
>Dans certains cas, vous voudrez peut-Ãªtre dÃ©marrer un service avant ou aprÃ¨s un
>autre, pout autant que cet autre service soit disponible. Notez qu'il ne s'agit
>plus d'une dÃ©pendance, mais simplement d'une demande de lancement de services
>dans un ordre dÃ©fini au sein d'un mÃªme runlevel. Pour dÃ©finir une sÃ©quence
>d'exÃ©cution, utilisez les mots-clefs <c>before</c> ou <c>after</c>.
>
>
>
>Voyez, par exemple, le service portmap&nbsp;:
>
>
><pre caption="La fonction depend() du service Portmap">
>depend() {
> need net
> before inetd
> before xinetd
>}
></pre>
>
>
>Vous pouvez aussi remplacez le nom de service par une Ã©toile ("*") pour
>spÃ©cifier tous les services d'un runlevel, mais cela n'est pas recommandÃ©.
>
>
><pre caption="Lancer un script avant tous les autres dans un runlevel">
>depend() {
> before *
>}
></pre>
>
></body>
></subsection>
><subsection>
><title>Fonctions standard</title>
><body>
>
>
>En plus de la fonction <c>depend()</c>, vous devez dÃ©finir la fonction
><c>start()</c> qui doit contenir les commandes nÃ©cessaires pour activer le
>service. Il est conseillÃ© d'utiliser les fonctions <c>ebegin</c> et <c>eend</c>
>pour afficher des messages Ã  l'Ã©cran et ainsi informer l'utilisateur que le
>service dÃ©marre.
>
>
><pre caption="Exemple de fonction start()">
>start() {
> ebegin "Gentoo dÃ©marre le_service"
> start-stop-daemon --start --quiet --exec /chemin/vers/le_service
> eend $?
>}
></pre>
>
>
>Vous trouverez plus d'exemples de fonctions <c>start()</c> dans les scripts
>d'initialisation qui se trouvent dans le rÃ©pertoire <path>/etc/init.d</path>.
>La commande <c>start-stop-daemon</c> est documentÃ©e sous la forme d'une page
>man&nbsp;:
>
>
><pre caption="Afficher l'aide de la commande start-stop-daemon">
># man start-stop-daemon
></pre>
>
>
>Vous pouvez aussi dÃ©finir les fonctions facultatives <c>stop()</c> et
><c>restart()</c> pour respectivement arrÃªter et relancer un service, mais
>Gentoo est capable de s'en passer si vous avez utilisÃ© la commande
><c>start-stop-daemon</c>.
>
>
></body>
></subsection>
><subsection>
><title>Ajouter un option non prÃ©vue</title>
><body>
>
>
>Si vous voulez utiliser une option non prÃ©vue par nos scripts, vous devez
>l'ajouter Ã  la variable <c>opts</c> et crÃ©er un fonction qui a le mÃªme nom. Par
>exemple, pour ajouter une option <c>restartdelay</c>&nbsp;:
>
>
><pre caption="Ajouter une option restartdelay">
>opts="${opts} restartdelay"
>
>restartdelay() {
> stop()
> sleep 3 <comment># Temporisation de 3 secondes</comment>
> start()
>}
></pre>
>
></body>
></subsection>
><subsection>
><title>Variables de configuration d'un service</title>
><body>
>
>
>Vous ne devez rien faire de particulier pour utiliser un fichier de
>configuration dans <path>/etc/conf.d</path>&nbsp;: avant que votre script
>d'initalisation ne soit exÃ©cutÃ©, les variables des fichiers suivants sont
>initialisÃ©es dans cet ordre&nbsp;:
>
>
><ul>
> <li><path>/etc/conf.d/&lt;votre_script&gt;</path></li>
> <li><path>/etc/conf.d/basic</path></li>
> <li><path>/etc/rc.conf</path></li>
></ul>
>
>
>De plus, si votre script fournit une dÃ©pendance virtuelle (comme <c>net</c>),
>le fichier de configuration correspondant (comme <path>/etc/conf.d/net</path>)
>sera Ã©galement lu.
>
>
></body>
></subsection>
></section>
></sections>

Actions: View

Attachments on bug 36917: 22921 | 22922 | 22923 | 22924 | 22925 | 22927 | 22928 | 22936 | 22938 | 23063 | 23067 | 23070 | 23072 | 23078 | 23079 | 23117 | 23270 | 23271 | 23273 | 23391 | 23392 | 23429 | 23458 | 23459