From patchwork Mon Jul 24 14:41:42 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ian Jackson X-Patchwork-Id: 9859611 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id A8AEA6038F for ; Mon, 24 Jul 2017 14:44:42 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 9A0F8283DA for ; Mon, 24 Jul 2017 14:44:42 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 8F13728573; Mon, 24 Jul 2017 14:44:42 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=2.0 tests=BAYES_00, RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 33E5F283DA for ; Mon, 24 Jul 2017 14:44:41 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dZeYg-00082G-Qa; Mon, 24 Jul 2017 14:42:06 +0000 Received: from mail6.bemta6.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dZeYf-00081u-Bs for xen-devel@lists.xenproject.org; Mon, 24 Jul 2017 14:42:05 +0000 Received: from [85.158.143.35] by server-8.bemta-6.messagelabs.com id 60/50-09901-C3706795; Mon, 24 Jul 2017 14:42:04 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFuphkeJIrShJLcpLzFFi42JxWrohUteGvSz S4MtjXovvWyYzOTB6HP5whSWAMYo1My8pvyKBNWPzxIiCzbwVy29dYGxgbOfuYuTkkBDwl7i9 p5kJxGYT0JVo2vKXrYuRg0NEQEXi9l4DEJNZIFRixwtLkAphgSCJE3/Xs4PYLAKqEru29TOC2 LwCnhKT+2YzQ0yUkzh//CeYzSngJXH6+3NWkDFCAvUSWxvkIUw1ibnr4yE6BSVOznzCAmIzC0 hIHHzxgnkCI+8sJKlZSFILGJlWMWoUpxaVpRbpGhvqJRVlpmeU5CZm5ugaGpjp5aYWFyemp+Y kJhXrJefnbmIEhgwDEOxgbFoUeIhRkoNJSZRXiKksUogvKT+lMiOxOCO+qDQntfgQowwHh5IE 7w9WoJxgUWp6akVaZg4weGHSEhw8SiK8JmxAad7igsTc4sx0iNQpRl2OVxP+f2MSYsnLz0uVE udVBikSACnKKM2DGwGLpEuMslLCvIxARwnxFKQW5WaWoMq/YhTnYFQS5s0FuYQnM68EbtMroC OYgI6YM6MU5IiSRISUVANjf4/DHDUXeTWmMwrNhxlvt1w+or4tJPPsmv+8Ox6GJPzpkrjzo61 USub3y2tm4SY3Gmexeiq9bjpirf7iH8v0stIbp5lmMyo/772bpmR6poyFo9Jupu725Zo/v/Op 7rC5GHZ5jW1+avzx/5ZbDofLNfMdOpxVltXEuUjr2qaFu7xOG2znEtqhxFKckWioxVxUnAgAd w5xVJ8CAAA= X-Env-Sender: prvs=371027d51=Ian.Jackson@citrix.com X-Msg-Ref: server-2.tower-21.messagelabs.com!1500907317!60769301!2 X-Originating-IP: [66.165.176.89] X-SpamReason: No, hits=0.0 required=7.0 tests=sa_preprocessor: VHJ1c3RlZCBJUDogNjYuMTY1LjE3Ni44OSA9PiAyMDMwMDc=\n, received_headers: No Received headers X-StarScan-Received: X-StarScan-Version: 9.4.25; banners=-,-,- X-VirusChecked: Checked Received: (qmail 32019 invoked from network); 24 Jul 2017 14:42:03 -0000 Received: from smtp.citrix.com (HELO SMTP.CITRIX.COM) (66.165.176.89) by server-2.tower-21.messagelabs.com with RC4-SHA encrypted SMTP; 24 Jul 2017 14:42:03 -0000 X-IronPort-AV: E=Sophos;i="5.40,407,1496102400"; d="scan'208";a="432707277" From: Ian Jackson To: Date: Mon, 24 Jul 2017 15:41:42 +0100 Message-ID: <1500907304-12791-2-git-send-email-ian.jackson@eu.citrix.com> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1500907304-12791-1-git-send-email-ian.jackson@eu.citrix.com> References: <22896.54014.418454.891770@mariner.uk.xensource.com> <1500907304-12791-1-git-send-email-ian.jackson@eu.citrix.com> MIME-Version: 1.0 Cc: Ian Jackson Subject: [Xen-devel] [OSSTEST PATCH 1/3] README.planner: Improve internals documentation a bit X-BeenThere: xen-devel@lists.xen.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" X-Virus-Scanned: ClamAV using ClamSMTP * share-flight resources may end up owned by a different task to their shareix, perhaps as a result of test database operations or perhaps as a result of donation with mg-allocate. This should not be a problem. * Document the xdbref task type. Signed-off-by: Ian Jackson --- README.planner | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/README.planner b/README.planner index f3cab53..b3b41a9 100644 --- a/README.planner +++ b/README.planner @@ -133,6 +133,10 @@ Types of task mg-execute-flight). They are automatically created and destroyed - see above. + * `xdbref' tasks. These are used to own resources whose allocation + authority has been transferred to a separate database, eg a test + database. The refkey is an indication of the other database. + * magic task numbers with special meanings: magic/allocatable @@ -211,10 +215,11 @@ Flights can be protected (preserved) by allocating them with Flights are represented by restype='share-flight' entries in the resources table. Conventionally, the shareix is the owning taskid. -This allows multiple tasks to lock a single flight. There is no -corresponding entry with restype='flight', nor a resource_sharing -entry. mg-allocate will create and clean up share-flight entries as -needed. +(This is not a constraint, because the convention can be violated by +transfer of ownerships.) This allows multiple tasks to lock a single +flight. There is no corresponding entry with restype='flight', nor a +resource_sharing entry. mg-allocate (and other tools) will create and +clean up share-flight entries as needed. DETAILED PROTOCOL NOTES