From nobody Tue Feb 10 07:21:31 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=pass(p=quarantine dis=none) header.from=suse.com ARC-Seal: i=1; a=rsa-sha256; t=1659528019; cv=none; d=zohomail.com; s=zohoarc; b=UABOmY8EwLI8Ze+9onvCkQDHh9D4MAgZ+z7TQUbf4zyOVVScLZzcb/nWjwxo9I0BU9oU7KxDlpcDZwHUCBi7ym9dACIZ+2xQ7HJUVHn2cf5SuhCmfUdThURPcSpFRxiDy9vZcSfEn8oN9aFg21Yc5kM0/8LfCYwwRKFQUCTXt4w= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1659528019; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=aEQopuLdWValM7nidZ9WkbS29HDB7GZW9XHtrUpHG2E=; b=N8ugMlj40p5m74XkjuOCI6jqGizL0yOm5iVUD8S8hBUcK2OQlbMYbYRO55Br+tIGDrCEu9lpJjIYTrsk70y9vZzehBwCrdruZl9q2zYs8hMGUkUzrWqbH8E1OSMI09teBUPaT9d40MWSUTfRGfiY8rVTbe2fZFBNeqmgrh+b28E= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1659528019884628.8235667724299; Wed, 3 Aug 2022 05:00:19 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.379829.613646 (Exim 4.92) (envelope-from ) id 1oJD2b-0000js-NK; Wed, 03 Aug 2022 11:59:57 +0000 Received: by outflank-mailman (output) from mailman id 379829.613646; Wed, 03 Aug 2022 11:59:57 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oJD2b-0000jc-GP; Wed, 03 Aug 2022 11:59:57 +0000 Received: by outflank-mailman (input) for mailman id 379829; Wed, 03 Aug 2022 11:59:55 +0000 Received: from se1-gles-flk1-in.inumbo.com ([94.247.172.50] helo=se1-gles-flk1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oJD2Z-00008E-Ct for xen-devel@lists.xenproject.org; Wed, 03 Aug 2022 11:59:55 +0000 Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id c91c58bb-1323-11ed-924f-1f966e50362f; Wed, 03 Aug 2022 13:59:53 +0200 (CEST) Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id A607E3FF38; Wed, 3 Aug 2022 11:59:53 +0000 (UTC) Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap2.suse-dmz.suse.de (Postfix) with ESMTPS id 6B60313AD8; Wed, 3 Aug 2022 11:59:53 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id cJn7GDlj6mKNUgAAMHmgww (envelope-from ); Wed, 03 Aug 2022 11:59:53 +0000 X-Outflank-Mailman: Message body and most headers restored to incoming version X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" X-Inumbo-ID: c91c58bb-1323-11ed-924f-1f966e50362f DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1659527993; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=aEQopuLdWValM7nidZ9WkbS29HDB7GZW9XHtrUpHG2E=; b=ZzORzULIhMATytSzjLQiP1BXdg5NirLRZS4Ep079EugR2FMuCKeYWVJFlHt01FEU0IMNnu FvY+a9VmZ3+9PmLxySSNSw3qJBC0mAMb3ppeoGn7PMvRslEAXAJT6uLCrK4OPshmRaUXBv RkY6l0pTLAketVLSucjmDFgiz6jwRFM= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Juergen Gross , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Stefano Stabellini , Wei Liu Subject: [PATCH v3 2/5] tools/xenstore: add documentation for new set/get-feature commands Date: Wed, 3 Aug 2022 13:59:47 +0200 Message-Id: <20220803115950.10904-3-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220803115950.10904-1-jgross@suse.com> References: <20220803115950.10904-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1659528021335100001 Content-Type: text/plain; charset="utf-8" Add documentation for two new Xenstore wire commands SET_FEATURE and GET_FEATURE used to set or query the Xenstore features visible in the ring page of a given domain. Signed-off-by: Juergen Gross Reviewed-by: Julien Grall --- V2: - remove feature bit (Julien Grall) - GET_FEATURE without domid will return Xenstore supported features (triggered by Julien Grall) V3: - clarify that guest only sees a copy of features (Julien Grall) - add remark that SET_FEATURE will be rejected after INTRODUCE of a domain (Julien Grall) --- docs/misc/xenstore.txt | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index a3d3da0a5b..9134cb7947 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -331,6 +331,23 @@ SET_TARGET || =20 xenstored prevents the use of SET_TARGET other than by dom0. =20 +GET_FEATURE [|] | +SET_FEATURE || + Returns or sets the contents of the "feature" field copied to + offset 2064 of the Xenstore ring page of the domain specified by + . is a decimal number being a logical or of the + feature bits as defined in docs/misc/xenstore-ring.txt. Trying + to set a bit for a feature not being supported by the running + Xenstore will be denied. Providing no with the + GET_FEATURE command will return the features which are supported + by Xenstore. + + SET_FEATURE for a domain will be rejected after the INTRODUCE + command for this domain has been sent to xenstored. + + xenstored prevents the use of GET_FEATURE and SET_FEATURE other + than by dom0. + ---------- Miscellaneous ---------- =20 CONTROL |[|] --=20 2.35.3