Replace the --base code with relative paths.
[darkstat] / contrib / LisezMoi.MacOS
1 +---------------------+
2 | Darkstat pour MacOS |
3 +---------------------+
4
5 Darkstat fonctionne parfaitement sur MacOS, sous forme de service utilisant le gestionnaire standard d'Apple, launchd, ou en tant que simple processus. Dans tous les cas, les conditions habituelles d'accès aux interfaces réseaux et aux ports s'appliquent de la même façon que pour les autres plate-formes UNIX.
6
7 Pour utiliser darkstat en tant que service système, nous devons donner à launchd les informations décrivant le nouveau service qu'on souhaite lui adjoindre.
8
9 Un fichier de configuration (cx.ath.darkstat) a déjà été préparé, il suffit de le placer dans le répertoire approprié et de l'activer. La configuration a été conçue pour écouter sur l'interface réseau « en0 » (ethernet) et faire tourner darkstat avec une politesse de 1.
10
11
12
13 +-----------------+
14 | Mise en service |
15 +-----------------+
16
17 Procédure pour installer la configuration du service :
18
19         1)      Éditez le fichier « cx.ath.darkstat » pour y définir le chemin d'accès complet à darkstat :
20                 si vous utiliser la distribution macports, mettez « /opt/local/sbin/darkstat »
21                 si vous utiliser la distribution fink, mettez « /sw/sbin/darkstat »
22                 si vous utiliser une installation manuelle, à vous de savoir.
23
24         2)      Copiez le fichier de configuration :
25                 sudo cp cx.ath.darkstat /Library/LaunchDaemons/
26                 sudo chown root:wheel /Library/LaunchDaemons/cx.ath.darkstat
27                 sudo chmod 644 /Library/LaunchDaemons/cx.ath.darkstat
28
29         3)      Activez darkstat :
30                 sudo launchctl load /Library/LaunchDaemons/cx.ath.darkstat
31
32 Désormais, darkstat est sous contrôle de launchd et sera lancé au démarrage de la machine.
33
34
35
36 +---------------------+
37 | Désactiver darkstat |
38 +---------------------+
39
40 Pour désactiver darkstat jusqu'au prochain démarrage, utilisez la commande : sudo launchctl unload /Library/LaunchDaemons/cx.ath.darkstat
41
42 Pour désactiver darkstat de façon permanente, vous pouvez effectuer au choix l'un des deux opérations suivantes :
43
44         1)      utilisez la commande : sudo launchctl unload -w /Library/LaunchDaemons/cx.ath.darkstat
45                 L'option « -w » va modifier le fichier de configuration pour ajouter une clé interdisant l'activation du service.
46
47                 Pour réactiver le service par la suite, il faut employer la commande : sudo launchctl load -w /Library/LaunchDaemons/cx.ath.darkstat
48                 L'option « -w » va modifier le fichier de configuration pour retirer une clé interdisant l'activation du service.
49
50         2)      supprimer simplement le fichier /Library/LaunchDaemons/cx.ath.darkstat
51
52
53
54 +---------------------+
55 | Plus d'informations |
56 +---------------------+
57
58 Pour en savoir plus :
59         - darkstat : man 1 darkstat
60         - launchctl, l'outil de contrôle de launchd : man 1 launchctl
61         - la configuration d'un service launchd : man 5 launchd.plist
62         - définition de la politesse : man 1 nice
63
64
65 --
66 Damien Clauzel, Damien@Clauzel.nom.fr
67 1/07/2008