From patchwork Tue Jan 30 10:15:05 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Uladzimir Bely X-Patchwork-Id: 3323 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Tue, 30 Jan 2024 11:15:17 +0100 X-Sieve: CMU Sieve 2.4 Received: from mail-lf1-f61.google.com (mail-lf1-f61.google.com [209.85.167.61]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 40UAFGGo006404 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 30 Jan 2024 11:15:17 +0100 Received: by mail-lf1-f61.google.com with SMTP id 2adb3069b0e04-5100d033f56sf2887201e87.0 for ; Tue, 30 Jan 2024 02:15:17 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1706609711; cv=pass; d=google.com; s=arc-20160816; b=l8xCzg3ZBRaPoAE9EyVEjVwWDJQDNHpTLcFMMDBgiRpT66Urg/tdhAB1Js8cRRUCfY rJaJvM7HinI4JUWo03JMVWLFYsLGa5Y83UbRF7K5TQ03FR5C4N3UZP0Ucnddcue4tAGH hJFkh3733luLjrhvMSFClF1DQMhSs0aA2hCvuRj33YIAiYbmEAFaBBXFDSeULja99JUa /wQtgbYZaznCpl7BICqcgnk4cA6Eg2MwFRtlyplyV3JhBgBB/QxTnHeIZrnkUFeEHajU pFlwva1QM5NXfBcOMFQJqR3M3o41Y6faZL3Ek6sb7knbCPpNvezLJCDaqRflE/EPt5kj YdLw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:mime-version:references:in-reply-to :message-id:date:subject:to:from:sender:dkim-signature; bh=ENVJApcv8mLMLoiXixsBTpHCfitFMrVFlbogTgVEpOI=; fh=7tclEdh7YbwSQowgJ6LNq720O7H5HTEaqj22NJWRE2E=; b=DRHGEDygTYLzJmALYI47YKKiO57jWp9r3pVLB9J5IIqfXrjeq+PSmMCytxqK2Fmi3p pOMgkQSxLxuH7RCI1gA+Tk9R0Q/CU4Z8i6KqxOInTn7wyZxrfHzkBWIDnAcOcVz5Aj3x RC0ArPJftaxd9QfrsoACfxhYnhzMQk87YzkN3XW6mdfJZupl2Z8peYpi77hbOHuR9kEf ZfueTZnhxAC3JYuWiqbFfBl5bkhlIc2Wt6f/MFmEuIA3RYakrqgzW80t+sdEGrHYmK1Z mEzu8Lj7IkBl59ARsn1iaumdGcbjFrKlhlQwMpk2yFzMmwlrTFhWpka157jWd0NVl/7H r50g== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20230601; t=1706609711; x=1707214511; darn=isar-build.org; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:x-original-authentication-results :x-original-sender:mime-version:references:in-reply-to:message-id :date:subject:to:from:sender:from:to:cc:subject:date:message-id :reply-to; bh=ENVJApcv8mLMLoiXixsBTpHCfitFMrVFlbogTgVEpOI=; b=pt0iQryLxL576thVOpciKFkhkiGQkZNch3EVV050RDZLNtKeiVTp1NYqHVOKagFUta KpWzXku3XzQ7alHNlnxdSqzhOnBi6QFfCUMVBCpejYAKJGjf0RhFid/QXtg8s+HCz++l j/DyVHc9HFql8dfWs5N3nIAILvUYTTdaiWIEo7En6xVpd5t1jWb1tYInoCnoVf2Hyz+5 MXJ1PS1NWGZsDSoS4cx0s0FRmx2p4qIUy98QS/FiICQChMic793qiU72yAi5+0WL0ZnH +y26ayAyUuNssSu4SXl2SVPcmCgJCzxmIYrTH8ZAovp25078NpbakMz0MxOCHRukU8tb hLxQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1706609711; x=1707214511; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :x-spam-checked-in-group:list-id:mailing-list:precedence :x-original-authentication-results:x-original-sender:mime-version :references:in-reply-to:message-id:date:subject:to:from:x-beenthere :x-gm-message-state:sender:from:to:cc:subject:date:message-id :reply-to; bh=ENVJApcv8mLMLoiXixsBTpHCfitFMrVFlbogTgVEpOI=; b=EgOxHnj0admYPynYVhabLZ3xneYr0QJGvypAWwgvB8Kayfg5TAbblm7ffq8lY+auo+ ubG7r82zTHvqWHzS6IzOyy8V/d5PNiKkg6YBx22bmv16jkSC4EOMCQOaAKYdXHz35MX7 5inDYb62iq5UZUV1jn8b3fsv7pSsOLW5E4uA5m6wnmT2ylEbM53YyxxMQ7lKm/TWea7l CoproQCUiwIB/97hC++R2o3H8Yn9VIwyr5HKKYXU6dPAKbmP4+lGGemsrGa0I7TeFwlW v/mUVIQoPsm8M9kxuRyyESL/A8rVABuRNfWraxfRTqYwi9Qv/POAB6G3oZu44VgKQQKk Vpvg== Sender: isar-users@googlegroups.com X-Gm-Message-State: AOJu0YwgOuW4LjkKNVAdtd4AFe769H6tzC/gRuHr/2MMPneiRT5ghISN laETUd+8+VjEVNu+Dhmz7Mn2RCKu+z9Viob8jaYQ8Vf3vLzmDXtO X-Google-Smtp-Source: AGHT+IEAZ7ezJ6gE7XruHNgBznJ9IHM0ArI3Zirq8ydAoN3CfOubFDHO94qtVrySOYfQrTVIMARbTA== X-Received: by 2002:a19:e057:0:b0:510:5e7:e5e5 with SMTP id g23-20020a19e057000000b0051005e7e5e5mr5000416lfj.5.1706609710877; Tue, 30 Jan 2024 02:15:10 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:6512:3444:b0:510:21ac:b9d6 with SMTP id j4-20020a056512344400b0051021acb9d6ls467273lfr.0.-pod-prod-07-eu; Tue, 30 Jan 2024 02:15:09 -0800 (PST) X-Received: by 2002:a05:6512:3996:b0:510:67d:7251 with SMTP id j22-20020a056512399600b00510067d7251mr5965417lfu.47.1706609708625; Tue, 30 Jan 2024 02:15:08 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1706609708; cv=none; d=google.com; s=arc-20160816; b=OtHiabjLOlhWPHgaQ2Ta62pg/cj0WPq7FvBxnLiviwyVvw0DCl2Ei5Kh9vWQM4KzLu 3JOhVxIw5GhxJUTePhPdoZIrz2s3RO2jhtnesAojO4M6tMY0rMpd1x3y2kAhPMRPMl2m bUtJxB/G1EizeWcOfnSDHwYNKqg/opPaL5hp7RlMfM8Djh1fozsfwDf0sBJBBtyWTOkP rG/RNAVeUBsPK8pyVM+1Nt2WqA4jPyjvQnDjmXEWXhGgZktdbrui4KsR+eMypXMnbVwR PeT00ci+VLh5I+IpgJD4KSTU7Swl5Zh6IwtbnOwGHBXAdfwBv9CxyQ+dWoCwnEEbTYw4 j35g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from; bh=IcgKUiBn9n6cYaDT80vrLnWisog6DOFbZl3TM0thZuM=; fh=7tclEdh7YbwSQowgJ6LNq720O7H5HTEaqj22NJWRE2E=; b=mcOn27r+ShEQEhAQ32XQXUzDLhuiCg/z+bxUQaamkvC0SlukCagFfLq1RDuAc9BQpG i/PllZ0ka3TR+38DhxLpTt3FyZG9bDmQwsSD77XYldYNmJX44Wn7FqnxYNLD9u4+JCrs tzbGUfb1Dq/jCE5vc8LWU7qoaw+ZcITx+jHt4tsTeG/CO5aFD81cx5ZmuzslbOAO4zsL IjptEnnOiBWtEUFFoWvQQmFi4FA7s7TMk3WJfXyPmdze1duySW/s8V9DMqCxHCL9zCsu rHr6W8r0ReFKVb66i52LIZzeGCQ35cKHabLuQGKPvDCg0jDhLvQqxhUGuztjfZZuGkBD 2BJQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id u6-20020ac258c6000000b0050e7c496b6esi335325lfo.13.2024.01.30.02.15.08 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Tue, 30 Jan 2024 02:15:08 -0800 (PST) Received-SPF: pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Received: from baighyz.m.ilbers.de (host-80-81-17-52.static.customer.m-online.net [80.81.17.52]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPSA id 40UAF62o006374 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 30 Jan 2024 11:15:07 +0100 From: Uladzimir Bely To: isar-users@googlegroups.com Subject: [PATCH 1/2] doc/user_manual.md: Fix/update the contents Date: Tue, 30 Jan 2024 11:15:05 +0100 Message-Id: <20240130101506.27451-2-ubely@ilbers.de> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20240130101506.27451-1-ubely@ilbers.de> References: <20240130101506.27451-1-ubely@ilbers.de> MIME-Version: 1.0 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H2,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-Original-Sender: ubely@ilbers.de X-Original-Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de 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-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= Add missing top-level sections of the contents and fix some sections with broken links. Signed-off-by: Uladzimir Bely --- doc/user_manual.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/doc/user_manual.md b/doc/user_manual.md index 2eb97647..27b86869 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -10,20 +10,26 @@ Copyright (C) 2016-2019, ilbers GmbH - [How Isar Works](#how-isar-works) - [General Isar Configuration](#general-isar-configuration) - [Isar Distro Configuration](#isar-distro-configuration) - - [Custom Package Compilation](#custom-package-compilation-1) + - [Custom Package Generation](#custom-package-generation-1) - [Image Type Selection](#image-type-selection) - [Add a New Distro](#add-a-new-distro) - [Add a New Machine](#add-a-new-machine) - [Add a New Image](#add-a-new-image) - [Add a New Image Type](#add-a-new-image-type) + - [Customize and configure image](#customize-and-configure-image) + - [Create a Custom Image Recipe](#create-a-custom-image-recipe) - [Add a Custom Application](#add-a-custom-application) - [Build statistics collection](#build-statistics-collection) - - [Enabling Cross-compilation](#isar-cross-compilation) + - [Isar Cross-compilation](#isar-cross-compilation) + - [Examining and debugging package generation inside their schroot rootfs](#examining-and-debugging-package-generation-inside-their-schroot-rootfs) - [Using ccache for custom packages](#using-ccache-for-custom-packages) - [Using sstate-cache](#using-sstate-cache) - [Create an ISAR SDK root filesystem](#create-an-isar-sdk-root-filesystem) - [Create a containerized Isar SDK root filesystem](#create-a-containerized-isar-sdk-root-filesystem) - [Creation of local apt repo caching upstream Debian packages](#creation-of-local-apt-repo-caching-upstream-debian-packages) + - [Add foreign packages from other repositories to the generated image](#add-foreign-packages-from-other-repositories-to-the-generated-image) + - [Cache all upstream Debian source packages in local apt](#cache-all-upstream-debian-source-packages-in-local-apt) + - [Use a custom sbuild chroot to speedup build](#use-a-custom-sbuild-chroot-to-speedup-build) ## Introduction From patchwork Tue Jan 30 10:15:06 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Uladzimir Bely X-Patchwork-Id: 3324 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Tue, 30 Jan 2024 11:15:18 +0100 X-Sieve: CMU Sieve 2.4 Received: from mail-lf1-f58.google.com (mail-lf1-f58.google.com [209.85.167.58]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 40UAFHhA006409 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 30 Jan 2024 11:15:17 +0100 Received: by mail-lf1-f58.google.com with SMTP id 2adb3069b0e04-5111de3fc23sf56217e87.1 for ; Tue, 30 Jan 2024 02:15:17 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1706609711; cv=pass; d=google.com; s=arc-20160816; b=f30j58Iz9hQF5+dU9ZHM2kav3bmbmkP0iKA8VIv6iNVOPHCA0bMoWSXSGvPs1VhRpF e5B1IhsOdiLJkRhHv1ZFasi/7Diqr+cLsPrLMkLjYFxgrnxOQQNP0SXUdk2Naf7Mbu2Z r7bpi5sp4Nwv8BmaCitLYR4QBFOq7BvIvLzNOr+W6hxAzAhbhkEL+iVowItWovc41QeY O1vtO+k+6jOOoxvc1HZgSVOzq5plgTma13l4uJzOWsQ8Y1wpS4XvjHfBETIbLynIcfha GXYY4ShwwNyxafeJWrmgzje2PovDW2OvB/6poQmD8fw9dyvohAIaYTVKqj6zpfs95zbV ekMQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:mime-version:references:in-reply-to :message-id:date:subject:to:from:sender:dkim-signature; bh=9CAcTYtGeEQBsP/tpnEU4X2h5LByxiLpCYRGe2qleQs=; fh=7tclEdh7YbwSQowgJ6LNq720O7H5HTEaqj22NJWRE2E=; b=k/4ppYT9mcFc1pWmRpVvUUkvC1SFnJSnC+7pqDkvsl2AiMmFDvXBsd68Pmv99S3nfS O8AmDdJmG3hu/HNDqnfCFB1jMmeU6aN4MkgCzRxxvhLRQkUin7XQOI/tRkfcobUbbUOz LUTfbaRi6Xv+Lv5jYnPsv0TIBpJhaSOV16EdU5hYIDMdyRwvGHY54nqE+LnxJjFExVLd nFG37yR8xFSb+ORK/Z0Mf7/3UEuln2RJPLgaFVkd68qT0d7evATYsz/L6aqLjxsrXAr6 H5f0i35p0zACVqMWYZ8fj+XlrWma4djCxJjfH73h51vth44Cmdwm3NY37SRivZ988X8e 23ug== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20230601; t=1706609711; x=1707214511; darn=isar-build.org; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:x-original-authentication-results :x-original-sender:mime-version:references:in-reply-to:message-id :date:subject:to:from:sender:from:to:cc:subject:date:message-id :reply-to; bh=9CAcTYtGeEQBsP/tpnEU4X2h5LByxiLpCYRGe2qleQs=; b=NTeIKm3yvjvtx0BdWE2g6G4YfTk9u1GyFNagnYkFtfB8kjIA+QW+NqxQlsJJgDcQBS lJtLPhtnawDROjqBN+1Vz5yf+izB1CsvORbw+0E7Zk2elX6oYIGJ1vS6ZjXrGVindOfR v+Gbva51Vrrv+fbORGNd5UCh3N4KuAG6aUeyxU6oMsgffwaujgiI9MbbW7azSWd+FWsB CfECXLwAQ69fyKXlTptBIfm4j3bdK4JAQskZ++iezBFha1clmb0Y+oy1HL3TTxEO3G4z XYA9OJ4vyxNff4qbEqFTu9K4I12fm6qTpSPyiByveAMLiBvqudwyl5PAeJpI6phfEbz2 vVvw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1706609711; x=1707214511; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :x-spam-checked-in-group:list-id:mailing-list:precedence :x-original-authentication-results:x-original-sender:mime-version :references:in-reply-to:message-id:date:subject:to:from:x-beenthere :x-gm-message-state:sender:from:to:cc:subject:date:message-id :reply-to; bh=9CAcTYtGeEQBsP/tpnEU4X2h5LByxiLpCYRGe2qleQs=; b=ujSLZGP1PFP93fAtr1ExKEGS1W6ctrdhvqHFuFLML16lSF/KAr3iZbQSGXfNZAk9eQ C+SvXNyW7i4/SJLbZITU8XSnPtaYdYuXHSskMsZ3MCi0En7CqHWq1lO5EX2mXerQZLLP y/zv8Zg5HmJEHZzPRsPD8CW3TKRktsnhmsCRu0k1L00MLmxb8ukTKEotCnqFXdQ+Tb7b pMx2V53UTdMNoEz29DFDyGBVRIF+8HjHquiNi+AqZSviHnhb5nVAEdW9B9mUdvhjnRXX GdR1p2NamOLzInPAjWXQHTObkcRNPvk1J8qrEvYXtvFRsCi6Kq6W0eaTiubIwazvxQ38 npcw== Sender: isar-users@googlegroups.com X-Gm-Message-State: AOJu0YzrfaHjtPJxalq46SoiXYaGbFalbOFzo1LtsHxjMX1nzkdlVjSz I74fQevQz+REUp6nBJAUc55LE1NdpFoD09nZLPT7mwXfWZ09Mde5 X-Google-Smtp-Source: AGHT+IH6xoLHHZZmCR5kuYffmTwjxmWNlaUvIXeKIrKQUsX1q5RTds9EpeFdAdg737zXQ8/XH3tHoQ== X-Received: by 2002:a19:4f57:0:b0:510:16ae:52e with SMTP id a23-20020a194f57000000b0051016ae052emr6000835lfk.2.1706609711362; Tue, 30 Jan 2024 02:15:11 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:6512:2311:b0:511:1738:dcf6 with SMTP id o17-20020a056512231100b005111738dcf6ls609826lfu.1.-pod-prod-07-eu; Tue, 30 Jan 2024 02:15:09 -0800 (PST) X-Received: by 2002:a2e:80d7:0:b0:2d0:54ef:1dc6 with SMTP id r23-20020a2e80d7000000b002d054ef1dc6mr1537762ljg.33.1706609708966; Tue, 30 Jan 2024 02:15:08 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1706609708; cv=none; d=google.com; s=arc-20160816; b=LLAy5u+JA2dOtHSs9d719AhPQlJD/tV1Rh+/ALTryGqvBErGBK2cub3/iBnc76tGEv vpzzNKtL+Ym1dFJYmXnee59iL0pnz6aualUpcqoDGgdGjJJ2EnNVTz1IUsUOxkClPYG9 f02tcULJ605sx4TbV473He3hfq2K4ad0Evd/LoKoxHJ3CXW8AmvIr+KRK7gDGy4L7Hx/ XvLcXq3XdImYZ3OTVt2r6DiWA/wFGJoPimFDrOMx+Za/A23ZJlNlXCAbu/Fp80D6alJ+ U8lySoWNMoEEpjrrTIXXUpSCzud05eo9yj3LZgj7ll6TZ5AoEdBu+r+3fFLNGOd3Ylz9 57mw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from; bh=HXakBnK4k6uECbv06kbLsj/m3F9AFnkbO/jc5iqKtLs=; fh=7tclEdh7YbwSQowgJ6LNq720O7H5HTEaqj22NJWRE2E=; b=vEOuWb90NbStsvZ7z+r5i50jKJeaq5xZRQU3trh3qN/62nqwsBmzYqQSv/9jaFUgCr ewGer2/hS5O3luG48Sx5kBt0Hkblssiw/CR+mNlkSs+p/nouwTGhFQGRs8khmDKRLNy7 5JWrFbNj5k5Y1MgGhi+e/BCmAm0cnrZ+xs/pczRftjoRBnq9LJTKz1nR/Y7MQGrjm77w U21OKgeReiClIZBlwvkf0cddrwcQ24yFjDnUL5O4sF0OzQ249nbKRcc5zNifeTL8Hrk0 iLXCS0nZeDWBUCNWCFDH/yigkn704o1hrHiBrbSDA+VNvkO+6aCWK+YlHHc9foAtAkFQ r39A== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id a25-20020a2e8619000000b002cf1dbde597si402499lji.2.2024.01.30.02.15.08 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Tue, 30 Jan 2024 02:15:08 -0800 (PST) Received-SPF: pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Received: from baighyz.m.ilbers.de (host-80-81-17-52.static.customer.m-online.net [80.81.17.52]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPSA id 40UAF62p006374 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 30 Jan 2024 11:15:07 +0100 From: Uladzimir Bely To: isar-users@googlegroups.com Subject: [PATCH 2/2] image-account-extension: Move examples to user manual Date: Tue, 30 Jan 2024 11:15:06 +0100 Message-Id: <20240130101506.27451-3-ubely@ilbers.de> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20240130101506.27451-1-ubely@ilbers.de> References: <20240130101506.27451-1-ubely@ilbers.de> MIME-Version: 1.0 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H2,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-Original-Sender: ubely@ilbers.de X-Original-Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de 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-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= Based on discussion in https://github.com/ilbers/isar/issues/103 Signed-off-by: Uladzimir Bely --- doc/user_manual.md | 22 ++++++++++++++++++++ meta/classes/image-account-extension.bbclass | 18 ---------------- 2 files changed, 22 insertions(+), 18 deletions(-) diff --git a/doc/user_manual.md b/doc/user_manual.md index 27b86869..747b5ffe 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -700,6 +700,28 @@ The `USERS` and `USER:` variable works similar to the `GROUPS` and `GR - `clear-text-password` - The `password` flag of the given user contains a clear-text password and not an encrypted version of it. - `force-passwd-change` - Force the user to change to password on first login. +#### Example + +``` +GROUPS += "root" +GROUP_root[gid] = "0" +GROUP_root[flags] = "system" + +USERS += "root" +USER_root[password] = "$6$rounds=10000$RXeWrnFmkY$DtuS/OmsAS2cCEDo0BF5qQsizIrq6jPgXnwv3PHqREJeKd1sXdHX/ayQtuQWVDHe0KIO0/sVH8dvQm1KthF0d/" +USER_root[expire] = "180" +USER_root[inactive] = "30" +USER_root[uid] = "0" +USER_root[gid] = "0" +USER_root[comment] = "The ultimate root user" +USER_root[home] = "/home/root" +USER_root[shell] = "/bin/sh" +USER_root[groups] = "audio video" +USER_root[flags] = "create-home system force-passwd-change" +``` + +Some examples can be also found in `meta-isar/conf/local.conf.sample`. + #### Home directory contents prefilling To cover all users simply use `/etc/skel`. Files in there will be available in every home directory under correct permissions. diff --git a/meta/classes/image-account-extension.bbclass b/meta/classes/image-account-extension.bbclass index 412aa06d..9e67cb91 100644 --- a/meta/classes/image-account-extension.bbclass +++ b/meta/classes/image-account-extension.bbclass @@ -6,26 +6,8 @@ # This class extends the image.bbclass for creating user accounts and groups. USERS ??= "" - -#USERS += "root" -#USER_root[password] = "" # Encrypted password, or clear-text when [flags] = "clear-text-password" -#USER_root[expire] = "" -#USER_root[inactive] = "" -#USER_root[uid] = "" -#USER_root[gid] = "" # If first character is a number: gid, otherwise groupname -#USER_root[comment] = "The ultimate root user" -#USER_root[home] = "/home/root" -#USER_root[shell] = "/bin/sh" -#USER_root[groups] = "audio video" -#USER_root[flags] = "no-create-home create-home system allow-empty-password clear-text-password force-passwd-change" - GROUPS ??= "" -#GROUPS += "root" -#GROUP_root[gid] = "" -#GROUP_root[flags] = "system" - - def image_create_groups(d: "DataSmart") -> None: """Creates the groups defined in the ``GROUPS`` bitbake variable.