Received: by 2002:a05:7412:6592:b0:d7:7d3a:4fe2 with SMTP id m18csp1263063rdg; Fri, 11 Aug 2023 15:50:48 -0700 (PDT) X-Google-Smtp-Source: AGHT+IG0Q7FA71jin17YmrA6iKtc+RalrvEPazfLnKbrXCK2/4yA3AwQoShaX4tso36AEaXVCw6b X-Received: by 2002:a5d:4391:0:b0:317:5bb2:aeca with SMTP id i17-20020a5d4391000000b003175bb2aecamr2396812wrq.16.1691794248735; Fri, 11 Aug 2023 15:50:48 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1691794248; cv=none; d=google.com; s=arc-20160816; b=BP7HwGxTzpxXEZ8lPKE08Y40ANDanHQ4ZLpQj64x6yuq/2xx6qsgBvYZwIWPkIpISb XfeReUXzGAwHgILAXewrJGImXZqlNIDFlETe5yLtwpObFVZMSKLyS0blqLQvV1bJtXse uu9Z8FDjG0xWwqHq0n1A00eylrxBDet8AP1akdH3e6JieByvBYqCRXiWcS446Fwx9YjH aZQhW2dQiV2OBAV2Lj4Roenq16c4Yl/X32S58WfFa/Xc2SL2fT1qs4tm9o/jkfZw3ipM ddHUj43/GEQN9ZyaHxVFavehHEgDHiz+4t5f6i+vNTL9FF7hp8jeZZsdUH2RnDidC2x4 HEOA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:subject:cc:to:from:date :dkim-signature; bh=uoDHaxNPOW0Fa1jjS9dAgVpjupxR10NJvSv1QRGTocU=; fh=iDb1FUdg5K+S4nIeEtPS2/J10XiwJ0UpiBa13xtQu0g=; b=iw1dmPmdcpid0Yi03xAL3nfij4SlOHLvQ970TrMi+pCZYQ6AYZ14Vzkm7LjbJnh1YL T/oX+U8pre6odGF7Z0Ba2peKjTVeS5+HMzW/S/xQ8ZS3v+onMBb4pdNBndKiY0nx7LH9 5y7bmHPhlbqFg5a+6dzAxSWo80KhPdT8AlxlxdnfRd1zxUdF+Q8EDgOq8XrQw20UlU+u 6qS6cCbd6bJOga/nW/6+UC9cOUmoqKyNIlhkhmn4XTojb2OSn3rPley7Q8kBEPzT7VTX s+MlFEYYhcb2r+wRqC/qRzYpIHEhEh8vJHzgV8xiVOkGJWPdwZge0wA1ochuVD4MB6d3 Rh9Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=fk6lC2QI; 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 be4-20020a0564021a2400b005222b655688si3755144edb.368.2023.08.11.15.50.24; Fri, 11 Aug 2023 15:50:48 -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=fk6lC2QI; 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 S234892AbjHKW0h (ORCPT + 99 others); Fri, 11 Aug 2023 18:26:37 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45108 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234276AbjHKW0g (ORCPT ); Fri, 11 Aug 2023 18:26:36 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AEA6FCE; Fri, 11 Aug 2023 15:26:36 -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 4D7AC651AA; Fri, 11 Aug 2023 22:26:36 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 490CAC433C8; Fri, 11 Aug 2023 22:26:35 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1691792795; bh=uoDHaxNPOW0Fa1jjS9dAgVpjupxR10NJvSv1QRGTocU=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=fk6lC2QIuJGe+JLCJzmT1erXDMWJtg/dMlaxrr7m5Kcn/v+gsjW+yK1z1pMEX16mM Qk/SMhsGc470EtoqejSb80Z98S8XfDHmwXQ3+o7wNwOh8ZvLH/ENKB5572C3zann+a 6tEdIaxcJ2H/IjO+ugH95mU3d03opsavD9MQwN7burGIXIDdBDk11J9UBXVsO6J+K5 uI66J9UqGEC8s3nbVoXaNsCOZig2DCq6lcZpN85ceDBHvKTRQOLIMPfGGzgcFNlQAd 0uqaTnQS42e6X9+wSv7S/4zlwdLf63lF4UxeO5sDC7ueSWyfamlckm9YXZnz62dZpI U4YGanMdxW6cQ== Date: Fri, 11 Aug 2023 15:26:34 -0700 From: Jakub Kicinski To: Lin Ma Cc: corbet@lwn.net, davem@davemloft.net, edumazet@google.com, pabeni@redhat.com, rdunlap@infradead.org, void@manifault.com, jani.nikula@intel.com, horms@kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, netdev@vger.kernel.org Subject: Re: [PATCH v3] docs: net: add netlink attrs best practices Message-ID: <20230811152634.271608c5@kernel.org> In-Reply-To: <20230811031549.2011622-1-linma@zju.edu.cn> References: <20230811031549.2011622-1-linma@zju.edu.cn> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-7.1 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_HI, 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, 11 Aug 2023 11:15:49 +0800 Lin Ma wrote: > Provide some suggestions that who deal with Netlink code could follow > (of course using the word "best-practices" may sound somewhat > exaggerate). I truly appreciate the effort, but I'm worried this will only confuse developers. This document does not reflect the reality of writing new netlink families at all. It's more of a historic perspective.