Received: (at 56145) by debbugs.gnu.org; 3 Jul 2022 10:38:41 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Jul 03 06:38:41 2022 Received: from localhost ([127.0.0.1]:43381 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1o7wzw-0002fE-Or for submit <at> debbugs.gnu.org; Sun, 03 Jul 2022 06:38:40 -0400 Received: from eggs.gnu.org ([209.51.188.92]:32876) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <ludo@HIDDEN>) id 1o7wzv-0002f1-3K for 56145 <at> debbugs.gnu.org; Sun, 03 Jul 2022 06:38:39 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:35886) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <ludo@HIDDEN>) id 1o7wzp-00083n-Lp; Sun, 03 Jul 2022 06:38:33 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:In-Reply-To:Date:References:Subject:To: From; bh=vjseHCNG3QBbdSJ5dEF48fQlcxoTejCIGLWH2qepjEo=; b=kKXL9e5d+d//BdfxnGCQ dXCSSpEV0iVbU+AEc5vJcp4O6ZFghoPt+q6ui6A6lEotN/ug9PEIgMgjKhYNGiHA8NBJ32muO+0+B Q0Csq/0QpgOMNdZdKRvT5KXU2IvcK8+ZiG9gpwax/3C6zSDF0PzVjVKVkYGlPZHMiF5vz7w92qMCk Hj9acXlvoGKHob9HzrAq0wt+f3MBoR+uOX9q5+4+zOur73VvAtKkL2UwFYDv+L6GT1NokLWildo+A Wbmag2RP418dVirBDa02JCK94U72U3uWLacn4mqKkhpekZ+BTaf9eulo5Ys0L0GUcg/8WpK88+urr JnQ0hl42zfgZZw==; Received: from 91-160-117-201.subs.proxad.net ([91.160.117.201]:50882 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <ludo@HIDDEN>) id 1o7wzp-00023d-9b; Sun, 03 Jul 2022 06:38:33 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= <ludo@HIDDEN> To: Hartmut Goebel <h.goebel@HIDDEN> Subject: Re: bug#56145: [PATCH 0/5] Add menus to Services sub-sections References: <cover.1655908912.git.h.goebel@HIDDEN> <201f3aa5e409f45423ec30187f37ee56cc0f7716.1655908912.git.h.goebel@HIDDEN> Date: Sun, 03 Jul 2022 12:38:32 +0200 In-Reply-To: <201f3aa5e409f45423ec30187f37ee56cc0f7716.1655908912.git.h.goebel@HIDDEN> (Hartmut Goebel's message of "Wed, 22 Jun 2022 17:55:07 +0200") Message-ID: <874jzy1nx3.fsf_-_@HIDDEN> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 56145 Cc: 56145 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) Hartmut Goebel <h.goebel@HIDDEN> skribis: > * doc/guix.texi (Services)[Base Services, Networking Setup, Networking > Services, X Window, Printing Services, Desktop Services, Sound Services, > LDAP, Certificate Services]: Structure section by adding headings for e= ach > service (in a broader snse fo service), ensure @anchors exist for each > heading and create a @menu at the top of the section. I=E2=80=99m less convinced about this one. I wonder if, instead of adding anchors, we should add proper sectioning at the same level as the existing sections (=E2=80=9CBase Services=E2=80=9D, etc.). Also, I don=E2=80=99t think we need one section (or anchor) per service: mingetty, agetty, and kmscon typically belong in the same section; likewise for urandom and rngd; udev, syslog, and nscd are arguably good fits under =E2=80=9CBase Services=E2=80=9D. WDYT? > +* Services related to files:: > +* Hostname:: Typographic note: titles should be capitalized, and =E2=80=9Chost name=E2= =80=9D is two words. :-) IWBN to have synopses after double colons like you did in the first patch. Ludo=E2=80=99.
guix-patches@HIDDEN:bug#56145; Package guix-patches.
Full text available.Received: (at 56145) by debbugs.gnu.org; 3 Jul 2022 10:33:17 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Jul 03 06:33:17 2022 Received: from localhost ([127.0.0.1]:43376 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1o7wuj-0002XP-3g for submit <at> debbugs.gnu.org; Sun, 03 Jul 2022 06:33:17 -0400 Received: from eggs.gnu.org ([209.51.188.92]:60228) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <ludo@HIDDEN>) id 1o7wuf-0002X7-06 for 56145 <at> debbugs.gnu.org; Sun, 03 Jul 2022 06:33:15 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:35848) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <ludo@HIDDEN>) id 1o7wuZ-0005xN-2R; Sun, 03 Jul 2022 06:33:07 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:In-Reply-To:Date:References:Subject:To: From; bh=EIIDPaOts11b+BJK8Jbp9YgqNs5w31oBJaJ+VBMBkdU=; b=H3nQKUOrfjHvG6cd/65A yGSwsNh6XPvphxCwj3JGuAeCz0vbML1xaLx+O7KV/ZLUj0A2+Gp20h/7L9a0rtX/rswCXpwkQiJP1 jlRQbzmM7S5m21FS5XZ9ZrdgAaDo/fN/Ywf2NFui41uwFB4iluQJw+QfRDcWc4yFsl0dz5UDbfC+n 7BFgJyiJ+NOJSztzbNspc51cs2m0AdToDAbuVTYVuEALQbqQ7c2l9QYh1FNKXtCLT/8VY6Ai5RFkX zRcCo9i1/kcCg80CjKWtX/6frG0y7QqRSp7p9riKQnesImTtUd5Zfb8RtI5XjEsO6UNhagQEYuCeM ksA4Z78Xf6ff4w==; Received: from 91-160-117-201.subs.proxad.net ([91.160.117.201]:52990 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <ludo@HIDDEN>) id 1o7wuX-0004mX-W5; Sun, 03 Jul 2022 06:33:06 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= <ludo@HIDDEN> To: Hartmut Goebel <h.goebel@HIDDEN> Subject: Re: bug#56145: [PATCH 0/5] Add menus to Services sub-sections References: <cover.1655908912.git.h.goebel@HIDDEN> <0dd93b0a014e8a3556e8aba5442d2d3b589ab525.1655908912.git.h.goebel@HIDDEN> Date: Sun, 03 Jul 2022 12:33:03 +0200 In-Reply-To: <0dd93b0a014e8a3556e8aba5442d2d3b589ab525.1655908912.git.h.goebel@HIDDEN> (Hartmut Goebel's message of "Wed, 22 Jun 2022 17:55:06 +0200") Message-ID: <87bku61o68.fsf_-_@HIDDEN> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 56145 Cc: 56145 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) Hi, This looks like a welcome improvement! Nitpick: Hartmut Goebel <h.goebel@HIDDEN> skribis: > +* Tailon Service:: A web application for viewing and s= earching log files. > +* Darkstat Service:: A packet sniffer. > +* Prometheus Node Exporter Service:: A client/agent for the Prometheus m= onitoring system. > +* Zabbix server:: A high performance monitoring syste= m. I think you can remove the article =E2=80=9Ca=E2=80=9D, it doesn=E2=80=99t = bring much. Thanks, Ludo=E2=80=99.
guix-patches@HIDDEN:bug#56145; Package guix-patches.
Full text available.Received: (at 56145) by debbugs.gnu.org; 22 Jun 2022 18:59:57 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jun 22 14:59:57 2022 Received: from localhost ([127.0.0.1]:36595 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1o45Zx-0007jn-Lh for submit <at> debbugs.gnu.org; Wed, 22 Jun 2022 14:59:57 -0400 Received: from laurent.telenet-ops.be ([195.130.137.89]:40512) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <maximedevos@HIDDEN>) id 1o45Zk-0007jT-Dc for 56145 <at> debbugs.gnu.org; Wed, 22 Jun 2022 14:59:52 -0400 Received: from ptr-bvsjgyhxw7psv60dyze.18120a2.ip6.access.telenet.be ([IPv6:2a02:1811:8c09:9d00:3c5f:2eff:feb0:ba5a]) by laurent.telenet-ops.be with bizsmtp id mJze270054UW6Th01Jze2d; Wed, 22 Jun 2022 20:59:38 +0200 Message-ID: <5342635245f0ba67f4320279e3bf755335355c98.camel@HIDDEN> Subject: Re: [bug#56145] [PATCH 0/5] Add menus to Services sub-sections From: Maxime Devos <maximedevos@HIDDEN> To: Hartmut Goebel <h.goebel@HIDDEN>, 56145 <at> debbugs.gnu.org Date: Wed, 22 Jun 2022 20:59:33 +0200 In-Reply-To: <cover.1655908912.git.h.goebel@HIDDEN> References: <cover.1655908912.git.h.goebel@HIDDEN> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-5TaV4HwcL4hiNDr7wc/E" User-Agent: Evolution 3.38.3-1 MIME-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r22; t=1655924378; bh=vmLTmwxaBdqzmWBTnHXjJWS0osQEAGHPvn0XmZwPwZU=; h=Subject:From:To:Date:In-Reply-To:References; b=e3HZzBSUJ0/dBTXVUn+kB1xRW6ZjQU5EZioXKUf5qVlnRrk6oeqEMLwzpDie9CJ1y nYmu99YsVpLe1NZXWrHUZKXHYNQjHmm31abcz1zxfIdFiMuCevZQW5s5IxwCT/ZJSU OR6tIybAsgtY8BEZDA0YaqOhrKXRlL1RqPTc9xzNoa7mvxakfHWv8931/870W0+UoW UnFVMwQHsFFRRpCxPmZJzZvtKYcDeyvwTTCKnkbxdnTkjbJ9QAugEAa812Qz1Jdogh dmlyuC3Q/e+WilyzELSSR8rEcgCXoaS79bm47kyYa3Sn8ckYb2+UE2f3qZxzwLLPQT lNkaXaWzg+5fQ== X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 56145 X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) --=-5TaV4HwcL4hiNDr7wc/E Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hartmut Goebel schreef op wo 22-06-2022 om 16:45 [+0200]: > Whenever I searched the services, it bugged me that I need to scroll thro= ugh > all the section to find which services are implemented and described > here. These patches add a @menu to each service section listing the headi= ngs > withing the section.=C2=A0 The second patch adds headings for sections wh= ich did > not have heading strucutres. >=20 Looking through the patches, looks nice and useful to me! --=-5TaV4HwcL4hiNDr7wc/E Content-Type: application/pgp-signature; name="signature.asc" Content-Description: This is a digitally signed message part Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- iI0EABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYrNmlRccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7igoAQCrFXLQH8PvwicOCeDwXm3MNgzp oQY2UZ5UMBqmt6u3ygEAy1UkGb9E9ZZsDk/pIwEhIIGtCcmctfrnlr0qqFZlAQs= =Mwt1 -----END PGP SIGNATURE----- --=-5TaV4HwcL4hiNDr7wc/E--
guix-patches@HIDDEN:bug#56145; Package guix-patches.
Full text available.
Received: (at 56145) by debbugs.gnu.org; 22 Jun 2022 15:55:41 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jun 22 11:55:41 2022
Received: from localhost ([127.0.0.1]:36392 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1o42hh-00052B-1Q
for submit <at> debbugs.gnu.org; Wed, 22 Jun 2022 11:55:41 -0400
Received: from mout.kundenserver.de ([217.72.192.73]:42787)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <h.goebel@HIDDEN>) id 1o42hV-000519-DZ
for 56145 <at> debbugs.gnu.org; Wed, 22 Jun 2022 11:55:29 -0400
Received: from hermia.goebel-consult.de ([79.211.183.96]) by
mrelayeu.kundenserver.de (mreue107 [212.227.15.183]) with ESMTPSA (Nemesis)
id 1M2fM1-1o6Vfg2PeB-004Dwq for <56145 <at> debbugs.gnu.org>; Wed, 22 Jun 2022
17:55:23 +0200
Received: from lenashee.fritz.box (lenashee.goebel-consult.de [192.168.110.2])
by hermia.goebel-consult.de (Postfix) with ESMTP id 4E675664D5;
Wed, 22 Jun 2022 17:55:19 +0200 (CEST)
From: Hartmut Goebel <h.goebel@HIDDEN>
To: 56145 <at> debbugs.gnu.org
Subject: [PATCH 5/5] doc: Add a URL link.
Date: Wed, 22 Jun 2022 17:55:10 +0200
Message-Id: <5569dcfb004430b8f4fe203203a27be58ca2a221.1655908913.git.h.goebel@HIDDEN>
X-Mailer: git-send-email 2.30.4
In-Reply-To: <cover.1655908912.git.h.goebel@HIDDEN>
References: <cover.1655908912.git.h.goebel@HIDDEN>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Provags-ID: V03:K1:0szIkx5qabd5CQzXYPg5hCLSpZJ2w+rxxB/uNQZyYXpd6BuPi5S
WL/Ezv2Q5/tRzUU41x+aDSVfeoFM6d+nvQcA1NwTL/gycB2nN7pJVn6NAWLNQ77ibDb4s8x
dZ5yo1nsiFHrg84+41moQxBE1mQNN2fsRC4Snv6ktk1lPEI3tvFkbKADaMxEu0hVBIec808
2f9W1hs4jl7nV412esSYw==
X-Spam-Flag: NO
X-UI-Out-Filterresults: notjunk:1;V03:K0:zw2IN8Z5bhQ=:tg+wCtektoVeBOFjyggUHy
izhZDgqugGc54O+Y1kd6sA5ugEErt8huGY6sz0XlQkIrDFQ0+QmqzavTUyTZNlszQkVlshjf4
4/6EqcE5iiCz1UmvrhbXpxeeBke+yoJCacXq3Td2kwvuoSK0xtioz51FbWBEAdIQ23XyvAXfD
kK/hL5epzH8Gz4IiT5sXQTKtYAg2YH0MuTLBnP2eIx34UXk07dlUpLeJubXxuXt56/xl/pI6m
3RDFPKB18Tn9HH9uttaH7VEXrpKO9/3+Clhey1YtOLRI3Ca+n8p1cp1KJVGpwUz22HvTCY9oh
KWsGSvvdK96QUR+wZUFI4yBvl+NU05hnXMF43u2LFEMzJpU94qD60fbebJwy+Fa0DZRyrSm28
29rEDvxcLQuRNkXPwISJxI9AI41S2BR+/CToeABZOPfSwv528jC18+W6M8RiOJVLF78ZDfqI9
XIUqTaF7bY+103QxABQmeUmUETtHhCEjiSXTcsVVRF84IMU5ebWKH0hX/qCADpsbwOIF4nKXV
51u8TX5yJxHmDq8JaALXD5AgRN525V0XpkvHm0KH7gbA2S7EOjeIlv4r8i/Ck+axLH7P4g4Z8
Yfv1LxDm0vFl9o/hvdFqO7Onq6+FFDzGPwK6/N/I9eEE7vQfHWraFsVijADWHh5nahExsF9Ci
uLS550PwUSNcyxCXkcOXi/Lu5aBs/QLFngnfxBWQhBM//UxDAhV34b7LqMKv/t4b7dS72vKnx
nP2H0SSOv7obBWMP+1vaeqojftjdLdiEWpexx+qFVAZmwy0aL/98aIMXgbs=
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 56145
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)
* doc/guix.texi (Services)[Telephony Services]{Jami}: Add link to the Jami
project home-page.
---
doc/guix.texi | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index db352bed95..25a6ca210d 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -26245,7 +26245,8 @@ services:
@cindex jami, service
-This section describes how to configure a Jami server that can be used
+This section describes how to configure a
+@uref{https://jami.net/, Jami} server that can be used
to host video (or audio) conferences, among other uses. The following
example demonstrates how to specify Jami account archives (backups) to
be provisioned automatically:
--
2.30.4
guix-patches@HIDDEN:bug#56145; Package guix-patches.
Full text available.Received: (at 56145) by debbugs.gnu.org; 22 Jun 2022 15:55:41 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jun 22 11:55:41 2022 Received: from localhost ([127.0.0.1]:36390 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1o42hg-000524-Om for submit <at> debbugs.gnu.org; Wed, 22 Jun 2022 11:55:40 -0400 Received: from mout.kundenserver.de ([212.227.17.24]:58603) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <h.goebel@HIDDEN>) id 1o42hS-000510-W9 for 56145 <at> debbugs.gnu.org; Wed, 22 Jun 2022 11:55:27 -0400 Received: from hermia.goebel-consult.de ([79.211.183.96]) by mrelayeu.kundenserver.de (mreue106 [212.227.15.183]) with ESMTPSA (Nemesis) id 1MAgIQ-1nxOqn160O-00B5Kf for <56145 <at> debbugs.gnu.org>; Wed, 22 Jun 2022 17:55:21 +0200 Received: from lenashee.fritz.box (lenashee.goebel-consult.de [192.168.110.2]) by hermia.goebel-consult.de (Postfix) with ESMTP id 4630D664D4; Wed, 22 Jun 2022 17:55:19 +0200 (CEST) From: Hartmut Goebel <h.goebel@HIDDEN> To: 56145 <at> debbugs.gnu.org Subject: [PATCH 4/5] doc: Small rewording. Date: Wed, 22 Jun 2022 17:55:09 +0200 Message-Id: <4a6eda0d158024e82be8b0fba97473df06713649.1655908913.git.h.goebel@HIDDEN> X-Mailer: git-send-email 2.30.4 In-Reply-To: <cover.1655908912.git.h.goebel@HIDDEN> References: <cover.1655908912.git.h.goebel@HIDDEN> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Provags-ID: V03:K1:sp2TrWxxFuUr+nWrbdrKBbtuXODFz64xgdh/w/j7WIM8UHwO5Zc nejdz7t8OVULQQZtjrRZvC5DOasBk83dBqI5edB5kqNaU/ScWyoHfhYpl7TYPa8YPYBT26m jGGYce7zqzPSCpbrXTMwqQHir2utpsmB2afTfGjxJ3OzZadiVrFHs5G8OLlxfQDxJj9I69Q 3pPdXrlq6H3oVu2WV3Enw== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:LsYB/fX7tOQ=:yq8XDSXwc21yKtrie3OZnL WVs345GJh+5B3iEZVgedResgwkav+dpXwbC+KW50n5X8iFsjF+9qXkvPjwsjDBUy9HR8OT/Yc 9LNYzsxBxOCjtVvC8RjR0c1/eyuNu/DXDn+esL0OMh1y+lL6x1vgI+egFoopZisamIGnjlzVL sbU2ufdliXcNXOSQOn6BWuIRPwPc1XW43EwQ2VyeyyrXR/XJhAOyHBd0VbSN0LBO5KLrZWxKL Q3o7Tbrb89wknFk9/UIk5wj+ERy6nbrTsrxZxfMP+0nccpzXVMQBt0wemiafdGhfvdbKWM+AC Sf/KPNhPGepdnUcgx231dTTGr9/oCDRbXssiYdQ4I7zKbXbsXLPJ/ok7C9a753jFERnVZL7M9 pWA4Q68XwawGdgE/jiJveXBLs5DZrKzj5rY22Y9lj2VDAZVecVSNNq2EGfS9U5R7DTQneYx9t Vsjqas745GO+zGsTH8xGOL+wg1Ja5qG67pudkHXUKQj3KfSoHU6K85g/WaRr4SLtfE7LwLE6y UUmqBSfmTnB9X7s75bUkCw6jUrEW8O9jeE+j6SUajGW2niFiyYj7bchORnSn+4SjNFxZZGEaX GiNteobnRm96hT5oKn7XJvNt4SDqisVbpSvAffeqOS5zgLcGblslZ0NdkXdd727121Zge8YWv ilyP2E/Sl8LWELtlF/421i6kr6JlSf7ma/Yf0dvj9l9l/bY5IhpOp0dGQdfFviGaZ75B4A1Ml r/pRWxrpNWJYOqR6dGVrc0aopAxAjDQcyY5WfnfJeaPMdpGExzrX1fLEsJI= X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 56145 X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) * doc/guix.texi (Services)[Continuous Integration]: Add quotes to mark terms as such. Fix typo. --- doc/guix.texi | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index f8f730648a..db352bed95 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -31597,8 +31597,8 @@ evaluated, they are sent to the local Guix daemon. Cuirass then listens to the Guix daemon output to detect the various build events. @item Using the remote build mechanism. -The build jobs are not submitted to the local Guix daemon. Instead, a -remote server dispatches build requests to the connect remote workers, +The build jobs are not submitted to the local Guix daemon. Instead, one +``remote server'' dispatches build requests to the connected ``remote workers'', according to the build priorities. @end itemize -- 2.30.4
guix-patches@HIDDEN:bug#56145; Package guix-patches.
Full text available.
Received: (at 56145) by debbugs.gnu.org; 22 Jun 2022 15:55:40 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jun 22 11:55:40 2022
Received: from localhost ([127.0.0.1]:36388 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1o42hg-00051v-Ga
for submit <at> debbugs.gnu.org; Wed, 22 Jun 2022 11:55:40 -0400
Received: from mout.kundenserver.de ([212.227.17.13]:42621)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <h.goebel@HIDDEN>) id 1o42hQ-00050w-Iu
for 56145 <at> debbugs.gnu.org; Wed, 22 Jun 2022 11:55:26 -0400
Received: from hermia.goebel-consult.de ([79.211.183.96]) by
mrelayeu.kundenserver.de (mreue108 [212.227.15.183]) with ESMTPSA (Nemesis)
id 1MNso2-1oJU5e42A4-00OIqg for <56145 <at> debbugs.gnu.org>; Wed, 22 Jun 2022
17:55:18 +0200
Received: from lenashee.fritz.box (lenashee.goebel-consult.de [192.168.110.2])
by hermia.goebel-consult.de (Postfix) with ESMTP id 323C3664D3;
Wed, 22 Jun 2022 17:55:19 +0200 (CEST)
From: Hartmut Goebel <h.goebel@HIDDEN>
To: 56145 <at> debbugs.gnu.org
Subject: [PATCH 3/5] doc: Fix a URL.
Date: Wed, 22 Jun 2022 17:55:08 +0200
Message-Id: <dd90991ec810e25827a4482258e884eb4971a0d1.1655908912.git.h.goebel@HIDDEN>
X-Mailer: git-send-email 2.30.4
In-Reply-To: <cover.1655908912.git.h.goebel@HIDDEN>
References: <cover.1655908912.git.h.goebel@HIDDEN>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Provags-ID: V03:K1:dPzGlo8JRk4bORaw5ykrOJ9HVaRArHY1q6JcH/8HasJxg+xZqiH
zb4mLqgw8dvyo2WC9KdAasp5Plkdq90kWnKDZk4xheagf5tm7JMRb0H+gCDTNSmvsiuigaS
dgEgOjC9BDkFItZAq/yIbFFvcIcPvRKiKo0LSAUie6QE5fepZAdb2RAdivcB0BxpnPv3mO7
9D2Zu+/336r2aHz0Qv+Dw==
X-Spam-Flag: NO
X-UI-Out-Filterresults: notjunk:1;V03:K0:4etTAEjHdik=:rIUqk02UuigvNYE9GORfA3
ZYtSiku9m+h+eXNBnQ/IQxEeMB/SY/kEv4MCP7i67fbym11JuZCPzmm+HlhcedNIBuYjY2w4O
XrYB039aMr7dGVhms5mkSeafL6r5NZDSewFYQml6VmbWIgn+FDxOepGZmx/i0F9vubv4byJUc
NmH6eZxBhQ5mLSwuOTAzVjwRL+2/ItepIyKiMHYINkQEjzLipdEH39FOCQ3mhdcwYy8hkB9eb
sEZwPctX1f4CLW/Y7HiMsLMKWf2Klhv4nss58fah4542y4us+VaMDkeGIQiGCfIjD/Cb/c0oq
Wmd3I04Rcymc2lC8HYEpsyIt3Elt7julhnQjWSzzzG1ERpPzGjaVialwielYPGnzHrUxIgAqv
hp7n+RVA++uygoITfR31FeNYhSkhH8qmpMF+FOvgZINx/Ull8vW41NvGHlhmVAadc+drzq/tn
ne+tXoM4MdfcVMxkRCF+feHdnvO0mOENgBnF2zEizkgtpfdnXUqb7//ljO4D8h96aLh/KcUG7
rjWyxqKmi12IIaA29KCwXQuyfnJV6MQsXixbPe/vY2C06an1XkrGjtEmVPdEApGUn7zYZO4jP
OWNyCaUZjrSlx1iB605zGq/tXgBdiUMmrhmetq0aFzv9XLJvERrpfU+YaeAIwTsoQX5wNdQYP
C/XcCfv8GxkD0HaiqicSlvzsFsx+3mgjoBlTC1z6eBFSMSvhFLJkTh0zmdOc4Umkf3KkkYHV8
DbUTwicdewYRzLb0cszbBm1dr0LGGc7dIRbl49jPUS7TykZDOEF/qZnb2Hw=
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 56145
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)
* doc/guix.texi (Services)[Desktop Services]: Fix an URL.
---
doc/guix.texi | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 4db012d651..f8f730648a 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -22313,7 +22313,7 @@ The GNOME package to use.
@subsubheading Xfce Desktop Environment
@defvr {Scheme Variable} xfce-desktop-service-type
-This is the type of a service to run the @uref{Xfce, https://xfce.org/}
+This is the type of a service to run the @uref{https://xfce.org/, Xfce}
desktop environment. Its value is an @code{xfce-desktop-configuration} object
(see below).
--
2.30.4
guix-patches@HIDDEN:bug#56145; Package guix-patches.
Full text available.
Received: (at 56145) by debbugs.gnu.org; 22 Jun 2022 15:55:40 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jun 22 11:55:40 2022
Received: from localhost ([127.0.0.1]:36386 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1o42hW-00051f-IO
for submit <at> debbugs.gnu.org; Wed, 22 Jun 2022 11:55:40 -0400
Received: from mout.kundenserver.de ([212.227.17.13]:47151)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <h.goebel@HIDDEN>) id 1o42hO-00050t-BQ
for 56145 <at> debbugs.gnu.org; Wed, 22 Jun 2022 11:55:26 -0400
Received: from hermia.goebel-consult.de ([79.211.183.96]) by
mrelayeu.kundenserver.de (mreue107 [212.227.15.183]) with ESMTPSA (Nemesis)
id 1M3lHZ-1o3DLr0Bmt-000uzv for <56145 <at> debbugs.gnu.org>; Wed, 22 Jun 2022
17:55:16 +0200
Received: from lenashee.fritz.box (lenashee.goebel-consult.de [192.168.110.2])
by hermia.goebel-consult.de (Postfix) with ESMTP id 2646B664D2;
Wed, 22 Jun 2022 17:55:19 +0200 (CEST)
From: Hartmut Goebel <h.goebel@HIDDEN>
To: 56145 <at> debbugs.gnu.org
Subject: [PATCH 2/5] doc: Add menus to Services sub-sections (part 2/2).
Date: Wed, 22 Jun 2022 17:55:07 +0200
Message-Id: <201f3aa5e409f45423ec30187f37ee56cc0f7716.1655908912.git.h.goebel@HIDDEN>
X-Mailer: git-send-email 2.30.4
In-Reply-To: <cover.1655908912.git.h.goebel@HIDDEN>
References: <cover.1655908912.git.h.goebel@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Provags-ID: V03:K1:XMrGjaDSZIP5P2ZoRk7s7qnEMibQ7o9ZOZ2Yn3owchgcCaGTWI9
nt8dA1c/DWq/1G2RzeOk/t9wdFUWQQRFjdOaMLZPTWl2NxxgpbELwwYR7HzqG75RyD9j05D
18q1nXlUySvmTZYN2zrXKTQRJH79FflDnFbgQ//EVxsp777Swuf4e1O0QRVEeRuZKH2hgBI
Lta/wP4FoTqnec0r/9Jdg==
X-Spam-Flag: NO
X-UI-Out-Filterresults: notjunk:1;V03:K0:nfqgWl152dA=:yqBQGvXyv0kGU3NjPO/sYA
ve4zfIm+bZ/lQwvDfzaYymJBw/GoZLjuEGiRuWjqO2AnfuE5mfebfqXj2jVsAoLnxyi2Xdo2k
E6Y3u6AvtYifrNx1BZhfkWfVJsrR3kGPhm+esTucNrmIBMm16vb8n5nxei24BPH2KHQIAsfQm
U2sqMyRX3j7vwtiy2YGgmr6Mxd0/BIfbFxwrwzMmxdRiqEbD92S563E0nGH6FQhjhME6V48n3
dd0YA7R8xchq9OQMd9Kc4OM94CHcBhsjjyaDX57Mn/ew3sux/vpFHdG3yuc7V6beGc2JJ+x5Q
0bxcv6a1GwXnYtS/79TxV6JonfM8xsMWAjQ3BGO0vr5IOJ5rViXFdGuw20MxvKv5ubAipwGBH
r6+2+kBrLCvyQwHhMH80UrqCsm4McuN2d69qB8hXg7PCsRaPK5rd7tuHUPZqHhUfrq9bPkR9w
hPkuD4rrvGN2iYcNPriap3cKqaoLNf+BukyeLKQ14CXSwUza8zNLLEoIU/ZuNKSSOHVN/FE9M
UfsfUYMN/dRFPsNS2nILhGby48epT6caRORCntV+ArYaP6F9/T1FlqBAk8ZVrFif+mdtdFNoA
4gCg3RFsWRd7pu0rEDf8GZcbkCiGfpoGG9vmNhXZV3YHF9S7LwRodHDGGpkVAMoNAUVpEP88E
I0wEwx5EKNW6Br8ninSM5rsKdw2qqplVH64qgTzaq6AAAUSXPEYr9mopT3vdOrQaqdGTw1x6s
CvtyL5eIXNewNCwvvj39C3JOLFvBIIRdG37EHVCADmvwlwJxRroyYoout9BKS9VvGBf4ZqjHG
I2VIz7gIeBFfqtSULlTYtydwt1U5Q==
X-Spam-Score: 2.8 (++)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
has NOT identified this incoming email as spam. The original
message has been attached to this so you can view it or label
similar future email. If you have any questions, see
the administrator of that system for details.
Content preview: * doc/guix.texi (Services)[Base Services, Networking Setup,
Networking Services, X Window, Printing Services, Desktop Services, Sound
Services, LDAP, Certificate Services]: Structure section by adding [...]
Content analysis details: (2.8 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
-0.0 RCVD_IN_MSPIKE_H2 RBL: Average reputation (+2)
[212.227.17.13 listed in wl.mailspike.net]
0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record
0.0 SPF_NONE SPF: sender does not publish an SPF Record
2.8 PERCENT_RANDOM Message has a random macro in it
-0.0 T_SCC_BODY_TEXT_LINE No description available.
X-Debbugs-Envelope-To: 56145
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 1.8 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
has NOT identified this incoming email as spam. The original
message has been attached to this so you can view it or label
similar future email. If you have any questions, see
the administrator of that system for details.
Content preview: * doc/guix.texi (Services)[Base Services, Networking Setup,
Networking Services, X Window, Printing Services, Desktop Services, Sound
Services, LDAP, Certificate Services]: Structure section by adding [...]
Content analysis details: (1.8 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record
0.0 SPF_NONE SPF: sender does not publish an SPF Record
2.8 PERCENT_RANDOM Message has a random macro in it
-0.0 T_SCC_BODY_TEXT_LINE No description available.
-1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list
manager
* doc/guix.texi (Services)[Base Services, Networking Setup, Networking
Services, X Window, Printing Services, Desktop Services, Sound Services,
LDAP, Certificate Services]: Structure section by adding headings for each
service (in a broader snse fo service), ensure @anchors exist for each
heading and create a @menu at the top of the section.
---
doc/guix.texi | 428 +++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 423 insertions(+), 5 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 58eb47535d..4db012d651 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -17267,6 +17267,25 @@ declaration.
The @code{(gnu services base)} module provides definitions for the basic
services that one expects from the system. The services exported by
this module are listed below.
+@menu
+* Services related to files::
+* Hostname::
+* Console::
+* Login::
+* mingetty::
+* agetty::
+* kmscon::
+* Name Service Cache Daemon::
+* Syslog::
+* Guix Build Daemon::
+* Guix Publish::
+* udev::
+* urandom::
+* gpm::
+* rngd::
+* PAM limits::
+* greetd::
+@end menu
@defvr {Scheme Variable} %base-services
This variable contains a list of basic services (@pxref{Service Types
@@ -17287,6 +17306,10 @@ this:
@end lisp
@end defvr
+
+@anchor{Services related to files}
+@subsubheading Services related to files
+
@defvr {Scheme Variable} special-files-service-type
This is the service that sets up ``special files'' such as
@file{/bin/sh}; an instance of it is part of @code{%base-services}.
@@ -17331,10 +17354,18 @@ symlink:
@end lisp
@end deffn
+
+@anchor{Hostname}
+@subsubheading Hostname
+
@deffn {Scheme Procedure} host-name-service @var{name}
Return a service that sets the host name to @var{name}.
@end deffn
+
+@anchor{Console}
+@subsubheading Console
+
@defvr {Scheme Variable} console-font-service-type
Install the given fonts on the specified ttys (fonts are per
virtual console on the kernel Linux). The value of this service is a list of
@@ -17352,6 +17383,10 @@ package or any valid argument to @command{setfont}, as in this example:
@end lisp
@end defvr
+
+@anchor{Login}
+@subsubheading Login
+
@deffn {Scheme Procedure} login-service @var{config}
Return a service to run login according to @var{config}, a
@code{<login-configuration>} object, which specifies the message of the day,
@@ -17374,6 +17409,10 @@ the 'root' account has just been created.
@end table
@end deftp
+
+@anchor{mingetty}
+@subsubheading mingetty
+
@deffn {Scheme Procedure} mingetty-service @var{config}
Return a service to run mingetty according to @var{config}, a
@code{<mingetty-configuration>} object, which specifies the tty to run, among
@@ -17412,6 +17451,10 @@ The Mingetty package to use.
@end table
@end deftp
+
+@anchor{agetty}
+@subsubheading agetty
+
@deffn {Scheme Procedure} agetty-service @var{config}
Return a service to run agetty according to @var{config}, an
@code{<agetty-configuration>} object, which specifies the tty to run,
@@ -17595,6 +17638,10 @@ The option can be used to provides extra shepherd requirements (for example
@end table
@end deftp
+
+@anchor{kmscon}
+@subsubheading kmscon
+
@deffn {Scheme Procedure} kmscon-service-type @var{config}
Return a service to run @uref{https://www.freedesktop.org/wiki/Software/kmscon,kmscon}
according to @var{config}, a @code{<kmscon-configuration>} object, which
@@ -17644,6 +17691,9 @@ The Kmscon package to use.
@end table
@end deftp
+
+@anchor{Name Service Cache Daemon}
+@subsubheading Name Service Cache Daemon
@cindex name service cache daemon
@cindex nscd
@deffn {Scheme Procedure} nscd-service [@var{config}] [#:glibc glibc] @
@@ -17759,9 +17809,13 @@ privacy---often the result of host name lookups is in local cache, so
external name servers do not even need to be queried.
@end defvr
+
@anchor{syslog-configuration-type}
+@anchor{Syslog}
+@subsubheading Syslog
@cindex syslog
@cindex logging
+
@deftp {Data Type} syslog-configuration
This data type represents the configuration of the syslog daemon.
@@ -17784,6 +17838,10 @@ Return a service that runs a syslog daemon according to @var{config}.
information on the configuration file syntax.
@end deffn
+
+@anchor{Guix Build Daemon}
+@subsubheading Guix Build Daemon
+
@defvr {Scheme Variable} guix-service-type
This is the type of the service that runs the build daemon,
@command{guix-daemon} (@pxref{Invoking guix-daemon}). Its value must be a
@@ -17939,6 +17997,10 @@ A list of file-like objects or strings pointing to additional directories the bu
@end table
@end deftp
+
+@anchor{udev}
+@subsubheading udev
+
@deffn {Scheme Procedure} udev-service [#:udev @var{eudev} #:rules @code{'()}]
Run @var{udev}, which populates the @file{/dev} directory dynamically.
udev rules can be provided as a list of files through the @var{rules}
@@ -18047,6 +18109,10 @@ well as in the @var{groups} of the @code{udev-rules-service} procedure.
%desktop-services)))
@end lisp
+
+@anchor{urandom}
+@subsubheading urandom
+
@defvr {Scheme Variable} urandom-seed-service-type
Save some entropy in @code{%random-seed-file} to seed @file{/dev/urandom}
when rebooting. It also tries to seed @file{/dev/urandom} from
@@ -18060,8 +18126,12 @@ This is the name of the file where some random bytes are saved by
It defaults to @file{/var/lib/random-seed}.
@end defvr
+
+@anchor{gpm}
+@subsubheading gpm
@cindex mouse
@cindex gpm
+
@defvr {Scheme Variable} gpm-service-type
This is the type of the service that runs GPM, the @dfn{general-purpose
mouse daemon}, which provides mouse support to the Linux console. GPM
@@ -18088,7 +18158,11 @@ The GPM package to use.
@end table
@end deftp
+
@anchor{guix-publish-service-type}
+@anchor{Guix Publish}
+@subsubheading Guix Publish
+
@deffn {Scheme Variable} guix-publish-service-type
This is the service type for @command{guix publish} (@pxref{Invoking
guix publish}). Its value must be a @code{guix-publish-configuration}
@@ -18173,6 +18247,9 @@ seconds for the negative lookups. @xref{Invoking guix publish,
@end deftp
@anchor{rngd-service}
+@anchor{rngd}
+@subsubheading rngd
+
@deffn {Scheme Procedure} rngd-service [#:rng-tools @var{rng-tools}] @
[#:device "/dev/hwrng"]
Return a service that runs the @command{rngd} program from @var{rng-tools}
@@ -18180,7 +18257,10 @@ to add @var{device} to the kernel's entropy pool. The service will fail if
@var{device} does not exist.
@end deffn
+
@anchor{pam-limits-service}
+@anchor{PAM limits}
+@subsubheading PAM limits
@cindex session limits
@cindex ulimit
@cindex priority
@@ -18228,6 +18308,10 @@ about the Pluggable Authentication Module (PAM) limits, refer to the
@samp{pam_limits} man page from the @code{linux-pam} package.
@end deffn
+
+@anchor{greetd}
+@subsubheading greetd
+
@defvr {Scheme Variable} greetd-service-type
@uref{https://git.sr.ht/~kennylevinsen/greetd, @code{greetd}} is a minimal and
flexible login manager daemon, that makes no assumptions about what you
@@ -18686,6 +18770,20 @@ configuration or a simple DHCP client are often more appropriate.
This section describes the various network setup services available,
starting with static network configuration.
+@menu
+* Static Networking::
+* DHCP Client::
+* NetworkManager::
+* Connman::
+* WiFi / WPA::
+* ModemManager::
+* USB Modeswitch::
+@end menu
+
+
+@anchor{Static Networking}
+@subsubheading Static Networking
+
@defvr {Scheme Variable} static-networking-service-type
This is the type for statically-configured network interfaces. Its
value must be a list of @code{static-networking} records. Each of them
@@ -18862,13 +18960,20 @@ when using QEMU's user-mode network stack on @code{eth0} (@pxref{Using
the user mode network stack,,, QEMU, QEMU Documentation}).
@end defvr
+
+@anchor{DHCP Client}
+@subsubheading DHCP Client
@cindex DHCP, networking service
+
@defvr {Scheme Variable} dhcp-client-service-type
This is the type of services that run @var{dhcp}, a Dynamic Host Configuration
Protocol (DHCP) client, on all the non-loopback network interfaces. Its value
is the DHCP client package to use, @code{isc-dhcp} by default.
@end defvr
+
+@anchor{NetworkManager}
+@subsubheading NetworkManager
@cindex NetworkManager
@defvr {Scheme Variable} network-manager-service-type
@@ -18939,7 +19044,11 @@ package, which allows NetworkManager to manage VPNs @i{via} OpenVPN.
@end table
@end deftp
+
+@anchor{Connman}
+@subsubheading Connman
@cindex Connman
+
@deffn {Scheme Variable} connman-service-type
This is the service type to run @url{https://01.org/connman,Connman},
a network connection manager.
@@ -18968,7 +19077,11 @@ When true, disable connman's vpn plugin.
@end table
@end deftp
+
+@anchor{WiFi / WPA}
+@subsubheading WiFi / WPA
@cindex WPA Supplicant
+
@defvr {Scheme Variable} wpa-supplicant-service-type
This is the service type to run @url{https://w1.fi/wpa_supplicant/,WPA
supplicant}, an authentication daemon required to authenticate against
@@ -19005,7 +19118,11 @@ List of additional command-line arguments to pass to the daemon.
@end table
@end deftp
+
+@anchor{ModemManager}
+@subsubheading ModemManager
@cindex ModemManager
+
Some networking devices such as modems require special care, and this is
what the services below focus on.
@@ -19029,6 +19146,9 @@ The ModemManager package to use.
@end table
@end deftp
+
+@anchor{USB Modeswitch}
+@subsubheading USB Modeswitch
@cindex USB_ModeSwitch
@cindex Modeswitching
@@ -19079,6 +19199,38 @@ running a WiFi access point with @command{hostapd}, running the
@command{inetd} ``superdaemon'', and more. This section describes
those.
+@menu
+* DHCP Server::
+* hostapd::
+* Simulate WiFi Networking::
+* iptables::
+* nftables::
+* ntpd::
+* OpenNTPD::
+* inetd::
+* OpenDHT::
+* Tor Anonymous Networking Daemon::
+* rsync Server::
+* syncthing::
+* SSH::
+* lsh::
+* OpenSSH::
+* Dropbear SSH Daemon::
+* AutoSSH::
+* WebSSH::
+* Facebook Host Aliases::
+* avahi::
+* Open vSwitch::
+* PageKite::
+* Yggdrasil::
+* IPFS network::
+* keepalived::
+@end menu
+
+@anchor{DHCP Server}
+@subsubheading DHCP Server
+@cindex DHCP
+
@deffn {Scheme Procedure} dhcpd-service-type
This type defines a service that runs a DHCP daemon. To create a
service of this type, you must supply a @code{<dhcpd-configuration>}.
@@ -19124,8 +19276,12 @@ interfaces here; see @code{man dhcpd} for details.
@end table
@end deftp
+
+@anchor{hostapd}
+@subsubheading hostapd
@cindex hostapd service, for Wi-Fi access points
@cindex Wi-Fi access points, hostapd service
+
@defvr {Scheme Variable} hostapd-service-type
This is the service type to run the @uref{https://w1.fi/hostapd/,
hostapd} daemon to set up WiFi (IEEE 802.11) access points and
@@ -19175,6 +19331,11 @@ configuration file reference.
@end table
@end deftp
+
+@anchor{Simulate WiFi Networking}
+@subsubheading Simulate WiFi Networking
+@cindex WiFi
+
@defvr {Scheme Variable} simulated-wifi-service-type
This is the type of a service to simulate WiFi networking, which can be
useful in virtual machines for testing purposes. The service loads the
@@ -19187,7 +19348,10 @@ The service's value is a @code{hostapd-configuration} record.
@end defvr
+@anchor{iptables}
+@subsubheading iptables
@cindex iptables
+
@defvr {Scheme Variable} iptables-service-type
This is the service type to set up an iptables configuration. iptables is a
packet filtering framework supported by the Linux kernel. This service
@@ -19237,7 +19401,11 @@ objects}).
@end table
@end deftp
+
+@anchor{nftables}
+@subsubheading nftables
@cindex nftables
+
@defvr {Scheme Variable} nftables-service-type
This is the service type to set up a nftables configuration. nftables is a
netfilter project that aims to replace the existing iptables, ip6tables,
@@ -19264,9 +19432,13 @@ The nftables ruleset to use. This may be any ``file-like'' object
@end table
@end deftp
+
+@anchor{ntpd}
+@subsubheading ntpd
@cindex NTP (Network Time Protocol), service
@cindex ntpd, service for the Network Time Protocol daemon
@cindex real time clock
+
@defvr {Scheme Variable} ntp-service-type
This is the type of the service running the @uref{https://www.ntp.org,
Network Time Protocol (NTP)} daemon, @command{ntpd}. The daemon will keep the
@@ -19325,7 +19497,11 @@ to use with the options @option{iburst} and @option{prefer}, as well as
@end table
@end deftp
+
+@anchor{OpenNTPD}
+@subsubheading OpenNTPD
@cindex OpenNTPD
+
@deffn {Scheme Procedure} openntpd-service-type
Run the @command{ntpd}, the Network Time Protocol (NTP) daemon, as implemented
by @uref{http://www.openntpd.org, OpenNTPD}. The daemon will keep the system
@@ -19379,7 +19555,11 @@ IP addresses, @code{ntpd} will calculate a median constraint from all of them.
@end table
@end deftp
+
+@anchor{inetd}
+@subsubheading inetd
@cindex inetd
+
@deffn {Scheme variable} inetd-service-type
This service runs the @command{inetd} (@pxref{inetd invocation,,,
inetutils, GNU Inetutils}) daemon. @command{inetd} listens for
@@ -19472,8 +19652,12 @@ must be @code{'()} or @code{'("internal")}.
detailed discussion of each configuration field.
@end deftp
-@cindex opendht, distributed hash table network service
+
+@anchor{OpenDHT}
+@subsubheading OpenDHT
+@cindex OpenDHT, distributed hash table network service
@cindex dhtproxy, for use with jami
+
@defvr {Scheme Variable} opendht-service-type
This is the type of the service running a @uref{https://opendht.net,
OpenDHT} node, @command{dhtnode}. The daemon can be used to host your
@@ -19566,7 +19750,11 @@ Defaults to @samp{disabled}.
@end deftypevr
@end deftp
+
+@anchor{Tor Anonymous Networking Daemon}
+@subsubheading Tor Anonymous Networking Daemon
@cindex Tor
+
@defvr {Scheme Variable} tor-service-type
This is the type for a service that runs the @uref{https://torproject.org,
Tor} anonymous networking daemon. The service is configured using a
@@ -19641,6 +19829,10 @@ See @uref{https://www.torproject.org/docs/tor-hidden-service.html.en, the Tor
project's documentation} for more information.
@end deffn
+@anchor{rsync Server}
+@subsubheading rsync Server
+@cindex rsync
+
The @code{(gnu services rsync)} module provides the following services:
You might want an rsync daemon if you have files that you want available
@@ -19746,6 +19938,11 @@ client.
@end table
@end deftp
+
+@anchor{syncthing}
+@subsubheading syncthing
+@cindex syncthing
+
The @code{(gnu services syncthing)} module provides the following services:
@cindex syncthing
@@ -19795,7 +19992,17 @@ directory is @file{$HOME} of the specified Syncthing @code{user}.
@end deftp
@end deffn
+
+@anchor{SSH}
+@subsubheading SSH
+@cindex SSH
+@cindex SSH server
+
Furthermore, @code{(gnu services ssh)} provides the following services.
+
+
+@anchor{lsh}
+@subsubheading lsh
@cindex SSH
@cindex SSH server
@@ -19835,8 +20042,11 @@ root.
The other options should be self-descriptive.
@end deffn
+@anchor{OpenSSH}
+@subsubheading OpenSSH
@cindex SSH
@cindex SSH server
+
@deffn {Scheme Variable} openssh-service-type
This is the type for the @uref{http://www.openssh.org, OpenSSH} secure
shell daemon, @command{sshd}. Its value must be an
@@ -20027,6 +20237,12 @@ Match Address 192.168.0.1
@end table
@end deftp
+
+@anchor{Dropbear SSH Daemon}
+@subsubheading Dropbear SSH Daemon
+@cindex SSH
+@cindex SSH server
+
@deffn {Scheme Procedure} dropbear-service [@var{config}]
Run the @uref{https://matt.ucc.asn.au/dropbear/dropbear.html,Dropbear SSH
daemon} with the given @var{config}, a @code{<dropbear-configuration>}
@@ -20068,7 +20284,11 @@ Whether to enable password-based authentication.
@end table
@end deftp
+
+@anchor{AutoSSH}
+@subsubheading AutoSSH
@cindex AutoSSH
+
@deffn {Scheme Variable} autossh-service-type
This is the type for the @uref{https://www.harding.motd.ca/autossh,
AutoSSH} program that runs a copy of @command{ssh} and monitors it,
@@ -20148,7 +20368,11 @@ may cause undefined behaviour.
@end table
@end deftp
+
+@anchor{WebSSH}
+@subsubheading WebSSH
@cindex WebSSH
+
@deffn {Scheme Variable} webssh-service-type
This is the type for the @uref{https://webssh.huashengdun.org/, WebSSH}
program that runs a web SSH client. WebSSH can be run manually from the
@@ -20223,6 +20447,10 @@ Logging level.
@end table
@end deftp
+
+@anchor{Facebook Host Aliases}
+@subsubheading Facebook Host Aliases
+
@defvr {Scheme Variable} %facebook-host-aliases
This variable contains a string for use in @file{/etc/hosts}
(@pxref{Host Names,,, libc, The GNU C Library Reference Manual}). Each
@@ -20252,6 +20480,10 @@ This mechanism can prevent programs running locally, such as Web
browsers, from accessing Facebook.
@end defvr
+
+@anchor{avahi}
+@subsubheading avahi
+
The @code{(gnu services avahi)} provides the following definition.
@defvr {Scheme Variable} avahi-service-type
@@ -20303,6 +20535,11 @@ This is a list of domains to browse.
@end table
@end deftp
+
+@anchor{Open vSwitch}
+@subsubheading Open vSwitch
+@cindex Open vSwitch
+
@deffn {Scheme Variable} openvswitch-service-type
This is the type of the @uref{https://www.openvswitch.org, Open vSwitch}
service, whose value should be an @code{openvswitch-configuration}
@@ -20321,6 +20558,11 @@ Package object of the Open vSwitch.
@end table
@end deftp
+
+@anchor{PageKite}
+@subsubheading PageKite
+@cindex PageKite
+
@defvr {Scheme Variable} pagekite-service-type
This is the service type for the @uref{https://pagekite.net, PageKite} service,
a tunneling solution for making localhost servers publicly visible, even from
@@ -20367,6 +20609,11 @@ Use this to add additional options and manage shared secrets out-of-band.
@end table
@end deftp
+
+@anchor{Yggdrasil}
+@subsubheading Yggdrasil
+@cindex Yggdrasil
+
@defvr {Scheme Variable} yggdrasil-service-type
The service type for connecting to the @uref{https://yggdrasil-network.github.io/,
Yggdrasil network}, an early-stage implementation of a fully end-to-end
@@ -20455,7 +20702,11 @@ address, delete everything except these options:
@end table
@end deftp
+
+@anchor{IPFS network}
+@subsubheading IPFS network
@cindex IPFS
+
@defvr {Scheme Variable} ipfs-service-type
The service type for connecting to the @uref{https://ipfs.io,IPFS network},
a global, versioned, peer-to-peer file system. Pass it a
@@ -20486,7 +20737,11 @@ Address of the API endpoint, in ‘multiaddress’ format.
@end table
@end deftp
+
+@anchor{keepalived}
+@subsubheading keepalived
@cindex keepalived
+
@deffn {Scheme Variable} keepalived-service-type
This is the type for the @uref{https://www.keepalived.org/, Keepalived}
routing software, @command{keepalived}. Its value must be an
@@ -20676,16 +20931,25 @@ File where unattended upgrades are logged.
@end table
@end deftp
+
@node X Window
@subsection X Window
@cindex X11
@cindex X Window System
+
@cindex login manager
Support for the X Window graphical display system---specifically
Xorg---is provided by the @code{(gnu services xorg)} module. Note that
there is no @code{xorg-service} procedure. Instead, the X server is
started by the @dfn{login manager}, by default the GNOME Display Manager (GDM).
+@menu
+* GNOME Desktop Manager (GDM)::
+* SLiM graphical login manager::
+* SDDM login manager::
+* Xorg configuration::
+* Screen Locker::
+@end menu
@cindex GDM
@cindex GNOME, login manager
@@ -20705,6 +20969,10 @@ its user interface, and it can also start Wayland sessions. The former is
required for the latter, to enable, set @code{wayland?} to @code{#t} in
@code{gdm-configuration}.
+
+@anchor{GNOME Desktop Manager (GDM)}
+@subsubheading GNOME Desktop Manager (GDM)
+
@defvr {Scheme Variable} gdm-service-type
This is the type for the @uref{https://wiki.gnome.org/Projects/GDM/, GNOME
Desktop Manager} (GDM), a program that manages graphical display servers and
@@ -20761,6 +21029,10 @@ environment.
@end table
@end deftp
+
+@anchor{SLiM graphical login manager}
+@subsubheading SLiM graphical login manager
+
@defvr {Scheme Variable} slim-service-type
This is the type for the SLiM graphical login manager for X11.
@@ -20864,8 +21136,11 @@ The default SLiM theme and its name.
@end defvr
+@anchor{SDDM login manager}
+@subsubheading SDDM login manager
@cindex login manager
@cindex X11 login
+
@defvr {Scheme Variable} sddm-service-type
This is the type of the service to run the
@uref{https://github.com/sddm/sddm,SDDM display manager}. Its value
@@ -20977,7 +21252,10 @@ Relogin after logout.
@end deftp
+@anchor{Xorg configuration}
+@subsubheading Xorg configuration
@cindex Xorg, configuration
+
@deftp {Data Type} xorg-configuration
This data type represents the configuration of the Xorg graphical display
server. Note that there is no Xorg service; instead, the X server is started
@@ -21044,6 +21322,9 @@ Usually the X server is started by a login manager.
@end deffn
+@anchor{Screen Locker}
+@subsubheading Screen Locker
+
@deffn {Scheme Procedure} screen-locker-service @var{package} [@var{program}]
Add @var{package}, a package for a screen locker or screen saver whose
command is @var{program}, to the set of setuid programs and add a PAM entry
@@ -21059,11 +21340,18 @@ makes the good ol' XlockMore usable.
@node Printing Services
@subsection Printing Services
-
+@cindex CUPS, printer support
@cindex printer support with CUPS
+
The @code{(gnu services cups)} module provides a Guix service definition
for the CUPS printing service. To add printer support to a Guix
system, add a @code{cups-service} to the operating system definition:
+@menu
+* CUPS::
+@end menu
+
+@anchor{CUPS}
+@subsubheading CUPS
@deffn {Scheme Variable} cups-service-type
The service type for the CUPS print server. Its value should be a valid
@@ -21919,6 +22207,29 @@ machine running a graphical display server, possibly with graphical user
interfaces, etc. It also defines services that provide specific desktop
environments like GNOME, Xfce or MATE.
+@menu
+* GNOME Desktop Environment::
+* Xfce Desktop Environment::
+* Mate Desktop Environment::
+* LXQt Desktop Environment::
+* Enlightenment Window Manager::
+* Selecting Your Desktop Environment::
+
+Service Definitions included in @code{%desktop-services}
+* D-Bus::
+* Elogind::
+* AccountsService::
+* Polkit::
+* upowerd::
+* UDisks::
+* colord::
+* SANE::
+* GeoClue::
+* Bluetooth::
+* GNOME Keyring::
+* seatd::
+@end menu
+
To simplify things, the module defines a variable containing the set of
services that users typically expect on a machine with a graphical
environment and networking:
@@ -21976,6 +22287,10 @@ Alternatively you can also try starting GNOME on Wayland manually from a
TTY with the command ``XDG_SESSION_TYPE=wayland exec dbus-run-session
gnome-session``. Currently only GNOME has support for Wayland.
+
+@anchor{GNOME Desktop Environment}
+@subsubheading GNOME Desktop Environment
+
@defvr {Scheme Variable} gnome-desktop-service-type
This is the type of the service that adds the @uref{https://www.gnome.org,
GNOME} desktop environment. Its value is a @code{gnome-desktop-configuration}
@@ -21994,6 +22309,9 @@ The GNOME package to use.
@end table
@end deftp
+@anchor{Xfce Desktop Environment}
+@subsubheading Xfce Desktop Environment
+
@defvr {Scheme Variable} xfce-desktop-service-type
This is the type of a service to run the @uref{Xfce, https://xfce.org/}
desktop environment. Its value is an @code{xfce-desktop-configuration} object
@@ -22020,6 +22338,10 @@ The Xfce package to use.
@end table
@end deftp
+
+@anchor{Mate Desktop Environment}
+@subsubheading Mate Desktop Environment
+
@deffn {Scheme Variable} mate-desktop-service-type
This is the type of the service that runs the @uref{https://mate-desktop.org/,
MATE desktop environment}. Its value is a @code{mate-desktop-configuration}
@@ -22039,6 +22361,10 @@ The MATE package to use.
@end table
@end deftp
+
+@anchor{LXQt Desktop Environment}
+@subsubheading LXQt Desktop Environment
+
@deffn {Scheme Variable} lxqt-desktop-service-type
This is the type of the service that runs the @uref{https://lxqt-project.org,
LXQt desktop environment}. Its value is a @code{lxqt-desktop-configuration}
@@ -22057,6 +22383,10 @@ The LXQT package to use.
@end table
@end deftp
+
+@anchor{Enlightenment Window Manager}
+@subsubheading Enlightenment Window Manager
+
@deffn {Scheme Variable} enlightenment-desktop-service-type
Return a service that adds the @code{enlightenment} package to the system
profile, and extends dbus with actions from @code{efl}.
@@ -22069,6 +22399,10 @@ The enlightenment package to use.
@end table
@end deftp
+
+@anchor{Selecting Your Desktop Environment}
+@subsubheading Selecting Your Desktop Environment
+
Because the GNOME, Xfce and MATE desktop services pull in so many packages,
the default @code{%desktop-services} variable doesn't include any of
them by default. To add GNOME, Xfce or MATE, just @code{cons} them onto
@@ -22090,10 +22424,18 @@ them by default. To add GNOME, Xfce or MATE, just @code{cons} them onto
These desktop environments will then be available as options in the
graphical login window.
+
+@anchor{Service Definitions included in @code{%desktop-services}}
+@subsubheading Service Definitions included in @code{%desktop-services}
+
The actual service definitions included in @code{%desktop-services} and
provided by @code{(gnu services dbus)} and @code{(gnu services desktop)}
are described below.
+
+@anchor{D-Bus}
+@subsubheading D-Bus
+
@deffn {Scheme Procedure} dbus-service [#:dbus @var{dbus}] [#:services '()] @
[#:verbose?]
Return a service that runs the ``system bus'', using @var{dbus}, with
@@ -22113,6 +22455,10 @@ and policy files. For example, to allow avahi-daemon to use the system bus,
@var{services} must be equal to @code{(list avahi)}.
@end deffn
+
+@anchor{Elogind}
+@subsubheading Elogind
+
@deffn {Scheme Procedure} elogind-service [#:config @var{config}]
Return a service that runs the @code{elogind} login and
seat management daemon. @uref{https://github.com/elogind/elogind,
@@ -22185,6 +22531,10 @@ their default values are:
@end table
@end deffn
+
+@anchor{AccountsService}
+@subsubheading AccountsService
+
@deffn {Scheme Procedure} accountsservice-service @
[#:accountsservice @var{accountsservice}]
Return a service that runs AccountsService, a system service that can
@@ -22198,6 +22548,10 @@ The @var{accountsservice} keyword argument is the @code{accountsservice}
package to expose as a service.
@end deffn
+
+@anchor{Polkit}
+@subsubheading Polkit
+
@deffn {Scheme Procedure} polkit-service @
[#:polkit @var{polkit}]
Return a service that runs the
@@ -22216,6 +22570,10 @@ for their own passwords when performing administrative actions instead of
@code{root}'s, similar to the behaviour used by @code{sudo}.
@end defvr
+
+@anchor{upowerd}
+@subsubheading upowerd
+
@defvr {Scheme Variable} upower-service-type
Service that runs @uref{https://upower.freedesktop.org/, @command{upowerd}}, a
system-wide monitor for power consumption and battery levels, with the given
@@ -22290,6 +22648,10 @@ Possible values are:
@end table
@end deftp
+
+@anchor{UDisks}
+@subsubheading UDisks
+
@deffn {Scheme Procedure} udisks-service [#:udisks @var{udisks}]
Return a service for @uref{https://udisks.freedesktop.org/docs/latest/,
UDisks}, a @dfn{disk management} daemon that provides user interfaces
@@ -22302,6 +22664,10 @@ file-systems in read and write fashion, you'll need to have
@code{ntfs-3g} installed system-wide.
@end deffn
+
+@anchor{colord}
+@subsubheading colord
+
@deffn {Scheme Variable} colord-service-type
This is the type of the service that runs @command{colord}, a system
service with a D-Bus
@@ -22311,7 +22677,11 @@ tool. See @uref{https://www.freedesktop.org/software/colord/, the colord web
site} for more information.
@end deffn
+
+@anchor{SANE}
+@subsubheading SANE
@cindex scanner access
+
@defvr {Scheme Variable} sane-service-type
This service provides access to scanners @i{via}
@uref{http://www.sane-project.org, SANE} by installing the necessary
@@ -22353,6 +22723,10 @@ a system which relies on @code{%desktop-services}, you may use
@end lisp
@end defvr
+
+@anchor{GeoClue}
+@subsubheading GeoClue
+
@deffn {Scheme Procedure} geoclue-application name [#:allowed? #t] [#:system? #f] [#:users '()]
Return a configuration allowing an application to access GeoClue
location data. @var{name} is the Desktop ID of the application, without
@@ -22388,6 +22762,10 @@ location databases. See
web site} for more information.
@end deffn
+
+@anchor{Bluetooth}
+@subsubheading Bluetooth
+
@deffn {Scheme Procedure} bluetooth-service [#:bluez @var{bluez}] @
[@w{#:auto-enable? #f}]
Return a service that runs the @command{bluetoothd} daemon, which
@@ -22841,6 +23219,10 @@ Possible values are:
@end table
@end deftp
+
+@anchor{GNOME Keyring}
+@subsubheading GNOME Keyring
+
@defvr {Scheme Variable} gnome-keyring-service-type
This is the type of the service that adds the
@uref{https://wiki.gnome.org/Projects/GnomeKeyring, GNOME Keyring}. Its
@@ -22875,6 +23257,10 @@ and ``passwd'' is with the value @code{passwd}.
@end table
@end deftp
+
+@anchor{seatd}
+@subsubheading seatd
+
@defvr {Scheme Variable} seatd-service-type
@uref{https://sr.ht/~kennylevinsen/seatd/, seatd} is a minimal seat
management daemon.
@@ -22923,15 +23309,23 @@ Log level to output logs. Possible values: @samp{"silent"}, @samp{"error"},
@node Sound Services
@subsection Sound Services
-
@cindex sound support
-@cindex ALSA
-@cindex PulseAudio, sound support
The @code{(gnu services sound)} module provides a service to configure the
Advanced Linux Sound Architecture (ALSA) system, which makes PulseAudio the
preferred ALSA output driver.
+@menu
+* ALSA::
+* PulseAudio::
+* LADSPA plugins path::
+@end menu
+
+
+@anchor{ALSA}
+@subsubheading ALSA
+@cindex ALSA
+
@deffn {Scheme Variable} alsa-service-type
This is the type for the @uref{https://alsa-project.org/, Advanced Linux Sound
Architecture} (ALSA) system, which generates the @file{/etc/asound.conf}
@@ -23001,6 +23395,11 @@ pcm.!default @{
See @uref{https://www.alsa-project.org/main/index.php/Asoundrc} for the
details.
+
+@anchor{PulseAudio}
+@subsubheading PulseAudio
+@cindex PulseAudio, sound support
+
@deffn {Scheme Variable} pulseaudio-service-type
This is the type for the @uref{https://www.pulseaudio.org/, PulseAudio}
sound server. It exists to allow system overrides of the default settings
@@ -23077,6 +23476,10 @@ above example to modify the existing @code{pulseaudio-service-type} via
@end deftp
+
+@anchor{LADSPA plugins path}
+@subsubheading LADSPA plugins path
+
@deffn {Scheme Variable} ladspa-service-type
This service sets the @var{LADSPA_PATH} variable, so that programs, which
respect it, e.g. PulseAudio, can load LADSPA plugins.
@@ -27655,6 +28058,10 @@ server. In addition to configuring the service itself, you may want to add
@code{ldap} as a name service to the Name Service Switch. @xref{Name Service
Switch} for detailed information.
+@menu
+* nslcd::
+@end menu
+
Here is a simple operating system declaration with a default configuration of
the @code{nslcd-service-type} and a Name Service Switch configuration that
consults the @code{ldap} name service last:
@@ -27683,6 +28090,10 @@ consults the @code{ldap} name service last:
(gshadow services)))))
@end lisp
+
+@anchor{nslcd}
+@subsubheading nslcd
+
@c %start of generated documentation for nslcd-configuration
Available @code{nslcd-configuration} fields are:
@@ -29368,6 +29779,13 @@ content securely over HTTPS or other TLS-based protocols, with the
knowledge that the client will be able to verify the server's
authenticity.
+@menu
+* certbot::
+@end menu
+
+@anchor{certbot}
+@subsubheading certbot
+
@url{https://letsencrypt.org/, Let's Encrypt} provides the
@code{certbot} tool to automate the certification process. This tool
first securely generates a key on the server. It then makes a request
--
2.30.4
guix-patches@HIDDEN:bug#56145; Package guix-patches.
Full text available.
Received: (at 56145) by debbugs.gnu.org; 22 Jun 2022 15:55:30 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jun 22 11:55:30 2022
Received: from localhost ([127.0.0.1]:36381 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1o42hP-000517-Bx
for submit <at> debbugs.gnu.org; Wed, 22 Jun 2022 11:55:30 -0400
Received: from mout.kundenserver.de ([217.72.192.73]:40319)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <h.goebel@HIDDEN>) id 1o42hM-00050o-3S
for 56145 <at> debbugs.gnu.org; Wed, 22 Jun 2022 11:55:21 -0400
Received: from hermia.goebel-consult.de ([79.211.183.96]) by
mrelayeu.kundenserver.de (mreue107 [212.227.15.183]) with ESMTPSA (Nemesis)
id 1MGQzj-1ntoM830Ht-00GtEc for <56145 <at> debbugs.gnu.org>; Wed, 22 Jun 2022
17:55:13 +0200
Received: from lenashee.fritz.box (lenashee.goebel-consult.de [192.168.110.2])
by hermia.goebel-consult.de (Postfix) with ESMTP id 0ED845F535;
Wed, 22 Jun 2022 17:55:19 +0200 (CEST)
From: Hartmut Goebel <h.goebel@HIDDEN>
To: 56145 <at> debbugs.gnu.org
Subject: [PATCH 1/5] doc: Add menus to Services sub-sections (part 1/2).
Date: Wed, 22 Jun 2022 17:55:06 +0200
Message-Id: <0dd93b0a014e8a3556e8aba5442d2d3b589ab525.1655908912.git.h.goebel@HIDDEN>
X-Mailer: git-send-email 2.30.4
In-Reply-To: <cover.1655908912.git.h.goebel@HIDDEN>
References: <cover.1655908912.git.h.goebel@HIDDEN>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Provags-ID: V03:K1:6p3VnUV+GVwiLlN1etWWUCY3GV7MV/BxykSm6C2yNR8n+XAdo1R
69X4h8NnGE12SolyVTEzPSHZH+0JkOImpbfcQKdYCff5/kl+r90IIrlp72sKrC0coa9vwjf
1JQRLY1q+hbyIVgXCS8oXzOQ9ftYQ/pxcvQxeRYT0yEviwhZvAv86NRPRXEOK7vLp+m9ImP
tqfunirVqnafgAElzr8ig==
X-Spam-Flag: NO
X-UI-Out-Filterresults: notjunk:1;V03:K0:7Pd662BpWAI=:k3AR3h/EoxiJBCM/5L+VYQ
kEaI9WrqSq5MkDpqQccQ1DEdzXchJmozlOXR7r9XmF1x7aO+oB/ZfJOk0iZGj9FoccxYT0swZ
QyWkTiqma0PznJMuqXYxYv8cUvPr2UmtoTrgicE/k7EeM10IZPsa0F427oZgEIvv7nAgaYwZf
LXe3tsnc954swfJisE9KrWmpUd5HkZqUhwuv4UpCJ6BAD18HWUaDAQRkpr9kJQvI+h5HVoErt
FvK1NMDmNjMZs6NfPX+fsqPa1axwTnhvt1tJcoWloXoDnY4hs59LNbamwJJTD/OVMBYacjhQ4
eyJoPmylnIzriHgr1uVnlKhjPY61kDk2p78u0Zz/5V40pUCFcZ3Q0nyX8ARGjAN4XHfSnwKbn
RlIPPeEwnXWRYFk3v2puT1qrpV+6v7wOYIw+N876ZnON3z0eKDt6SfBgsC9TwLDp5kZSs9RFx
UGxz9mEP3fQ+O9nCpzWpCVYgbuX1ZZztnCDIYMp5K+dESwr0aHxq0i+4zMiS+tYjmTEZ8+lhQ
FAoUbmLeeyU8AC22TByykVbs1qwf+d+8Geumi2407IvLo2xXlxc82PjxDnRUykoFZOe9cDdct
19eHCmgCLHFyhSYXXWyow1jq9Y9xEDE2eRINH4rpvTg1+BIPcf03rbjpJ/KPj0FCFkktUn+m8
6vcwVGYqjaz4LgX+JcXzt3E/za67BTZRgq58LQcuRV1B+20fNxJTvqFrdTS8Sgc5Ztb6PH5jp
384yjb5SwbLPeD4DLwsGNqETC4OLMMHQMWNcb30Njr4h1vVTNQkT7lC5kF8=
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 56145
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)
* doc/guix.texi (Services)[Database Services, Mail Services, Messaging
Services, Telephony Services, File-Sharing Services, Monitoring Services,
Kerberos Services, Web Services, DNS Services, Network File System, Power
Management Services, Audio Services, Virtualization Services, Version
Control Services, Game Services, Guix Services, Linux Services,
Miscellaneous Services]: Ensure @anchors exist for each heading and create a
@menu at the top of the section.
[Continuous Integration]: Same and add a heading for Cuirass.
[VPN Services]: Same and change heading level of "strongSwan" to match the
other headings.
---
doc/guix.texi | 221 +++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 217 insertions(+), 4 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 43a5fc85bd..58eb47535d 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -23100,7 +23100,14 @@ details.
@cindex database
@cindex SQL
The @code{(gnu services databases)} module provides the following services.
+@menu
+* PostgreSQL:: One of the major SQL databases.
+* MariaDB/MySQL:: Another major SQL databases.
+* Memcached:: A distributed memory object caching system.
+* Redis:: An in-memory key/value data store.
+@end menu
+@anchor{PostgreSQL}
@subsubheading PostgreSQL
The following example describes a PostgreSQL service with the default
@@ -23325,6 +23332,7 @@ The initial PostgreSQL roles to create.
@end table
@end deftp
+@anchor{MariaDB/MySQL}
@subsubheading MariaDB/MySQL
@defvr {Scheme Variable} mysql-service-type
@@ -23369,6 +23377,7 @@ be disabled if you would rather do that manually.
@end table
@end deftp
+@anchor{Memcached}
@subsubheading Memcached
@defvr {Scheme Variable} memcached-service-type
@@ -23403,6 +23412,7 @@ Additional command line options to pass to @code{memcached}.
@end table
@end deftp
+@anchor{Redis}
@subsubheading Redis
@defvr {Scheme Variable} redis-service-type
@@ -23438,7 +23448,17 @@ The @code{(gnu services mail)} module provides Guix service definitions
for email services: IMAP, POP3, and LMTP servers, as well as mail
transport agents (MTAs). Lots of acronyms! These services are detailed
in the subsections below.
+@menu
+* Dovecot Service:: An IMAP/POP3/LMTP server.
+* OpenSMTPD Service:: A message transfer agent (MTA) stemming from the OpenBSD project.
+* Exim Service:: Another message transfer agent (MTA).
+* Getmail service:: Get your mail from several mail accounts to your local machine.
+* Mail Aliases Service:: This service which provides /etc/aliases.
+* GNU Mailutils IMAP4 Daemon:: Another IMAP4 Daemon.
+* Radicale Service:: A CalDAV (calendars, to-do lists) and CardDAV (contacts) server.
+@end menu
+@anchor{Dovecot Service}
@subsubheading Dovecot Service
@deffn {Scheme Procedure} dovecot-service [#:config (dovecot-configuration)]
@@ -24846,6 +24866,7 @@ could instantiate a dovecot service like this:
(string "")))
@end lisp
+@anchor{OpenSMTPD Service}
@subsubheading OpenSMTPD Service
@deffn {Scheme Variable} opensmtpd-service-type
@@ -24876,6 +24897,7 @@ remote servers. Run @command{man smtpd.conf} for more information.
@end table
@end deftp
+@anchor{Exim Service}
@subsubheading Exim Service
@cindex mail transfer agent (MTA)
@@ -24915,6 +24937,7 @@ variables.
@end table
@end deftp
+@anchor{Getmail service}
@subsubheading Getmail service
@cindex IMAP
@@ -25206,6 +25229,7 @@ Defaults to @samp{()}.
@end deftypevr
+@anchor{Mail Aliases Service}
@subsubheading Mail Aliases Service
@cindex email aliases
@@ -25234,6 +25258,7 @@ the @code{operating-system}'s @code{user-accounts} in order to deliver
the @code{postmaster} mail to @code{bob} (which subsequently would
deliver mail to @code{bob@@example.com} and @code{bob@@example2.com}).
+@anchor{GNU Mailutils IMAP4 Daemon}
@subsubheading GNU Mailutils IMAP4 Daemon
@cindex GNU Mailutils IMAP4 Daemon
@@ -25264,6 +25289,7 @@ Mailutils Manual}, for details.
@end table
@end deftp
+@anchor{Radicale Service}
@subsubheading Radicale Service
@cindex CalDAV
@cindex CardDAV
@@ -25297,7 +25323,13 @@ on TCP port 5232 of @code{localhost} and use the @code{htpasswd} file at
The @code{(gnu services messaging)} module provides Guix service
definitions for messaging services. Currently it provides the following
services:
+@menu
+* Prosody Service:: A modern XMPP communication server.
+* BitlBee Service:: A IRC gateway to a variety of messaging protocols.
+* Quassel Service:: A modern, cross-platform, distributed IRC client
+@end menu
+@anchor{Prosody Service}
@subsubheading Prosody Service
@deffn {Scheme Variable} prosody-service-type
@@ -25715,6 +25747,7 @@ string, you could instantiate a prosody service like this:
@c end of Prosody auto-generated documentation
+@anchor{BitlBee Service}
@subsubheading BitlBee Service
@cindex IRC (Internet Relay Chat)
@@ -25759,6 +25792,7 @@ Configuration snippet added as-is to the BitlBee configuration file.
@end table
@end deftp
+@anchor{Quassel Service}
@subsubheading Quassel Service
@cindex IRC (Internet Relay Chat)
@@ -25798,7 +25832,12 @@ and Error.
The @code{(gnu services telephony)} module contains Guix service
definitions for telephony services. Currently it provides the following
services:
+@menu
+* Jami:: A distributed multimedia communications platform.
+* Mumble server:: A low latency, high quality voice chat server.
+@end menu
+@anchor{Jami}
@subsubheading Jami
@cindex jami, service
@@ -26020,6 +26059,7 @@ account fingerprint for a registered username.
@end deftp
+@anchor{Mumble server}
@subsubheading Mumble server
@cindex Mumble
@@ -26239,6 +26279,11 @@ going forward.
The @code{(gnu services file-sharing)} module provides services that
assist with transferring files over peer-to-peer file-sharing networks.
+@menu
+* Transmission Daemon Service:: A flexible BitTorrent client.
+@end menu
+
+@anchor{Transmission Daemon Service}
@subsubheading Transmission Daemon Service
@uref{https://transmissionbt.com/, Transmission} is a flexible
@@ -27034,6 +27079,16 @@ Defaults to @samp{#t}.
@node Monitoring Services
@subsection Monitoring Services
+@menu
+* Tailon Service:: A web application for viewing and searching log files.
+* Darkstat Service:: A packet sniffer.
+* Prometheus Node Exporter Service:: A client/agent for the Prometheus monitoring system.
+* Zabbix server:: A high performance monitoring system.
+* Zabbix agent:: Gathers information for the Zabbix monitoring server.
+* Zabbix front-end:: Provides a web interface to Zabbix.
+@end menu
+
+@anchor{Tailon Service}
@subsubheading Tailon Service
@uref{https://tailon.readthedocs.io/, Tailon} is a web application for
@@ -27142,6 +27197,7 @@ the 2nd element of the pair is the password.
@end deftp
+@anchor{Darkstat Service}
@subsubheading Darkstat Service
@cindex darkstat
Darkstat is a packet sniffer that captures network traffic, calculates
@@ -27184,6 +27240,7 @@ Specify the path of the base URL@. This can be useful if
@end deftp
@anchor{prometheus-node-exporter}
+@anchor{Prometheus Node Exporter Service}
@subsubheading Prometheus Node Exporter Service
@cindex prometheus-node-exporter
@@ -27223,6 +27280,7 @@ Extra options to pass to the Prometheus node exporter.
@end table
@end deftp
+@anchor{Zabbix server}
@subsubheading Zabbix server
@cindex zabbix zabbix-server
Zabbix is a high performance monitoring system that can collect data from a
@@ -27314,6 +27372,7 @@ configuration file.
@c %end of fragment
@anchor{zabbix-agent}
+@anchor{Zabbix agent}
@subsubheading Zabbix agent
@cindex zabbix zabbix-agent
@@ -27392,6 +27451,7 @@ configuration file.
@c %end of fragment
@anchor{zabbix-front-end}
+@anchor{Zabbix front-end}
@subsubheading Zabbix front-end
@cindex zabbix zabbix-front-end
@@ -27458,7 +27518,12 @@ Zabbix server port.
The @code{(gnu services kerberos)} module provides services relating to
the authentication protocol @dfn{Kerberos}.
+@menu
+* Krb5 Service:: Create Kerberos client configuration file /etc/krb5.conf.
+* PAM krb5 Service:: Allows for login authentication and password management via Kerberos.
+@end menu
+@anchor{Krb5 Service}
@subsubheading Krb5 Service
Programs using a Kerberos client library normally
@@ -27552,6 +27617,7 @@ field.
@end deftp
+@anchor{PAM krb5 Service}
@subsubheading PAM krb5 Service
@cindex pam-krb5
@@ -28065,7 +28131,20 @@ Defaults to @samp{()}.
@cindex HTTP
The @code{(gnu services web)} module provides the Apache HTTP Server,
the nginx web server, and also a fastcgi wrapper daemon.
+@menu
+* Apache HTTP Server:: A major HTTP server.
+* NGINX:: Another major HTTP server.
+* Varnish Cache:: A fast web cache server.
+* Patchwork:: A patch tracking system.
+* Mumi:: A web interface to the Debbugs bug tracker
+* FastCGI:: An interface between front- and back-end of a web service.
+* PHP-FPM:: An alternative FastCGI implementation for PHP.
+* Hpcguix-web:: A customizable web interface to browse Guix packages.
+* gmnisrv:: A simple Gemini protocol server.
+* Agate:: A simple Gemini protocol server written in Rust.
+@end menu
+@anchor{Apache HTTP Server}
@subsubheading Apache HTTP Server
@deffn {Scheme Variable} httpd-service-type
@@ -28532,6 +28611,7 @@ body of a named location block cannot contain location blocks.
@end table
@end deftp
+@anchor{Varnish Cache}
@subsubheading Varnish Cache
@cindex Varnish
Varnish is a fast cache server that sits in between web applications
@@ -28610,6 +28690,7 @@ Additional arguments to pass to the @command{varnishd} process.
@end table
@end deftp
+@anchor{Patchwork}
@subsubheading Patchwork
@cindex Patchwork
Patchwork is a patch tracking system. It can collect patches sent to a
@@ -28784,6 +28865,7 @@ The port on which to connect to the database.
@end table
@end deftp
+@anchor{Mumi}
@subsubheading Mumi
@cindex Mumi, Debbugs Web interface
@@ -28821,6 +28903,7 @@ mailutils, GNU@tie{}Mailutils}.
@end deftp
+@anchor{FastCGI}
@subsubheading FastCGI
@cindex fastcgi
@cindex fcgiwrap
@@ -29065,6 +29148,7 @@ A simple setup for cat-avatar-generator can look like this:
%base-services))
@end lisp
+@anchor{Hpcguix-web}
@subsubheading Hpcguix-web
@cindex hpcguix-web
@@ -29147,6 +29231,7 @@ Thus, make sure to add @code{nss-certs} or another certificate package to the
more information on X.509 certificates.
@end quotation
+@anchor{gmnisrv}
@subsubheading gmnisrv
@cindex gmnisrv
@@ -29181,6 +29266,7 @@ gmnisrv} and @command{man gmnisrv.ini}.
@end table
@end deftp
+@anchor{Agate}
@subsubheading Agate
@cindex agate
@@ -29460,7 +29546,14 @@ an @emph{authoritative} DNS server for multiple zones, slave or master.
This service uses @uref{https://www.knot-dns.cz/, Knot DNS}. And also a
caching and forwarding DNS server for the LAN, which uses
@uref{http://www.thekelleys.org.uk/dnsmasq/doc.html, dnsmasq}.
+@menu
+* Knot Service:: A DNS server.
+* Knot Resolver Service:: A DNS resolver service based on Knot.
+* Dnsmasq Service:: A DNS caching and DHCP server for small networks.
+* ddclient Service:: Takes care of automatically updating DNS entries.
+@end menu
+@anchor{Knot Service}
@subsubheading Knot Service
An example configuration of an authoritative server for two zones, one master
@@ -29920,6 +30013,7 @@ The list of knot-zone-configuration used by this configuration.
@end table
@end deftp
+@anchor{Knot Resolver Service}
@subsubheading Knot Resolver Service
@deffn {Scheme Variable} knot-resolver-service-type
@@ -29958,6 +30052,7 @@ Number of milliseconds for @code{kres-cache-gc} to periodically trim the cache.
@end deftp
+@anchor{Dnsmasq Service}
@subsubheading Dnsmasq Service
@deffn {Scheme Variable} dnsmasq-service-type
@@ -30098,6 +30193,7 @@ network or obtained a DHCP lease from dnsmasq.
@end table
@end deftp
+@anchor{ddclient Service}
@subsubheading ddclient Service
@cindex ddclient
@@ -30213,7 +30309,14 @@ Defaults to @samp{()}.
The @code{(gnu services vpn)} module provides services related to
@dfn{virtual private networks} (VPNs).
+@menu
+* Bitmask:: A VPN client
+* OpenVPN:: A OpenVPN @emph{client} service.
+* strongSwan:: Configures strongSwan for IPsec.
+* Wireguard:: A Wireguard tunnel interface.
+@end menu
+@anchor{Bitmask}
@subsubheading Bitmask
@defvr {Scheme Variable} bitmask-service-type
@@ -30223,6 +30326,7 @@ the client expects an active polkit-agent, which is either run by your
desktop-environment or should be run manually.
@end defvr
+@anchor{OpenVPN}
@subsubheading OpenVPN
It provides a @emph{client} service for your machine to connect to a
@@ -30603,7 +30707,8 @@ Defaults to @samp{#f}.
@c %end of automatic openvpn-server documentation
-@subheading strongSwan
+@anchor{strongSwan}
+@subsubheading strongSwan
Currently, the strongSwan service only provides legacy-style configuration with
@file{ipsec.conf} and @file{ipsec.secrets} files.
@@ -30640,6 +30745,7 @@ The file name of your @file{ipsec.secrets}. If not @code{#f}, then this and
@end table
@end deftp
+@anchor{Wireguard}
@subsubheading Wireguard
@defvr {Scheme Variable} wireguard-service-type
@@ -30729,6 +30835,15 @@ While it is possible to use the individual components that together make
up a Network File System service, we recommended to configure an NFS
server with the @code{nfs-service-type}.
+@menu
+* NFS Service:: Takes care of setting up all NFS component services, etc.
+* RPC Bind Service:: Maps program numbers into universal addresses.
+* Pipefs Pseudo File System:: Used to transfer NFS related data between the kernel and user space.
+* GSS Daemon Service:: Strong security for RPC based protocols.
+* IDMAP Daemon Service:: Mapping between user IDs and user names.
+@end menu
+
+@anchor{NFS Service}
@subsubheading NFS Service
@cindex NFS, server
@@ -30803,6 +30918,7 @@ is a list of symbols. Any of these symbols are valid: @code{nfsd},
If you don't need a complete NFS service or prefer to build it yourself
you can use the individual component services that are documented below.
+@anchor{RPC Bind Service}
@subsubheading RPC Bind Service
@cindex rpcbind
@@ -30831,6 +30947,7 @@ instance.
@end deftp
+@anchor{Pipefs Pseudo File System}
@subsubheading Pipefs Pseudo File System
@cindex pipefs
@cindex rpc_pipefs
@@ -30852,6 +30969,7 @@ The directory to which the file system is to be attached.
@end deftp
+@anchor{GSS Daemon Service}
@subsubheading GSS Daemon Service
@cindex GSSD
@cindex GSS
@@ -30881,6 +30999,7 @@ The directory where the pipefs file system is mounted.
@end deftp
+@anchor{IDMAP Daemon Service}
@subsubheading IDMAP Daemon Service
@cindex idmapd
@cindex name mapper
@@ -30915,14 +31034,22 @@ The verbosity level of the daemon.
@node Continuous Integration
@subsection Continuous Integration
-
@cindex continuous integration
+
+The @code{(gnu services cuirass)} module provides the following service.
+@menu
+* Cuirass:: A continuous integration tool for Guix.
+* Cuirass remote building:: Distribute builds to several workers.
+* Laminar:: A lightweight and modular Continuous Integration service.
+@end menu
+
+@anchor{Cuirass}
+@subsubheading Cuirass
+
@uref{https://guix.gnu.org/cuirass/, Cuirass} is a continuous
integration tool for Guix. It can be used both for development and for
providing substitutes to others (@pxref{Substitutes}).
-The @code{(gnu services cuirass)} module provides the following service.
-
@defvr {Scheme Procedure} cuirass-service-type
The type of the Cuirass service. Its value must be a
@code{cuirass-configuration} object, as described below.
@@ -31040,6 +31167,7 @@ Extra options to pass when running the Cuirass processes.
@end deftp
@cindex remote build
+@anchor{Cuirass remote building}
@subsubheading Cuirass remote building
Cuirass supports two mechanisms to build derivations.
@@ -31141,6 +31269,7 @@ the store items being published.
@end table
@end deftp
+@anchor{Laminar}
@subsubheading Laminar
@uref{https://laminar.ohwg.net/, Laminar} is a lightweight and modular
@@ -31202,8 +31331,14 @@ Base URL to use for links to laminar itself.
@node Power Management Services
@subsection Power Management Services
+@menu
+* TLP daemon:: A Linux power management tool.
+* Thermald daemon:: An interface to thermald, a CPU frequency scaling service.
+@end menu
+
@cindex tlp
@cindex power management with TLP
+@anchor{TLP daemon}
@subsubheading TLP daemon
The @code{(gnu services pm)} module provides a Guix service definition
@@ -31736,6 +31871,7 @@ Defaults to @samp{#f}.
@cindex thermald
@cindex CPU frequency scaling with thermald
+@anchor{Thermald daemon}
@subsubheading Thermald daemon
The @code{(gnu services pm)} module provides an interface to
@@ -31771,7 +31907,12 @@ Package object of thermald.
The @code{(gnu services audio)} module provides a service to start MPD
(the Music Player Daemon).
+@menu
+* Music Player Daemon:: Can be controlled from the local machine or over the network.
+@end menu
+
@cindex mpd
+@anchor{Music Player Daemon}
@subsubheading Music Player Daemon
The Music Player Daemon (MPD) is a service that can play music while
@@ -31890,7 +32031,16 @@ an HTTP audio streaming output.
The @code{(gnu services virtualization)} module provides services for
the libvirt and virtlog daemons, as well as other virtualization-related
services.
+@menu
+* Libvirt daemon:: Server side daemon of the libvirt system.
+* Virtlog daemon:: Manage logs from virtual machine consoles.
+* Transparent Emulation with QEMU:: Emulate binaries built for different architectures.
+* QEMU Guest Agent:: Provides control over the emulated system to the host.
+* The Hurd in a Virtual Machine:: Run GNU/Hurd in a virtual machine (childhurd).
+* Ganeti:: A virtual machine management system with cluster failover.
+@end menu
+@anchor{Libvirt daemon}
@subsubheading Libvirt daemon
@code{libvirtd} is the server side daemon component of the libvirt
@@ -32454,6 +32604,7 @@ Defaults to @samp{5}.
@c %end of autogenerated docs
+@anchor{Virtlog daemon}
@subsubheading Virtlog daemon
The virtlogd service is a server side daemon component of libvirt that is
used to manage logs from virtual machine consoles.
@@ -32599,6 +32750,7 @@ Defaults to @samp{3}
@end deftypevr
@anchor{transparent-emulation-qemu}
+@anchor{Transparent Emulation with QEMU}
@subsubheading Transparent Emulation with QEMU
@cindex emulation
@@ -32679,6 +32831,7 @@ Return the name of @var{platform}---a string such as @code{"arm"}.
@end deffn
+@anchor{QEMU Guest Agent}
@subsubheading QEMU Guest Agent
@cindex emulation
@@ -32726,6 +32879,7 @@ host. If empty, QEMU uses a default file name.
@end deftp
+@anchor{The Hurd in a Virtual Machine}
@subsubheading The Hurd in a Virtual Machine
@cindex @code{hurd}
@@ -32905,6 +33059,7 @@ the @code{--snapshot} flag using something along these lines:
(options '())))
@end lisp
+@anchor{Ganeti}
@subsubheading Ganeti
@cindex ganeti
@@ -33566,6 +33721,11 @@ the @code{git://} unsecured TCP-based protocol, extending the
@code{nginx} web server to proxy some requests to
@code{git-http-backend}, or providing a web interface with
@code{cgit-service-type}.
+@menu
+* Cgit Service:: A web frontend for Git repositories written in C
+* Gitolite Service:: A tool for hosting Git repositories on a central server.
+* Gitile Service:: A Git forge for viewing public git repository contents from a web browser.
+@end menu
@deffn {Scheme Procedure} git-daemon-service [#:config (git-daemon-configuration)]
@@ -33702,6 +33862,7 @@ HTTPS@. You will also need to add an @code{fcgiwrap} proxy to your
system services. @xref{Web Services}.
@end deffn
+@anchor{Cgit Service}
@subsubheading Cgit Service
@cindex Cgit service
@@ -34653,6 +34814,7 @@ could instantiate a cgit service like this:
(cgitrc "")))
@end lisp
+@anchor{Gitolite Service}
@subsubheading Gitolite Service
@cindex Gitolite service
@@ -34761,6 +34923,7 @@ This setting controls the commands and features to enable within Gitolite.
@end deftp
+@anchor{Gitile Service}
@subsubheading Gitile Service
@cindex Gitile service
@@ -34895,6 +35058,11 @@ like to serve.
@node Game Services
@subsection Game Services
+@menu
+* The Battle for Wesnoth Service:: A fantasy, turn based tactical strategy game.
+@end menu
+
+@anchor{The Battle for Wesnoth Service}
@subsubheading The Battle for Wesnoth Service
@cindex wesnothd
@uref{https://wesnoth.org, The Battle for Wesnoth} is a fantasy, turn
@@ -35010,6 +35178,13 @@ The complete list of possible options can be found in the man page for
@node Guix Services
@subsection Guix Services
+@menu
+* Guix Build Coordinator:: Aids in distributing derivation builds.
+* Guix Data Service:: Processes, stores and provides data about GNU Guix.
+* Nar Herder:: A utility for managing a collection of nars.
+@end menu
+
+@anchor{Guix Build Coordinator}
@subsubheading Guix Build Coordinator
The @uref{https://git.cbaines.net/guix/build-coordinator/,Guix Build
Coordinator} aids in distributing derivation builds among machines
@@ -35239,6 +35414,7 @@ processing them again if the service is restarted.
@end table
@end deftp
+@anchor{Guix Data Service}
@subsubheading Guix Data Service
The @uref{http://data.guix.gnu.org,Guix Data Service} processes, stores
and provides data about GNU Guix. This includes information about
@@ -35291,6 +35467,7 @@ Extra command line options for @code{guix-data-service-process-jobs}.
@end table
@end deftp
+@anchor{Nar Herder}
@subsubheading Nar Herder
The @uref{https://git.cbaines.net/guix/nar-herder/about/,Nar Herder} is
a utility for managing a collection of nars.
@@ -35384,10 +35561,18 @@ individual requests.
@node Linux Services
@subsection Linux Services
+@menu
+* Early OOM Service:: A minimalist out of memory (OOM) daemon.
+* Kernel Module Loader Service:: Load loadable kernel modules at boot.
+* Rasdaemon Service:: Monitors platform RAS (Reliability, Availability, and Serviceability) reports from Linux kernel trace events.
+* Zram Device Service:: A compressed swap device in system memory.
+@end menu
+
@cindex oom
@cindex out of memory killer
@cindex earlyoom
@cindex early out of memory daemon
+@anchor{Early OOM Service}
@subsubheading Early OOM Service
@uref{https://github.com/rfjakob/earlyoom,Early OOM}, also known as
@@ -35448,6 +35633,7 @@ notifications.
@cindex modprobe
@cindex kernel module loader
+@anchor{Kernel Module Loader Service}
@subsubheading Kernel Module Loader Service
The kernel module loader service allows one to load loadable kernel
@@ -35485,6 +35671,7 @@ parameters, can be done as follow:
@cindex rasdaemon
@cindex Platform Reliability, Availability and Serviceability daemon
+@anchor{Rasdaemon Service}
@subsubheading Rasdaemon Service
The Rasdaemon service provides a daemon which monitors platform
@@ -35566,6 +35753,7 @@ The database location is hard-coded to @file{/var/lib/rasdaemon/ras-mc_event.db}
@cindex zram
@cindex compressed swap
@cindex Compressed RAM-based block devices
+@anchor{Zram Device Service}
@subsubheading Zram Device Service
The Zram device service provides a compressed swap device in system
@@ -35653,7 +35841,22 @@ An integer specifying the baud rate of the tty.
@node Miscellaneous Services
@subsection Miscellaneous Services
+@menu
+* Fingerprint Service:: A DBus service to read and identify fingerprints
+* System Control Service:: Configure kernel parameters at boot.
+* PC/SC Smart Card Daemon Service:: Coordinate communications with smart card readers.
+* Lirc Service:: Decodes infrared signals from remote controls.
+* Spice Service:: Runs VDAGENT for sharing the clipboard with a VM,
+* inputattach Service:: Use Wacom tablets, touchscreens, or joysticks with the Xorg.
+* Dictionary Service:: Runs the @code{dicod} DICT server (RFC 2229).
+* Docker Service:: Runs the Docker daemon.
+* Auditd Service:: Tracks security-relevant information on your system.
+* R-Shiny service:: Run a webapp created with @code{r-shiny}.
+* Nix service:: Run build daemon of the Nix package manager.
+@end menu
+
@cindex fingerprint
+@anchor{Fingerprint Service}
@subsubheading Fingerprint Service
The @code{(gnu services authentication)} module provides a DBus service to
@@ -35669,6 +35872,7 @@ reading capability.
@end defvr
@cindex sysctl
+@anchor{System Control Service}
@subsubheading System Control Service
The @code{(gnu services sysctl)} provides a service to configure kernel
@@ -35719,6 +35923,7 @@ on Guix System.
@end defvr
@cindex pcscd
+@anchor{PC/SC Smart Card Daemon Service}
@subsubheading PC/SC Smart Card Daemon Service
The @code{(gnu services security-token)} module provides the following service
@@ -35750,6 +35955,7 @@ under @file{pcsc/drivers} in the store directory of the package.
@end deftp
@cindex lirc
+@anchor{Lirc Service}
@subsubheading Lirc Service
The @code{(gnu services lirc)} module provides the following service.
@@ -35769,6 +35975,7 @@ passed to @command{lircd}.
@end deffn
@cindex spice
+@anchor{Spice Service}
@subsubheading Spice Service
The @code{(gnu services spice)} module provides the following service.
@@ -35780,6 +35987,7 @@ resolution when the graphical console window resizes.
@end deffn
@cindex inputattach
+@anchor{inputattach Service}
@subsubheading inputattach Service
@cindex tablet input, for Xorg
@@ -35811,6 +36019,7 @@ If true, this must be the name of a file to log messages to.
@end table
@end deftp
+@anchor{Dictionary Service}
@subsubheading Dictionary Service
@cindex dictionary
The @code{(gnu services dict)} module provides the following service:
@@ -35915,6 +36124,7 @@ The following is an example @code{dicod-service} configuration.
@end lisp
@cindex Docker
+@anchor{Docker Service}
@subsubheading Docker Service
The @code{(gnu services docker)} module provides the following services.
@@ -35980,6 +36190,7 @@ setuid-root (@pxref{Setuid Programs}) such that unprivileged users can invoke
@end defvr
@cindex Audit
+@anchor{Auditd Service}
@subsubheading Auditd Service
The @code{(gnu services auditd)} module provides the following service.
@@ -36036,6 +36247,7 @@ instantiate on startup.
@end deftp
@cindex rshiny
+@anchor{R-Shiny service}
@subsubheading R-Shiny service
The @code{(gnu services science)} module provides the following service.
@@ -36083,6 +36295,7 @@ runApp(launch.browser=0, port=4202)~%\n"
@end defvr
@cindex Nix
+@anchor{Nix service}
@subsubheading Nix service
The @code{(gnu services nix)} module provides the following service.
--
2.30.4
guix-patches@HIDDEN:bug#56145; Package guix-patches.
Full text available.Received: (at submit) by debbugs.gnu.org; 22 Jun 2022 14:45:22 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jun 22 10:45:22 2022 Received: from localhost ([127.0.0.1]:36265 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1o41be-00038r-0V for submit <at> debbugs.gnu.org; Wed, 22 Jun 2022 10:45:22 -0400 Received: from lists.gnu.org ([209.51.188.17]:35964) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <h.goebel@HIDDEN>) id 1o41bc-00038k-KM for submit <at> debbugs.gnu.org; Wed, 22 Jun 2022 10:45:20 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35340) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <h.goebel@HIDDEN>) id 1o41bc-0003Il-Dr for guix-patches@HIDDEN; Wed, 22 Jun 2022 10:45:20 -0400 Received: from mout.kundenserver.de ([212.227.126.134]:38883) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <h.goebel@HIDDEN>) id 1o41ba-0000Pu-K1 for guix-patches@HIDDEN; Wed, 22 Jun 2022 10:45:20 -0400 Received: from hermia.goebel-consult.de ([79.211.183.96]) by mrelayeu.kundenserver.de (mreue010 [212.227.15.167]) with ESMTPSA (Nemesis) id 1MryGj-1nIZtH1t3d-00nxDn for <guix-patches@HIDDEN>; Wed, 22 Jun 2022 16:45:14 +0200 Received: from lenashee.fritz.box (lenashee.goebel-consult.de [192.168.110.2]) by hermia.goebel-consult.de (Postfix) with ESMTP id A53735F535; Wed, 22 Jun 2022 16:45:19 +0200 (CEST) From: Hartmut Goebel <h.goebel@HIDDEN> To: guix-patches@HIDDEN Subject: [PATCH 0/5] Add menus to Services sub-sections Date: Wed, 22 Jun 2022 16:45:12 +0200 Message-Id: <cover.1655908912.git.h.goebel@HIDDEN> X-Mailer: git-send-email 2.30.4 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Provags-ID: V03:K1:6sbdolucFIdKwu2O4A4kIIYCPPTSZWtDSgNGWFX/C9yjuwoH7Kl P1rsk6UqZbCHSoHPCsyQAGjgpN1lciFZUuXQmoItGzy3h94iczmjsnGGVWB4Hw1n7K0k2kP X4IiaJAy9n/gQ/CcYI4o9Kct3Z4JcqUrPHzBVdHbIL4VQ5KOJ1/fcvW0pffrt2ubBNi/yOU khDu2Mhy8mWE037Tp6wqA== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:z49xsp5n3eg=:4oEBVFz+YSyrYUIx5dPDD4 HYxQGQLrW0KHFag1vf0Rqge2cYWWXDVVDNpdXHA4XTUtbJSUQnIHbG4jjmUpV/cdV/SgkjRW4 vrYzYmYVUW5b0xsQHH44NJcIWZVpLP2jL85r6lUn+20lD0y0KsAxz6kiHntW48762qVsxJqeE lO60Hu35kPHju8VnQ7tf4mlAr9bDWs9qvWP5RZ52+okxA6MDdN5OhKoZzN8v75Agxmb8d34Th kUNNu8jgy9Mh7HwLHg1CTMLICpVIjh0hAfROMB8jz0vr5DnChqI1clubnfPNNm2c3m2MAs/1R o+yAyFyCJW79Br+jir1ONjxRCkVxoc+YovIbhbqIpGFxEm0slPDNyYMY0dz+6YUu+dFoFbytu kBoKwpWmA6ZfHshmRRtuyQy439/j2x4owEBNx9O732dAE8oCJvJFB78hTMl0M/1a8Ny4y1VgO CCD4ctnHXmlJdnYM1BUqDYXsbq/AOC/pon5PjPQR0wccelHFoqtuQPEVaJzLy7OvF1B4isA6K kpQjO7GuHNXTzH0Cp6VRuesJeHzvuK0WZQW6LRhGvIgnsE3pkM3kIAWr871w/ZVTWkvbY5Dpw SZuZzPONh6mCKz6UrORGIDYZJT3/1AjCyCS2/HPfSPFPVKzbo9xqrKOEMNPjQ9PkTxlIxa1az NdmgGEYPcbKviis7BU+b5MAPf7gnaS5pBUf1a3rTS4otl8N0IBCIO7fyTbwZmby8wUMbTlBdN 8HZDigrFDgSA/8QX9K4+yWL0yEJdrngHQhrZoIVD2GDtATC2uJb1EcogLuM= Received-SPF: none client-ip=212.227.126.134; envelope-from=h.goebel@HIDDEN; helo=mout.kundenserver.de X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) Whenever I searched the services, it bugged me that I need to scroll through all the section to find which services are implemented and described here. These patches add a @menu to each service section listing the headings withing the section. The second patch adds headings for sections which did not have heading strucutres. Hartmut Goebel (5): doc: Add menus to Services sub-sections (part 1/2). doc: Add menus to Services sub-sections (part 2/2). doc: Fix a URL. doc: Small rewording. doc: Add a URL link. doc/guix.texi | 658 +++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 645 insertions(+), 13 deletions(-) -- 2.30.4
Hartmut Goebel <h.goebel@HIDDEN>:guix-patches@HIDDEN.
Full text available.guix-patches@HIDDEN:bug#56145; Package guix-patches.
Full text available.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.