From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 329D3C77B70 for ; Fri, 7 Apr 2023 01:25:47 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239022AbjDGBZq (ORCPT ); Thu, 6 Apr 2023 21:25:46 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34160 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232563AbjDGBZn (ORCPT ); Thu, 6 Apr 2023 21:25:43 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AF9E57EFA for ; Thu, 6 Apr 2023 18:25:42 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 41F5864D96 for ; Fri, 7 Apr 2023 01:25:42 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 3FF2BC433EF; Fri, 7 Apr 2023 01:25:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1680830741; bh=XylMkO0ZM7opGBGpW1+eWOkMczIFVC7JdTXkfP7gpyE=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=EX0dtPNyCWRxkucIJMOyzBMmDvZv1uKiMWUmIA0Ego5nIvzIL2xfa4FGMOtTZd8t+ Fbd/RRCwIQT2o1caFeNaWIMa4wVw+huFiM7P8ymntdfjwVAvBsoeMvQBb34Pv2onmz LQFDamQQATGuScwE58i+3j5ysRL1rgako9lJoC/obUFTwBVLFZo/OQWFdEFd8Ez+M8 cgdHFCDAHYtBbadBlu7BxrAeT1x9gGzFZPKDw5id+yCVWEvehWqw1t2vKjTwyhcIK7 Hxq5c9ES5g0eVvFPEK3k5OOA97Jwm4+blZ8ikizo4Yw+B9XCEt9bbGt54DgLkhGvWW kvitRlbYulL6w== From: Jakub Kicinski To: davem@davemloft.net Cc: netdev@vger.kernel.org, edumazet@google.com, pabeni@redhat.com, herbert@gondor.apana.org.au, alexander.duyck@gmail.com, hkallweit1@gmail.com, andrew@lunn.ch, willemb@google.com, Jakub Kicinski Subject: [PATCH net-next v4 3/7] docs: net: use C syntax highlight in driver.rst Date: Thu, 6 Apr 2023 18:25:32 -0700 Message-Id: <20230407012536.273382-4-kuba@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230407012536.273382-1-kuba@kernel.org> References: <20230407012536.273382-1-kuba@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Use syntax highlight, comment out the "..." since they are not valid C. Signed-off-by: Jakub Kicinski --- Documentation/networking/driver.rst | 30 +++++++++++++++++++---------- 1 file changed, 20 insertions(+), 10 deletions(-) diff --git a/Documentation/networking/driver.rst b/Documentation/networking/driver.rst index bfbd66871bb3..19c363291d04 100644 --- a/Documentation/networking/driver.rst +++ b/Documentation/networking/driver.rst @@ -43,7 +43,9 @@ there is no way your device can tell ahead of time when its transmit function will become busy. Instead it must maintain the queue properly. For example, -for a driver implementing scatter-gather this means:: +for a driver implementing scatter-gather this means: + +.. code-block:: c static netdev_tx_t drv_hard_start_xmit(struct sk_buff *skb, struct net_device *dev) @@ -51,7 +53,7 @@ Instead it must maintain the queue properly. For example, struct drv *dp = netdev_priv(dev); lock_tx(dp); - ... + //... /* This is a hard error log it. */ if (TX_BUFFS_AVAIL(dp) <= (skb_shinfo(skb)->nr_frags + 1)) { netif_stop_queue(dev); @@ -61,34 +63,42 @@ Instead it must maintain the queue properly. For example, return NETDEV_TX_BUSY; } - ... queue packet to card ... - ... update tx consumer index ... + //... queue packet to card ... + //... update tx consumer index ... if (TX_BUFFS_AVAIL(dp) <= (MAX_SKB_FRAGS + 1)) netif_stop_queue(dev); - ... + //... unlock_tx(dp); - ... + //... return NETDEV_TX_OK; } -And then at the end of your TX reclamation event handling:: +And then at the end of your TX reclamation event handling: + +.. code-block:: c if (netif_queue_stopped(dp->dev) && TX_BUFFS_AVAIL(dp) > (MAX_SKB_FRAGS + 1)) netif_wake_queue(dp->dev); -For a non-scatter-gather supporting card, the three tests simply become:: +For a non-scatter-gather supporting card, the three tests simply become: + +.. code-block:: c /* This is a hard error log it. */ if (TX_BUFFS_AVAIL(dp) <= 0) -and:: +and: + +.. code-block:: c if (TX_BUFFS_AVAIL(dp) == 0) -and:: +and: + +.. code-block:: c if (netif_queue_stopped(dp->dev) && TX_BUFFS_AVAIL(dp) > 0) -- 2.39.2