From nobody Sun Apr 28 18:19:19 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=1558719955; cv=none; d=zoho.com; s=zohoarc; b=GkKmDsJEB4SVNoNuSPcwbgd6AHR/UOXmaEX4JfBJCFQyubL+ABEmlS7jWy2I+FujWI/9xx84NOy4PaMfecereaCUKhAvI8nd5RTjUcolB53UpvzdoQUsd5usi74PIaxyPIXYsWTqktWEDhpXVOyNh/i9/vxuMiMq4Jt5pUhnxbI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1558719955; 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=wuRA31eStPlKt3+0/cP1Nch/C9HDPxJaeSXO3Cr4CxU=; b=FXI128degowbAgtGN3WfAX+jItoa9rRy/gTJY6QFOmnoRL16IuwQy3nNIex2tPNCOWsYMcT+aV3L/DDJ0p+5xPah/MvYCOV9bllCA1ncCrRAcjRhpT5IIHmyzrtgivUINypjAEHeNEg1G7ZApcYNVEhD/Van/sMJ0rZDBTve9KI= 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 1558719954910265.6662655292864; Fri, 24 May 2019 10:45:54 -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 1hUEF1-0004bk-1Q; Fri, 24 May 2019 17:44:27 +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 1hUEF0-0004bf-8f for xen-devel@lists.xenproject.org; Fri, 24 May 2019 17:44:26 +0000 Received: from mail.xenproject.org (unknown [104.130.215.37]) by us1-amaz-eas2.inumbo.com (Halon) with ESMTPS id 9186c81a-7e4b-11e9-b7b4-e33c82d6839c; Fri, 24 May 2019 17:44:24 +0000 (UTC) Received: from xenbits.xenproject.org ([104.239.192.120]) by mail.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hUEEq-0001dY-UF; Fri, 24 May 2019 17:44:16 +0000 Received: from localhost ([127.0.0.1] helo=localhost.localdomain) by xenbits.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hUEEq-00036U-J1; Fri, 24 May 2019 17:44:16 +0000 X-Inumbo-ID: 9186c81a-7e4b-11e9-b7b4-e33c82d6839c From: Lars Kurth To: xen-devel@lists.xenproject.org Date: Fri, 24 May 2019 11:44:04 -0600 Message-Id: <6250372b05e95412cfd0f8e6f558f2376c4f3d94.1558719481.git.lars.kurth@citrix.com> X-Mailer: git-send-email 2.13.0 Subject: [Xen-devel] [PATCH v3] 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 An example, what file content may look like is embedded below repo: linux-torvalds git https://git.kernel.org/pub/scm/linux/kernel/git/to= rvalds/linux.git file: xen/drivers/passthrough/arm/smmu.c linux-torvalds linux/drivers/iommu= /arm-smmu.c b77cf11f094136 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 Changes since v1 * Require a colon after repo:, file:, ... keywords * Replace manual:|auto: with file: as there auto: use-case was invalid * Added more verbose description of format Changes since v2 * Changed some formatting * Removed examples * Removed references to https Signed-off-by: Lars Kurth CC: committers@xenproject.org Acked-by: Jan Beulich --- TRACKING.FILES | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 TRACKING.FILES diff --git a/TRACKING.FILES b/TRACKING.FILES new file mode 100644 index 0000000000..60c47bdefb --- /dev/null +++ b/TRACKING.FILES @@ -0,0 +1,44 @@ +# 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 +# file: a mapping to track files +# +# Note that repo: entries must come *before* file: entries +# +# Repository Definitions are of the following format +# -------------------------------------------------- +# repo: name-of-source-repo git|svn url-of-source-repo +# +# name-of-source-repo +# Name of source repository. The name will be used as reference in file: +# statements +# +# git|svn +# Type of source repository +# +# url-of-source-repo +# URL of source repository +# +# Mappings to track files are of the following format +# --------------------------------------------------- +# file: xen-file name-of-original-repo original-file commit-id +# +# xen-file +# Xen file that needs to be tracked +# +# name-of-original-repo +# A reference to a source repository defined by *repo* keyword +# +# original-file +# File in original-repo from which we regularly want to merge changes +# into xen-file +# +# commit id +# Last commit id of original-file that was deemed to be ok +# and either imported into the tree or rejected + +version: 1 --=20 2.13.0 _______________________________________________ Xen-devel mailing list Xen-devel@lists.xenproject.org https://lists.xenproject.org/mailman/listinfo/xen-devel