From patchwork Sun Oct 7 11:57:43 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Yann E. MORIN" X-Patchwork-Id: 980147 Return-Path: X-Original-To: incoming-buildroot@patchwork.ozlabs.org Delivered-To: patchwork-incoming-buildroot@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=busybox.net (client-ip=140.211.166.137; helo=fraxinus.osuosl.org; envelope-from=buildroot-bounces@busybox.net; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=free.fr Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="XJm53Nui"; dkim-atps=neutral Received: from fraxinus.osuosl.org (smtp4.osuosl.org [140.211.166.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 42ShpM5HchzB2xn for ; Sun, 7 Oct 2018 22:58:19 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id 2F45C8593C; Sun, 7 Oct 2018 11:58:18 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from fraxinus.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id VVuJhDJelwET; Sun, 7 Oct 2018 11:58:17 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by fraxinus.osuosl.org (Postfix) with ESMTP id 883E18593E; Sun, 7 Oct 2018 11:58:17 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from hemlock.osuosl.org (smtp2.osuosl.org [140.211.166.133]) by ash.osuosl.org (Postfix) with ESMTP id 5EEC21BF429 for ; Sun, 7 Oct 2018 11:58:14 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by hemlock.osuosl.org (Postfix) with ESMTP id 5C88B86BFB for ; Sun, 7 Oct 2018 11:58:14 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from hemlock.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 5eP0N23dwsQk for ; Sun, 7 Oct 2018 11:58:13 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-wm1-f49.google.com (mail-wm1-f49.google.com [209.85.128.49]) by hemlock.osuosl.org (Postfix) with ESMTPS id 7BDDE86B25 for ; Sun, 7 Oct 2018 11:58:13 +0000 (UTC) Received: by mail-wm1-f49.google.com with SMTP id y140-v6so6792642wmd.0 for ; Sun, 07 Oct 2018 04:58:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references; bh=flo4bRw1Th5Am3CW61bu6q5lH8rf79fPrWtAuyOOPOk=; b=XJm53Nuigm6mMYCYiL+iSxkdcDQmGJ9FtGbsOTPsQQf44QGMiTGxuSIUWc1+EprakX N5uGEPLXfPJGGOEB2F4RdZ/EUnvUPvUgPYgv6aJKcLQSd/2bqZ68wmbJC5/yIlXLWWxZ Lkr4NBnoR8tgMiwIuG6oTo+UXmMsjkX+SjI3G6rltQO3Aq2Z95MdAbRpXMJrqKCTWN2n lS/2zh1Uk9cdIEAzWjrDpsKkMjKBQmxy6/aqwFJUWvtoUFoJi//dHQRjsy2++M2f49tn fu2bss+ODNJT2D0dRXBq+IjiOZk+0mbz95s+RktM3tYsCtt3IWlZ5dyTTL9oQiOQYMKA B3gg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references; bh=flo4bRw1Th5Am3CW61bu6q5lH8rf79fPrWtAuyOOPOk=; b=IAWpkXWkOOmYwMjp7r4Jw1/3KY5PuOj8P8Q8YWlPzZOx08FaA36V4BQSAqj6fpWpXt 3FctfBmAgxw3clp9Y7XoaYeu5c4S/8jClN+HpsOrQHHJDdaXma87jSds7gA3MuQhXXKe EQhQwM56kkl8zmNt0ogq5Mb3W3+fA/FxhvMc9W7HsnqVtDSuGoVMnxcBw6MViE6q3Ezz ktlUDXfE7dsl2YHP8bkSVbshsG9WVlnFZ5zJ1LUh5YCHh1yye1ofUMjZqN3YSTIfnqu+ OuL1GWmeFwWAVuJmZ5hybfUkt5ER2zn9YSHfru9E2F1d6XCVfTgyHWvvoHHRicg1vWov 3JpQ== X-Gm-Message-State: ABuFfohhkfO2MERVaWBHHJ+HuxeZLudMCYAO6XfIdmjOG9cCkn9I+rzb C5vFwizpRdit33B6CgQRyYWRbL8x X-Google-Smtp-Source: ACcGV60fQEBg2wD4E9KnV0/f+yD7S3l1txzvqqXJYws8QOsX0bRHPHT7XaPdaaFUT9uAV58Iof6ZGQ== X-Received: by 2002:a1c:1183:: with SMTP id 125-v6mr12985808wmr.103.1538913491469; Sun, 07 Oct 2018 04:58:11 -0700 (PDT) Received: from localhost.localdomain ([2a01:cb19:829a:2800:68e8:7a61:9bb9:12a]) by smtp.gmail.com with ESMTPSA id v1-v6sm11373138wrd.24.2018.10.07.04.58.10 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 07 Oct 2018 04:58:10 -0700 (PDT) From: "Yann E. MORIN" To: buildroot@buildroot.org Date: Sun, 7 Oct 2018 13:57:43 +0200 Message-Id: X-Mailer: git-send-email 2.14.1 In-Reply-To: References: Subject: [Buildroot] [PATCH 6/6] docs/manual: document location of hash files for multi-versions packages X-BeenThere: buildroot@busybox.net X-Mailman-Version: 2.1.29 Precedence: list List-Id: Discussion and development of buildroot List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas Petazzoni , Luca Ceresoli , "Yann E. MORIN" , Thomas De Schampheleire MIME-Version: 1.0 Errors-To: buildroot-bounces@busybox.net Sender: "buildroot" Signed-off-by: "Yann E. MORIN" Cc: Thomas De Schampheleire Cc: Thomas Petazzoni Cc: Arnout Vandecappelle Cc: Luca Ceresoli Cc: Baruch Siach Reviewed-by: Luca Ceresoli --- docs/manual/adding-packages-directory.txt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/manual/adding-packages-directory.txt b/docs/manual/adding-packages-directory.txt index f5e1e313d5..761605eda9 100644 --- a/docs/manual/adding-packages-directory.txt +++ b/docs/manual/adding-packages-directory.txt @@ -444,6 +444,13 @@ contains the hashes of the downloaded files for the +libfoo+ package. The only reason for not adding a +.hash+ file is when hash checking is not possible due to how the package is downloaded. +When a package has a version selection choice, then the hash file may be +stored in a subdirectory named after the version, e.g. ++package/libfoo/1.2.3/libfoo.hash+. This is especially important if the +different versions have different licensing terms, but they are stored +in the same file. Otherwise, the hash file should stay in the package's +directory. + The hashes stored in that file are used to validate the integrity of the downloaded files and of the license files.