From patchwork Mon Jan 27 15:19:07 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paul Durrant X-Patchwork-Id: 11352833 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id AF5A592A for ; Mon, 27 Jan 2020 15:20:26 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 8B15120674 for ; Mon, 27 Jan 2020 15:20:26 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=amazon.com header.i=@amazon.com header.b="Sb/UOQEe" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 8B15120674 Authentication-Results: mail.kernel.org; dmarc=fail (p=quarantine dis=none) header.from=amazon.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1iw6AZ-0007kH-NZ; Mon, 27 Jan 2020 15:19:19 +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 1iw6AY-0007kC-0J for xen-devel@lists.xenproject.org; Mon, 27 Jan 2020 15:19:18 +0000 X-Inumbo-ID: 627a2cfc-4118-11ea-8561-12813bfff9fa Received: from smtp-fw-2101.amazon.com (unknown [72.21.196.25]) by us1-amaz-eas2.inumbo.com (Halon) with ESMTPS id 627a2cfc-4118-11ea-8561-12813bfff9fa; Mon, 27 Jan 2020 15:19:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amazon.com; i=@amazon.com; q=dns/txt; s=amazon201209; t=1580138358; x=1611674358; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=MOhQDbXASYZVhYqAAJHvyv+pHEkUOIPVcwG9VrumpU4=; b=Sb/UOQEexC7M0GHGBB6fYQb6FvAIHGbLsjj0Nv/IGk/9cFSCP+f/HjIu wBNIbbEQtraUKSV1gPIX9qcPMAGR8PBq5VivD/8e2GOiCyriGrrqD9w3a +2TqT9Pi21FGmnMgxbUmDjj/7OnKJ/INeIEF+s/FH1E2obCzNMPiyawp6 Y=; IronPort-SDR: xuWLrBPwqiX/fHsA+YOA35Dt53ZuLzS2Zg4MLzj9Ba+0oD44Jub5RkysNcGEBcNyzTCPhdq9lB 222By44vFsEQ== X-IronPort-AV: E=Sophos;i="5.70,370,1574121600"; d="scan'208";a="14397635" Received: from iad12-co-svc-p1-lb1-vlan2.amazon.com (HELO email-inbound-relay-1a-16acd5e0.us-east-1.amazon.com) ([10.43.8.2]) by smtp-border-fw-out-2101.iad2.amazon.com with ESMTP; 27 Jan 2020 15:19:17 +0000 Received: from EX13MTAUEA002.ant.amazon.com (iad55-ws-svc-p15-lb9-vlan2.iad.amazon.com [10.40.159.162]) by email-inbound-relay-1a-16acd5e0.us-east-1.amazon.com (Postfix) with ESMTPS id 1DFD3A2436; Mon, 27 Jan 2020 15:19:13 +0000 (UTC) Received: from EX13D32EUC002.ant.amazon.com (10.43.164.94) by EX13MTAUEA002.ant.amazon.com (10.43.61.77) with Microsoft SMTP Server (TLS) id 15.0.1236.3; Mon, 27 Jan 2020 15:19:12 +0000 Received: from EX13MTAUEE002.ant.amazon.com (10.43.62.24) by EX13D32EUC002.ant.amazon.com (10.43.164.94) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Mon, 27 Jan 2020 15:19:11 +0000 Received: from u2f063a87eabd5f.cbg10.amazon.com (10.125.106.135) by mail-relay.amazon.com (10.43.62.224) with Microsoft SMTP Server id 15.0.1367.3 via Frontend Transport; Mon, 27 Jan 2020 15:19:09 +0000 From: Paul Durrant To: Date: Mon, 27 Jan 2020 15:19:07 +0000 Message-ID: <20200127151907.2877-1-pdurrant@amazon.com> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Precedence: Bulk Subject: [Xen-devel] [PATCH] docs: retrospectively add XS_DIRECTORY_PART to the xenstore protocol... X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.23 List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Juergen Gross , Stefano Stabellini , Julien Grall , Wei Liu , Konrad Rzeszutek Wilk , George Dunlap , Andrew Cooper , Paul Durrant , Ian Jackson Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" ... specification. This was added by commit 0ca64ed8 "xenstore: add support for reading directory with many children" but not added to the specification at that point. A version of xenstored supporting the command was first released in Xen 4.9. Signed-off-by: Paul Durrant Acked-by: Ian Jackson --- Cc: Juergen Gross Cc: Andrew Cooper Cc: George Dunlap Cc: Ian Jackson Cc: Jan Beulich Cc: Julien Grall Cc: Konrad Rzeszutek Wilk Cc: Stefano Stabellini Cc: Wei Liu --- docs/misc/xenstore.txt | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index ae1b6a8c6e..bf42e9ec37 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -125,8 +125,9 @@ Values commonly included in payloads include: -The following are the actual type values, including the request and -reply payloads as applicable: +The following are the actual type values defined in io/xs_wire.h +(omitting the XS_ prefix), including the request and reply payloads +as applicable: ---------- Database read, write and permissions operations ---------- @@ -152,6 +153,14 @@ DIRECTORY | |* leafnames. The resulting children are each named /. +DIRECTORY_PART | |* + Performs the same function as DIRECTORY, but returns a + sub-list of children starting at in the overall + child list and less than or equal to XENSTORE_PAYLOAD_MAX + octets in length. If is beyond the end of the + overall child list then the returned sub-list will be + empty. + GET_PERMS | |+ SET_PERMS ||+? is one of the following