From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from atuin.qyliss.net (localhost [IPv6:::1]) by atuin.qyliss.net (Postfix) with ESMTP id 70CB243EB; Sun, 29 Sep 2024 18:24:33 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 993) id 90462448B; Sun, 29 Sep 2024 18:24:27 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on atuin.qyliss.net X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=DMARC_MISSING, RCVD_IN_MSPIKE_H4,RCVD_IN_MSPIKE_WL,SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=4.0.1 Received: from fhigh-a7-smtp.messagingengine.com (fhigh-a7-smtp.messagingengine.com [103.168.172.158]) by atuin.qyliss.net (Postfix) with ESMTPS id 6F0D6447A for ; Sun, 29 Sep 2024 18:24:23 +0000 (UTC) Received: from phl-compute-07.internal (phl-compute-07.phl.internal [10.202.2.47]) by mailfhigh.phl.internal (Postfix) with ESMTP id BC47C114016C for ; Sun, 29 Sep 2024 14:24:21 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-07.internal (MEProxy); Sun, 29 Sep 2024 14:24:21 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alyssa.is; h=cc :content-transfer-encoding:content-type:date:date:from:from :in-reply-to:message-id:mime-version:reply-to:subject:subject:to :to; s=fm1; t=1727634261; x=1727720661; bh=0YpRzJ2diIrqHQ47dUH26 YiQkqnoiSOfeKu8SoqQC5Y=; b=rFxRmah5h2fRMDOUjC7nXI7WFZIPQajAkduyX sOgNdW9yPJZnkxYQ2312pcvWgw30Zw7wQNKY469nIEGtay0xiZdQf2CLwMcR8W9I u7pMv/Vq8QBMalCzrfIkGcPg7vAs0iKLdc4SqNjJyfaKNnvK4Oqxd47ctS42Kn2V rS8dISVw6ZTDH+Qc9nV8E/InK/NshJv/FoGa9y+8xxvbU2fePRA3AdTjuRqUc5+s 3Uvzut1tRwc0xZ7P9+fOkfDVhs2tN4pvpb129lYAqm1dClIubzqOlKLY3kHksTkb E0TJYLgQEGqUX5vaoMix2LrBkfPCIHqsuxThTdnQnfbaxwivw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:date:feedback-id:feedback-id:from:from:in-reply-to :message-id:mime-version:reply-to:subject:subject:to:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm2; t=1727634261; x=1727720661; bh=0YpRzJ2diIrqHQ47dUH26YiQkqno iSOfeKu8SoqQC5Y=; b=Ia+vlLvbbYtDxLTAIlPBgmJBZGPPOLMBQ3era6nIFn7W Rs0I+wIZttFCHKilTryapuJqAmP13BsPODLLdNagRWSffQOfTSS0c7PbRlQ9/0h6 rvZDVbrJbAmP2Ou7P+LiJY8CHQLcYLW3JiT9TkCi3zKBa/IfvsiSSlyZb7PoSTKr fGENCIEjClbEe+uDNcsHgR/8R1xAZ4zw31fou9dS9uJC7RaBL9Mm3w5RoA87Vk+c jUjYZkzzdSQ8YeOqFWmhEi1ZEONWRSCQs3pjn6OAFEbfasnN3cAzlmGxMo9sxYs9 lsX+RDBSYGFRUOSK0vHeagNGkw5t0BJHwPSgQn+1iA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeftddrvddufedguddviecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvuf ffkffoggfgsedtkeertdertddtnecuhfhrohhmpeetlhihshhsrgcutfhoshhsuceohhhi segrlhihshhsrgdrihhsqeenucggtffrrghtthgvrhhnpeduteejueehfeeklefhkeeihe fgheelgfeijeelvdfhveeileeltdehieehfeegffenucffohhmrghinhepnhhigidruggv vhenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehhih esrghlhihsshgrrdhishdpnhgspghrtghpthhtohepuddpmhhouggvpehsmhhtphhouhht pdhrtghpthhtohepuggvvhgvlhesshhpvggtthhruhhmqdhoshdrohhrgh X-ME-Proxy: Feedback-ID: i12284293:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Sun, 29 Sep 2024 14:24:21 -0400 (EDT) Received: by sf.qyliss.net (Postfix, from userid 1000) id DE1C32C26CE0B; Sun, 29 Sep 2024 20:24:19 +0200 (CEST) From: Alyssa Ross To: devel@spectrum-os.org Subject: [PATCH] Documentation: explain Nix using too many cores Date: Sun, 29 Sep 2024 20:24:10 +0200 Message-ID: <20240929182410.2528178-1-hi@alyssa.is> X-Mailer: git-send-email 2.45.2 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Message-ID-Hash: G6EHBU45RTOZGETAEUHHVOZBTG57VZDO X-Message-ID-Hash: G6EHBU45RTOZGETAEUHHVOZBTG57VZDO X-MailFrom: hi@alyssa.is X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-devel.spectrum-os.org-0; header-match-devel.spectrum-os.org-1; header-match-devel.spectrum-os.org-2; header-match-devel.spectrum-os.org-3; header-match-devel.spectrum-os.org-4; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.9 Precedence: list List-Id: Patches and low-level development discussion Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: This is confusing to people, and will be especially so if Spectrum is the first big Nix build they've done, which is not unlikely. Signed-off-by: Alyssa Ross --- Documentation/installation/getting-spectrum.adoc | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/Documentation/installation/getting-spectrum.adoc b/Documentation/installation/getting-spectrum.adoc index 3620c79..29803aa 100644 --- a/Documentation/installation/getting-spectrum.adoc +++ b/Documentation/installation/getting-spectrum.adoc @@ -2,7 +2,7 @@ :page-parent: Build and Run :page-nav_order: 2 -// SPDX-FileCopyrightText: 2022-2023 Alyssa Ross +// SPDX-FileCopyrightText: 2022-2024 Alyssa Ross // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0 To get Spectrum, you need to build it from source. As long as you're @@ -16,6 +16,13 @@ TIP: Before you start, consider setting up the xref:binary-cache.adoc[Spectrum binary cache], which will save you a lot of time waiting for builds. +TIP: If you encounter build failures, especially timeouts or +out-of-memory (OOM) kills, Nix might be configured to run too many +builds at once, with too many cores per build. See Nix's +documentation for +https://nix.dev/manual/nix/2.24/advanced-topics/cores-vs-jobs.html[tuning +cores and jobs]. + == Trying Spectrum If you want to try Spectrum out to get a feel for it, without base-commit: 6e9c1f7967a44206e8f70d1d20e0f4e71987bed8 -- 2.45.2