Outils pour utilisateurs

Outils du site


system:base:rcctl

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Prochaine révision
Révision précédente
system:base:rcctl [2020/01/19 16:30]
127.0.0.1 modification externe
system:base:rcctl [2021/07/20 14:51] (Version actuelle)
pengouinbsd [Utilisation]
Ligne 1: Ligne 1:
 ====== rcctl : configurer et contrôler les services ====== ====== rcctl : configurer et contrôler les services ======
  
-===== manpage =====+===== Utilisation ===== 
 +  
 +Pour rappel : 
  
-==== Synopsis ====+  * Activer un service : ''rcctl enable service'' 
 +  * Désactiver un service : ''rcctl disable service'' 
 +  * Lancer/Démarrer un service : ''rcctl start service'' 
 +  * Redémarrer/recharger un service : ''rcctl restart service'', ''rcctl reload service'' 
 +  * Vérifier les scripts éteints alors qu'ils devraient tourner : ''rcctl ls failed''
  
-  * **rcctl** **get**|**getdef**|**set** //service// | //daemon// [//variable// [//arguments//]] +----
-  * **rcctl** [**-df**] //action daemon// ... +
-  * **rcctl** **disable**|**enable**|**order** [//daemon// ...] +
-  * **rcctl** **ls** //lsarg//+
  
-==== Description ====+===== Documentation =====
  
-L'utilitaire ''rcctl'' peut activer ou désactiver un //service// du système de base ou un //démon// d'un paquet dans [[http://man.openbsd.org/rc.conf.local.8|rc.conf.local(8)]] ou afficher sa configuration et son statut. Pour un //démon//, il peut aussi changer les arguments de ligne de commande, l'utilisateur avec lequel l'exécuter, le délai "timeout" d'action de [[http://man.openbsd.org/rc.d.8|rc.d(8)]] ou appeler son script de contrôle du démon [[http://man.openbsd.org/rc.d.8|rc.d(8)]].+  * ''[[#man-8-rcctl|man rcctl]]''
  
-Les commandes suivantes sont disponibles (''//variable//'' peut être de type **class**, **flags**, **status**, **timeout** ou **user**) : +==== man 8 rcctl ====
  
-  * ''[**-df**] action daemon ...'' : exécute les scripts du //démon// [[http://man.openbsd.org/rc.d.8|rc.d(8)]] avec l'argument //action//, passant par dessus les options spécifiées, s'il y en a.  
-  * ''**disable** //service// ... | //daemon// ...'' : alias de ''**set** //service//|//daemon// **status off**''. 
-  * ''**enable** //service// ... | //daemon// ...'' : alias de ''**set** //service//|//daemon// **status on**''. 
-  * ''**get** //service// | //daemon// [//variable//]'' : affiche la valeur du //service// ou //démon//. Si //variable// est vide, affiche toutes les variables et valeurs du //service// ou du //démon// dans un format compatible avec [[http://man.openbsd.org/rc.conf.8|rc.conf(8)]]. Lorsque //daemon// est paramétré sur ''"al"'', //variable// ne doit pas être configurée et **rcctl** affichera toutes les variables des services et démons.  
-  * ''**getdef** //service// | //daemon// [//variable//]'' : tout comme ''get'' mais retourne les valeurs par défaut. 
-  * ''**ls** //lsarg//'' : affiche une liste de services et démons correspondant à //lsarg//, qui peut être un des suivants :  
-    * ''**all**'' : tous les services et démons 
-    * ''**failed**'' : les démons activés mais arrêtés 
-    * ''**off**'' : les services et démons désactivés 
-    * ''**on**'' : les services et démons activés 
-    * ''**started**'' : les démons fonctionnant 
-    * ''**stopped**'' : les démons stoppés 
-  * ''**order** [//daemon// ...]'' : place les démons du paquet spécifiés au commencement de //pkg_scripts//. Ils doivent être toujours activés. Si aucun démon n'est spécifié, affiche l'ordre actuel. \\ La commande **order** est seulement nécessaire après l'activation d'un démon qui a besoin d'être exécuté avant un ou plusieurs démons déjà actifs. Spécifiez le nouveau démon précédé de tout ceux qui doivent être exécutés avant lui, mais pas de ceux qui en dépendent. 
-  * ''**set** //service// | //daemon variable// [//arguments//]'' : Pour un démon, configure la variable du démon avec les arguments spécifiés. Si //variable// est déjà paramétrée, la variable du démon est reconfigurée par les arguments fournis en option ou sa valeur par défaut. \\ Le **status** //variable// doit être fourni avec un argument **on** ou **off**. Il est utilisé pour activer ou désactiver un //service// ou //démon// dans [[http://man.openbsd.org/rc.conf.local.8|rc.conf.local(8)]]. Quand un démon désactivé d'un paquet est activé, il est ajouté à la fin de //pkg_scripts//. Quand un démon d'un paquet est désactivé, il est supprimé de //pkg_scripts// et ses variables sont supprimées, s'il y en a. 
  
 +=== Synopsis ===
  
-==== Statut de sortie ====+  * **rcctl** **get**|**getdef**|**set** __service__ | __daemon__ [__variable__ [__arguments__]] 
 +  * **rcctl** [**-df**] __action daemon__ __…__ 
 +  * **rcctl** **disable**|**enable**|**order** [__daemon__ __…__] 
 +  * **rcctl** **ls** __lsarg__
  
-**rcctl** //action// retourne un statut de sortie du script du démon [[http://man.openbsd.org/rc.d.8|rc.d(8)]]. ''**rcctl get** //daemon// | //service// [**status**]'' termine avec ''0'' si le démon ou service est activé et avec ''1'' s'il ne l'est pas.  ''**rcctl getdef** //daemon// | //service// [//status//]'' termine avec ''0'' si le démon ou service est activé par défaut et ''1'' s'il ne l'est pas''**rcctl ls failed**'' termine avec ''1'' si un démon activé ne fonctionne pasAutrement, l'utilitaire **rcctl** termine avec ''0'' en cas de succès, et supèrieur à 0 si une erreur arrive (''2'' indique un démon ou service non existant).+=== Description === 
 +L'utilitaire **rcctl** peut activer ou désactiver un __service__ du système de base ou un __démon__ d'un paquet dans [[http://man.openbsd.org/rc.conf.local.8|rc.conf.local(8)]] ou afficher sa configuration et son statut. Pour un __démon__, il peut aussi changer les arguments de ligne de commande, l'utilisateur avec lequel l'exécuter, le délai "timeout" d'action de [[http://man.openbsd.org/rc.d.8|rc.d(8)]] ou appeler son script de contrôle du démon [[http://man.openbsd.org/rc.d.8|rc.d(8)]].
  
-==== Exemples ====+Les commandes suivantes sont disponibles (__variable__ peut être de type **class**, **flags**, **status**, **timeout** ou **user**) :  
 + 
 +  * [**-df**] action daemon __…__ : exécute les scripts du __démon__ [[http://man.openbsd.org/rc.d.8|rc.d(8)]] avec l'argument __action__, passant par dessus les options spécifiées, s'il y en a.  
 +  * **disable** __service__ __…__ | __daemon__ __…__ : alias de **set** __service__|__daemon__ **status off**. 
 +  * **enable** __service__ __…__ | __daemon__ __…__ : alias de **set** __service__|__daemon__ **status on**. 
 +  * **get** __service__ | __daemon__ [__variable__] : affiche la valeur du __service__ ou __démon__. Si __variable__ est vide, affiche toutes les variables et valeurs du __service__ ou du __démon__ dans un format compatible avec [[http://man.openbsd.org/rc.conf.8|rc.conf(8)]]. Lorsque __daemon__ est paramétré sur "al", __variable__ ne doit pas être configurée et **rcctl** affichera toutes les variables des services et démons.  
 +  * **getdef** __service__ | __daemon__ [__variable__] : tout comme get mais retourne les valeurs par défaut. 
 +  * **ls** __lsarg__ : affiche une liste de services et démons correspondant à __lsarg__, qui peut être un des suivants :  
 +    * **all** : tous les services et démons 
 +    * **failed** : les démons activés mais arrêtés 
 +    * **off** : les services et démons désactivés 
 +    * **on** : les services et démons activés 
 +    * **started** : les démons fonctionnant 
 +    * **stopped** : les démons stoppés 
 +  * **order** [__daemon__ __…__] : place les démons du paquet spécifiés au commencement de __pkg_scripts__. Ils doivent être toujours activés. Si aucun démon n'est spécifié, affiche l'ordre actuel. \\ La commande **order** est seulement nécessaire après l'activation d'un démon qui a besoin d'être exécuté avant un ou plusieurs démons déjà actifs. Spécifiez le nouveau démon précédé de tout ceux qui doivent être exécutés avant lui, mais pas de ceux qui en dépendent. 
 +  * **set** __service__ | __daemon variable__ [__arguments__] : Pour un démon, configure la variable du démon avec les arguments spécifiés. Si __variable__ est déjà paramétrée, la variable du démon est reconfigurée par les arguments fournis en option ou sa valeur par défaut. \\ Le **status** __variable__ doit être fourni avec un argument **on** ou **off**. Il est utilisé pour activer ou désactiver un __service__ ou __démon__ dans [[http://man.openbsd.org/rc.conf.local.8|rc.conf.local(8)]]. Quand un démon désactivé d'un paquet est activé, il est ajouté à la fin de __pkg_scripts__. Quand un démon d'un paquet est désactivé, il est supprimé de __pkg_scripts__ et ses variables sont supprimées, s'il y en a. 
 + 
 + 
 +=== Statut de sortie ==
 + 
 +**rcctl** __action__ retourne un statut de sortie du script du démon [[http://man.openbsd.org/rc.d.8|rc.d(8)]]. **rcctl get** __daemon__ | __service__ [**status**] termine avec 0 si le démon ou service est activé et avec 1 s'il ne l'est pas.  **rcctl getdef** __daemon__ | __service__ [__status__] termine avec 0 si le démon ou service est activé par défaut et 1 s'il ne l'est pas. **rcctl ls failed** termine avec 1 si un démon activé ne fonctionne pas. Autrement, l'utilitaire **rcctl** termine avec 0 en cas de succès, et supèrieur à 0 si une erreur arrive (2 indique un démon ou service non existant). 
 + 
 +=== Exemples ===
  
 Active et paramètre les drapeaux d'[[http://man.openbsd.org/apmd.8|apmd(8)]] :  Active et paramètre les drapeaux d'[[http://man.openbsd.org/apmd.8|apmd(8)]] : 
Ligne 62: Ligne 78:
 </code> </code>
  
-==== Voir aussi ====+=== Voir aussi ===
  
   * [[http://man.openbsd.org/rc.conf.local.8|rc.conf.local(8)]], [[http://man.openbsd.org/rc.d.8|rc.d(8)]]   * [[http://man.openbsd.org/rc.conf.local.8|rc.conf.local(8)]], [[http://man.openbsd.org/rc.d.8|rc.d(8)]]
  
-==== Histoire ====+=== Histoire ===
  
 **rcctl** est apparu la première fois dans OpenBSD 5.7. **rcctl** est apparu la première fois dans OpenBSD 5.7.
  
-==== Auteurs ====+=== Auteurs ===
  
 **rcctl** a été écrit par Antoine Jacoutot <ajacoutot@openbsd.org>. **rcctl** a été écrit par Antoine Jacoutot <ajacoutot@openbsd.org>.
- 
----- 
- 
-===== Mémo ===== 
-  
-Pour rappel :  
- 
-  * Activer un service : ''rcctl enable service'' 
-  * Désactiver un service : ''rcctl disable service'' 
-  * Lancer un service : ''rcctl start service'' 
-  * Redémarrer/recharger un service : ''rcctl restart service'', ''rcctl reload service'' 
-  * Vérifier les scripts éteints alors qu'ils devraient tourner : ''rcctl ls failed'' 
- 
  
 ---- ----
system/base/rcctl.1579451445.txt.gz · Dernière modification: 2020/01/19 16:30 de 127.0.0.1