From patchwork Fri Mar 1 16:43:06 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Maxime Chevallier X-Patchwork-Id: 21219 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:fa17:b0:10a:f01:a869 with SMTP id ju23csp6196dyc; Fri, 1 Mar 2024 08:50:09 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCWo1pAxQLKRipbCHysFfO62Ftrr12Xl/QkbAu+OI0jgb8doW9Pj8YulU04cp93T6LvOsIyfWFpzL40c+fh4uuk80syV2w== X-Google-Smtp-Source: AGHT+IFNrDKAdh9LZ56SIelMPU1K/IUE5DW7zSaJ7H2+EkAHTMNWOR3rddKBa8VgjHf1jHI6KA+i X-Received: by 2002:a50:a6d8:0:b0:565:d63a:708d with SMTP id f24-20020a50a6d8000000b00565d63a708dmr1732927edc.14.1709311809139; Fri, 01 Mar 2024 08:50:09 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1709311809; cv=pass; d=google.com; s=arc-20160816; b=pVRJ6y14hn5eJJy+Qh5CkjElK3W5y0cnHBl5hlcgB0rQ3gHZOn9SYoNRfhiN9rT0Zo pyB549CE2tm3kLHUvsPLPrmUhEeGd5OWfT/KwxF34jxYvMGO9+M1JdDLVtfd6RrSl2CM o57bcUglyqkUO2F9sw25G5jv4JRkmYqcHatENRJaGdXygB/xbL8jregqSyYzsvDEn8FT iFYrjHUd4N7nk4CORpgSEuRJ6vyij0L/m+Sm8k7fNby8qZpbjGLxnqmtrK/9RbW4ib3L F08Ci2X4+rmQhSwTYitY35/hi2fzPKSUlDgw8ID+zQVAbs/B7RJdvJefzLeJz/JiPPI/ MxJg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=s1kVtBo3wFo1/4oQQJ6i5NIv1hpQWWCqz+qSHUmD/D4=; fh=ucD0yDUQK4vkOjaD7gGMeT6G/Uk5SnXQjlHJp9K/X74=; b=EdmvI2XTcin4F/Uaz2utm5q6MISA2CDjm21n1pVDEcvqhN9JJ1NWM5l20AmtYWBenk ljwsKtALPEqdbosruU0sAsy6hDr02w88PNKkcJM8PA27Ljhp4lqZ7InwaQM7y4HvQ4yS iRq5I9kkd0PVRBa0xVNyp5SqdXOcUo1I9Fi/ci3/2qdZe9pSS7Gg1H/nHSRC8XLIkyOm yunAvu1thhdxZAc6MOoifqoi11FT3PktSnvaRyNs/gwPi2ENFQ/kfUtcu1KUWyK764FC vSJLylLewETuglWuU0FwP29ELFfkyQ0Ey0DTlGq/yunnzki8J0XbvHX+d2iaXRP+9p78 y5gw==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b="pFTSD/0k"; arc=pass (i=1 spf=pass spfdomain=bootlin.com dkim=pass dkdomain=bootlin.com dmarc=pass fromdomain=bootlin.com); spf=pass (google.com: domain of linux-kernel+bounces-88750-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-88750-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id a15-20020a50c30f000000b00566d87b9391si546913edb.268.2024.03.01.08.50.08 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 01 Mar 2024 08:50:09 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-88750-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b="pFTSD/0k"; arc=pass (i=1 spf=pass spfdomain=bootlin.com dkim=pass dkdomain=bootlin.com dmarc=pass fromdomain=bootlin.com); spf=pass (google.com: domain of linux-kernel+bounces-88750-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-88750-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id B51931F2170B for ; Fri, 1 Mar 2024 16:50:08 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id BD6A82F29; Fri, 1 Mar 2024 16:43:18 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b="pFTSD/0k" Received: from relay1-d.mail.gandi.net (relay1-d.mail.gandi.net [217.70.183.193]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9961A3A1DA; Fri, 1 Mar 2024 16:43:13 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.70.183.193 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709311396; cv=none; b=ZqEG9S4wQnZbLtCtyo3wAKyJcTuO8NwHfIRZ0JBb5F45Co5ekuvef5JFwlkoACCt7kQ7xmMkI8MEMhOybxXmthycjE4pG6cOfgyYSh70odmSemDik5U0LBRxtlLOTkTamRr3nk9GS7foPHH4q9xlxNd+f+k4JNItiUOaJuge+sI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709311396; c=relaxed/simple; bh=d88IbXBojHwL6DV2uZhvy9YjIo2iMnBl7jgt2E1FEtc=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=ZEGOLiFRaylgkzVYx5N0Kf1jBvQnJ4UlyWOZF+K2aCJwwsSM7qxojgBH2L0Bbd8/Jdg3Z2xQPTD1UcUrvgBjGyWQg0RBzCaqhCd202ap4Zdqk39dA0rtoBXRbZTG1vyZv9MF6arVbMujcnS8DoHR8/2gf2IvmtHPDMTKejPSvCg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com; spf=pass smtp.mailfrom=bootlin.com; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b=pFTSD/0k; arc=none smtp.client-ip=217.70.183.193 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=bootlin.com Received: by mail.gandi.net (Postfix) with ESMTPSA id 6A56A240006; Fri, 1 Mar 2024 16:43:10 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1709311391; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=s1kVtBo3wFo1/4oQQJ6i5NIv1hpQWWCqz+qSHUmD/D4=; b=pFTSD/0kVcP9ps/fq8QSVgFvLV84hl0UtNohbfFwMTV4Fi/oqisBzqPFOuCebwYV1Dl3Rt CcovQc08lJyu4geMrEl9tkXCR70kb/ZWuOJjeN8n3bibCQ+GZOmG8eaPiNqY/nhqhiiqLT IBRhPtu6xUS02gzQ12UTbFxYYoP/Z7jQtZ013uR66sYWbuV/WGt7uTEbBsVgVZfxUGBlxM YhabU7E9pJOjYwY08umqui8kCRlV9bPadfFJSGDbSpCRIDyBQlIJhk50SYe9AP9XvX/1dm 5/aNwvaLTIDJ0sr/IONWLQOZ9OjMJHEzkKhpL5pSy+tExkNhUT7VPeHRXuPD4g== From: Maxime Chevallier To: davem@davemloft.net Cc: Maxime Chevallier , netdev@vger.kernel.org, linux-kernel@vger.kernel.org, thomas.petazzoni@bootlin.com, Andrew Lunn , Jakub Kicinski , Eric Dumazet , Paolo Abeni , Russell King , Florian Fainelli , Heiner Kallweit , Jonathan Corbet Subject: [PATCH net-next v3 0/2] doc: sfp-phylink: update the porting guide Date: Fri, 1 Mar 2024 17:43:06 +0100 Message-ID: <20240301164309.3643849-1-maxime.chevallier@bootlin.com> X-Mailer: git-send-email 2.43.2 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-GND-Sasl: maxime.chevallier@bootlin.com X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1792343339666686985 X-GMAIL-MSGID: 1792343339666686985 Hello everyone, Here's a V3 for an update on the phylink porting guide. The only difference with V2 is a whitespace fix along with a line-wrap. The main point of the update is the description of a basic process to follow to expose one or more PCS to phylink. Let me know if you spot any inaccuracies in the guide. The second patch is a simple fixup on some in-code doc that was spotted while updating the guide. Link to V2: https://lore.kernel.org/netdev/20240228095755.1499577-1-maxime.chevallier@bootlin.com/ Link to V1: https://lore.kernel.org/netdev/20240220160406.3363002-1-maxime.chevallier@bootlin.com/ Maxime Chevallier (2): doc: sfp-phylink: update the porting guide with PCS handling net: phylink: clean the pcs_get_state documentation Documentation/networking/sfp-phylink.rst | 147 ++++++++++++++++++++--- include/linux/phylink.h | 3 - 2 files changed, 133 insertions(+), 17 deletions(-)