From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id F20BC103A9A1 for ; Wed, 25 Mar 2026 10:44:40 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1w5LiK-0003I0-Ki; Wed, 25 Mar 2026 06:43:52 -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 1w5LiI-0003HX-HY for qemu-devel@nongnu.org; Wed, 25 Mar 2026 06:43:50 -0400 Received: from forwardcorp1d.mail.yandex.net ([178.154.239.200]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1w5LiG-0002JV-I3 for qemu-devel@nongnu.org; Wed, 25 Mar 2026 06:43:50 -0400 Received: from mail-nwsmtp-smtp-corp-main-68.klg.yp-c.yandex.net (mail-nwsmtp-smtp-corp-main-68.klg.yp-c.yandex.net [IPv6:2a02:6b8:c42:94a9:0:640:a3fa:0]) by forwardcorp1d.mail.yandex.net (Yandex) with ESMTPS id DC605806D8; Wed, 25 Mar 2026 13:43:41 +0300 (MSK) Received: from d-tatianin-lin.yandex-team.ru (unknown [2a02:6bf:8080:438::1:5]) by mail-nwsmtp-smtp-corp-main-68.klg.yp-c.yandex.net (smtpcorp/Yandex) with ESMTPSA id WhRpAd0AVuQ0-f379HOxO; Wed, 25 Mar 2026 13:43:41 +0300 Precedence: bulk X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1774435421; bh=asN1aFegIg/cYVENScSgLOkkAbtIHqO82TGF9uW+GUs=; h=Message-Id:Date:Cc:Subject:To:From; b=TfgwvhTA9tdrge0q/xCJRXgwiyNMYuX5WlwG2C0fXcgDaRGyC+pNPOt3z86vSY3Dy pMzlDPJgT9RD54UyrRknRaDcUC9zP1NYdjBbrHc82+w4CwzXYKN88PRQd5aSJPeIfa KmptmSFEpW2hIMuUghx4SAzaasVF7k6mfJK3D7aI= Authentication-Results: mail-nwsmtp-smtp-corp-main-68.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 Subject: [PATCH] docs/vhost-user: clarify the semantics of VHOST_USER_SET_VRING_ENABLE Date: Wed, 25 Mar 2026 13:43:29 +0300 Message-Id: <20260325104329.154875-1-d-tatianin@yandex-team.ru> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=178.154.239.200; 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, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, 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+qemu-devel=archiver.kernel.org@nongnu.org Sender: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org 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. Signed-off-by: Daniil Tatianin --- 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..79690c73b25 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 Signal the back-end to enable or disable corresponding vring. + Note that the ``num`` field contains the target vring state where 0 means + disabled, and any other value means enabled. This request should be sent only when ``VHOST_USER_F_PROTOCOL_FEATURES`` has been negotiated. -- 2.34.1