Services divers (Manuel de référence de GNU Guix)

12.9.34 Services divers

Service d’empreintes digitales

Le module (gnu services authentication) fournit un service DBus pour lire et identifier les empreintes digitales via un lecteur d’empreinte.

Variable Scheme : fprintd-service-type

Le type de service pour fprintd, qui fournit des capacités de lecture d’empreinte.

(service fprintd-service-type)

Service de contrôle du système

Le module (gnu services sysctl) fournit un service pour configurer les paramètres du noyau au démarrage.

Variable Scheme : sysctl-service-type

Le type de service pour sysctl, qui modifie les paramètres du noyau dans /proc/sys/. Pour activer le transfert d’IPv4, vous pouvez l’instancier ainsi :

(service sysctl-service-type
         (sysctl-configuration
           (settings '(("net.ipv4.ip_forward" . "1")))))

Comme le service sysctl-service-type fait partie des services par défaut, %base-services et %desktop-services, vous pouvez utiliser modify-services pour changer sa configuration et ajouter les paramètres du noyau que vous voulez (voir modify-services).

(modify-services %base-services
  (sysctl-service-type config =>
                       (sysctl-configuration
                         (settings (append '(("net.ipv4.ip_forward" . "1"))
                                           %default-sysctl-settings)))))

Type de données : sysctl-configuration

Le type de données représentant la configuration de sysctl.

sysctl (par défaut : (file-append procps "/sbin/sysctl"): L’exécutable sysctl à utiliser.
settings (par défaut : %default-sysctl-settings): Une liste d’association spécifiant les paramètres du noyau et leur valeur.

Variable Scheme : %default-sysctl-settings: Une liste d’association spécifiant les paramètres sysctl par défaut sur le système Guix.

Service du démon PC/SC Smart Card

Le module (gnu services security-token) fournit le service suivant qui lance pcscd, le démon PC/SC Smart Card. pcscd est le démon pour pcsc-lite et MuscleCard. C’est un gestionnaire de ressource qui coordonne les communications avec les lecteurs de smart cards, les smart cards et les jetons cryptographiques connectés au système.

Variable Scheme : pcscd-service-type

Le type de service pour le service pcscd. Sa valeur doit être un objet pcscd-configuration. Pour lancer pcscd dans sa configuration par défaut, instantiez-le avec :

(service pcscd-service-type)

Type de données : pcscd-configuration

Type de données représentant la configuration de pcscd.

pcsc-lite (par défaut : pcsc-lite): Le paquet pcsc-lite qui fournit pcscd.
usb-drivers (par défaut : (list ccid)): Liste des paquets qui fournissent des pilotes USB à pcscd. Les pilotes doivent être dans pcsc/drivers dans le répertoire du dépôt du paquet.

Service Lirc

Le module (gnu services lirc) fournit le service suivant.

Procédure Scheme : lirc-service [#:lirc lirc] [#:device #f] [#:driver #f] [#:config-file #f] [#:extra-options '()]

Renvoie un service qui lance LIRC, un démon qui décode les signaux infrarouges des télécommandes.

Éventuellement, device, driver et config-file (le nom du fichier de configuration) peuvent être spécifiés. Voir le manuel de lircd pour plus de détails.

Enfin, extra-options est une liste d’options de la ligne de commande supplémentaires à passer à lircd.

Service Spice

Le module (gnu services spice) fournit le service suivant.

Procédure Scheme : spice-vdagent-service [#:spice-vdagent]: Renvoie un service qui lance VDAGENT, un démon qui permet le partage du presse-papier avec une vm et de configurer la résolution d’affichage du client lorsque la fenêtre de la console graphique est redimensionnée.

service inputattach

Le service inputattach vous permet d’utiliser des périphériques d’entrée comme les tablettes Wacom, les écrans tactiles ou les joysticks avec le serveur d’affichage Xorg.

Variable Scheme : inputattach-service-type: Type d’un service qui lance inputattach sur un appareil et envie les événements qu’il reçoit.

Type de données : inputattach-configuration

device-type (par défaut : "wacom"): Le type du périphérique à gérer. Lancez inputattach --help, du paquet inputattach, pour voir la liste des types de périphériques supportés.
device (par défaut : "/dev/ttyS0"): Le fichier de périphérique pour s’y connecter.
baud-rate (par défaut : #f): Taux de Baud à utiliser pour la connexion série. Cela doit être un nombre ou #f.
log-file (par défaut : #f): Si la valeur est vraie, cela doit être le nom d’un fichier où enregistrer les messages.

Service de dictionnaire

Le module (gnu services dict) fournit le service suivant :

Variable Scheme : dicod-service-type: C’est le type de service qui lance le démon dicod, une implémentation du serveur DICT (voir Dicod dans GNU Dico Manual).

Procédure Scheme : dicod-service [#:config (dicod-configuration)]

Renvoie un service qui lance le démon dicod, une implémentation du serveur DICT (voir Dicod dans GNU Dico Manual).

L’argument config facultatif spécifie la configuration pour dicod, qui devrait être un objet <dicod-configuration>, par défaut il sert le dictionnaire international collaboratif de GNU pour l’anglais.

Vous pouvez ajouter open localhost à votre fichier ~/.dico pour faire de localhost le serveur par défaut du client dico (voir Initialization File dans GNU Dico Manual).

Type de données : dicod-configuration

Type de données représentant la configuration de dicod.

dico (par défaut : dico): Objet de paquet du serveur de dictionnaire GNU Dico.
interfaces (par défaut : ’("localhost")): C’est la liste des adresses IP et des ports et éventuellement des noms de fichiers de socket sur lesquels écouter (voir listen directive dans GNU Dico Manual).
handlers (par défaut : ’()): Liste des objets <dicod-handler> qui définissent des gestionnaires (des instances de modules).
databases (par défaut : (list %dicod-database:gcide)): Liste d’objets <dicod-database> qui définissent des dictionnaires à servir.

Type de données : dicod-handler

Type de données représentant un gestionnaire de dictionnaire (instance de module).

name: Nom du gestionnaire (instance de module).
module (par défaut : #f): Nom du module dicod du gestionnaire (instance). Si la valeur est #f, le module a le même nom que le gestionnaire. (voir Modules dans GNU Dico Manual).
options: Liste de chaînes ou de gexps représentant les arguments pour le gestionnaire de module

Type de données : dicod-database

Type de données représentant une base de données de dictionnaire.

name: Nom de la base de données, qui sera utilisée dans les commande DICT.
handler: Nom du gestionnaire dicod (instance de module) utilisé par cette base de données (voir Handlers dans GNU Dico Manual).
complex? (par défaut : #f): Indique si la configuration est pour une base de données complexe. La configuration complexe a besoin d’un objet <dicod-handler> correspondant, sinon inutile.
options: Liste de chaînes ou de gexps représentant les arguments pour la base de données (voir Databases dans GNU Dico Manual).

Variable Scheme : %dicod-database:gcide: Un objet <dicod-database> servant le dictionnaire international collaboratif en anglais via le paquet gcide.

Voici un exemple de configuration de dicod-service.

(dicod-service #:config
  (dicod-configuration
   (handlers (list (dicod-handler
                    (name "wordnet")
                    (module "dictorg")
                    (options
                     (list #~(string-append "dbdir=" #$wordnet))))))
   (databases (list (dicod-database
                     (name "wordnet")
                     (complex? #t)
                     (handler "wordnet")
                     (options '("database=wn")))
                    %dicod-database:gcide))))

Service Docker

Le module (gnu services docker) fournit les services suivants.

Variable Scheme : docker-service-type: C’est le type du service qui lance Docker, un démon qui peut exécuter des lots applicatifs (aussi appelés « conteneurs ») dans des environnements isolés.

Type de données : docker-configuration

Le type de données qui représente la configuration de Docker et Containerd.

docker (par défaut : docker)

Le paquet du démon Docker à utiliser.

docker-cli (par défaut : docker-cli)

Le paquet du client Docker à utiliser.

containerd (par défaut : containerd)

Le paquet Containerd à utiliser.

proxy (par défaut : docker-libnetwork-cmd-proxy)

Le paquet du mandataire réseau en espace utilisateur de Docker à utiliser.

enable-proxy? (par défaut : #t)

Indique s’il faut utiliser le mandataire réseau en espace utilisateur de Docker.

debug? (par défaut : #f)

Indique s’il faut activer la sortie de débogage.

enable-iptables? (par défaut : #t)

Indique s’il faut ajouter des règles iptables.

environment-variables (par défaut : ())

Liste de variables d’environnement à initialiser pour dockerd.

Cela doit être une liste de chaines où chaque chaine a pour forme ‘clé=valeur’ comme dans cet exemple :

(list "LANGUAGE=eo:ca:eu"
      "TMPDIR=/tmp/dockerd")

Variable Scheme : singularity-service-type

C’est le type de service qui vous permet de lancer Singularity, un outil similaire à Docker pour créer et lancer des lots applicatifs (aussi appelés « conteneurs »). la valeur de ce service est le paquet Singularity à utiliser.

Le service n’installe pas de démon : à la place, il installe des utilitaires en setuid-root (voir Programmes setuid) pour que les utilisateurs non privilégiés puisse invoquer singularity run et les commandes similaires.

Service auditd

Le module (gnu services auditd) fournit le service suivant.

Variable Scheme : auditd-service-type

C’est le type du service qui lance auditd, un démon qui suit les informations de sécurité de votre système.

Exemples de ce qui peut être suivi :

Les accès aux fichiers
Les appels système
Les commandes invoquées
Les tentatives de connexion échouées
Le filtrage du pare-feu
Les accès réseau

auditctl du paquet audit peut être utilisé pour ajouter ou supprimer des évènements à suivre (jusqu’au prochain redémarrage). Pour suivre les évènements de manière permanente, ajoutez des arguments à la commande auditctl dans un fichier nommé audit.rules dans le répertoire de configuration (voir plus bas). aureport du paquet audit peut être utilisé pour visualiser un rapport de tous les évènements enregistrés. le démon d’audit enregistre par défaut dans le fichier /var/log/audit.log.

Type de données : auditd-configuration

Le type de données qui représente la configuration de auditd.

audit (par défaut : audit): Le paquet audit à utiliser.
configuration-directory (par défaut : %default-auditd-configuration-directory): Le répertoire contenant le fichier de configuration du paquet audit, qui doit être nommé auditd.conf, et éventuellement des règles d’audit à instancier au démarrage.

Service R-Shiny

Le module (gnu services science) fournit le service suivant.

Variable Scheme : rshiny-service-type

C’est le type de service utilisé pour lancer une appli web créée avec r-shiny. Ce service initialise la variable d’environnement R_LIBS_USER et lance le script fournit pour appeler runApp.

Type de données : rshiny-configuration

Le type de données qui représente la configuration de rshiny.

package (par défaut : r-shiny)

Le paquet à utiliser.

binary (par défaut : "rshiny")

Le nom du binaire ou du script shell situé dans package/bin/ à lancer au démarrage du service.

La manière habituelle de créer ce fichier est :

…
(let* ((out       (assoc-ref %outputs "out"))
       (targetdir (string-append out "/share/" ,name))
       (app       (string-append out "/bin/" ,name))
       (Rbin      (search-input-file %build-inputs "/bin/Rscript")))
  ;; …
  (mkdir-p (string-append out "/bin"))
  (call-with-output-file app
    (lambda (port)
      (format port
"#!~a
library(shiny)
setwd(\"~a\")
runApp(launch.browser=0, port=4202)~%\n"
      Rbin targetdir))))

Service Nix

Le module (gnu services nix) fournit le service suivant.

Variable Scheme : nix-service-type

C’est le type du service qui lance le démon de construction du gestionnaire de paquets Nix. Voici un exemple qui montre comment l’utiliser :

(use-modules (gnu))
(use-service-modules nix)
(use-package-modules package-management)

(operating-system
  ;; …
  (packages (append (list nix)
                    %base-packages))

  (services (append (list (service nix-service-type))
                    %base-services)))

Après guix system reconfigure, configurez Nix pour votre utilisateur :

Ajoutez un canal Nix et mettez-le à jour. Voir Guide du gestionnaire de paquets Nix.
Créez un lien symbolique vers votre profil et activez le profil de Nix :

$ ln -s "/nix/var/nix/profiles/per-user/$USER/profile" ~/.nix-profile
$ source /run/current-system/profile/etc/profile.d/nix.sh

Type de données : nix-configuration

Ce type de données représente la configuration du démon Nix.

nix (par défaut : nix): Le paquet Nix à utiliser.
sandbox (par défaut : #t): Spécifie si les constructions sont effectuées dans un bac à sable par défaut.
build-sandbox-items (par défaut : '()): C’est une liste de chaines de caractères ou d’objets ajoutés au champ build-sandbox-items du fichier de configuration.
extra-config (par défaut : '()): C’est une liste de chaînes de caractères ou d’objets ajoutés au fichier de configuration. Elle est utile pour ajouter du texte supplémentaire directement dans le fichier de configuration.
extra-options (par défaut : '()): Options supplémentaires de la ligne de commande pour nix-service-type.