{"id":1585731,"url":"http://patchwork.ozlabs.org/api/patches/1585731/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20220128153009.2467560-17-peter.maydell@linaro.org/","project":{"id":14,"url":"http://patchwork.ozlabs.org/api/projects/14/?format=json","name":"QEMU Development","link_name":"qemu-devel","list_id":"qemu-devel.nongnu.org","list_email":"qemu-devel@nongnu.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20220128153009.2467560-17-peter.maydell@linaro.org>","list_archive_url":null,"date":"2022-01-28T15:29:53","name":"[PULL,16/32] scripts: Explain the difference between linux-headers and standard-headers","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"4424d1f52450b8ce27e56bc0972dfffe4199f9c2","submitter":{"id":5111,"url":"http://patchwork.ozlabs.org/api/people/5111/?format=json","name":"Peter Maydell","email":"peter.maydell@linaro.org"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20220128153009.2467560-17-peter.maydell@linaro.org/mbox/","series":[{"id":283405,"url":"http://patchwork.ozlabs.org/api/series/283405/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/list/?series=283405","date":"2022-01-28T15:29:53","name":"[PULL,01/32] Update copyright dates to 2022","version":1,"mbox":"http://patchwork.ozlabs.org/series/283405/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/1585731/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/1585731/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming@bilbo.ozlabs.org","Authentication-Results":["bilbo.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=linaro.org header.i=@linaro.org header.a=rsa-sha256\n header.s=google header.b=t+94CuuQ;\n\tdkim-atps=neutral","ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org\n (client-ip=209.51.188.17; helo=lists.gnu.org;\n envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n receiver=)"],"Received":["from lists.gnu.org (lists.gnu.org [209.51.188.17])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby bilbo.ozlabs.org (Postfix) with ESMTPS id 4JlhLn2KQ7z9t56\n\tfor ; Sat, 29 Jan 2022 02:33:37 +1100 (AEDT)","from localhost ([::1]:60422 helo=lists1p.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.90_1)\n\t(envelope-from )\n\tid 1nDTFn-0002Dq-3Q\n\tfor incoming@patchwork.ozlabs.org; Fri, 28 Jan 2022 10:33:35 -0500","from eggs.gnu.org ([209.51.188.92]:57678)\n by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from )\n id 1nDTD6-0002Ae-TG\n for qemu-devel@nongnu.org; Fri, 28 Jan 2022 10:30:52 -0500","from [2a00:1450:4864:20::432] (port=42598\n helo=mail-wr1-x432.google.com)\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)\n (Exim 4.90_1) (envelope-from )\n id 1nDTD0-0006Q0-2o\n for qemu-devel@nongnu.org; Fri, 28 Jan 2022 10:30:45 -0500","by mail-wr1-x432.google.com with SMTP id a13so11560609wrh.9\n for ; Fri, 28 Jan 2022 07:30:32 -0800 (PST)","from orth.archaic.org.uk (orth.archaic.org.uk. [2001:8b0:1d0::2])\n by smtp.gmail.com with ESMTPSA id j3sm4749485wrb.57.2022.01.28.07.30.30\n for \n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Fri, 28 Jan 2022 07:30:31 -0800 (PST)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google;\n h=from:to:subject:date:message-id:in-reply-to:references:mime-version\n :content-transfer-encoding;\n bh=dwHC/ctEYOOYZjyRsSRWGZZC159ozfXxs9syF5bxiNs=;\n b=t+94CuuQrKSosJGOI4rVaV31UvLb5KpjwFV6c4gKmu4q4KvsQCCUIPFLOKZ0i8dgym\n VMIRqt95UNpB1viGiyzb3KxV23KCXvNilQ02XZKWws7LezFqq4e/BXZxFPRRnGhaOZ+h\n jn3MBNTj3c0eiiu8moaL0OqbsCb+BAFd+uKlr75XF/ChNFN1Zf4ZWtJRIz6l2Q/XaBKF\n wu52yFgeGGU5ilHCUDOtgxeqtqrQe7tCaEPQGfVloJ+KinkQ/YP5x4TYajmPQ9ks6IGO\n ufSBFbb9ht5JICzNPtpbPJjiL7s7XvTRMB+aQdvK8PokujeALmc79bLPy6AYdtm4I5HU\n 7/LA==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20210112;\n h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to\n :references:mime-version:content-transfer-encoding;\n bh=dwHC/ctEYOOYZjyRsSRWGZZC159ozfXxs9syF5bxiNs=;\n b=e1nIb2kl8yePsyluURqyn448E+L2iarZO1hjQQS6vW4uJuZYjaqLI77IyK1gN9fJaO\n qLmOH5vPxveCpur1dKaQCiKZKeBX+BbGXvlmsjOYskgnyS09TyKFbCUO5jHwO/D16z8X\n hKgvpVSOWU6cspFBF+s9fxIKvaanGbOdLDOkMtYOO5RhhDmZjQqtxV1hxCdbk28U5kzr\n /RF3KIaN2M8yhs5NnYJ/tv0dkfWHiIbPM4sTNZBaAXmdJfVQi94W6/LpWDJangiiv7aJ\n aS/O3Tm0ViAmlYyZZfqvrisKpy23FvdVEnJxHhP8eq78pk9vtpTQPKYB2IdqOUefzBK0\n f/Kw==","X-Gm-Message-State":"AOAM530Z4dyjfc+fl91bas1q7351c8BajBdU2OnaC5Zo9xtOEC8vOmMT\n bsdJWybsMCCNBcC27mNte10yEzvnn0eIhw==","X-Google-Smtp-Source":"\n ABdhPJwoRqT76mTqnWUXomioJhjk8iLIm0k8KzuXVKPT8NUTa9IW7Tw4OHsTtTPuUxtBnnZP0Gh+uw==","X-Received":"by 2002:adf:d1ec:: with SMTP id g12mr7936088wrd.8.1643383831391;\n Fri, 28 Jan 2022 07:30:31 -0800 (PST)","From":"Peter Maydell ","To":"qemu-devel@nongnu.org","Subject":"[PULL 16/32] scripts: Explain the difference between linux-headers\n and standard-headers","Date":"Fri, 28 Jan 2022 15:29:53 +0000","Message-Id":"<20220128153009.2467560-17-peter.maydell@linaro.org>","X-Mailer":"git-send-email 2.25.1","In-Reply-To":"<20220128153009.2467560-1-peter.maydell@linaro.org>","References":"<20220128153009.2467560-1-peter.maydell@linaro.org>","MIME-Version":"1.0","Content-Type":"text/plain; charset=UTF-8","Content-Transfer-Encoding":"8bit","X-Host-Lookup-Failed":"Reverse DNS lookup failed for 2a00:1450:4864:20::432\n (failed)","Received-SPF":"pass client-ip=2a00:1450:4864:20::432;\n envelope-from=peter.maydell@linaro.org; helo=mail-wr1-x432.google.com","X-Spam_score_int":"-12","X-Spam_score":"-1.3","X-Spam_bar":"-","X-Spam_report":"(-1.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,\n DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,\n PDS_HP_HELO_NORDNS=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793,\n SPF_HELO_NONE=0.001, SPF_PASS=-0.001,\n T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no","X-Spam_action":"no action","X-BeenThere":"qemu-devel@nongnu.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org","Sender":"\"Qemu-devel\"\n "},"content":"If you don't know it, it's hard to figure out the difference between\nthe linux-headers folder and the include/standard-headers folder.\nSo let's add a short explanation to clarify the difference.\n\nSuggested-by: Thomas Huth \nSigned-off-by: Peter Maydell \nReviewed-by: Alex Bennée \nReviewed-by: Cornelia Huck \nReviewed-by: Thomas Huth \n---\n scripts/update-linux-headers.sh | 16 ++++++++++++++++\n 1 file changed, 16 insertions(+)","diff":"diff --git a/scripts/update-linux-headers.sh b/scripts/update-linux-headers.sh\nindex fea4d6eb655..fe850763c55 100755\n--- a/scripts/update-linux-headers.sh\n+++ b/scripts/update-linux-headers.sh\n@@ -9,6 +9,22 @@\n #\n # This work is licensed under the terms of the GNU GPL version 2.\n # See the COPYING file in the top-level directory.\n+#\n+# The script will copy the headers into two target folders:\n+#\n+# - linux-headers/ for files that are required for compiling for a\n+# Linux host. Generally we have these so we can use kernel structs\n+# and defines that are more recent than the headers that might be\n+# installed on the host system. Usually this script can do simple\n+# file copies for these headers.\n+#\n+# - include/standard-headers/ for files that are used for guest\n+# device emulation and are required on all hosts. For instance, we\n+# get our definitions of the virtio structures from the Linux\n+# kernel headers, but we need those definitions regardless of which\n+# host OS we are building for. This script has to be careful to\n+# sanitize the headers to remove any use of Linux-specifics such as\n+# types like \"__u64\". This work is done in the cp_portable function.\n \n tmpdir=$(mktemp -d)\n linux=\"$1\"\n","prefixes":["PULL","16/32"]}