From patchwork Fri May 23 09:04:34 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sergey Trofimov X-Patchwork-Id: 42882 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 5CAE827BC4C; Fri, 23 May 2025 10:06:21 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-7.4 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,MAILING_LIST_MULTI,RCVD_IN_DNSWL_BLOCKED,RCVD_IN_MSPIKE_H2, RCVD_IN_VALIDITY_CERTIFIED,RCVD_IN_VALIDITY_RPBL,RCVD_IN_VALIDITY_SAFE, SPF_HELO_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 94FEC27BC49 for ; Fri, 23 May 2025 10:06:20 +0100 (BST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1uIOM2-0008Ig-Ut; Fri, 23 May 2025 05:06:14 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uIOLv-0008HR-3E for guix-patches@gnu.org; Fri, 23 May 2025 05:06:07 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1uIOLs-0001IC-Ur; Fri, 23 May 2025 05:06:06 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:References:In-Reply-To:Date:From:To:Subject; bh=VsLEuU+wl0gD/5DF4++hXvms4px+AwasLFn9bwHggU8=; b=ffcg9cDaB0ETngz14iSEN8tyCIFSTi34dF0JhNiLPXansnKBCpOWcoGKnCs9RrIhKvVwdkF/llqOQAp5qS0nSaobsW5JcPsj+UdpkqR15mvUedgQ/Hh+cV78U7+WWMSaKLYUhJhpjZGYnlLEuZEfRX3Ea/9xrbg9uvfYpvlXIan7E1UfElR+lcXoF7NeA/mNQpK64IdOTopqwBM98kE79YqEisy+VcHp9Wdb1KpvTkJZLR2pU8w8XLngTD7BXJZaic41ThyjtXEVsTH3nRt59Hbm5tfQvlO9cszaGLp1on6CAg32Bt547A/EODJ2oTNGH5LWgo7qEMtxSL9YDn114A==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1uIOLq-0006sh-V6; Fri, 23 May 2025 05:06:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#78546] [PATCH 3/3] services: networking: Add iwd-service-type. Resent-From: Sergey Trofimov Original-Sender: "Debbugs-submit" Resent-CC: sarg@sarg.org.ru, gabriel@erlikon.ch, ludo@gnu.org, maxim.cournoyer@gmail.com, guix-patches@gnu.org Resent-Date: Fri, 23 May 2025 09:06:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 78546 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 78546@debbugs.gnu.org Cc: Sergey Trofimov , Sergey Trofimov , Gabriel Wicki , Ludovic =?utf-8?q?Court=C3=A8s?= , Maxim Cournoyer X-Debbugs-Original-Xcc: Sergey Trofimov , Gabriel Wicki , Ludovic =?utf-8?q?Court=C3=A8s?= , Maxim Cournoyer Received: via spool by 78546-submit@debbugs.gnu.org id=B78546.174799110425886 (code B ref 78546); Fri, 23 May 2025 09:06:02 +0000 Received: (at 78546) by debbugs.gnu.org; 23 May 2025 09:05:04 +0000 Received: from localhost ([127.0.0.1]:45526 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1uIOKs-0006iy-QR for submit@debbugs.gnu.org; Fri, 23 May 2025 05:05:04 -0400 Received: from mail-ed1-x52b.google.com ([2a00:1450:4864:20::52b]:47517) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1uIOKj-0006hP-87 for 78546@debbugs.gnu.org; Fri, 23 May 2025 05:04:55 -0400 Received: by mail-ed1-x52b.google.com with SMTP id 4fb4d7f45d1cf-5fff52493e0so10631420a12.3 for <78546@debbugs.gnu.org>; Fri, 23 May 2025 02:04:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sarg.org.ru; s=google; t=1747991087; x=1748595887; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=VsLEuU+wl0gD/5DF4++hXvms4px+AwasLFn9bwHggU8=; b=vqgM39bwfU0wkNEVRipRbZRZ7HhNrD01Q9bmV31Dhtxll9giMtj4Na5sVCaabehaeu Vc/dSkvKeFFZkQs8oapHRJsi05iDkUQ/tHpdm6kvZ3x8jtVl9MloeVEY9D7V2bFe8h0Q 4suYy29wB0Kt4NOopCUrHtSgIwYMmdB5SB+Smwm1W7DM9FYBEtcsp1iBVIwHW8DeWadG xfmfMM+A1LvaJtHypvYZ+qtl+DLzZQFZG+cbQFuvRmLroCk4TAC8Guz3QLuN6VJ2Dr7d LPQenNbQ8NuAg4LgIGaXkDsl17UaI4L4q8/FL7WAjdaChZFwk10w1ZKy6gHYqnDMqihm hv1g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1747991087; x=1748595887; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=VsLEuU+wl0gD/5DF4++hXvms4px+AwasLFn9bwHggU8=; b=Jek5aDJg4TMlc9MRB4lga44WlscXS2a+Z7fYuhYvvvdGlNJ1HGjpaTQ1Ipf6N1nA11 HbuRA1uTbOgEfPF6VPOsfJGaWeXPv8dXdjMQ1IUn8jSJVE/8jAt4m7fqHCMd3S9AWMsx M6+LY0LuHj+gya8z5zBp2M/AW0M0oIJY9z+qSrFPFk1PKtCom/ekUPQ8FXPqL7FjfUgh oDlsVtAxXR5AlhQ8MBMO4tACs4AjpCsNob17Wo6jKY7wcFv5NezN/5vOd383bNDf5IYO yJIy8BwCc3zPhhp0Fmx/Yp5INtUiGrYsUyixvvgUVAHODPphPZqscId2V0rUhElq7wtD 8Ejg== X-Gm-Message-State: AOJu0Yw0X9U4NqDgN2ZIn95rjKCLU3d2q1BN6LmECSjAcnzM/I061OFY iKb/7yzzz1tFPdTvbrmw9HDczfeNlAnMBOxZhlbHmi/HGDq4HVfFW52lLudcNObrlULAwhJywP7 EGGlOsg8= X-Gm-Gg: ASbGncsAdnKx2I+e7qrSSJL2fo3Vsb4Ljz0o+qA6Pwwqfc9ZlxYVvTrE97uWri1GspC 7cxZnN5vHaC1Bmu/VWGcVkl3ccb4gGfGiLFh/yLSs7dNbYgmmXQeEW4Dalv3UvpSDFeHeQrgjPe SuJlCAGxrphXZ5BWk+6GF+Eprru8OfWRFpiIL3f1zvFzVBAmNQH25TPnja4PKEEHvolCecgbWVB RryIlPApgyxlrwusnudXruPz8ACKc9IcXvVAbS5E2/ayIKsSVIWp6Alskoo0Oy0Qi2Yv0oo2Ra2 GiGc4W/AqKBEbS3wfwx6OvuoRLzONwE+5tZxoNVdQ2WBuKY8EQ== X-Google-Smtp-Source: AGHT+IF+HVLS5w3LNIXYHWdwKOgiL8VsAosroG2psWGCEcynfDl01NsDPa7MNtMywtI3A0p1lMqG0w== X-Received: by 2002:a17:906:8d7:b0:ad5:372d:87e3 with SMTP id a640c23a62f3a-ad5372dbbb2mr1995084966b.27.1747991086177; Fri, 23 May 2025 02:04:46 -0700 (PDT) Received: from localhost ([2a02:2454:a095:5600:a64e:31ff:fe38:fd6c]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-ad52d047cf1sm1212140366b.16.2025.05.23.02.04.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 23 May 2025 02:04:45 -0700 (PDT) From: Sergey Trofimov Date: Fri, 23 May 2025 11:04:34 +0200 Message-ID: <8617d132a80c6570e1c1a0ebe8d02b0baacfc9ef.1747990996.git.sarg@sarg.org.ru> X-Mailer: git-send-email 2.49.0 In-Reply-To: References: MIME-Version: 1.0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches * gnu/services/networking.scm (iwd-service-type): New service type. (iwd-configuration), (iwd-settings), (iwd-scan-settings), (iwd-general-settings), (iwd-network-settings): New configuration types. * doc/guix.texi (Networking setup): Document it. Change-Id: I852115b9c6768b3ec4eedb34a7f9e66438bd1429 --- doc/guix.texi | 157 ++++++++++++++++++++++++ gnu/services/networking.scm | 236 ++++++++++++++++++++++++++++++++++++ 2 files changed, 393 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index 3ef2e50e57..5c07b35ccb 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -22404,6 +22404,163 @@ Networking Setup @end table @end deftp +@cindex IWD +@defvar iwd-service-type +This is the service type to run @acronyml{IWD,Internet Wireless Daemon}, +a wireless daemon required to authenticate against encrypted WiFi +networks. +@end defvar + +@quotation Warning +By default @code{iwd} removes and re-creates interfaces it manages. It +doesn't play nicely with @code{dhcp-client-service-type} that enumerates +wireless interfaces before starting the Shepherd service. Use either +@code{dhcpcd-service-type} or the @code{iwd}'s built-in DHCP client (see +@code{enable-network-configuration} option below). +@end quotation + +@c %start of fragment + +@deftp {Data Type} iwd-configuration +Available @code{iwd-configuration} fields are: + +@table @asis +@item @code{iwd} (default: @code{iwd}) (type: file-like) +The IWD package to use. + +@item @code{interfaces} (default: @code{()}) (type: list-of-strings) +If this is set, it must specify @dfn{glob patterns} matching network +interfaces that IWD will control. + +@item @code{ignored-interfaces} (default: @code{()}) (type: list-of-strings) +If this is set, it must specify @dfn{glob patterns} matching network +interfaces that IWD will not manage. + +@item @code{phys} (default: @code{()}) (type: list-of-strings) +If this is set, it must specify @dfn{glob patterns} matching network +PHYs names that IWD will control. + +@item @code{ignored-phys} (default: @code{()}) (type: list-of-strings) +If this is set, it must specify @dfn{glob patterns} matching network +PHYs names that IWD will not manage. + +@item @code{shepherd-requirement} (default: @code{()}) (type: list-of-symbols) +Shepherd requirements the service should depend on. + +@item @code{shepherd-provision} (default: @code{(iwd)}) (type: list-of-symbols) +The name(s) of the service. + +@item @code{config} (type: iwd-settings) +Configuration settings. + +@end table + +@end deftp + + +@c %end of fragment + +@c %start of fragment + +@deftp {Data Type} iwd-settings +Available @code{iwd-settings} fields are: + +@table @asis +@item @code{general} (type: iwd-general-settings) +General settings. + +@item @code{network} (type: maybe-iwd-network-settings) +Network settings. + +@item @code{scan} (type: maybe-iwd-scan-settings) +Scan settings. + +@item @code{extra-config} (default: @code{()}) (type: list-of-strings) +Extra configuration values to append to the IWD configuration file. + +@end table + +@end deftp + + +@c %end of fragment + +@c %start of fragment + +@deftp {Data Type} iwd-general-settings +Available @code{iwd-general-settings} fields are: + +@table @asis +@item @code{enable-network-configuration} (default: @code{#f}) (type: boolean) +Setting this option to true enables @code{iwd} to configure the network +interfaces with the IP addresses. + +@item @code{extra-options} (default: @code{()}) (type: alist) +An association list of option symbols/strings to string values to be +appended to the General settings group. + +@end table + +@end deftp + + +@c %end of fragment + +@c %start of fragment + +@deftp {Data Type} iwd-network-settings +Available @code{iwd-network-settings} fields are: + +@table @asis +@item @code{enable-ipv6} (default: @code{#t}) (type: boolean) +Sets the global default that tells @code{iwd} whether it should +configure IPv6 addresses and routes + +@item @code{name-resolving-service} (default: @code{none}) (type: resolving-service) +Configures a DNS resolution method used by the system. + +@item @code{extra-options} (default: @code{()}) (type: alist) +An association list of option symbols/strings to string values to be +appended to the Network settings group. + +@end table + +@end deftp + + +@c %end of fragment + +@c %start of fragment + +@deftp {Data Type} iwd-scan-settings +Available @code{iwd-scan-settings} fields are: + +@table @asis +@item @code{disable-periodic-scan} (type: maybe-boolean) +Setting this option to @code{#t} will prevent @code{iwd} from issuing +the periodic scans for the available networks while disconnected. + +@item @code{initial-periodic-scan-interval} (type: maybe-number) +The initial periodic scan interval upon disconnect (in seconds). + +@item @code{maximum-periodic-scan-interval} (type: maybe-number) +The maximum periodic scan interval (in seconds). + +@item @code{disable-roaming-scan} (type: maybe-boolean) +Setting this option to @code{#t} will prevent @code{iwd} from trying to +scan when roaming decisions are activated. + +@item @code{extra-options} (default: @code{()}) (type: alist) +An association list of option symbols/strings to string values to be +appended to the Scan settings group. + +@end table + +@end deftp + + +@c %end of fragment + @cindex ModemManager Some networking devices such as modems require special care, and this is what the services below focus on. diff --git a/gnu/services/networking.scm b/gnu/services/networking.scm index 4cb7313808..86a6859a66 100644 --- a/gnu/services/networking.scm +++ b/gnu/services/networking.scm @@ -41,6 +41,7 @@ ;;; along with GNU Guix. If not, see . (define-module (gnu services networking) + #:use-module (gnu home services utils) #:use-module (gnu services) #:use-module (gnu services base) #:use-module (gnu services configuration) @@ -80,6 +81,7 @@ (define-module (gnu services networking) #:use-module (srfi srfi-9) #:use-module (srfi srfi-26) #:use-module (srfi srfi-43) + #:use-module ((ice-9 curried-definitions) #:select (define)) #:use-module (ice-9 match) #:use-module (ice-9 string-fun) #:use-module (json) @@ -233,6 +235,21 @@ (define-module (gnu services networking) wpa-supplicant-configuration-extra-options wpa-supplicant-service-type + iwd-configuration + iwd-configuration-config + iwd-configuration-ignored-interfaces + iwd-configuration-ignored-phys + iwd-configuration-interfaces + iwd-configuration-iwd + iwd-configuration-phys + iwd-configuration-shepherd-provision + iwd-configuration-shepherd-requirement + iwd-service-type + iwd-general-settings + iwd-network-settings + iwd-scan-settings + iwd-settings + hostapd-configuration hostapd-configuration? hostapd-configuration-package @@ -2083,6 +2100,225 @@ (define wpa-supplicant-service-type implements authentication, key negotiation and more for wireless networks.") (default-value (wpa-supplicant-configuration))))) + +;;; +;;; IWD +;;; +(define (iwd-uglify-field-name name) + (object->camel-case-string name 'upper)) + +(define (iwd-serialize-base field-name val) + (format #f "~a=~a\n" field-name val)) + +(define (iwd-serialize-field field-name val) + (iwd-serialize-base (iwd-uglify-field-name field-name) val)) + +(define iwd-serialize-number iwd-serialize-field) + +(define (iwd-serialize-boolean field-name value) + (iwd-serialize-field field-name (if value "true" "false"))) + +(define (iwd-serialize-alist field-name value) + (if (null? value) + "" + #~(string-append #$@(generic-serialize-alist list + iwd-serialize-base + value)))) + +(define-maybe boolean (prefix iwd-)) +(define-maybe number (prefix iwd-)) +(define-enumerated-field-type resolving-service + (none systemd resolvconf) + (prefix iwd-)) + +(define-configuration iwd-general-settings + (enable-network-configuration + (boolean #f) + "Setting this option to true enables @code{iwd} to configure the network +interfaces with the IP addresses.") + (extra-options + (alist '()) + "An association list of option symbols/strings to string values to be +appended to the General settings group.") + + (prefix iwd-)) + +(define-configuration iwd-network-settings + (enable-ipv6 + (boolean #t) + "Sets the global default that tells @code{iwd} whether it should configure +IPv6 addresses and routes") + + (name-resolving-service + (resolving-service 'none) + "Configures a DNS resolution method used by the system.") + + (extra-options + (alist '()) + "An association list of option symbols/strings to string values to be +appended to the Network settings group.") + + (prefix iwd-)) + +(define-configuration iwd-scan-settings + (disable-periodic-scan + maybe-boolean + "Setting this option to @code{#t} will prevent @code{iwd} from issuing the +periodic scans for the available networks while disconnected.") + + (initial-periodic-scan-interval + maybe-number + "The initial periodic scan interval upon disconnect (in seconds).") + + (maximum-periodic-scan-interval + maybe-number + "The maximum periodic scan interval (in seconds).") + + (disable-roaming-scan + maybe-boolean + "Setting this option to @code{#t} will prevent @code{iwd} from trying to scan +when roaming decisions are activated.") + + (extra-options + (alist '()) + "An association list of option symbols/strings to string values to be +appended to the Scan settings group.") + + (prefix iwd-)) + +(define-maybe iwd-network-settings) +(define-maybe iwd-scan-settings) + +(define ((iwd-serialize-config-section fields) name cfg) + #~(format #f "[~a]\n~a\n" + #$(string-upcase (object->string name) 0 1) + #$(serialize-configuration cfg fields))) + +(define serialize-iwd-network-settings + (iwd-serialize-config-section iwd-network-settings-fields)) + +(define serialize-iwd-scan-settings + (iwd-serialize-config-section iwd-scan-settings-fields)) + +(define serialize-iwd-general-settings + (iwd-serialize-config-section iwd-general-settings-fields)) + +(define-configuration iwd-settings + (general + (iwd-general-settings (iwd-general-settings)) + "General settings.") + + (network + maybe-iwd-network-settings + "Network settings.") + + (scan + maybe-iwd-scan-settings + "Scan settings.") + + (extra-config + (list-of-strings '()) + "Extra configuration values to append to the IWD configuration file." + (serializer (lambda (_ value) (string-join value "\n" 'suffix))))) + +(define-configuration/no-serialization iwd-configuration + (iwd + (file-like iwd) + "The IWD package to use.") + + (interfaces + (list-of-strings '()) + "If this is set, it must specify @dfn{glob patterns} matching network +interfaces that IWD will control.") + + (ignored-interfaces + (list-of-strings '()) + "If this is set, it must specify @dfn{glob patterns} matching network +interfaces that IWD will not manage.") + + (phys + (list-of-strings '()) + "If this is set, it must specify @dfn{glob patterns} matching network +PHYs names that IWD will control.") + + (ignored-phys + (list-of-strings '()) + "If this is set, it must specify @dfn{glob patterns} matching network +PHYs names that IWD will not manage.") + + (shepherd-requirement + (list-of-symbols '()) + "Shepherd requirements the service should depend on.") + + (shepherd-provision + (list-of-symbols '(iwd)) + "The name(s) of the service.") + + (config + (iwd-settings (iwd-settings)) + "Configuration settings.")) + +(define (iwd-generate-documentation) + (configuration->documentation 'iwd-configuration) + (configuration->documentation 'iwd-settings) + (configuration->documentation 'iwd-general-settings) + (configuration->documentation 'iwd-network-settings) + (configuration->documentation 'iwd-scan-settings)) + +(define (iwd-config-file config) + "Return an IWD configuration file." + (mixed-text-file "main.conf" + (serialize-configuration + (iwd-configuration-config config) + iwd-settings-fields))) + +(define (iwd-shepherd-service config) + (match-record config + (iwd interfaces ignored-interfaces + phys ignored-phys + shepherd-requirement shepherd-provision) + + (list (shepherd-service + (documentation "Run Internet Wireless Daemon") + (provision shepherd-provision) + (requirement `(user-processes dbus-system loopback ,@shepherd-requirement)) + (start #~(make-forkexec-constructor + (list (string-append #$iwd "/libexec/iwd") + "--logger=syslog" + #$@(if (null? interfaces) '() + (list (string-append "--interfaces=" + (string-join interfaces ",")))) + #$@(if (null? ignored-interfaces) '() + (list (string-append "--nointerfaces=" + (string-join ignored-interfaces ",")))) + #$@(if (null? phys) '() + (list (string-append "--phys=" + (string-join phys ",")))) + #$@(if (null? ignored-phys) '() + (list (string-append "--nophys=" + (string-join ignored-phys ","))))))) + (stop #~(make-kill-destructor)))))) + +(define (iwd-etc-service config) + `(("iwd/main.conf" ,(iwd-config-file config)))) + +(define iwd-service-type + (let ((add-iwd-package (compose list iwd-configuration-iwd))) + (service-type (name 'iwd) + (extensions + (list (service-extension shepherd-root-service-type + iwd-shepherd-service) + (service-extension etc-service-type + iwd-etc-service) + (service-extension dbus-root-service-type + add-iwd-package) + (service-extension profile-service-type + add-iwd-package))) + (default-value (iwd-configuration)) + (description + "Run @url{https://iwd.wiki.kernel.org/,Iwd}, +a network connection manager.")))) + ;;; ;;; Hostapd.