From nobody Sat May 18 10:57:14 2024 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=1653636299; cv=none; d=zohomail.com; s=zohoarc; b=cQagJyGK4unpQKnZxht07ERFmKsmnSCzNCw/cEIYRmuaEBHkhaGj0Jl0qrPjR7zmiUiLzV4pd2o+G95a87QNde1S3NuI/6OpgFw/2OtDTm6LfFIZrZAB+bBzAbpuSaubFA/haO6I0v7eIw2g6AWCSJ3ItINIUc7Jcy4NoixQkOc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1653636299; 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=k6QNfdHoQpClTtcFyNorgKp8JNEjHOV3+KrUm17Tu6g=; b=CMXhy86MfD/gIUxdKsDnAklCufRGzf2A6TfiDJ+bizhNtlQxWjlBrNUsYBXg7BKS6QO3/VlEcJMGC64trrfb7hESfKjOJVoz3lpVuFCa9ASRAyx43rUGtdzQ/kc1xOoCfnTjD9VNtILe3ATGvXrR6LKc/XcyuY5GRT6sYo1ja1s= 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 1653636299120784.3866253238273; Fri, 27 May 2022 00:24:59 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.337814.562524 (Exim 4.92) (envelope-from ) id 1nuUKo-0003pR-Rk; Fri, 27 May 2022 07:24:34 +0000 Received: by outflank-mailman (output) from mailman id 337814.562524; Fri, 27 May 2022 07:24:34 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1nuUKo-0003nC-JM; Fri, 27 May 2022 07:24:34 +0000 Received: by outflank-mailman (input) for mailman id 337814; Fri, 27 May 2022 07:24:33 +0000 Received: from se1-gles-sth1-in.inumbo.com ([159.253.27.254] helo=se1-gles-sth1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1nuUKn-0003UV-TP for xen-devel@lists.xenproject.org; Fri, 27 May 2022 07:24:33 +0000 Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id 0c4e4fb1-dd8e-11ec-bd2c-47488cf2e6aa; Fri, 27 May 2022 09:24:30 +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 216D721A82; Fri, 27 May 2022 07:24:30 +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 DD257139C4; Fri, 27 May 2022 07:24:29 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id ONqkNK18kGJLIgAAMHmgww (envelope-from ); Fri, 27 May 2022 07:24:29 +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: 0c4e4fb1-dd8e-11ec-bd2c-47488cf2e6aa DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1653636270; 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=k6QNfdHoQpClTtcFyNorgKp8JNEjHOV3+KrUm17Tu6g=; b=D9GSqwx0VyC/4JZtvww3XF3dFTWmEL6cxsGI9xzMNMYJ0t2qpehEw9/csEaWr7S/ow79XU NGGsgFWUlz/CQyQlZZqQj99aH9vKSkcqtYgnnTmNTrWSwshJScV8ZDCYugq/Abt9EuIcBr rf56Sb2c4Jm/jP9Xe/uuCL06NVJ8Kmk= 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 v2 1/4] tools/xenstore: modify feature bit specification in xenstore-ring.txt Date: Fri, 27 May 2022 09:24:24 +0200 Message-Id: <20220527072427.20327-2-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220527072427.20327-1-jgross@suse.com> References: <20220527072427.20327-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1653636299953100001 Content-Type: text/plain; charset="utf-8" Instead of specifying the feature bits in xenstore-ring.txt as a mask value use bit numbers. This will make the specification easier to read when adding more features. Signed-off-by: Juergen Gross Reviewed-by: Julien Grall --- V2: - new patch (triggered by Julien Grall) --- docs/misc/xenstore-ring.txt | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/misc/xenstore-ring.txt b/docs/misc/xenstore-ring.txt index f3d6ca4264..2792d13530 100644 --- a/docs/misc/xenstore-ring.txt +++ b/docs/misc/xenstore-ring.txt @@ -62,12 +62,13 @@ the server feature bitmap. The server features are offe= red to the guest; it is up to the guest whether to use them or not. The guest should ignore any unknown feature bits. =20 -The following features are defined: +The following features are defined (bit number 0 is equivalent to a mask +value of 1): =20 -Mask Description +Bit Description ----------------------------------------------------------------- -1 Ring reconnection (see the ring reconnection feature below) -2 Connection error indicator (see connection error feature below) +0 Ring reconnection (see the ring reconnection feature below) +1 Connection error indicator (see connection error feature below) =20 The "Connection state" field is used to request a ring close and reconnect. The "Connection state" field only contains valid data if the server has --=20 2.35.3 From nobody Sat May 18 10:57:14 2024 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=1653636299; cv=none; d=zohomail.com; s=zohoarc; b=S5h29btM1w3hSyeMyaS+44vi9nPmsMxYqNZ0ZXIJkeiT3iyGrvLZvq7akwpBNbaU4EU5qZKU4sc73yCQ89y0Pns+4mRjXLRXN9jWOB6d7n/E639KrFMLaMSl3YL1oc6HihKU6lZvkr9pIVxgb1yNNDlRYX2PYA9TqFB09ikScPI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1653636299; 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=E6zy0H1QLcikhT3nJW6R/zDsHVZ2kOQtMcpCnXKd1Ms=; b=VCCxOqFOwNTRaS8RJK5ltEijirOYbIK/VNwNy+A2HDsleBfITPs5L9HCtkNOJq+4VDFn3NxcYt3vgA1wIwWXvrDnagFLM5NACoyfE2q0BwSiCLCz3T4VODFrq2mNsTQzrW9oFKml4mmtdkevaRXzQa/YSjZxPNs16A/I6fzV7BI= 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 1653636299815998.4331501346782; Fri, 27 May 2022 00:24:59 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.337812.562508 (Exim 4.92) (envelope-from ) id 1nuUKn-0003Xx-S0; Fri, 27 May 2022 07:24:33 +0000 Received: by outflank-mailman (output) from mailman id 337812.562508; Fri, 27 May 2022 07:24:33 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1nuUKn-0003XC-Oh; Fri, 27 May 2022 07:24:33 +0000 Received: by outflank-mailman (input) for mailman id 337812; Fri, 27 May 2022 07:24:32 +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 1nuUKm-0003UW-HH for xen-devel@lists.xenproject.org; Fri, 27 May 2022 07:24:32 +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 0c6e98e2-dd8e-11ec-837f-e5687231ffcc; Fri, 27 May 2022 09:24:30 +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 6019B21A85; Fri, 27 May 2022 07:24:30 +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 28F57139C4; Fri, 27 May 2022 07:24:30 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id 8IatCK58kGJLIgAAMHmgww (envelope-from ); Fri, 27 May 2022 07:24:30 +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: 0c6e98e2-dd8e-11ec-837f-e5687231ffcc DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1653636270; 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=E6zy0H1QLcikhT3nJW6R/zDsHVZ2kOQtMcpCnXKd1Ms=; b=DrsrayzqmPCppEAAobwVZV/l/JkmprzER9r2PN4rky3JrC2ejxKrJ0sY1fusvlWsT3Hftt Z6oRaJbTi+Ty8LS56YoEWxxArV3oHuaz0rgkSHOc1jhhN+S/MG7cZyBKH5patYd/DiRLvI EaMLzXA33J9w/IB1ca8ourPK3L4Q2ro= 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 v2 2/4] tools/xenstore: add documentation for new set/get-feature commands Date: Fri, 27 May 2022 09:24:25 +0200 Message-Id: <20220527072427.20327-3-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220527072427.20327-1-jgross@suse.com> References: <20220527072427.20327-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1653636302039100007 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 --- Do we need support in the migration protocol for the features? V2: - remove feature bit (Julien Grall) - GET_FEATURE without domid will return Xenstore supported features (triggered by Julien Grall) --- docs/misc/xenstore.txt | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index a3d3da0a5b..00f6969202 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -331,6 +331,20 @@ 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 located at + 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. + + xenstored prevents the use of GET_FEATURE and SET_FEATURE other + than by dom0. + ---------- Miscellaneous ---------- =20 CONTROL |[|] --=20 2.35.3 From nobody Sat May 18 10:57:14 2024 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=1653636299; cv=none; d=zohomail.com; s=zohoarc; b=n3Udfx9kPVs7Wu5KyL9mzKyeXXeo2+JJ2AFezb7M3Ilw1k1g5duGiHEPn4PgC3PRKemVLlTW0oRu54z2Le3RkKZPQCuVQ8lrZtIuhRHrTJLM4YewBj4Xu6f76kCIJE/Pa57hFxKxTVQ8MhkBpl9fqs+l5JPzLMYmESLMgkRUrWY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1653636299; 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=LXfNj/iGT8On9btajkRJiSegeiqr4EifmedQT5zKgB8=; b=UDo6y/ND2E25ABRZdCTx7dC833EBjqs82U0Nu5q9HtHEWft3prbOfzfk2hVVtIiQmvNSA+D5RFL5KckWQXbW22p+nmod7/twEHj1z4xa3VDZ05vel3Ge2rnFEM+2lsbHz5muDoAv5bIaj8myX9qlBcydS3nZksx+TUV/4ZyzK+Y= 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 1653636299782981.1178923190079; Fri, 27 May 2022 00:24:59 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.337813.562515 (Exim 4.92) (envelope-from ) id 1nuUKo-0003fA-Bd; Fri, 27 May 2022 07:24:34 +0000 Received: by outflank-mailman (output) from mailman id 337813.562515; Fri, 27 May 2022 07:24:34 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1nuUKo-0003do-5l; Fri, 27 May 2022 07:24:34 +0000 Received: by outflank-mailman (input) for mailman id 337813; Fri, 27 May 2022 07:24:32 +0000 Received: from se1-gles-sth1-in.inumbo.com ([159.253.27.254] helo=se1-gles-sth1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1nuUKm-0003UV-T7 for xen-devel@lists.xenproject.org; Fri, 27 May 2022 07:24:32 +0000 Received: from smtp-out2.suse.de (smtp-out2.suse.de [195.135.220.29]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id 0c920126-dd8e-11ec-bd2c-47488cf2e6aa; Fri, 27 May 2022 09:24:31 +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-out2.suse.de (Postfix) with ESMTPS id 9EC531F937; Fri, 27 May 2022 07:24:30 +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 66C4B139C4; Fri, 27 May 2022 07:24:30 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id YETfF658kGJLIgAAMHmgww (envelope-from ); Fri, 27 May 2022 07:24:30 +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: 0c920126-dd8e-11ec-bd2c-47488cf2e6aa DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1653636270; 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=LXfNj/iGT8On9btajkRJiSegeiqr4EifmedQT5zKgB8=; b=MRnjpdNTuiaij2HtIBz/4giFm4JwphAzSH2SPbn7zst2jXfoBve17Sd9qyvqpmoBq7FtSs lF/sak4APgN9ydnGx9ixg3D4mEOxpHhZ/hWW2ChlzDqrWGw/2uDB4A60UWTd3PZhSWU9bm K6XTSfDxuvvFrxvrQI76f+IKohN+lEs= 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 v2 3/4] tools/xenstore: add documentation for new set/get-quota commands Date: Fri, 27 May 2022 09:24:26 +0200 Message-Id: <20220527072427.20327-4-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220527072427.20327-1-jgross@suse.com> References: <20220527072427.20327-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1653636301825100005 Content-Type: text/plain; charset="utf-8" Add documentation for two new Xenstore wire commands SET_QUOTA and GET_QUOTA used to set or query the global Xenstore quota or those of a given domain. Signed-off-by: Juergen Gross Reviewed-by: Julien Grall --- Note that it might be a good idea to add support to the Xenstore migration protocol to transfer quota data (global and/or per domain). V2: - remove feature bit (Julien Grall) - add possibility to access global quota and to query supported quotas --- docs/misc/xenstore.txt | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 00f6969202..49b05e3c9a 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -345,6 +345,23 @@ SET_FEATURE || xenstored prevents the use of GET_FEATURE and SET_FEATURE other than by dom0. =20 +GET_QUOTA [[|]|] | +SET_QUOTA [|]|| + Returns or sets a quota value for the domain being specified by + . Omitting will return or set the global quota + values, which are the default values for new domains. is + one of "nodes", "watches", "transactions", "node-size", + "permissions", or any other implementation defined value. For + GET_QUOTA it is possible to omit the parameter together + with the parameter, which will return a single string of + all supported values separated by blanks. is a + decimal number specifying the quota value, with "0" having the + special meaning of quota checks being disabled. The initial quota + settings for a domain are the global ones of Xenstore. + + xenstored prevents the use of GET_QUOTA and SET_QUOTA other + than by dom0. + ---------- Miscellaneous ---------- =20 CONTROL |[|] --=20 2.35.3 From nobody Sat May 18 10:57:14 2024 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=1653636299; cv=none; d=zohomail.com; s=zohoarc; b=iU8oCzM4SXkH1UaVFIqJaxt9Xpe3LGjJyQPZmf7fo6SSe5kb60Dcbju0E1bBdGKdeBJ7DRTUPfC9IuPllEu+NTetP3REG4U5XJCoHHuBue4LES2pznYQ5WepMR1GDg2Bot7vZ7imHe192MrErYjRGI2CNsOTTttfDt7ysM/OgYw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1653636299; 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=E+SUmV11tds+ppSwEyJnfHL4XIHvPoscWfM4Hj0mYrg=; b=Ccllb9hJ1oToQ/B1U03TrSml7Dje7MYsYeLXRlb79V8RN9f+oY6cZWfWGQXXNPtJb/RXL0yf4SjrJf/IEV3zC+Fb5GASluHL+8t9RR3kwXmZPjRg9LCnNEbMOs1QzyMCNE9Fi50FRAHD6zQW4oFH09FEnkxpamDE2id8JXqep1M= 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 165363629945359.91632373214668; Fri, 27 May 2022 00:24:59 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.337815.562547 (Exim 4.92) (envelope-from ) id 1nuUKr-0004WG-6d; Fri, 27 May 2022 07:24:37 +0000 Received: by outflank-mailman (output) from mailman id 337815.562547; Fri, 27 May 2022 07:24:37 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1nuUKr-0004W5-14; Fri, 27 May 2022 07:24:37 +0000 Received: by outflank-mailman (input) for mailman id 337815; Fri, 27 May 2022 07:24:35 +0000 Received: from se1-gles-sth1-in.inumbo.com ([159.253.27.254] helo=se1-gles-sth1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1nuUKo-0003UV-Tk for xen-devel@lists.xenproject.org; Fri, 27 May 2022 07:24:35 +0000 Received: from smtp-out2.suse.de (smtp-out2.suse.de [195.135.220.29]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id 0cb93622-dd8e-11ec-bd2c-47488cf2e6aa; Fri, 27 May 2022 09:24:31 +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-out2.suse.de (Postfix) with ESMTPS id DD5501F945; Fri, 27 May 2022 07:24:30 +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 A53CD139C4; Fri, 27 May 2022 07:24:30 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id sP8tJ658kGJLIgAAMHmgww (envelope-from ); Fri, 27 May 2022 07:24:30 +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: 0cb93622-dd8e-11ec-bd2c-47488cf2e6aa DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1653636270; 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=E+SUmV11tds+ppSwEyJnfHL4XIHvPoscWfM4Hj0mYrg=; b=i+mJb0wqBZEFW+3y5/4of/g4Mt0FA2xAv7LPJOuWePAK7Nv+7XbpUex2kYg2hhafQx4TmF ec0x7Uo9pLTc2dXI4wWDzUTQAXctdEBhRB1jH+l/KRWYMgYcMhFubaI2Tvioa2N+Sf8lP3 /tlz3TCMG+ARSeYtBJ8pRVWvpjPRFZI= 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 v2 4/4] tools/xenstore: add documentation for extended watch command Date: Fri, 27 May 2022 09:24:27 +0200 Message-Id: <20220527072427.20327-5-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220527072427.20327-1-jgross@suse.com> References: <20220527072427.20327-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1653636300133100003 Content-Type: text/plain; charset="utf-8" Add documentation for an extension of the WATCH command used to limit the scope of watched paths. Additionally it enables to receive more information in the events related to special watches (@introduceDomain or @releaseDomain). Signed-off-by: Juergen Gross Reviewed-by: Julien Grall --- This will probably need an extension of the Xenstore migration protocol, too. --- docs/misc/xenstore-ring.txt | 1 + docs/misc/xenstore.txt | 16 +++++++++++++--- 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/docs/misc/xenstore-ring.txt b/docs/misc/xenstore-ring.txt index 2792d13530..dbc7335e24 100644 --- a/docs/misc/xenstore-ring.txt +++ b/docs/misc/xenstore-ring.txt @@ -69,6 +69,7 @@ Bit Description ----------------------------------------------------------------- 0 Ring reconnection (see the ring reconnection feature below) 1 Connection error indicator (see connection error feature below) +2 WATCH can take a third parameter limiting its scope =20 The "Connection state" field is used to request a ring close and reconnect. The "Connection state" field only contains valid data if the server has diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 49b05e3c9a..e2daf2eef8 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -187,7 +187,7 @@ SET_PERMS ||+? =20 ---------- Watches ---------- =20 -WATCH ||? +WATCH ||[|]? Adds a watch. =20 When a is modified (including path creation, removal, @@ -198,7 +198,11 @@ WATCH ||? matching watch results in a WATCH_EVENT message (see below). =20 The event's path matches the watch's if it is an child - of . + of . This match can be limited by specifying (a + decimal value of 0 or larger): it denotes the directory levels + below to consider for a match ("0" would not match for + a child of , "1" would match only for a direct child, + etc.). =20 can be a to watch or @. In the latter case may have any syntax but it matches @@ -209,7 +213,13 @@ WATCH ||? shutdown, and also on RELEASE and domain destruction events are sent to privileged callers or explicitly - via SET_PERMS enabled domains only. + via SET_PERMS enabled domains only. The semantics for a + specification of differ for generating + events: specifying "1" will report the related domid by using + @/ for the reported path. Other + values are not supported. + For @releaseDomain it is possible to watch only for a specific + domain by specifying @releaseDomain/ for the path. =20 When a watch is first set up it is triggered once straight away, with equal to . Watches may be triggered --=20 2.35.3