NOM

update-rc.d - Installer ou supprimer les liens vers les scripts d'initialisation de type Système V

SYNOPSIS

update-rc.d [-f] nom remove
 
update-rc.d nom defaults
 
update-rc.d nom defaults-disabled
 
update-rc.d nom disable|enable [ S|2|3|4|5 ]

DESCRIPTION

update-rc.d met à jour automatiquement les liens vers le script d'initialisation de type Système V dont le nom est /etc/rc runlevel.d/NNnom vers le script /etc/init.d/ nom. Ces liens sont lancés par init quand le niveau de fonctionnement change et ils sont généralement utilisés pour démarrer ou arrêter des services tels que les démons. runlevel est l'un des niveaux de fonctionnement autorisés par init, c'est-à-dire, 0123456789S, et NN est le code à deux chiffres utilisé par init pour décider de la séquence d'exécutions des scripts.
 
Cette page de manuel documente seulement le comportement de update-rc.d et son utilisation. Pour une discussion sur la préparation des scripts pour l'initialisation de type Système V, consultez init(8) et la charte Debian.

INSTALLATION DES LIENS DES SCRIPTS D'INITIALISATION

update-rc.d nécessite que des informations de dépendance et de niveau de fonctionnement soient fournies dans l'en-tête de commentaire LSB de tous les scripts init.d. Consultez la page de manuel insserv(8) pour avoir plus de détails sur le format d'en-tête LSB.
 
Quand update-rc.d est lancé avec l'option defaults, il crée les liens /etc/rcrunlevel.d/[SK]NNnom qui pointent vers le script /etc/init.d/nom en utilisant l'information de niveau de fonctionnement et de dépendance de l'en-tête de commentaire LSB du script init.d.
 
Quand update-rc.d est lancé avec l'option defaults/disabled, il crée les liens /etc/rcrunlevel .d/[SK]NNnom qui pointent vers le script /etc/init.d/nom en utilisant l'information de niveau de fonctionnement et de dépendance de l'en-tête de commentaire LSB du script init.d. Cela signifie que ce script sera désactivé (voir ci-dessous).
 
Quand des fichiers /etc/rcrunlevel.d/[SK]??nom existent déjà, update-rc.d ne fait rien. Ce programme a été conçu ainsi de façon à ne jamais modifier une configuration existante qui aurait été personnalisée par l’administrateur du système. Le programme n'installera des liens que si aucun n'est présent, c'est-à-dire s'il semble que le service n'était pas installé auparavant.
 
Les anciennes versions de update-rc.d prenaient également en charge les options start et stop. Ces options ne sont plus prises en charge et sont maintenant équivalentes à l'option defaults.
 
Une erreur courante d'administration d'un système consiste à supprimer les liens en pensant que cela « désactive » le service, c'est-à-dire que cela empêchera le service de démarrer. Cependant, si tous les liens sont supprimés, alors la prochaine fois que le paquet sera mis à jour, son script postinst lancera update-rc.d de nouveau, ce qui réinstallera les liens à leur emplacement par défaut. La façon correcte pour désactiver des services est de configurer le service comme étant arrêté dans tous les niveaux d'exécution pour lesquels il serait démarré par défaut. Avec le système d'initialisation Système V, cela signifie qu'il faut renommer le lien symbolique du service de S vers K. Le script /etc/init.d/ nom doit exister avant l’exécution de update-rc.d pour créer les liens.

SUPPRESSION DES SCRIPTS

Quand update-rc.d est appelé avec l'option remove, les liens dans les répertoires /etc/rcrunlevel.d qui pointent vers le script /etc/init.d/nom sont supprimés. Ce script doit déjà avoir été supprimé. Si le script est toujours présent, update-rc.d quittera avec un message d'erreur. update-rc.d est habituellement appelé par un script de post-suppression de paquet et quand l’argument purge est fourni à ce script. Tous les fichiers dans les répertoires /etc/rcrunlevel.d qui ne sont pas des liens symboliques vers le script /etc/init.d/nom seront inchangés.

DÉSACTIVATION DES LIENS DE DÉMARRAGE DES SCRIPTS D'INITIALISATION

Avec les options disable [ S|2|3|4|5 ], update-rc.d modifie les liens de niveau d'exécution existants pour le script /etc/init.d/ nom en renommant les liens de démarrage en liens d'arrêt avec un numéro de séquence égal à 100 moins le numéro de séquence d'origine.
 
Avec les options enable [ S|2|3|4|5 ], update-rc.d modifie les liens de niveau d'exécution existants pour le script /etc/init.d/ nom en renommant les liens d'arrêt en liens de démarrage avec un numéro de séquence égal à la différence positive du numéro de séquence actuelle moins 100, revenant ainsi au numéro de séquence d'origine du script avant qu'il ne soit désactivé. Ces deux options ne fonctionnent qu'avec les niveaux d'exécution S, 2, 3, 4 ou 5. Si aucun niveau d'exécution n'est précisé après le mot clé disable ou enable, le script essaiera de modifier des liens dans tous les niveaux d'exécution.

OPTIONS

-f
Forcer la suppression des liens même si /etc/init.d/ nom existe encore.

EXEMPLES

Insérer des liens avec l'option « defaults » :
update-rc.d truc defaults


 
L'en-tête des dépendances équivalent devrait avoir des dépendances de démarrage et d'arrêt pour $remote_fs et $syslog, et devrait démarrer dans les niveaux d'exécution 2 à 5 et s'arrêter dans les niveaux 0, 1 et 6.
 
Retirer tous les liens d'un script (en supposant que truc a déjà été supprimé) :
update-rc.d truc remove


 
Exemple de désactivation d'un service :
update-rc.d truc disable


 
Exemple de commande pour installer un script système d'initialisation et d'arrêt :
update-rc.d truc defaults


 
Exemple de commande pour désactiver un script système d'initialisation et d'arrêt :
update-rc.d truc disable


BOGUES

Consultez http://bugs.debian.org/sysv-rc et http://bugs.debian.org/init-system-helpers.

FICHIERS

/etc/init.d/
Le répertoire qui contient les scripts d'initialisation eux-mêmes.
/etc/rc?.d/
Les répertoires qui contiennent les liens utilisés par init et gérés par update-rc.d.
/etc/init.d/skeleton
Modèle pour l'écriture des scripts d'init.d.

VOIR AUSSI

Debian Policy Manual,
/etc/init.d/skeleton,
insserv(8),
init(8)
 

AUTEUR

Ian Jackson, Miquel van Smoorenburg
 
Licence : licence publique générale GNU version 2 ou postérieure (GPLv2+) 2001 Henrique de Moraes Holschuh

TRADUCTION

La traduction française de cette page de manuel a été créée par carmie, Thierry Vignaud <[email protected]>, Éric Piel <[email protected]>, Gérard Delafond <[email protected]>, Danny <[email protected]>, Christophe Blaess <[email protected]>, Frédéric Delanoy <[email protected]>, François Wendling <[email protected]>, Philippe Batailler, Nicolas François <[email protected]>, David Prévot <[email protected]>, Romain Doumenc <[email protected]>, Thomas Vincent <[email protected]> et Jean-Paul Guillonneau <[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à [email protected]

Recommended readings

Pages related to update-rc.d you should read also: