Received: by 2002:a05:7412:6592:b0:d7:7d3a:4fe2 with SMTP id m18csp890848rdg; Fri, 11 Aug 2023 03:23:26 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEB3EF5dUttZFsGmG5SHjtXarGCPz7C8Rg7s/7F12eZs+uTlV1lvTG8qcoNVoVAWKeEfd8v X-Received: by 2002:a17:907:778c:b0:99c:a0f8:d109 with SMTP id ky12-20020a170907778c00b0099ca0f8d109mr1404340ejc.20.1691749405755; Fri, 11 Aug 2023 03:23:25 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1691749405; cv=none; d=google.com; s=arc-20160816; b=Tl2PWPfDIfKI5MUwsCdIn7F3V7Xw6qF3imqq1vOx797upvSLajOl6WviZqUAMDZtdd 07y0zSYoinxb/pyjKbZaDIvFmBqfNL6wlqDXjAkedTcMfOaY47lunyVMRgHWwf1YWb8B xcwTez2XJMEA3lx6MXFy8iiuNOMAOAsZjevhmuy8aNzLkRCWr9QHC7v3VC4e8uwPNlE/ AlDyNDwYIcT47meg97rqLudOMVpj6LeN0qxy7GNJLIeP/61dhSM4+cLKYj6qfDEpAjjZ 9Tg6/axLz1NkWBI5Jbpp1syMmLf9zz9X7svvgtqsUJa/QSH1KWWkuFWsm6XSOzpalh5M 9QGw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date:dkim-signature; bh=mqgtCU5HABAvu/8EWs9cJfLCQdzjvV4FVoj6JrPZr/Y=; fh=gcYzaCxlkwUWCssGN5Tq/bel4nFFXLzPQx98fWA6vF4=; b=xpIrhekY++Y/h+8z2pKDsZSX0+/EezCdEPsm4sgPRmePE6+YWMRjGuy9oTQOmr5duI n7FnttlgMLuY9K870z7o3RfuU1x+oAP8Yp3FckLpAp01ZTSDOSxpEYomPxJJEE+MCzvc Jcec1oXiK/BHSPbRR8eLFjvx5TDAi3TtGJW0Ev9/r/3/r+JKM+OZSPGbf0cgjtvpvL4j HSSYjJLYBQFtOixi4xCAMh+T48Emxr5mB3O5wFybPkL88vVe7AR3Bd8xLjvf12FA809i l0Jv4Z9CQWRoXPp4qTqFBSnhoz3ZIIryYH2NpQs7xoOs6SB4MMtbEMeAMYvpx+iQPCGt 5FzQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=BEOfoWws; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id ay3-20020a170906d28300b0098e2edf7479si3164700ejb.858.2023.08.11.03.22.59; Fri, 11 Aug 2023 03:23:25 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=BEOfoWws; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234343AbjHKJxP (ORCPT + 99 others); Fri, 11 Aug 2023 05:53:15 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56444 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231476AbjHKJxO (ORCPT ); Fri, 11 Aug 2023 05:53:14 -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 514DD19E; Fri, 11 Aug 2023 02:53:14 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id DBDEB66D2E; Fri, 11 Aug 2023 09:53:13 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id CF87DC433C9; Fri, 11 Aug 2023 09:53:10 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1691747593; bh=u8bULopGztMMXDUlY34aexEHjdKcFlVqp4+mps7Hlto=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=BEOfoWwsm4u+avTAMjCNM0I+BhgmX40uO3SjypS0LkfWEUPy8/g1TP4OsY8FKKA9m 6AxfVr6mhqMLui/q9ltAbQ18+1lKb6rsrlNRdzneE30y/7R+XBzFsUOIwIM/dKWg2W oWRPkGIAoWLz/tdjJ3DA//54n1G+cxlcCnL8ddkgH+PKoDNfwi/t0ysoL7u1bT+IMh ii/0+V68aIgH237ARY7hfSt9bBkELa2gPwkfOOd9j96NrbrEmXBRddqGs+rBR+pfvH JFSE9vw0gOsPI+87/XqNMFVEUnjzBGLmdItaiEsIpwyJcujJGyr2xXNpJeKIq4MJpi RQGENS8CgQYGA== Date: Fri, 11 Aug 2023 11:53:07 +0200 From: Simon Horman To: Lin Ma Cc: Simon Horman , corbet@lwn.net, davem@davemloft.net, edumazet@google.com, kuba@kernel.org, pabeni@redhat.com, rdunlap@infradead.org, void@manifault.com, jani.nikula@intel.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, netdev@vger.kernel.org Subject: Re: [PATCH v2] docs: staging: add netlink attrs best practices Message-ID: References: <20230809032552.765663-1-linma@zju.edu.cn> <41722e43.1049b3.189e02f50f6.Coremail.linma@zju.edu.cn> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <41722e43.1049b3.189e02f50f6.Coremail.linma@zju.edu.cn> X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF, RCVD_IN_DNSWL_BLOCKED,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, Aug 11, 2023 at 12:02:24AM +0800, Lin Ma wrote: > Hello Simon, > > > > Provide some suggestions that who deal with Netlink code could follow > > > (of course using the word "best-practices" may sound somewhat > > > exaggerate). > > > > > > According to my recent practices, the parsing of the Netlink attributes > > > lacks documents for kernel developers. Since recently the relevant docs > > > for Netlink user space get replenished, I guess is a good chance for > > > kernel space part to catch with. > > > > > > First time to write a document and any reviews are appreciated. > > > > > > Signed-off-by: Lin Ma > > > > Thanks for writing this up, from my perspective this is very useful. > > > > Some trivial feedback follows. > > Thanks sooooooo much. And feel really sorry that the v2 still has so many > typos, grammar issues, and word misuse. I will prepare the v3 carefully > with all those suggestions. Really appreciate that. No problem. Much of my feedback was subjective. And Randy managed to spot an error in my feedback too. It's hard to get things right :) ...