From patchwork Mon Apr 5 00:34:59 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vijai Kumar K X-Patchwork-Id: 403 Return-Path: Delivered-To: ilbers.mnt@gmail.com Received: by 2002:a4a:378f:0:0:0:0:0 with SMTP id r137csp3239344oor; Mon, 5 Apr 2021 01:35:34 -0700 (PDT) X-Received: by 2002:adf:fa08:: with SMTP id m8mr28205772wrr.12.1617611734723; Mon, 05 Apr 2021 01:35:34 -0700 (PDT) ARC-Seal: i=3; a=rsa-sha256; t=1617611734; cv=pass; d=google.com; s=arc-20160816; b=pSI9iPr0A+7XWHpyZ0CKrL5z0aSr6rYHINPKVpjA8XbSp6QonPirzdhlXf7NCUacVb jjm+rLT8obPeDFLOxWF1yJ6ZvTBQjpkclp0Pl1abmh+Usz4HI1Xhnd/qco9CfjSAlLmc zZDS6oIm5VPaBIvyht3ah+QYv5uUQIVzeuM2YMBtNh10Jv/XQreMMWPHmo6cdcDP9pDq o7vXvLMsn9TLGNMTbp+NQC+DlWaRRzLYL2plV7s/0o2iUJLf7y+TzwdNp59vo9sthKQp SjZdcYBPWfX2e1zJl7PgtmR/gnjZBTnfm+3vbE8eWgql53RHMQo220FhOpD2HsmC+ooL AOxA== ARC-Message-Signature: i=3; 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:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:ironport-sdr:ironport-sdr:sender:dkim-signature; bh=xaovFuBMeHGdM36XS1BczsJWV0ROrZiAdTR8NqFzQwQ=; b=lZDGNT8bM6yz70EoF+Z9lpW8nwfghtci4KCByzwd5ZK8KxwugckvyM3zGlb3z3qI9b he1LBA4hspqkjEhKPSoliCRK/wjQ3VM5RExrTYBzF4tfXS1r1+slMfRGm1gG6xtGG+dE uGxLHsRJsgUNeGpYUJuoHipH81xAPj6m5S6Wynx+wlDXqfYpyZ7T9f4PsnqsDZl7Xcmd ZVs0TYI0NDiT9k2lvWv9FmRpthPotgaxraBXrWlSFpbv2L3I2ggxfEvzyVp18R+vVq8S ujZP7TQLapOC+Ym587DXX6M0+nq0lr+9+PQ9fyazoyhGXRFf8jwfWr9XFTR4yxsP/IBP O4MA== ARC-Authentication-Results: i=3; mx.google.com; dkim=pass header.i=@googlegroups.com header.s=20161025 header.b=Bj528B8s; arc=pass (i=2 spf=pass spfdomain=mentor.com); spf=pass (google.com: domain of isar-users+bncbcwp7lf37ukrbvuxvobqmgqedjohg5a@googlegroups.com designates 209.85.220.55 as permitted sender) smtp.mailfrom=isar-users+bncBCWP7LF37UKRBVUXVOBQMGQEDJOHG5A@googlegroups.com Received: from mail-sor-f55.google.com (mail-sor-f55.google.com. [209.85.220.55]) by mx.google.com with SMTPS id m17sor6852469wmq.7.2021.04.05.01.35.34 (Google Transport Security); Mon, 05 Apr 2021 01:35:34 -0700 (PDT) Received-SPF: pass (google.com: domain of isar-users+bncbcwp7lf37ukrbvuxvobqmgqedjohg5a@googlegroups.com designates 209.85.220.55 as permitted sender) client-ip=209.85.220.55; Authentication-Results: mx.google.com; dkim=pass header.i=@googlegroups.com header.s=20161025 header.b=Bj528B8s; arc=pass (i=2 spf=pass spfdomain=mentor.com); spf=pass (google.com: domain of isar-users+bncbcwp7lf37ukrbvuxvobqmgqedjohg5a@googlegroups.com designates 209.85.220.55 as permitted sender) smtp.mailfrom=isar-users+bncBCWP7LF37UKRBVUXVOBQMGQEDJOHG5A@googlegroups.com ARC-Seal: i=2; a=rsa-sha256; t=1617611734; cv=pass; d=google.com; s=arc-20160816; b=EpAo9fmNASuqrMoJR5oivD5pWtVoEmA+k2f6fZow3loKW+6L6yXm8SlI1S3yHXlvwR AMudfS3DMZD3Y0VRHAvzfXlUq/kqvE9l+ipjopR+JEEOo2J6fb4/2a4dCw9lHxZZlEFX IyXPrJHni/GE6plRckF3iWxst4pv47vMxctYQ0lnHlr5Iz9AE7yEngxfsvk9cC6cDkyK rshU+CBPEFVwvbw+mWM8PsvWJr989uCUcpfuvdd9nrO+yPZZqC2MLZvDw0HxD7fi0ZWO Twpd9TtywJadmSCvdrEeWLHj1RMe6vbLhdnzVDNHNjw0/yhgSTM5pP4GWoLFSBeYC0Yn DEKA== 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:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:ironport-sdr:ironport-sdr:sender:dkim-signature; bh=xaovFuBMeHGdM36XS1BczsJWV0ROrZiAdTR8NqFzQwQ=; b=jWE6Ep1iZpBZIiNSVAQzHcCVa9IVf9ZNLQ1wDjTDKC4nBo3Vxyrm2B9981rqWisHyv uZfyiwtMDqKwSU60QCFtBu++xAcBISJKgHtJmpgc8EEbPcR0ipKOvtxaxBu7D5Yn8LSQ QiACIvmx+B33dS1Kb+fXgelcGcDTQoZWaw2JONHPgxUdwUKdw06ViKe5PXUJrHb7ndBA 4is7RQvqMt2fqF9FXxfPEvIy2cw8cl20mxPQNkIcuMeY03RkcL8O5OJ79cGMMoF06dLm GNiV0LA2KIP6UKqPqfgdAPQDgtTCX8dtKHh0nf97ETYZUCFYOmw7tqolqFyqKlJ7K1PO G+PQ== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=pass (google.com: domain of vijaikumar_kanagarajan@mentor.com designates 68.232.137.252 as permitted sender) smtp.mailfrom=Vijaikumar_Kanagarajan@mentor.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:ironport-sdr:ironport-sdr:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:x-original-sender :x-original-authentication-results:content-transfer-encoding :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=xaovFuBMeHGdM36XS1BczsJWV0ROrZiAdTR8NqFzQwQ=; b=Bj528B8swW7P3iXVFA9xlmbs3zIyQ7TIrg4rtBUriHD0Pt8GQ9rjcCiFUyBo1dS2NE xJCsrD5mdsDapybfJZtJEEmxXy2l4Iej2psf3QmrbqdwhAkWeOIv+ZVXu8Wxz/Hz9Tb0 DwuwN0KxrWfTR/OlFcIdlIboornMVpfWcITXONPoOlGyfdfhipdpFMOYbowiCP8X0Wr3 xxU3SJ68blL7em2qxF/Xlvf8ynWRUclc+/oA7+fE8VMtdXywZMK2Nsc7F3flnmrfNTin N4Do9YKSd317/JxdSJU7ZyoZfozGSqKoKvfw4HYexDO+pQVymMMl8EWoHpBNlXIgIBN4 Ll6Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:ironport-sdr:ironport-sdr:from:to:cc :subject:date:message-id:in-reply-to:references:mime-version :x-original-sender:x-original-authentication-results :content-transfer-encoding:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=xaovFuBMeHGdM36XS1BczsJWV0ROrZiAdTR8NqFzQwQ=; b=n2Q7or8ydZ8LyivYSZW8EV4pWV8KameU7jLnZRbnyoI4hsgwDQUfyDX2GpImiDghaz GTB4bAo58WhRZUsNJtSarJ0rIyI5RFGezqUHTOqh+o8ceqmyiL8swWCaisrWEk0cHH4G pU09cQGjdGlDH9rsaRB5jeRQBDwMlYvaPk6IlLDWeAWLEngLRhl1F0X41NhOlbrfieWY lv+mJOubgCiABZ3CDQmu0PCrZQYgLGv1ynEuN5Uik+h0U7ADKJcdOmObProF09vt+irB cqqU3Hz6oQtQTmWgap45hYn09cmVBqwIZj1acnyT9Bp3I5Jksu4aGCtx3EIYhR6iLS59 /4yg== Sender: isar-users@googlegroups.com X-Gm-Message-State: AOAM530L9YQDcaCJ0Ous37XK4sp3Jeu1PHTMR7OerPVBjYLvPWCvqONQ 9EhUOPE8R2+q7jOzS1TVydw= X-Google-Smtp-Source: ABdhPJzgX+DIo/xicMFZN3n4Si5INP8lsvwCNtwBxckOTRZvz09pa3qxgU6AMgMAIprjVropBQnT6Q== X-Received: by 2002:a05:600c:4998:: with SMTP id h24mr13709104wmp.174.1617611734481; Mon, 05 Apr 2021 01:35:34 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a1c:6204:: with SMTP id w4ls1335162wmb.2.gmail; Mon, 05 Apr 2021 01:35:33 -0700 (PDT) X-Received: by 2002:a05:600c:358c:: with SMTP id p12mr24844606wmq.159.1617611733644; Mon, 05 Apr 2021 01:35:33 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1617611733; cv=none; d=google.com; s=arc-20160816; b=WewbbE6BwdjHIT9xvO7dy1IfE06drkeX8TM5sKzU/oRjWY0DDwTEpFrHnoMmAbZ/I2 sjEaJnDMAU/fF6QIyLfQZ2VY0Ji3SMAja6Mr0tiQxfn0VAb5OS/ulIAQ+OQ53ZQYx+kN tv2bFl/PczbT/6FmTwAze2cKXd+BMQPvfMSzYeCdeCP0yrnvwZJrEt5hwSCmSzJxfyhH 9CPe0U86i0qwW9jmHGqJUfFGUiSm8jhyUFbuU0zS5J9PVHFol3L6yOmyu2WjXBXd5TBQ CmoX22BN6Lobm/0NCCSymXZQM1vgZH+0nZLxqTRVLbRXAchcrgk5EQkCLEv8uugbbmQA 14Qg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:ironport-sdr:ironport-sdr; bh=hutTmkbd7edZUOBMyQ2tFZlyi790wkfX1Jwj6+whHhw=; b=MLZEKm6FPym3FCGzbPn8IbFIck3fi5ePbWx0UHFgwEubV0QQ896Y91nSOOH1V+aYkc CZujNLnpp0A1cYK+XL8OiaI1yV58iSYAzI3gnw/dPWSH3cHFMnXyrrMlK7KTK0lK/utH r8truGdVtk6Ofk4sonZPcr4o5AvwNk0PsQCSXjTVVvd7rmfxaywqBjKykmfcjQ7TLTje EIHllKMauYHOi/06MSbzzO3bn3tLgqra4Sc2tvjRjcdgIq9pnS8I0G0W7LRu4z3ukeVa 6NojT3FHay4rnd70gKN/Cr7bSmlerrEZjvGnoorZWzfCV+3hwyOk/RHrqtT8K9B/uiBB wZ9A== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of vijaikumar_kanagarajan@mentor.com designates 68.232.137.252 as permitted sender) smtp.mailfrom=Vijaikumar_Kanagarajan@mentor.com Received: from esa4.mentor.iphmx.com (esa4.mentor.iphmx.com. [68.232.137.252]) by gmr-mx.google.com with ESMTPS id r11si2072016wrm.1.2021.04.05.01.35.33 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 05 Apr 2021 01:35:33 -0700 (PDT) Received-SPF: pass (google.com: domain of vijaikumar_kanagarajan@mentor.com designates 68.232.137.252 as permitted sender) client-ip=68.232.137.252; IronPort-SDR: aKyVzLwj6OxfFSJ6KNH0ET1aKWP9leeiSEElP5MKHZtdQ4sZc9a8MLok2dTr1FfTvkingdefET 9rTyX4vWnbNkVg9zgsehYcuECEZPAwdOwuT8148A/QHFIqRXP4a3YOkf17yCL9JBDw7gCtrqqh wp57Qyz34DjzwaMbufWsSwraKAvJyt0R6sE/DuWW6bRvT9+dynUfubj9/eBIYf0xI1aVM3B4sL SCtq86CQo43ph7VWDYb8oER823TJFvJFUXah/dVy3PUqSIaahmEODePPda4znLTDwmKgXtloSY GVA= X-IronPort-AV: E=Sophos;i="5.81,306,1610438400"; d="scan'208";a="59930283" Received: from orw-gwy-01-in.mentorg.com ([192.94.38.165]) by esa4.mentor.iphmx.com with ESMTP; 05 Apr 2021 00:35:32 -0800 IronPort-SDR: 4+4/itC3dslyk7BMwKawilsxFLrJQmb5NiIZLGS2P7G4DA0xo2fGCbP+okiCCieHhPVGaOcLiK dL3wMMmwC/SwGGrp+lexTTnRSk/sOsgr1SAx7QlojbsiUO8I2uzdpgRUxvTtL5u48XJLDK2vZi KpfnBYlSdWen+EFhOvWWmmXGWGya3UaMk11kNm8F5dbYdhzF2UVG41msm50So88FZtNSuYAoTw 4tn7SgR6I1223VJs8HGjQCfk8yH0m2vg+iFCJetxaKYYvzz9yfnWsgZnhanUnDYezQZ0jAbCZD mXk= From: Vijai Kumar K To: , , , CC: Vijai Kumar K Subject: [PATCH v5 3/3] docs: Add detailed documentation about apt:// Date: Mon, 5 Apr 2021 14:04:59 +0530 Message-ID: <20210405083459.12277-4-Vijaikumar_Kanagarajan@mentor.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20210405083459.12277-1-Vijaikumar_Kanagarajan@mentor.com> References: <20210405083459.12277-1-Vijaikumar_Kanagarajan@mentor.com> MIME-Version: 1.0 X-ClientProxiedBy: svr-orw-mbx-04.mgc.mentorg.com (147.34.90.204) To svr-orw-mbx-01.mgc.mentorg.com (147.34.90.201) X-Original-Sender: vijaikumar_kanagarajan@mentor.com X-Original-Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of vijaikumar_kanagarajan@mentor.com designates 68.232.137.252 as permitted sender) smtp.mailfrom=Vijaikumar_Kanagarajan@mentor.com 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: INBOX X-GMAIL-THRID: =?utf-8?q?1696188842328859906?= X-GMAIL-MSGID: =?utf-8?q?1696188842328859906?= Add detailed documentation about apt:// in user manual. Signed-off-by: Vijai Kumar K --- doc/user_manual.md | 61 +++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 57 insertions(+), 4 deletions(-) diff --git a/doc/user_manual.md b/doc/user_manual.md index 9ca8e01..530f4c6 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -676,16 +676,69 @@ Before creating a new recipe it's highly recommended to take a look into the Bit Isar currently supports two ways of creating custom packages. +### Compilation of upstream sources + +Isar does understand `SRC_URI` entries starting with "apt://". For an example +of a customized upstream package have a look at `meta-isar/recipes-app/hello`. +This is what you do if you want to rebuild/modify an upstream package. + +### apt:// options +With apt:// you can specify the version of package you want to fetch by one of the below methods. + + - Specify the right ${PV} in the recipe name or inside the recipe. +``` +inherit dpkg + +PV=2.10 + +SRC_URI = "apt://${PN}" +``` + - You could also specify the version in SRC_URI as below +``` +inherit dpkg + +SRC_URI="apt://hello=2.10" +``` + - You can also specify the distribution instead of the package version. +``` +inherit dpkg + +SRC_URI="apt://hello/buster" +``` + - You can also ignore the ${PV} or distribution name and let apt resolve the version at build time. + +Recipe filename: hello.bb +``` +inherit dpkg + +SRC_URI="apt://hello" +``` + +When you use the last two methods, apt will pull the latest source package available for that particular +distribution. This might be different than the latest binary package version available for that particular +architecture. + +This happens when new source package is available via the debian security feeds, but builds are only available +for the major architectures like amd64, i386 and arm. + +Please see https://www.debian.org/security/faq#archismissing for details. + +If the user wants to make sure that he builds the right binary package available for their architecture, +please set ${PV}, so that the right source package is pulled for that architecture. + +Below are some of the packages with this scenario at the time of writing this. + +1. https://packages.debian.org/stretch/zstd +2. https://packages.debian.org/stretch/hello +3. https://packages.debian.org/stretch/apt +4. https://packages.debian.org/stretch/busybox + ### Compilation of debianized-sources The `deb` packages are built using `dpkg-buildpackage`, so the sources should contain the `debian` directory with necessary meta information. This way is the default way of adding software that needs to be compiled from source. The bbclass for this approach is called `dpkg`. **NOTE:** If the sources do not contain a `debian` directory your recipe can fetch, create, or ship that. You might want to read the the next section before returning here. -This is also what you do if you want to rebuild/modify an upstream package. -Isar does understand `SRC_URI` entries starting with "apt://". For an example -of a customized upstream package have a look at `meta-isar/recipes-app/hello`. - #### Example ``` DESCRIPTION = "Sample application for ISAR"