From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, MAILING_LIST_MULTI autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 5959 invoked from network); 26 Sep 2023 00:42:05 -0000 Received: from alyss.skarnet.org (95.142.172.232) by inbox.vuxu.org with ESMTPUTF8; 26 Sep 2023 00:42:05 -0000 Received: (qmail 53105 invoked by uid 89); 26 Sep 2023 00:42:28 -0000 Mailing-List: contact supervision-help@list.skarnet.org; run by ezmlm Sender: Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Received: (qmail 53098 invoked from network); 26 Sep 2023 00:42:27 -0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=westernsemico.com; s=default; h=Content-Transfer-Encoding:MIME-Version: Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=WjW3YXtfdD0kem8acGK2jIVUGC5dH4Bm4oR0RAj63RE=; b=q+871DFgovngbTCUyCsUxvzLdI ZKRwFiYZ+a+PWfnBS3zID6pLoclmh59c+9GpVB44r8GjMt2Wq/wCqA7n0PzRPIMdy0mLKgbr8Ydwc UXsJ9Wm8sGN3WeJF+KefFX9YkBJbmt96/ayjhBqrifndHF62OlZE2hs6XlDa3MWN7FMPpkm6gjW2F AFLqojoPGan94Sat/p878sYv5Xezy6CpBGUNAn4E/y03iO0KYtZMaq58RG5ug3j2BcfSeEIDklhOk GZFZdc0SSrKjYqbPInjFPHwX/EEXG1kyCx2cU0dP3FZyHlHm9vbJXhQUGn2JZ030nHtm/M98tGAA/ NQMI6d3Q==; From: Adam Joseph To: supervision@list.skarnet.org Cc: Adam Joseph Subject: [PATCH 1/2] doc/s6-rc-compile.html: document bundle flattening Date: Mon, 25 Sep 2023 17:41:16 -0700 Message-ID: <20230926004117.23478-1-adam@westernsemico.com> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - server220.web-hosting.com X-AntiAbuse: Original Domain - list.skarnet.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - westernsemico.com X-Get-Message-Sender-Via: server220.web-hosting.com: authenticated_id: westwhdn/from_h X-Authenticated-Sender: server220.web-hosting.com: adam@westernsemico.com X-Source: X-Source-Args: X-Source-Dir: X-From-Rewrite: unmodified, already matched This commit adds a single sentence explaining that nested bundles are flattened by s6-rc-compile; the fact that one bundle contains another (rather than merely happening to contain all the atomics that the latter contains) is not preserved by s6-rc-compile. Although this is the most reasonable handling it is not the only possible handling. I had to read the source code in order to make sure that bundle nesting was not represented in the output of s6-rc-compile, and figured that adding a mention of this fact to the documentation might save others the trouble. More importantly, the special rules for singleton bundles (see next patch in series) depend on this flattening behavior. Signed-off-by: Adam Joseph --- doc/s6-rc-compile.html | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/s6-rc-compile.html b/doc/s6-rc-compile.html index e1ad82b..ef06893 100644 --- a/doc/s6-rc-compile.html +++ b/doc/s6-rc-compile.html @@ -136,6 +136,9 @@ deprecated. contents file. However, if s6-rc-compile detects a cycle in bundle definitions, it will complain and exit 1. +Bundles are flattened during compilation: a parent bundle which +contains a child bundle will be compiled as if the parent bundle had +directly included the child bundle's contents.

For atomic services

-- 2.41.0