From patchwork Fri Dec 13 16:39:44 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paul Durrant X-Patchwork-Id: 11291173 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 9324714BD for ; Fri, 13 Dec 2019 21:01:22 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 642DD24682 for ; Fri, 13 Dec 2019 21:01:22 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=amazon.com header.i=@amazon.com header.b="LlFbUEoI" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 642DD24682 Authentication-Results: mail.kernel.org; dmarc=fail (p=quarantine dis=none) header.from=amazon.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1ifnyr-0002xm-Eo; Fri, 13 Dec 2019 16:39:53 +0000 Received: from all-amaz-eas1.inumbo.com ([34.197.232.57] helo=us1-amaz-eas2.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1ifnyp-0002xg-Sa for xen-devel@lists.xenproject.org; Fri, 13 Dec 2019 16:39:51 +0000 X-Inumbo-ID: 2f2c20f4-1dc7-11ea-8f83-12813bfff9fa Received: from smtp-fw-4101.amazon.com (unknown [72.21.198.25]) by us1-amaz-eas2.inumbo.com (Halon) with ESMTPS id 2f2c20f4-1dc7-11ea-8f83-12813bfff9fa; Fri, 13 Dec 2019 16:39:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amazon.com; i=@amazon.com; q=dns/txt; s=amazon201209; t=1576255192; x=1607791192; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=l5UveEjdT/QO2j8m/QO/WpdM9MmyJurDN25ZblnVW8A=; b=LlFbUEoIhmXs9JacCFEVKWfOLPEVORbu2rFz8BnkUFfhZowyb0Sf/TeE A/UnIlmAkky1syBoh5pbJfTrHo7Ly+3NvsdZ1iYoBkmgop0X7IRgW9kJA 2UVMKrglyE3JHmw0yXWchNPY2xiAV6SGta5hPjcEmoom/qCTeRg/51Wvi s=; IronPort-SDR: Gf97QlvgSqg3Ymr3w/YnkwuPnORNMJ9LJ6q+XCL1JyTgWLg+pUEDju7yYTo7iaRTpDa++p/zmv w43WIupMK9Gg== X-IronPort-AV: E=Sophos;i="5.69,309,1571702400"; d="scan'208";a="8388489" Received: from iad6-co-svc-p1-lb1-vlan3.amazon.com (HELO email-inbound-relay-2a-22cc717f.us-west-2.amazon.com) ([10.124.125.6]) by smtp-border-fw-out-4101.iad4.amazon.com with ESMTP; 13 Dec 2019 16:39:51 +0000 Received: from EX13MTAUEA001.ant.amazon.com (pdx4-ws-svc-p6-lb7-vlan3.pdx.amazon.com [10.170.41.166]) by email-inbound-relay-2a-22cc717f.us-west-2.amazon.com (Postfix) with ESMTPS id AAC59A1812; Fri, 13 Dec 2019 16:39:49 +0000 (UTC) Received: from EX13D32EUC002.ant.amazon.com (10.43.164.94) by EX13MTAUEA001.ant.amazon.com (10.43.61.243) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Fri, 13 Dec 2019 16:39:48 +0000 Received: from EX13MTAUEA001.ant.amazon.com (10.43.61.82) by EX13D32EUC002.ant.amazon.com (10.43.164.94) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Fri, 13 Dec 2019 16:39:48 +0000 Received: from u2f063a87eabd5f.cbg10.amazon.com (10.125.106.135) by mail-relay.amazon.com (10.43.61.243) with Microsoft SMTP Server id 15.0.1367.3 via Frontend Transport; Fri, 13 Dec 2019 16:39:46 +0000 From: Paul Durrant To: Date: Fri, 13 Dec 2019 16:39:44 +0000 Message-ID: <20191213163944.32241-1-pdurrant@amazon.com> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Precedence: Bulk Subject: [Xen-devel] [PATCH v3] public/io/netif.h: document a mechanism to advertise carrier state X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.23 List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Juergen Gross , Paul Durrant , Konrad Rzeszutek Wilk Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" This patch adds a specification for a 'carrier' node in xenstore to allow a backend to notify a frontend of it's virtual carrier/link state. E.g. a backend that is unable to forward packets from the guest because it is not attached to a bridge may wish to advertise 'no carrier'. While in the area also fix an erroneous backend path description. NOTE: This is purely a documentation patch. No functional change. Signed-off-by: Paul Durrant Reviewed-by: Juergen Gross --- Cc: Konrad Rzeszutek Wilk v3: - Fix another typo v2: - Fix text - Fix path --- xen/include/public/io/netif.h | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/xen/include/public/io/netif.h b/xen/include/public/io/netif.h index 2454448baa..9fcf91a2fe 100644 --- a/xen/include/public/io/netif.h +++ b/xen/include/public/io/netif.h @@ -171,7 +171,7 @@ * The ability of the backend to use a control ring is advertised by * setting: * - * /local/domain/X/backend///feature-ctrl-ring = "1" + * /local/domain/X/backend/vif///feature-ctrl-ring = "1" * * The frontend provides a control ring to the backend by setting: * @@ -190,6 +190,20 @@ * order as requests. */ +/* + * Link state + * ========== + * + * The backend can advertise its current link (carrier) state to the + * frontend using the /local/domain/X/backend/vif///carrier + * node. If this node is not present, then the frontend should assume that + * the link is up (for compatibility with backends that do not implement + * this feature). If this node is present, then a value of "0" should be + * interpreted by the frontend as the link being down (no carrier) and a + * value of "1" should be interpreted as the link being up (carrier + * present). + */ + /* * Hash types * ==========