From patchwork Wed Sep 5 22:22:12 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Angelo Compagnucci X-Patchwork-Id: 966725 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.138; helo=whitealder.osuosl.org; envelope-from=buildroot-bounces@busybox.net; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=gmail.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="f4rqoQHp"; dkim-atps=neutral Received: from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 425J9T1CJYz9sCh for ; Thu, 6 Sep 2018 08:22:36 +1000 (AEST) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id 1EF2E88859; Wed, 5 Sep 2018 22:22:34 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id nYOmpaeSgyHz; Wed, 5 Sep 2018 22:22:27 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by whitealder.osuosl.org (Postfix) with ESMTP id D0E9988845; Wed, 5 Sep 2018 22:22:25 +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 D376B1C2B9B for ; Wed, 5 Sep 2018 22:22:23 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by hemlock.osuosl.org (Postfix) with ESMTP id D0EC488C75 for ; Wed, 5 Sep 2018 22:22:23 +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 bWdr5gA55uTZ for ; Wed, 5 Sep 2018 22:22:22 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-wr1-f67.google.com (mail-wr1-f67.google.com [209.85.221.67]) by hemlock.osuosl.org (Postfix) with ESMTPS id 91FFA88C7B for ; Wed, 5 Sep 2018 22:22:22 +0000 (UTC) Received: by mail-wr1-f67.google.com with SMTP id e1-v6so180240wrt.3 for ; Wed, 05 Sep 2018 15:22:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=aZM0igE/6hUdFD6NlB7u8kZ9/Vx/ldBrGGis32HAhHw=; b=f4rqoQHp2x0takAHvhK0rOz7lya5DNv0Q/ly1DqXwrBs1Np+vGNZBJjRCQNvaV9fcU Z5iomeYIKGVlGkiX9IWUgC6b6m9fRhVyYYnIRa6qRdm1fCMSrdYPBoud6SZBebeY5pgd mcKbTWwEthKMtXCDh1kZfnsmg6Fjm6P/Gf+U0HjtUNX4iSv6RJS7VyRQvPLcasbIn7Js Q6nxkUbFWzAOzljQbe/8By3Lj8ciBzUe9QKpaHtrbR4ZqWY9pRTaJXqnbZjRGaXjOfxh KyZLxo0Cfm3gzg+B1uicSndViYgnX+fCKftySlhN2zLAYKEEE/vrK2UES2U9P+pBFefl LEsw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=aZM0igE/6hUdFD6NlB7u8kZ9/Vx/ldBrGGis32HAhHw=; b=O8X/Lx5AsQKUwYjLfEKMSIU2HuOX2BXsQi7gEpP0DuQQmo5zJo8oANA6y3UqYcsCuv wjtNAQ6Y+H9uH390pj9GUr9pnvABDecW57MbCAxISsKSNjWd/Q8G60hrhEu5N05KfDzU I8WLBkC3CX6eSukDD3h0q15RDKx4QW6vgomCM+dC36yVt9Eq29aoVz7yfuk2ZPZWb8az jtpNZ6Bi16WmfnjknAWCGMYafTD3ERZgMO1o5QRHmoAaUWXDhlgxulG1RtggCR4R+JYA B3XXlKIojKsm9GHkJVR+/Evc8Z169jHct2ZIQj9B8BZFPOucsRRTb7Euw7MuJBCLGY9F Hppg== X-Gm-Message-State: APzg51Bq40k36mA2FtEsjKli7TwC7KOrKh3uIFZbAWeZ/EozbRpfq5gM 1PK6drCxg0M0FLELJ7LjRoB3IENV X-Google-Smtp-Source: ANB0VdYbJWir9w3DD/aWgY/YwFso5yjHE+3UZEwN0MMUSebk6DA6lKzBlw4johm7HzI8+Oo/YX7ijg== X-Received: by 2002:a5d:54cb:: with SMTP id x11-v6mr12357220wrv.150.1536186140969; Wed, 05 Sep 2018 15:22:20 -0700 (PDT) Received: from localhost.localdomain ([37.162.44.87]) by smtp.gmail.com with ESMTPSA id b10-v6sm4303981wmc.28.2018.09.05.15.22.19 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 05 Sep 2018 15:22:20 -0700 (PDT) From: Angelo Compagnucci To: buildroot@buildroot.org Date: Thu, 6 Sep 2018 00:22:12 +0200 Message-Id: <1536186133-9933-3-git-send-email-angelo.compagnucci@gmail.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1536186133-9933-1-git-send-email-angelo.compagnucci@gmail.com> References: <1536186133-9933-1-git-send-email-angelo.compagnucci@gmail.com> Subject: [Buildroot] [PATCH v5 2/3] docs/manual: adding infos about tainting X-BeenThere: buildroot@busybox.net X-Mailman-Version: 2.1.24 Precedence: list List-Id: Discussion and development of buildroot List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Angelo Compagnucci MIME-Version: 1.0 Errors-To: buildroot-bounces@busybox.net Sender: "buildroot" From: Angelo Compagnucci Adding documentation about the usage of LIBFOO_TAINTS and "make check-tainted". Signed-off-by: Angelo Compagnucci Signed-off-by: Angelo Compagnucci --- docs/manual/adding-packages-generic.txt | 6 ++++++ docs/manual/legal-notice.txt | 12 ++++++++++++ 2 files changed, 18 insertions(+) diff --git a/docs/manual/adding-packages-generic.txt b/docs/manual/adding-packages-generic.txt index 7be1754..6495157 100644 --- a/docs/manual/adding-packages-generic.txt +++ b/docs/manual/adding-packages-generic.txt @@ -445,6 +445,12 @@ not and can not work as people would expect it should: to let you know, and +not saved+ will appear in the +license files+ field of the manifest file for this package. +* +LIBFOO_TAINTS+ shoud be set to YES if a package taints a Buildroot + configuration. A Buildroot configuration is tainted when a packages uses + external dependencies for which Buildroot cannot clearly recover licensing + informations. If a configuration is tainted, it means that the licensing + information produced by +make legal-info+ could not be accurate. + * +LIBFOO_ACTUAL_SOURCE_TARBALL+ only applies to packages whose +LIBFOO_SITE+ / +LIBTOO_SOURCE+ pair points to an archive that does not actually contain source code, but binary code. This a very diff --git a/docs/manual/legal-notice.txt b/docs/manual/legal-notice.txt index 6975328..7fde09a 100644 --- a/docs/manual/legal-notice.txt +++ b/docs/manual/legal-notice.txt @@ -73,6 +73,18 @@ distribution is required). When you run +make legal-info+, Buildroot produces warnings in the +README+ file to inform you of relevant material that could not be saved. +Furthermore, a Buildroot configuration could be tainted from a package that uses +some custom external dependencies from the Buildroot tree. An example could be +a package manager for a software stack that downloads the required dependencies +during the building of a package. In such cases, Buildroot cannot check the +licensing of the downloaded software and thus giving accurate licensing +informations. +To check if your configuration is tainted, run: + +-------------------- +make check-tainted +-------------------- + Finally, keep in mind that the output of +make legal-info+ is based on declarative statements in each of the packages recipes. The Buildroot developers try to do their best to keep those declarative statements as