From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ian Jackson Subject: [PATCH 20/29] libxl: cancellation: Note that driver domain task cannot be usefully cancelled Date: Tue, 10 Feb 2015 20:10:07 +0000 Message-ID: <1423599016-32639-21-git-send-email-ian.jackson@eu.citrix.com> References: <1423599016-32639-1-git-send-email-ian.jackson@eu.citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: In-Reply-To: <1423599016-32639-1-git-send-email-ian.jackson@eu.citrix.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: xen-devel@lists.xensource.com Cc: Ian Jackson , Euan Harris , Roger Pau Monne List-Id: xen-devel@lists.xenproject.org In practice, cancelling this task will cause all subsequent actual backend operations to fail, but will not actually cause the libxl_device_events_handler operation to complete. Signed-off-by: Ian Jackson CC: Roger Pau Monne --- v2: New in this version of the series. --- tools/libxl/libxl.h | 3 +++ 1 file changed, 3 insertions(+) diff --git a/tools/libxl/libxl.h b/tools/libxl/libxl.h index e8a2a91..08a87aed 100644 --- a/tools/libxl/libxl.h +++ b/tools/libxl/libxl.h @@ -1353,6 +1353,9 @@ libxl_device_pci *libxl_device_pci_list(libxl_ctx *ctx, uint32_t domid, * From a libxl API point of view, this starts a long-running * operation. That operation consists of "being a driver domain" * and never completes. + * + * Attempting to cancel this operation is not advisable; proper + * shutdown of the driver domain task is not supported. */ int libxl_device_events_handler(libxl_ctx *ctx, const libxl_asyncop_how *ao_how) -- 1.7.10.4