From nobody Fri Mar 29 00:52:40 2024 Delivered-To: importer@patchew.org Received-SPF: none (zoho.com: 192.237.175.120 is neither permitted nor denied by domain of lists.xenproject.org) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; spf=none (zoho.com: 192.237.175.120 is neither permitted nor denied by domain of lists.xenproject.org) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org ARC-Seal: i=1; a=rsa-sha256; t=1557958848; cv=none; d=zoho.com; s=zohoarc; b=R44orRO/K3l7zpSlai2UIum3F+DkiXR58b3sY8zEf5mamEOlVoNeWu8zIjfOE0hN3/uuI2hZEA9dFloAjv+Oq2D7wlVCi0wmIJbqIZikdUGCLNKgiTJaf4oRO6SIEF9Y6p5BjNhcDcSA5S7HwLzv16WCvaKfpiBEeV52ml4vnNA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1557958848; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To:ARC-Authentication-Results; bh=MfDZ+O4KcAOgrH9pz1t34ZsQ0I2T+6bka8/SutvqDbY=; b=J9f6SpE886/wBZBokXRhpZ4wN5BGjsf8y0Sjr+uUqOiWDMihK1et2o638dxgimg9MYCPV9q+lqQFPaBaeCGWno8e6Ek5+wONK8Ex0jA2+aESdYkMn0LIbvoBCI+uzo08OFOHuoLEN2hsiHYhflwbFfS1303u2tnIy7+K4kce1sU= ARC-Authentication-Results: i=1; mx.zoho.com; spf=none (zoho.com: 192.237.175.120 is neither permitted nor denied by domain of lists.xenproject.org) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1557958848107182.95886061063948; Wed, 15 May 2019 15:20:48 -0700 (PDT) Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hR2Ey-00049N-9J; Wed, 15 May 2019 22:19:12 +0000 Received: from all-amaz-eas1.inumbo.com ([34.197.232.57] helo=us1-amaz-eas2.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hR2Ex-00048N-FJ for xen-devel@lists.xenproject.org; Wed, 15 May 2019 22:19:11 +0000 Received: from mail.xenproject.org (unknown [104.130.215.37]) by us1-amaz-eas2.inumbo.com (Halon) with ESMTPS id 74def2b6-775f-11e9-b576-4f6e64908efc; Wed, 15 May 2019 22:19:08 +0000 (UTC) Received: from xenbits.xenproject.org ([104.239.192.120]) by mail.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hR2El-0006EN-4c; Wed, 15 May 2019 22:18:59 +0000 Received: from localhost ([127.0.0.1] helo=localhost.localdomain) by xenbits.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hR2Ek-0004bk-QT; Wed, 15 May 2019 22:18:59 +0000 X-Inumbo-ID: 74def2b6-775f-11e9-b576-4f6e64908efc From: Lars Kurth To: xen-devel@lists.xenproject.org Date: Wed, 15 May 2019 16:18:46 -0600 Message-Id: <0648312f1c78e519142ff1829a984e7e965bf3c7.1557957269.git.lars.kurth@citrix.com> X-Mailer: git-send-email 2.13.0 Subject: [Xen-devel] [PATCH] Add TRACKING.IMPORTS to xen.git to more easily manage imported files that need to be kept in sync with an upstream X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Lars Kurth , Stefano Stabellini , Wei Liu , Konrad Rzeszutek Wilk , George Dunlap , Andrew Cooper , Ian Jackson , Tim Deegan , Julien Grall , committers@xenproject.org, Jan Beulich MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" Following the recent discussion, we had on IRC and the action I had in=20 the March community call, this file provides a file format that=20 enables writing an automated test to check whether files are out of sync.=20 Unlike in the IRC discussion, which suggested a single line for all information, I broke out the repository into a separate statement for - Better readability (aka shorter lines) - Better maintainability if a repo URL changes The list of files that need to be included are Once the file format is agree, I will write a test or script. I also need some more correct test data, aka entries in the file from committers looking after the following files [Jan] xen/arch/x86/cpu/mwait-idle.c=20 [Stefano, Julien - this has to be finalized] xen/drivers/passthrough/arm/smmu.c xen/arch/arm/vgic/* xen/include/asm-arm/div64.h xen/drivers/char/meson-uart.c xen/arch/arm/arm32/lib/* xen/arch/arm/arm64/lib/* xen/arch/arm/arm64/cache.S xen/arch/arm/arm64/bpi.S xen/include/asm-arm/system.h xen/arch/arm/arm64/insn.c [Others?] xen/common/rbtree.c Note that in some cases Linux has diverged and some Linux files have disapp= eared.=20 Julien also raised the point, that in some cases only a subset of code from= Linux Xen files was applied or that only some functions get moved across t= o Xen. I believe that is entirely OK. The workflow would be in most cases that: - We use a Linux (source) commit as a benchmark and record the commit ID - If there is a change in Linux the test will fail - The committer looks at the diff and either - Decides to ignore it and bumps the commit ID in this file - Decides the change is needed, integrates it into Xen and then=20 bumps the commit ID in this file Signed-off-by: Lars Kurth CC: committers@xenproject.org --- TRACKING.IMPORTS | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 TRACKING.IMPORTS diff --git a/TRACKING.IMPORTS b/TRACKING.IMPORTS new file mode 100644 index 0000000000..39829e078c --- /dev/null +++ b/TRACKING.IMPORTS @@ -0,0 +1,40 @@ +# This file contains information about source files that have been +# copied from other sources and need to be tracked +# +# The file may contain lines starting with ... +# -------------------------------------------- +# version: of file format +# repo: repository definition +# auto|manual: a mapping to track files +# +# Repository Definitions are of the following format +# -------------------------------------------------- +# repo name-of-source-repo git|svn https-url-of-source-repo +# +# For example: +# repo linux-torvalds git https://git.kernel.org/pub/scm/linux/kernel/gi= t/torvalds/linux.git +# +# Mappings to track files are of the following format +# --------------------------------------------------- +# manual|auto xen-file name-of-original-repo original-file commit-id +# +# auto: +# The xen-file needs to track the the original-file exactly +# In other words, we can automatically update the file using a script +# +# manual: +# A developer needs to make a decision whether a +# specific change is applied or ignored and update the last commit id +# accordingly +# +# name-of-original-repo: +# A reference to a source repository defined by *repo* keyword +# +# commit id: +# Last commit id of source file that was deemed to be ok +# and either imported into the tree or rejected +# +# For example: +# manual xen/drivers/passthrough/arm/smmu.c linux-torvalds linux/drivers= /iommu/arm-smmu.c b77cf11f094136 + +version 1 --=20 2.13.0 _______________________________________________ Xen-devel mailing list Xen-devel@lists.xenproject.org https://lists.xenproject.org/mailman/listinfo/xen-devel