From patchwork Wed Sep 5 16:06:35 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Angelo Compagnucci X-Patchwork-Id: 966526 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=amarulasolutions.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=amarulasolutions.com header.i=@amarulasolutions.com header.b="TGbtE91c"; 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 4257r65px8z9sDb for ; Thu, 6 Sep 2018 02:07:02 +1000 (AEST) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id C971B87199; Wed, 5 Sep 2018 16:06:59 +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 hKMFJK_ZYnUC; Wed, 5 Sep 2018 16:06:57 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by fraxinus.osuosl.org (Postfix) with ESMTP id 0E17C8714F; Wed, 5 Sep 2018 16:06:57 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136]) by ash.osuosl.org (Postfix) with ESMTP id 7AF0F1C2DF0 for ; Wed, 5 Sep 2018 16:06:48 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id 768C028985 for ; Wed, 5 Sep 2018 16:06:48 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from silver.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id LnHFk2Nd4Qn9 for ; Wed, 5 Sep 2018 16:06:48 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from mail-wr1-f67.google.com (mail-wr1-f67.google.com [209.85.221.67]) by silver.osuosl.org (Postfix) with ESMTPS id A5B8522921 for ; Wed, 5 Sep 2018 16:06:47 +0000 (UTC) Received: by mail-wr1-f67.google.com with SMTP id u12-v6so8253540wrr.4 for ; Wed, 05 Sep 2018 09:06:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amarulasolutions.com; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=FloB9hfN4epO20KW9xnIndiL+0KrLWWL/7CKMGS2kzs=; b=TGbtE91c9ublgyNGvmWXztK7+YmaXKN1SSnWJiO5XdQyR0vbUwx8kgLq4YVCu9faZJ CKedvBjOIZeE9AxSpV0YmScNnQTVW6A2KOGktIW64eoxiQNaEoaVJVAQFuVtaonK9T5S zejhE/JNd6tF71M/fe7puofPsa/3dh9zgaP5A= 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=FloB9hfN4epO20KW9xnIndiL+0KrLWWL/7CKMGS2kzs=; b=TftwBcKWJ7sYkmDXhhDqb24J79ASVcFr7DkRsJDpoeSqZGRmi2WByrO54fWE52cj9w PHQbAE/reHF/SLcDPAqGbz4nB5LM6m+dzBZmx+MLRfyvFSQSDi+pcSUcPfRGKjDIn65i fP7UKSc2OEk7FWyQNOyKlvIAV4BGxvw0fJ9EWT+PEmWU4k8VT3mFy+ZtkSjQrSTHlc6/ 9B5qMtPWfylJOlwRqXpUD/hcTHcqmvX+TcRPnqOApIDJv6+zi2hzywcNMlnWuvz9I8UE TzzN2WVM9hLFiy+soNM9OJGUHk9+6DsS69s2fv+vAbvP3B1BIW4RTKpbyaQ0TE5A7wlc SiYA== X-Gm-Message-State: APzg51CJPBznGawGtal+rvzvyOVOc3fJPUAVJceGBd1OSxBiIZJUVFtw uPHfqDz0agO4v8Hm6MG/uudqZN3PZAs= X-Google-Smtp-Source: ANB0VdaAuqYnBayuOjouGcERW/k8r5LDtvhtahUATD3s2RI4PlVrJuiQq0FtgIUp7u8t3wYTXnudHQ== X-Received: by 2002:adf:806d:: with SMTP id 100-v6mr26639431wrk.23.1536163605779; Wed, 05 Sep 2018 09:06:45 -0700 (PDT) Received: from localhost.localdomain ([89.202.204.147]) by smtp.gmail.com with ESMTPSA id k34-v6sm3525308wre.18.2018.09.05.09.06.44 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 05 Sep 2018 09:06:45 -0700 (PDT) From: Angelo Compagnucci To: buildroot@buildroot.org Date: Wed, 5 Sep 2018 18:06:35 +0200 Message-Id: <1536163596-5310-3-git-send-email-angelo@amarulasolutions.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1536163596-5310-1-git-send-email-angelo@amarulasolutions.com> References: <1536163596-5310-1-git-send-email-angelo@amarulasolutions.com> Subject: [Buildroot] [PATCH v3 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" Adding documentation about the usage of LIBFOO_TAINTS and "make check-tainted". 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..8f159ad 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