services: network-manager: Add 'shepherd-requirement' field.

Note: This also makes wpa-supplicant an optional requirement.

* gnu/services/networking.scm (<network-manager-configuration>)
[shepherd-requirement]: New field.
(network-manager-shepherd-service): Honor it.
(network-manager-configuration-shepherd-requirement): Export accessor.
* doc/guix.texi (Networking Setup): Document it.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>
This commit is contained in:
Bruno Victal 2023-03-07 12:43:58 +00:00 committed by Ludovic Courtès
parent 79ae719ad1
commit 7777d767a4
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5
2 changed files with 13 additions and 3 deletions

View file

@ -19836,6 +19836,12 @@ Data type representing the configuration of NetworkManager.
@item @code{network-manager} (default: @code{network-manager})
The NetworkManager package to use.
@item @code{shepherd-requirement} (default: @code{'(wpa-supplicant)})
This option can be used to provide a list of symbols naming Shepherd services
that this service will depend on, such as @code{'wpa-supplicant} or
@code{'iwd} if you require authenticated access for encrypted WiFi or Ethernet
networks.
@item @code{dns} (default: @code{"default"})
Processing mode for DNS, which affects how NetworkManager uses the
@code{resolv.conf} configuration file.

View file

@ -143,6 +143,7 @@ (define-module (gnu services networking)
network-manager-configuration
network-manager-configuration?
network-manager-configuration-shepherd-requirement
network-manager-configuration-dns
network-manager-configuration-vpn-plugins
network-manager-service-type
@ -1140,6 +1141,8 @@ (define-record-type* <network-manager-configuration>
network-manager-configuration?
(network-manager network-manager-configuration-network-manager
(default network-manager))
(shepherd-requirement network-manager-configuration-shepherd-requirement
(default '(wpa-supplicant)))
(dns network-manager-configuration-dns
(default "default"))
(vpn-plugins network-manager-configuration-vpn-plugins ;list of file-like
@ -1200,7 +1203,7 @@ (define (network-manager-environment config)
(define (network-manager-shepherd-service config)
(match-record config <network-manager-configuration>
(network-manager dns vpn-plugins iwd?)
(network-manager shepherd-requirement dns vpn-plugins iwd?)
(let ((conf (plain-file "NetworkManager.conf"
(string-append
"[main]\ndns=" dns "\n"
@ -1209,8 +1212,9 @@ (define (network-manager-shepherd-service config)
(list (shepherd-service
(documentation "Run the NetworkManager.")
(provision '(networking))
(requirement (append '(user-processes dbus-system loopback)
(if iwd? '(iwd) '(wpa-supplicant))))
(requirement `(user-processes dbus-system loopback
,@shepherd-requirement
,@(if iwd? '(iwd) '())))
(start #~(make-forkexec-constructor
(list (string-append #$network-manager
"/sbin/NetworkManager")