From nobody Thu Nov 13 14:54:34 2025 Delivered-To: importer@patchew.org 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; Authentication-Results: mx.zohomail.com; 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=fail(p=none dis=none) header.from=intel.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1581434728803782.063611462217; Tue, 11 Feb 2020 07:25:28 -0800 (PST) Received: from localhost ([::1]:51390 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j1XPj-0006CY-7o for importer@patchew.org; Tue, 11 Feb 2020 10:25:27 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:37447) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j1XOk-0005Zf-NG for qemu-devel@nongnu.org; Tue, 11 Feb 2020 10:24:27 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j1XOi-0005Xz-Jf for qemu-devel@nongnu.org; Tue, 11 Feb 2020 10:24:25 -0500 Received: from mga09.intel.com ([134.134.136.24]:10472) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1j1XOi-0005Vp-By for qemu-devel@nongnu.org; Tue, 11 Feb 2020 10:24:24 -0500 Received: from orsmga005.jf.intel.com ([10.7.209.41]) by orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 11 Feb 2020 07:24:18 -0800 Received: from orsmsx105.amr.corp.intel.com ([10.22.225.132]) by orsmga005.jf.intel.com with ESMTP; 11 Feb 2020 07:24:18 -0800 Received: from orsmsx115.amr.corp.intel.com ([169.254.4.100]) by ORSMSX105.amr.corp.intel.com ([169.254.2.101]) with mapi id 14.03.0439.000; Tue, 11 Feb 2020 07:24:18 -0800 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.70,428,1574150400"; d="scan'208,223";a="405967096" From: "Boeuf, Sebastien" To: "qemu-devel@nongnu.org" Subject: docs: Update vhost-user spec regarding backend program conventions Thread-Topic: docs: Update vhost-user spec regarding backend program conventions Thread-Index: AQHV4O9TY4yCVz7xVU+TIDtOwGOnlA== Date: Tue, 11 Feb 2020 15:24:18 +0000 Message-ID: <15a5fbc76266fb51b365e66872c105b9e2832999.camel@intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [10.252.25.164] Content-Type: text/plain; charset="utf-8" Content-ID: <7A1FEFBA75A0AA4A9CC2EE183A3E03E4@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 134.134.136.24 X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: "marcandre.lureau@redhat.com" , "stefanha@redhat.com" , "mst@redhat.com" Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" From c073d528b8cd7082832fd1825dc33dd65b305aa2 Mon Sep 17 00:00:00 2001 From: Sebastien Boeuf Date: Tue, 11 Feb 2020 16:01:22 +0100 Subject: [PATCH] docs: Update vhost-user spec regarding backend program conventions The vhost-user specification is not clearly stating the expected behavior from a backend program whenever the client disconnects. This patch addresses the issue by defining the default behavior and proposing an alternative through a command line option. By default, a backend program will have to keep listening even if the client disconnects, unless told otherwise through the newly introduced option --exit-on-disconnect. Signed-off-by: Sebastien Boeuf Signed-off-by: Stefan Hajnoczi --- docs/interop/vhost-user.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/interop/vhost-user.rst b/docs/interop/vhost-user.rst index 5f8b3a456b..da9a1ebc4c 100644 --- a/docs/interop/vhost-user.rst +++ b/docs/interop/vhost-user.rst @@ -1323,6 +1323,10 @@ The backend program must end (as quickly and cleanly= as possible) when the SIGTERM signal is received. Eventually, it may receive SIGKILL by the management layer after a few seconds. =20 +By default, the backend program continues running after the client +disconnects. It accepts only 1 connection at a time on each UNIX domain +socket. + The following command line options have an expected behaviour. They are mandatory, unless explicitly said differently: =20 @@ -1337,6 +1341,12 @@ are mandatory, unless explicitly said differently: vhost-user socket as file descriptor FDNUM. It is incompatible with --socket-path. =20 +--exit-on-disconnect + + When this option is provided, the backend program must terminate when + the client disconnects. This can be used to keep the backend program's + lifetime synchronized with its client process. + --print-capabilities =20 Output to stdout the backend capabilities in JSON format, and then --=20 2.20.1 --------------------------------------------------------------------- Intel Corporation SAS (French simplified joint stock company) Registered headquarters: "Les Montalets"- 2, rue de Paris,=20 92196 Meudon Cedex, France Registration Number: 302 456 199 R.C.S. NANTERRE Capital: 4,572,000 Euros This e-mail and any attachments may contain confidential material for the sole use of the intended recipient(s). Any review or distribution by others is strictly prohibited. If you are not the intended recipient, please contact the sender and delete all copies.