From patchwork Fri Aug 9 09:09:13 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "pelzflorian (Florian Pelz)" X-Patchwork-Id: 66898 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id CDE2727BBEA; Fri, 9 Aug 2024 10:12:54 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-7.6 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,MAILING_LIST_MULTI,RCVD_IN_VALIDITY_CERTIFIED, RCVD_IN_VALIDITY_RPBL,RCVD_IN_VALIDITY_SAFE,SPF_HELO_PASS, URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 9945B27BBE2 for ; Fri, 9 Aug 2024 10:12:53 +0100 (BST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1scLfu-0001Gm-Bg; Fri, 09 Aug 2024 05:12:42 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1scLfo-0001GE-2Y for guix-patches@gnu.org; Fri, 09 Aug 2024 05:12:36 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1scLfn-0006AU-0A; Fri, 09 Aug 2024 05:12:35 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:From:To:In-Reply-To:References:Subject; bh=ZAu2lqRISvc2+51Wwbbwp9PU9UT/UygpxmmhIE2oUa8=; b=q5wyhU67hFbIPlc44EQPjQvuqgLxmuR6QV9zfsyCh5oC3qqI9Nmfl8QMK5hniaafsCsQUDCno+rJCzQy0tcKWDywy1ZF1zx6Twads353TZV4oIfJiycWAitd/pWI/vvM0Y5MvFKGdEsHIFXZhCPuGPncpUFTFeWMrMDJ4Hzy5IVTbHcPnEha8eblHG4pR6ZglpqJsbDrkZs7dkWsitdSUROi6jt4oQGgpcTshM9/J3mubcAThUpZaOJQLsQxgP0eZoU4r23jR7rRuANPWGbKUvR2nZv9jRpn4+zJRfbVYMroznsc1QprI5AIZJM9AAcDNBxaoN1z7yJ+z72/BW+4tQ==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1scLgD-000109-KK; Fri, 09 Aug 2024 05:13:01 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#72439] [PATCH v4] doc: Setting Up the Daemon: Give guidance to whom this section is useful. References: <16e8cb82047987725668c1b493e4bde392779371.1722671885.git.pelzflorian@pelzflorian.de> In-Reply-To: <16e8cb82047987725668c1b493e4bde392779371.1722671885.git.pelzflorian@pelzflorian.de> Resent-From: Florian Pelz Original-Sender: "Debbugs-submit" Resent-CC: pelzflorian@pelzflorian.de, vincent.legoll@gmail.com, pelzflorian@pelzflorian.de, ludo@gnu.org, matt@excalamus.com, maxim.cournoyer@gmail.com, guix-patches@gnu.org Resent-Date: Fri, 09 Aug 2024 09:13:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 72439 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 72439@debbugs.gnu.org Cc: Florian Pelz , Florian Pelz , Vincent Legoll , pelzflorian , Ludovic =?utf-8?q?Court=C3=A8s?= , Matthew Trzcinski , Maxim Cournoyer X-Debbugs-Original-Xcc: Florian Pelz , Vincent Legoll , pelzflorian , Ludovic =?utf-8?q?Court=C3=A8s?= , Matthew Trzcinski , Maxim Cournoyer Received: via spool by 72439-submit@debbugs.gnu.org id=B72439.17231947683825 (code B ref 72439); Fri, 09 Aug 2024 09:13:01 +0000 Received: (at 72439) by debbugs.gnu.org; 9 Aug 2024 09:12:48 +0000 Received: from localhost ([127.0.0.1]:37664 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1scLfz-0000zd-QA for submit@debbugs.gnu.org; Fri, 09 Aug 2024 05:12:48 -0400 Received: from relay.yourmailgateway.de ([188.68.61.103]:51573) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1scLfx-0000zU-NZ for 72439@debbugs.gnu.org; Fri, 09 Aug 2024 05:12:46 -0400 Received: from mors-relay-8403.netcup.net (localhost [127.0.0.1]) by mors-relay-8403.netcup.net (Postfix) with ESMTPS id 4WgJ8J5qBcz8412 for <72439@debbugs.gnu.org>; Fri, 9 Aug 2024 11:12:16 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1723194736; bh=aLAB7L2YhDbdOo4ZtTlThC77X+gsS4n2p5aNqYzkkac=; h=From:To:Cc:Subject:Date:From; b=Ie/9yzBl1ouunRhzD2aXki1w2dTBjAiws42Zszk/FUy3fA9zAnCcOXDJOl1+ZtuOz lkoVH2Y3YUvBBSIvZeD0TkoXxfAdy8oHSR9rzomS+8HpXF7aY3+KxFRCTh2JnaDQ/Z H3RmVyWyn/eeguGqJKm7uANJdlJjCGWguIjvA2CA+6Gj1QvOSTBD0TtBjRaVMjsNsr +p00LTJx24FNEqZTszGduFh+engLdidLKD1t9Zrl6OIU5m23uoVdOv2nIh7R4XaQw0 iBCejNVbamT+A6vjJSHNKYwLv9M1RUrE0WcPfbt0vS9XXveexXU+p/4UX34sbuwot9 I47rnulPJfWKQ== Received: from policy02-mors.netcup.net (unknown [46.38.225.35]) by mors-relay-8403.netcup.net (Postfix) with ESMTPS id 4WgJ8J5QvNz82G6 for <72439@debbugs.gnu.org>; Fri, 9 Aug 2024 11:12:16 +0200 (CEST) Received: from mxe217.netcup.net (unknown [10.243.12.53]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by policy02-mors.netcup.net (Postfix) with ESMTPS id 4WgJ8J3w6Gz8sZV for <72439@debbugs.gnu.org>; Fri, 9 Aug 2024 11:12:15 +0200 (CEST) Received: from florianhp.fritz.box (ipb2186896.dynamic.kabel-deutschland.de [178.24.104.150]) by mxe217.netcup.net (Postfix) with ESMTPSA id 95F39840D4; Fri, 9 Aug 2024 11:12:10 +0200 (CEST) From: Florian Pelz Date: Fri, 9 Aug 2024 11:09:13 +0200 Message-ID: X-Mailer: git-send-email 2.45.2 MIME-Version: 1.0 X-Rspamd-Queue-Id: 95F39840D4 X-Rspamd-Server: rspamd-worker-8404 X-NC-CID: pKgpyAOb8+taeDiVv8XkIJFrUbBG2L/9MwmNGtWU4otadISdMmd1E+Np X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches * doc/guix.texi (Setting Up the Daemon): Specify intended audience. Change-Id: I784c5f720aa87bddb6455e42181a1e9de5d7ec9a --- Changes since v3: * reword: some of us have reason to -> now would be a good time to doc/guix.texi | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) base-commit: 20dbf225f332ccc707578263ed710dcf2a8fb78e diff --git a/doc/guix.texi b/doc/guix.texi index b7eb8fd346..6e03d8bbcc 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -860,8 +860,28 @@ Setting Up the Daemon @section Setting Up the Daemon @cindex daemon +During the installation, the @dfn{build daemon} that must be running +to use Guix has already been set up and you can run @command{guix} +commands in your terminal program, @pxref{Getting Started}: + +@example +guix build hello +@end example + +If this runs through without error, feel free to skip this section. +You should continue with the following section, @ref{Application +Setup}. + +However, now would be a good time to replace outdated daemon versions, +tweak it, perform builds on other machines (@pxref{Daemon Offload +Setup}) or start it manually in special environments like Chroots +(@pxref{Chrooting into an existing system}) or WSL (not needed for WSL +images created with Guix, @pxref{System Images, +@code{wsl2-image-type}}). If you want to know more or optimize your +system, this section is worth reading. + Operations such as building a package or running the garbage collector -are all performed by a specialized process, the @dfn{build daemon}, on +are all performed by a specialized process, the build daemon, on behalf of clients. Only the daemon may access the store and its associated database. Thus, any operation that manipulates the store goes through the daemon. For instance, command-line tools such as