From patchwork Wed Dec 3 14:10:36 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Clara Kowalsky X-Patchwork-Id: 4700 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Wed, 03 Dec 2025 15:10:56 +0100 X-Sieve: CMU Sieve 2.4 Received: from mail-wr1-f62.google.com (mail-wr1-f62.google.com [209.85.221.62]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 5B3EAsnk026073 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 3 Dec 2025 15:10:54 +0100 Received: by mail-wr1-f62.google.com with SMTP id ffacd0b85a97d-42b2ad2a58csf3235017f8f.0 for ; Wed, 03 Dec 2025 06:10:54 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1764771049; cv=pass; d=google.com; s=arc-20240605; b=jZQwv7dkYBN1jqfmz5poBMVify/BPmKgrrnx/1Zs5Sr1az+yNwPosaRtNwoIdoJzr+ kgEXgklVkDN4Pdiksw1WR0ka/IISDQqlDbE2kEmqjluw5nEo+YhtQoNNRquI8926MJO5 TdEG9hC8QHblshIlqJ9smv5VFKrxe6jTTBtcWo3ef3GXOEKWw6zuJyqqfUYvMncVE4Uh Saiuk5a4htazeaieQappTeB0m4eqtXC4jR5njl41fcPV0KXYE79Q89A0W6wPxDxIeECP JSwu1mbn1pv2xG2KQMqlBCw468o7x1i5St4MBxEmIye1F/rZTS8WIEZoADZr1VWQEeJH uzbQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:reply-to:feedback-id:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=o85J+wfDhP9X2ERrsuzaAw96z35Q+dtPDD8Xf6xJJNQ=; fh=UUamcLHF8mIqI+UwCpDBrIkHGiQa4ZPloHgNXhO9U7k=; b=dl9y4LQDXrNlYSbDlPqYHx0lY8cRO1qGugFcR6ybnW9mvYADMgZisiwIzH/1hQHzDn vyAOlLXbdDcNhtFkWnoZGXrhWe80qlumU7gsOd69VRpK2VMr+iYIB/HR6j5zATZOS1TA rKER582RN55E0+fvM1PxjLDTRoieFObpQQQUM/KBxWuxiUav6jlRrgf/EIMs1zcdBLHd Y+O0bEDJmjWY15vH3pK9618hlBkg+VEK5LKB2gbo6KyYVkKyyH6wK8R1vvYlzr2HlcNM HiZcuBIjx1CEJjAx3Ex3xtMpF6cCuSkiNMM31JLmho9GmSsmCiwAPwr1qB4Cf0I1B543 UK6Q==; darn=isar-build.org ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm2 header.b=hVrgRJwF; spf=pass (google.com: domain of fm-1047747-202512031410448665af2f56000207ab-uuvdn4@rts-flowmailer.siemens.com designates 185.136.65.227 as permitted sender) smtp.mailfrom=fm-1047747-202512031410448665af2f56000207ab-uUVDN4@rts-flowmailer.siemens.com; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=siemens.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20230601; t=1764771049; x=1765375849; darn=isar-build.org; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:reply-to :x-original-authentication-results:x-original-sender:feedback-id :mime-version:message-id:date:subject:cc:to:from:from:to:cc:subject :date:message-id:reply-to; bh=o85J+wfDhP9X2ERrsuzaAw96z35Q+dtPDD8Xf6xJJNQ=; b=TDG95M8m5a7iQ0zWf5pHO6VCPM62glUNfD2keSt5+GOw7g7ucMWQMZoPJCGVF3tuaU ALo+05F0r+uLjwZhHmj6pve+Ss3nECDwhuwVDYvenqgBOBLkdl3XQTeKqzFeqrWl27Qq KseffY5v+FNea9ddGPRhyKbMZ8cjRvCYBck3Aeaw5jxg+HKm3i/RzVF2fm8rCkBgxsRN OxIS34YXeTay1wqc3m4HCBsuoUr3hXP46JSzKrg//yJyoop15PVgket/F4mc66rns8qQ P2iT1XaDKZP9Rkk3P591Ydb55Y1aKlWDmPWkOEbY3D16rMuLFTrKCAN5RCHXvAcDs+59 y/qQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1764771049; x=1765375849; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :x-spam-checked-in-group:list-id:mailing-list:precedence:reply-to :x-original-authentication-results:x-original-sender:feedback-id :mime-version:message-id:date:subject:cc:to:from:x-beenthere :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=o85J+wfDhP9X2ERrsuzaAw96z35Q+dtPDD8Xf6xJJNQ=; b=uNDPcXSi2TkSlDcv3Rq4LJVv2iC/3FwoM6UuEFvWzZnbqKARFRaDT91d0VWKCkCahb p21LYPsd9LHhEayN//Opb/Ni59RxxbqLXtKivXS585eNFxIx2UTy3tF6xdjOxs1nL/4S X6NWztQFuQyUDHqOE0XEklWTRcJgMTbXB41WWHPTphBi3MFsoZ2Cqin0DnmD+DYGhdHI seUO6bkUFQZCe/CB7Uf79n0S4SYtwHSK3t8Bq9iMkOLJrkb4U0YNHYRxljvusbH3G6CW nKdguo7uj3xYHrLZq5lgwbB/Jm5RI+eIcjALMYRupmMKkpWs/tW7aw179hS+4S+pRf7y lfTg== X-Forwarded-Encrypted: i=2; AJvYcCVag2G8knfSVEm956+vDYzKdCfnXjlblNE1mjnzw6f6nS//Kiq6F6p2W6OQNmbT4pky6fwBUww=@isar-build.org X-Gm-Message-State: AOJu0YyFm1pgjs4xcijpLEc5LwCnomEa3RCgITn6EEVxJgVLxIpmu/fN r7jmhY30VTWhV2QOBf+s6+S1eD0dvmRTLL7ziTBhdFEv75U/uYP+BUJJ X-Google-Smtp-Source: AGHT+IGJ2PRFpCiAJso7SVs/MKz8JlZfnPOrMOCbIK5HrVaJoMnnsoJf4Jk0+j19K94nBPX6qnCPgQ== X-Received: by 2002:a05:600c:4706:b0:46e:49fb:4776 with SMTP id 5b1f17b1804b1-4792aee37efmr23151945e9.11.1764771048261; Wed, 03 Dec 2025 06:10:48 -0800 (PST) X-BeenThere: isar-users@googlegroups.com; h="Ae8XA+YMUGvsPd0MbO2Nb8x61r8N3mA2/mCks8b2msTJpxjynA==" Received: by 2002:a05:6000:43cc:10b0:426:f2f7:295c with SMTP id ffacd0b85a97d-42e1b49cc32ls2889971f8f.1.-pod-prod-04-eu; Wed, 03 Dec 2025 06:10:45 -0800 (PST) X-Received: by 2002:a05:6000:2403:b0:42b:4219:269 with SMTP id ffacd0b85a97d-42f731c3110mr2506117f8f.41.1764771045372; Wed, 03 Dec 2025 06:10:45 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1764771045; cv=none; d=google.com; s=arc-20240605; b=Pumw4i3NLKW/A69PwRRwll7HKtkCldXw4uNlRpuavU9ubSczWbdbeKH86FDELIc5oG xhcbnQQPcCImO+xCeLTEKaTFzlI5ZFKBVYGOqkE0AIB08yyYLxuRE/5XKv6MSBYBAJy6 gS55QCuYo0KemzJ2piqSh0js52XQOAE/jHxlsp0/aaaon2LbcSRyx4sOpLGB6b5+yNe2 Vjex8tSQpQ8OyNbspJrZuluJ+2WsWbzeBheTXR3fXUnqIco9W6ZTwrzPnO8Oh5KOwtRH jQYHd//cc9SFZj67V5RXoMXetQ0csWqo6U8JlTk58QyEsmR1d2TBINRoiZdYvuNX1gVs 6Ikw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=feedback-id:content-transfer-encoding:mime-version:message-id:date :subject:cc:to:from:dkim-signature; bh=M/SfPqabqvIt4zXu/RTBUdlI9Wd6taKZwEcB2THCQ1w=; fh=a/whyPBaBHcGEIUHNzsYkldQWeziqq3pHW0lRWinC6c=; b=Zw2M3JRU6ENPT5IhTD7NUoAeMr3tKl7EEvJOfONqatNdF8HrLqxpSY2qLjFUcsoE9i IjEQtHZbeNkToSwOc1cpFR4igjMZEKr51pJd177rBkP9urXWFxupJuwP4UrsqaAh0VB3 CD0YaaNqeVPZCFoJHRR7cpV6AM21hdrnBbbi+yvZBumr80wGMN4rSjq5vwDBetZLppxQ 1Nw865XpQTnUTRlEn0NVpkN4o3zkmG4GklX1to9PzzH5/DB+speTiN2WhFxvQPxEb2xh tYlM7WRU6RbVRFfc2OzWZgCA7gphSl4EiF5NI45YOMHKlM0UuC+p7Ksq8LPLkeentnFN mlgw==; dara=google.com ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm2 header.b=hVrgRJwF; spf=pass (google.com: domain of fm-1047747-202512031410448665af2f56000207ab-uuvdn4@rts-flowmailer.siemens.com designates 185.136.65.227 as permitted sender) smtp.mailfrom=fm-1047747-202512031410448665af2f56000207ab-uUVDN4@rts-flowmailer.siemens.com; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=siemens.com Received: from mta-65-227.siemens.flowmailer.net (mta-65-227.siemens.flowmailer.net. [185.136.65.227]) by gmr-mx.google.com with ESMTPS id ffacd0b85a97d-42e1ca5449csi281102f8f.9.2025.12.03.06.10.45 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 03 Dec 2025 06:10:45 -0800 (PST) Received-SPF: pass (google.com: domain of fm-1047747-202512031410448665af2f56000207ab-uuvdn4@rts-flowmailer.siemens.com designates 185.136.65.227 as permitted sender) client-ip=185.136.65.227; Received: by mta-65-227.siemens.flowmailer.net with ESMTPSA id 202512031410448665af2f56000207ab for ; Wed, 03 Dec 2025 15:10:45 +0100 X-Patchwork-Original-From: "'Clara Kowalsky' via isar-users" From: Clara Kowalsky To: isar-users@googlegroups.com Cc: quirin.gylstorff@siemens.com, Clara Kowalsky Subject: [PATCH] docs: fix typos in initramfs part Date: Wed, 3 Dec 2025 15:10:36 +0100 Message-ID: <20251203141036.952294-1-clara.kowalsky@siemens.com> MIME-Version: 1.0 X-Flowmailer-Platform: Siemens Feedback-ID: 519:519-1047747:519-21489:flowmailer X-Original-Sender: clara.kowalsky@siemens.com X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm2 header.b=hVrgRJwF; spf=pass (google.com: domain of fm-1047747-202512031410448665af2f56000207ab-uuvdn4@rts-flowmailer.siemens.com designates 185.136.65.227 as permitted sender) smtp.mailfrom=fm-1047747-202512031410448665af2f56000207ab-uUVDN4@rts-flowmailer.siemens.com; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=siemens.com X-Original-From: Clara Kowalsky Reply-To: Clara Kowalsky Precedence: list Mailing-list: list isar-users@googlegroups.com; contact isar-users+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: isar-users@googlegroups.com X-Google-Group-Id: 914930254986 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , X-Spam-Status: No, score=-4.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,MAILING_LIST_MULTI, RCVD_IN_DNSWL_BLOCKED,RCVD_IN_MSPIKE_H2,RCVD_IN_RP_CERTIFIED, RCVD_IN_RP_RNBL,RCVD_IN_RP_SAFE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= Signed-off-by: Clara Kowalsky --- doc/user_manual.md | 29 +++++++++++++++-------------- meta/classes/initramfs.bbclass | 4 ++-- 2 files changed, 17 insertions(+), 16 deletions(-) diff --git a/doc/user_manual.md b/doc/user_manual.md index 4df122a8..5a95fdc3 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -1687,16 +1687,16 @@ SRC_URI += "docker://debian;digest=sha256:f528891ab1aa484bf7233dbcc84f3c806c3e42 ## Switch from initramfs-tools to dracut -To build a Isar image with dracut as the initramfs generator instead -of initramfs-tools in Debian 13(trixie) or previous versions add dracut +To build an Isar image with dracut as the initramfs generator instead +of initramfs-tools in Debian 13 (trixie) or previous versions, add dracut as a package to the image: ``` IMAGE_PREINSTALL += "dracut" ``` -An dracut based initrd contains the file `/usr/lib/initrd-release`. In -case of trixie the file has the following content: +A dracut-based initrd contains the file `/usr/lib/initrd-release`. In +case of trixie, the file has the following content: ```bash NAME=dracut @@ -1737,7 +1737,7 @@ For running a custom script during boot-up, provide a bottom-half file in process: `init-top`, `init-premount`, `local-top`, `nfs-top`, `local-block`, `local-premount`, `nfs-premount`, `local-bottom`, `nfs-bottom`, `init-bottom`. If you do not benefit from the script header with its static `SCRIPT_PREREQ`, -you may instead provide `init-top-complete`, `init-premount-complete` etc. to +you may instead provide `init-top-complete`, `init-premount-complete`, etc., to still use automatic installation while defining the boot script completely yourself. @@ -1759,17 +1759,17 @@ It is controlled by following variables: - `DRACUT_REQUIRED_BINARIES` defines the binaries required by the module. - `DRACUT_MODULE_DEPENDENCIES` defines dependencies to other dracut modules. - `DRACUT_MODULE_NO` defines the module number which prefixes the module name -to define the execution order.The default is `50`. -- `DRACUT_MODULE_NAME` the name of the module which is used to install the +to determine the execution order. The default is `50`. +- `DRACUT_MODULE_NAME` defines the name of the module which is used to install the module in the initrd or as a dependency to other modules. It defaults to `${PN}` without the prefix `dracut-`. - `DRACUT_MODULE_PATH` contains the path to the installed module. It is set -to `${D}/usr/lib/dracut/modules.d/${DRACUT_MODULE_NO}${DRACUT_MODULE_NAME}/` +to `${D}/usr/lib/dracut/modules.d/${DRACUT_MODULE_NO}${DRACUT_MODULE_NAME}/`. The `install()` function is added by storing the file `install.sh` in the files directory of the dracut module. -Other files can by added to the module by coping them to the Module folder +Other files can by added to the module by copying them to the module folder with: ```bash install -m 666 ${WORKDIR}/lighttpd.service ${DRACUT_MODULE_PATH} @@ -1794,15 +1794,16 @@ See `isar-initramfs` or `isar-dracut` for an example recipes. #### dracut config -A dracut initramfs can be configured by the command line or a configuration file. -The use configuration files is preferred: +A dracut initramfs can be configured via the command line or a configuration file. +The use of configuration files is preferred: - Debian provides dracut-config-* packages - It is easier to upstream and to maintain. The configuration file can be chosen with the variable `DRACUT_CONFIG_PATH`. This variable -contains the absolut path to the used configuration in the root file system. +contains the absolute path to the used configuration in the root file system. +The configuration file should be placed in `/etc/dracut.conf.d` to follow the dracut convention. -Still there are some use cases like debugging to add modules via the command line. -For this the recipe meta/classes/initrd-dracut.bbclass provides the following options: +There are still some use cases, like debugging, where modules can be added via the command line. +For this, the recipe meta/classes/initrd-dracut.bbclass provides the following options: - `DRACUT_EXTRA_DRIVERS` add extra drivers to the dracut initrd - `DRACUT_EXTRA_MODULES` add extra modules to the dracut initrd diff --git a/meta/classes/initramfs.bbclass b/meta/classes/initramfs.bbclass index 862bd873..85b07f28 100644 --- a/meta/classes/initramfs.bbclass +++ b/meta/classes/initramfs.bbclass @@ -29,9 +29,9 @@ ROOTFSDIR = "${INITRAMFS_ROOTFS}" ROOTFS_FEATURES = "generate-manifest" ROOTFS_PACKAGES = "${INITRAMFS_GENERATOR_PKG} ${INITRAMFS_PREINSTALL} ${INITRAMFS_INSTALL}" -# validate if have incompatible packages in the installation list +# validate whether there are incompatible packages in the installation list python do_validate_rootfs_packages () { - # in Debian initramfs-tools specific packages should end or star + # in Debian, initramfs-tools specific packages should end or start # with initramfs # dracut specific packages end with dracut incompatible_initrd_packages = { 'initramfs-tools':['dracut'],