From patchwork Fri Dec 13 15:51:45 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paul Durrant X-Patchwork-Id: 11291179 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 0DDF914BD for ; Fri, 13 Dec 2019 21:01:44 +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 D3ED924682 for ; Fri, 13 Dec 2019 21:01:43 +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="jGtc6iBo" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org D3ED924682 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 1ifnER-0005Qn-P5; Fri, 13 Dec 2019 15:51:55 +0000 Received: from us1-rack-iad1.inumbo.com ([172.99.69.81]) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1ifnEQ-0005Qf-GA for xen-devel@lists.xenproject.org; Fri, 13 Dec 2019 15:51:54 +0000 X-Inumbo-ID: 7c1f4cee-1dc0-11ea-88e7-bc764e2007e4 Received: from smtp-fw-2101.amazon.com (unknown [72.21.196.25]) by us1-rack-iad1.inumbo.com (Halon) with ESMTPS id 7c1f4cee-1dc0-11ea-88e7-bc764e2007e4; Fri, 13 Dec 2019 15:51:54 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amazon.com; i=@amazon.com; q=dns/txt; s=amazon201209; t=1576252314; x=1607788314; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=yJcquBl3qgjy9JF7h1fzXlWgWBuPd41njEBIXiYE9VM=; b=jGtc6iBoMzapzuesx/2pZBxXqSDh1Qv5FxoJhCSHI/OSIwOu+WJxr5Nn 8oLSJ2/AxkJK559lps/8NnLZFToIbkGqzMR5iP3MXfCN/msV2JeCyQTUm i8H4aTH7ozHH+9VYF3YgMBWqB1hAxtSmf+WzJh/M3CNNpNyw1lk1+C6pl o=; IronPort-SDR: dk8M0okXTqrvKaOzPYge+IluIhuUw3hcx2YRzLa7k0e51ZbXcmhg8vmkX4Pyt0rdqfow2Qe8rX AnTmi25G4Yyw== X-IronPort-AV: E=Sophos;i="5.69,309,1571702400"; d="scan'208";a="8449933" Received: from iad6-co-svc-p1-lb1-vlan2.amazon.com (HELO email-inbound-relay-1d-37fd6b3d.us-east-1.amazon.com) ([10.124.125.2]) by smtp-border-fw-out-2101.iad2.amazon.com with ESMTP; 13 Dec 2019 15:51:53 +0000 Received: from EX13MTAUEA001.ant.amazon.com (iad55-ws-svc-p15-lb9-vlan2.iad.amazon.com [10.40.159.162]) by email-inbound-relay-1d-37fd6b3d.us-east-1.amazon.com (Postfix) with ESMTPS id 0270A282065; Fri, 13 Dec 2019 15:51:52 +0000 (UTC) Received: from EX13D32EUC001.ant.amazon.com (10.43.164.159) by EX13MTAUEA001.ant.amazon.com (10.43.61.243) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Fri, 13 Dec 2019 15:51:52 +0000 Received: from EX13MTAUEA001.ant.amazon.com (10.43.61.82) by EX13D32EUC001.ant.amazon.com (10.43.164.159) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Fri, 13 Dec 2019 15:51:51 +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 15:51:50 +0000 From: Paul Durrant To: Date: Fri, 13 Dec 2019 15:51:45 +0000 Message-ID: <20191213155145.31945-1-pdurrant@amazon.com> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Precedence: Bulk Subject: [Xen-devel] [PATCH v2] 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 --- Cc: Konrad Rzeszutek Wilk Cc: Juergen Gross 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..52dd2087cd 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 no 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 * ==========