Received: by 2002:a05:6a10:22f:0:0:0:0 with SMTP id 15csp1050268pxk; Thu, 1 Oct 2020 22:53:43 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxLL5Ux95a0ForRDVB9shR9wr0On0QpxWF1YpzlsfHNLOR6ThnNfYTbXwgF8easZW6+U15w X-Received: by 2002:a17:907:7283:: with SMTP id dt3mr547047ejc.291.1601618023245; Thu, 01 Oct 2020 22:53:43 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1601618023; cv=none; d=google.com; s=arc-20160816; b=OudXLAeu4M3bDLXEgW7M8u13a7PM4TlxnCddOZXq12f24lQz51rAiJPVylXmIvmbvd yHL8tjDAavuvfIB3t6qES4K2gaW5FKVynlUIQum3Ibtdgfq3kK3ehvOIRblq15k+2VqM QazDE3zeoeOVHmskpBxpiE8FavFszwznzzWkny3YeyulYt3so7asdVQPpWGdF3stezpn pAr1Rta4wvr7JtjU6GuJH6DMXv4ohcpUaNYB5ijyb3khh+WyY4k6AnjU8S1Xg0jsyH3/ UujO2g+UzGZl+4MqovwJFy4NN+G71rXAK3vvITNfcT2tLSZK7CiOhDY/raaPWjPn76AJ ixAA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=spyvBcjnCZBTcUVFrqB1siiBueHANcs/9YF4Iemfj1A=; b=QZrl79RbN2iSpw6ed9cRWKvBqbSuadhsOS4yAAHFYR48ziKurWavwJm4g4irQ/3345 Go3hGDF3ao7qWHEeReYcihj6QZ5akNWEk5cFQvCmAdF+Wn08F3XFJF5TxEJJHu17WSnR mOiKB8oaFV7bC5MstvM+Ld1s/In3i9++hOQbWxKh5RGJ+ak/k/TVwSz1Xjuzy4vohrOG kzF6HUDjldPwfjWsXcMt1AgiYKJa9r0wo8sUfRGTHpFtLDx3E/joFnvqfB96pPKTcvnF 5D2i6bbwX8tMIZH8QDJURRYDFDDCfHNZGobeOtceu0TJ+EXLBxR/1MeoSXPrmxrrmzsA MpXg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b="H0Ro11/C"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 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 vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id a16si351859ejk.665.2020.10.01.22.53.20; Thu, 01 Oct 2020 22:53:43 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b="H0Ro11/C"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 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 S1726238AbgJBFuY (ORCPT + 99 others); Fri, 2 Oct 2020 01:50:24 -0400 Received: from mail.kernel.org ([198.145.29.99]:59754 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725957AbgJBFt7 (ORCPT ); Fri, 2 Oct 2020 01:49:59 -0400 Received: from mail.kernel.org (ip5f5ad59f.dynamic.kabel-deutschland.de [95.90.213.159]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 68FA720719; Fri, 2 Oct 2020 05:49:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601617798; bh=d9jAg3Nj6JZLFhzRqkSiYIiTdyrjfTNgd8OfBC8Nm6U=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=H0Ro11/CcD0alduc+ONpMk906bG5pFT+6qM5O7ZlF1B9LD0HDhtNtQy+qLsFy+H9w AO+sLiQEJZismTALlCG/Djke1Rrbe1OGjF3p2W5lGvow4V6nIwgJVHEgrE9JyIR6J3 WKJ4q2F2gEm7/9KuhqBKzlUPmZ/XDWVz18FvW9is= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kODx6-006hil-8a; Fri, 02 Oct 2020 07:49:56 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "David S. Miller" , "Jonathan Corbet" , Jakub Kicinski , Taehee Yoo , linux-kernel@vger.kernel.org, netdev@vger.kernel.org Subject: [PATCH 1/6] net: core: document two new elements of struct net_device Date: Fri, 2 Oct 2020 07:49:45 +0200 Message-Id: <1c6293ffd174d0301c0acb85f0e60e9edf5e4a27.1601616399.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org As warned by "make htmldocs", there are two new struct elements that aren't documented: ../include/linux/netdevice.h:2159: warning: Function parameter or member 'unlink_list' not described in 'net_device' ../include/linux/netdevice.h:2159: warning: Function parameter or member 'nested_level' not described in 'net_device' Fixes: 1fc70edb7d7b ("net: core: add nested_level variable in net_device") Signed-off-by: Mauro Carvalho Chehab --- include/linux/netdevice.h | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/include/linux/netdevice.h b/include/linux/netdevice.h index 78880047907e..7852921480da 100644 --- a/include/linux/netdevice.h +++ b/include/linux/netdevice.h @@ -1843,6 +1843,11 @@ enum netdev_priv_flags { * @udp_tunnel_nic: UDP tunnel offload state * @xdp_state: stores info on attached XDP BPF programs * + * @nested_level: Used as as a parameter of spin_lock_nested() of + * dev->addr_list_lock. + * @unlink_list: As netif_addr_lock() can be called recursively, + * keep a list of interfaces to be deleted. + * * FIXME: cleanup struct net_device such that network protocol info * moves out. */ -- 2.26.2