From patchwork Fri Dec 13 13:03:16 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paul Durrant X-Patchwork-Id: 11291193 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 1364C14BD for ; Fri, 13 Dec 2019 21:02:06 +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 D8DE32465E for ; Fri, 13 Dec 2019 21:02:05 +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="GIFLWJDG" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org D8DE32465E 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 1ifkbW-0003j3-Sp; Fri, 13 Dec 2019 13:03:34 +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 1ifkbV-0003id-I8 for xen-devel@lists.xenproject.org; Fri, 13 Dec 2019 13:03:33 +0000 X-Inumbo-ID: f6d9177a-1da8-11ea-8ef8-12813bfff9fa Received: from smtp-fw-33001.amazon.com (unknown [207.171.190.10]) by us1-amaz-eas2.inumbo.com (Halon) with ESMTPS id f6d9177a-1da8-11ea-8ef8-12813bfff9fa; Fri, 13 Dec 2019 13:03:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amazon.com; i=@amazon.com; q=dns/txt; s=amazon201209; t=1576242212; x=1607778212; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=pXLbiQW3h6ArNxyatTC+5TwvfA8RAqWrCGd/qqWBmfk=; b=GIFLWJDGbFncLn/550kP/N6gDwUG6BOIubGssuhZf2qOI98ihUd3nZmm jqeebrOKJs8e30TMa3TR/Ej/KNSim8oGb+udEkDuJzh/X9RTekeS+jlmr cLuKZUTbfi2VX6ghc423Xd0EQmmWrY9jh7bGnYHHiLazhXg14JqqOn3OO o=; IronPort-SDR: K2B1AS/kOJlev6nR+rMTZjXFcWTI4HUoOOnIF7mSo90Qm/tPLQWwziwavQjHSNpyzHh9/yiPuo B3Ggt227p/DA== X-IronPort-AV: E=Sophos;i="5.69,309,1571702400"; d="scan'208";a="14715938" Received: from sea32-co-svc-lb4-vlan3.sea.corp.amazon.com (HELO email-inbound-relay-2b-859fe132.us-west-2.amazon.com) ([10.47.23.38]) by smtp-border-fw-out-33001.sea14.amazon.com with ESMTP; 13 Dec 2019 13:03:21 +0000 Received: from EX13MTAUEA001.ant.amazon.com (pdx4-ws-svc-p6-lb7-vlan2.pdx.amazon.com [10.170.41.162]) by email-inbound-relay-2b-859fe132.us-west-2.amazon.com (Postfix) with ESMTPS id 3120E2229C8; Fri, 13 Dec 2019 13:03:21 +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 13:03:20 +0000 Received: from EX13MTAUEE001.ant.amazon.com (10.43.62.200) by EX13D32EUC001.ant.amazon.com (10.43.164.159) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Fri, 13 Dec 2019 13:03:19 +0000 Received: from u2f063a87eabd5f.cbg10.amazon.com (10.125.106.135) by mail-relay.amazon.com (10.43.62.226) with Microsoft SMTP Server id 15.0.1367.3 via Frontend Transport; Fri, 13 Dec 2019 13:03:18 +0000 From: Paul Durrant To: Date: Fri, 13 Dec 2019 13:03:16 +0000 Message-ID: <20191213130316.21085-1-pdurrant@amazon.com> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Precedence: Bulk Subject: [Xen-devel] [PATCH] 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'. NOTE: This is purely a documentation patch. No functional change. Signed-off-by: Paul Durrant --- Cc: Konrad Rzeszutek Wilk Cc: Juergen Gross --- xen/include/public/io/netif.h | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/xen/include/public/io/netif.h b/xen/include/public/io/netif.h index 2454448baa..e587055f68 100644 --- a/xen/include/public/io/netif.h +++ b/xen/include/public/io/netif.h @@ -190,6 +190,20 @@ * order as requests. */ +/* + * Link state + * ========== + * + * The backend can advertise it is current link (carrier) state to the + * frontend using the /local/domain/X/backend///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 * ==========