From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6558749580291211264 X-Received: by 2002:a1c:47d8:: with SMTP id m85-v6mr144074wmi.28.1527681010442; Wed, 30 May 2018 04:50:10 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:adf:dd51:: with SMTP id u17-v6ls3553998wrm.12.gmail; Wed, 30 May 2018 04:50:10 -0700 (PDT) X-Google-Smtp-Source: ADUXVKLWOU4/L9+QaRrOV3D2lSanm/lgZDyCWh8j4qs4dYxFPSx1yYar13uBg/pwjq/lUIwZPHuQ X-Received: by 2002:adf:e7c7:: with SMTP id e7-v6mr204410wrn.25.1527681010025; Wed, 30 May 2018 04:50:10 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1527681010; cv=none; d=google.com; s=arc-20160816; b=vY8TRM+giLdYWuAKwhM79RBJQOiF+x6IccSne4CBnOoni1eIIAaAqA6HWUCVLQCL2b XvkkFt3FrFkOlD1AEyH812pkDaC+/SJ/mznVQYnRpBlQ9cXQt0UOAcBWRR7j0rPmYalR iqxsN7OLYFcU472Ayn1U3qYEM5XPAq2EUhyXwHNAJqzbYwzWm2sHBxym/Zdxmdt9nbF8 SFm/PVXHE4YRHHyXXNsKeIEToZrWDsUBCiJbMdXZ44S4thghJ6LumXO9sxWw2Pl0WO2f EKqTx4q2ejJvwy/hMqEeIvD8Y2YxnwujrTBITWMGelURpyQxKflJKl8Yk6R3yFhWW5sV fh6g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=references:in-reply-to:message-id:date:subject:cc:to:from :arc-authentication-results; bh=EkLDTisk8gSqf3CKVC6r9HQZ7Ro/eW39Khglyl7P+iY=; b=LDshXNskn4hXN4XoPog5ndwnTTjvWMbr9Gby/JgcGXm3aMntYQ0k4yAaeIHnsMdYMn BqEXa5WaMKw7oDcle3s8QylUeWm1FxbnRfWyNObWYPhKzM9TkQlxtPs3WPz+AcBnHUSK +YA2v6Y7DOscgw/tpd2iS7lbDXgVWyVLCm3VsVwu0cHFO3hDYWBJj7Eq4r8F/IvNfCTe uTcHa2l/TdeapVF6J7+K76/iaYHvxnXkjf+az95y9HRDCs3AhuCOH81H6RXwb+63sCbT svpEiOzF4eANqEqK+QnNSM5xoy7rp3F8qcOXNDe+K0Y1Z9F5TbYFAQKzLugqEWKHkNPM De7w== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of claudius.heine.ext@siemens.com designates 194.138.37.40 as permitted sender) smtp.mailfrom=claudius.heine.ext@siemens.com Return-Path: Received: from gecko.sbs.de (gecko.sbs.de. [194.138.37.40]) by gmr-mx.google.com with ESMTPS id x17-v6si61344wmd.0.2018.05.30.04.50.09 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 30 May 2018 04:50:09 -0700 (PDT) Received-SPF: pass (google.com: domain of claudius.heine.ext@siemens.com designates 194.138.37.40 as permitted sender) client-ip=194.138.37.40; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of claudius.heine.ext@siemens.com designates 194.138.37.40 as permitted sender) smtp.mailfrom=claudius.heine.ext@siemens.com Received: from mail2.sbs.de (mail2.sbs.de [192.129.41.66]) by gecko.sbs.de (8.15.2/8.15.2) with ESMTPS id w4UBo8fA019984 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 30 May 2018 13:50:08 +0200 Received: from ring.ppmd.siemens.net (linux-ses-ext02.ppmd.siemens.net [139.25.69.69]) by mail2.sbs.de (8.15.2/8.15.2) with ESMTP id w4UBo7F5014220; Wed, 30 May 2018 13:50:08 +0200 From: claudius.heine.ext@siemens.com To: isar-users@googlegroups.com Cc: Claudius Heine Subject: [PATCH v6 4/4] doc: added description of `IMAGE_TRANSIENT_PACKAGES` and locale vars Date: Wed, 30 May 2018 13:50:00 +0200 Message-Id: <20180530115000.14424-5-claudius.heine.ext@siemens.com> X-Mailer: git-send-email 2.17.0 In-Reply-To: <20180530115000.14424-1-claudius.heine.ext@siemens.com> References: <20180530115000.14424-1-claudius.heine.ext@siemens.com> X-TUID: qIZBVFLZbj6o From: Claudius Heine --- doc/user_manual.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/user_manual.md b/doc/user_manual.md index a2f4b92..9921f3a 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -318,6 +318,8 @@ Some other variables include: - `IMAGE_INSTALL` - The list of custom packages to build and install to target image, please refer to relative chapter for more information. - `BB_NUMBER_THREADS` - The number of `bitbake` jobs that can be run in parallel. Please set this option according your host CPU cores number. + - `LOCALE_GEN` - A `\n` seperated list of `/etc/locale.gen` entries desired on the target. + - `LOCALE_DEFAULT` - The default locale used for the `LANG` and `LANGUAGE` variable in `/etc/locale`. --- @@ -481,6 +483,22 @@ Isar contains two image type classes that can be used as reference: --- +## Customize and configure image + +Customization and configuration of an image should be done via packages, see below. + +Adding those configuration packages to the image can be done in two ways: + + 1. Simply adding the package to `IMAGE_INSTALL`, like any other isar created package, or + 2. Adding the package to `IMAGE_TRANSIENT_PACKAGES`. + +In most cases adding the configuration package to `IMAGE_INSTALL` is the right option. + +In cases were the configuration script of the package has some external dependencies, that should not be part of the final image, then `IMAGE_TRANSIENT_PACKAGES` is the right option. +Packages in the `IMAGE_TRANSIENT_PACKAGES` variable are installed to the image and purged in the next step. If such a configuration package deploys file as part of their content, then those files will be removed as well. + +--- + ## Add a Custom Application Before creating a new recipe it's highly recommended to take a look into the BitBake user manual mentioned in Terms and Definitions section. -- 2.17.0