From nobody Fri Apr 3 01:26:46 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=yandex-team.ru ARC-Seal: i=1; a=rsa-sha256; t=1774438659; cv=none; d=zohomail.com; s=zohoarc; b=ZMkg0FYQ6NMzK7obMzOEmlyoBTLGcj0Nts0hmzrtOHSybvqfzs/aci4aaaif07rE07YJiaA6sFyQ4w3NFxBzh9X1spEFkZQGfdeGdIeoP//1cnajDb7fj8THJ5HI7f8ZFWIOpDZA6qsBUYgoDWkd8rT4uZNUAmsG4Za2uV3qzJ8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1774438659; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=15BcKcDlCarfJCvy8M3fRq8OzYznzyQxSbRUOsBx494=; b=HZ34IxtDV1Q/PD1eHGluZuK9HF7onT2RYh4hqOv1nJZhujsUU+uM8CkSXjdIXktjcLwv8FnOaoGSXIP77UJKmsMuC5m2Lh1n+bItuxutS7Qd9PJkGINwul4rGXuoqaBG1nTlwRg4D2wyWsPbVaMDrxXkusi6+cDRf+8ZLDTLQcA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1774438658177282.6919736679905; Wed, 25 Mar 2026 04:37:38 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1w5MXw-0002Iy-CV; Wed, 25 Mar 2026 07:37:14 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1w5MXq-0002Ii-M7 for qemu-devel@nongnu.org; Wed, 25 Mar 2026 07:37:08 -0400 Received: from forwardcorp1d.mail.yandex.net ([2a02:6b8:c41:1300:1:45:d181:df01]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1w5MXo-0003N1-2m for qemu-devel@nongnu.org; Wed, 25 Mar 2026 07:37:06 -0400 Received: from mail-nwsmtp-smtp-corp-main-56.klg.yp-c.yandex.net (mail-nwsmtp-smtp-corp-main-56.klg.yp-c.yandex.net [IPv6:2a02:6b8:c42:65a0:0:640:e1de:0]) by forwardcorp1d.mail.yandex.net (Yandex) with ESMTPS id 0A7D9804D2; Wed, 25 Mar 2026 14:36:59 +0300 (MSK) Received: from d-tatianin-lin.yandex-team.ru (unknown [2a02:6bf:8080:438::1:5]) by mail-nwsmtp-smtp-corp-main-56.klg.yp-c.yandex.net (smtpcorp/Yandex) with ESMTPSA id raSPqZ0AdeA0-cKFHxvsD; Wed, 25 Mar 2026 14:36:58 +0300 Precedence: bulk X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1774438618; bh=15BcKcDlCarfJCvy8M3fRq8OzYznzyQxSbRUOsBx494=; h=Message-Id:Date:Cc:Subject:To:From; b=Bc3Res+hfQ8sLPyMv6/mlcvv3clgnbmVht/zOSLVUrgqkZejAHzHROcPWH/56ZVMs hzKFj3RlnpAw1TJDuK/+Cb8Hj7XcSxp9/2WBI6jVhK6uETqOek52d932Z9bVH4DFoX Fr+xopbeiEIaqtre4iQWyMbU2LNgb2ZkO2zLd+eU= Authentication-Results: mail-nwsmtp-smtp-corp-main-56.klg.yp-c.yandex.net; dkim=pass header.i=@yandex-team.ru From: Daniil Tatianin To: "Michael S. Tsirkin" Cc: Daniil Tatianin , Stefano Garzarella , Pierrick Bouvier , qemu-devel@nongnu.org, yc-core@yandex-team.ru, Vladimir Sementsov-Ogievskiy Subject: [PATCH v1] docs/vhost-user: clarify the semantics of VHOST_USER_SET_VRING_ENABLE Date: Wed, 25 Mar 2026 14:36:44 +0300 Message-Id: <20260325113644.175108-1-d-tatianin@yandex-team.ru> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a02:6b8:c41:1300:1:45:d181:df01; envelope-from=d-tatianin@yandex-team.ru; helo=forwardcorp1d.mail.yandex.net X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 List-Id: qemu development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @yandex-team.ru) X-ZM-MESSAGEID: 1774438663032158500 Content-Type: text/plain; charset="utf-8" Documentation didn't really make it clear that the payload contains any sort of desired state field, you could only derive that by looking at the QEMU implementation of this request. Add an extra note to make that clear. Reviewed-by: Vladimir Sementsov-Ogievskiy Signed-off-by: Daniil Tatianin --- Changes since v0: - Remove 'Note that' (suggested by Vladimir) --- docs/interop/vhost-user.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/interop/vhost-user.rst b/docs/interop/vhost-user.rst index 137c9f3669d..e29eb291f11 100644 --- a/docs/interop/vhost-user.rst +++ b/docs/interop/vhost-user.rst @@ -1346,6 +1346,8 @@ Front-end message types :reply payload: N/A =20 Signal the back-end to enable or disable corresponding vring. + The ``num`` field contains the target vring state where 0 means disabled, + and any other value means enabled. =20 This request should be sent only when ``VHOST_USER_F_PROTOCOL_FEATURES`` has been negotiated. --=20 2.34.1