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