Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/1585731/?format=api
{ "id": 1585731, "url": "http://patchwork.ozlabs.org/api/patches/1585731/?format=api", "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=api", "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=api", "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=api", "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": "<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>", "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=<UNKNOWN>)" ], "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 <incoming@patchwork.ozlabs.org>; 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 <qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>)\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 <peter.maydell@linaro.org>)\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 <peter.maydell@linaro.org>)\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 <qemu-devel@nongnu.org>; 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 <qemu-devel@nongnu.org>\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 <peter.maydell@linaro.org>", "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": "<qemu-devel.nongnu.org>", "List-Unsubscribe": "<https://lists.nongnu.org/mailman/options/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>", "List-Archive": "<https://lists.nongnu.org/archive/html/qemu-devel>", "List-Post": "<mailto:qemu-devel@nongnu.org>", "List-Help": "<mailto:qemu-devel-request@nongnu.org?subject=help>", "List-Subscribe": "<https://lists.nongnu.org/mailman/listinfo/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=subscribe>", "Errors-To": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org", "Sender": "\"Qemu-devel\"\n <qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>" }, "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 <thuth@redhat.com>\nSigned-off-by: Peter Maydell <peter.maydell@linaro.org>\nReviewed-by: Alex Bennée <alex.bennee@linaro.org>\nReviewed-by: Cornelia Huck <cohuck@redhat.com>\nReviewed-by: Thomas Huth <thuth@redhat.com>\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" ] }