[tip:x86/mm 3/4] htmldocs: kernel/resource.c:338: warning: Function parameter or member 'start' not described in 'find_next_iomem_res'

From: kbuild test robot
Date: Tue Oct 09 2018 - 17:39:23 EST

Next message: Heiner Kallweit: "Re: R8169: Network lockups in 4.18.{8,9,10} (and 4.19 dev)"
Previous message: Andrew Morton: "Re: [PATCH] mm: Speed up mremap on large regions"
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

tree: https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git x86/mm
head: b69c2e20f6e4046da84ce5b33ba1ef89cb087b40
commit: 010a93bf97c72f43aac664d0a685942f83d1a103 [3/4] resource: Fix find_next_iomem_res() iteration issue
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

WARNING: convert(1) not found, for SVG to PDF conversion install ImageMagick (https://www.imagemagick.org)
>> kernel/resource.c:338: warning: Function parameter or member 'start' not described in 'find_next_iomem_res'
>> kernel/resource.c:338: warning: Function parameter or member 'end' not described in 'find_next_iomem_res'
>> kernel/resource.c:338: warning: Function parameter or member 'flags' not described in 'find_next_iomem_res'
>> kernel/resource.c:338: warning: Function parameter or member 'desc' not described in 'find_next_iomem_res'
kernel/resource.c:338: warning: Function parameter or member 'first_level_children_only' not described in 'find_next_iomem_res'
>> kernel/resource.c:338: warning: Function parameter or member 'res' not described in 'find_next_iomem_res'
include/linux/srcu.h:175: warning: Function parameter or member 'p' not described in 'srcu_dereference_notrace'
include/linux/srcu.h:175: warning: Function parameter or member 'sp' not described in 'srcu_dereference_notrace'
include/linux/gfp.h:1: warning: no structured comments found
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4381: warning: Function parameter or member 'wext.ibss' not described in 'wireless_dev'
include/net/cfg80211.h:4381: warning: Function parameter or member 'wext.connect' not described in 'wireless_dev'
include/net/cfg80211.h:4381: warning: Function parameter or member 'wext.keys' not described in 'wireless_dev'
include/net/cfg80211.h:4381: warning: Function parameter or member 'wext.ie' not described in 'wireless_dev'
include/net/cfg80211.h:4381: warning: Function parameter or member 'wext.ie_len' not described in 'wireless_dev'
include/net/cfg80211.h:4381: warning: Function parameter or member 'wext.bssid' not described in 'wireless_dev'
include/net/cfg80211.h:4381: warning: Function parameter or member 'wext.ssid' not described in 'wireless_dev'
include/net/cfg80211.h:4381: warning: Function parameter or member 'wext.default_key' not described in 'wireless_dev'
include/net/cfg80211.h:4381: warning: Function parameter or member 'wext.default_mgmt_key' not described in 'wireless_dev'
include/net/cfg80211.h:4381: warning: Function parameter or member 'wext.prev_bssid_valid' not described in 'wireless_dev'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'
include/net/cfg80211.h:4869: warning: Excess function parameter 'ptr' description in 'reg_query_regdb_wmm'

vim +338 kernel/resource.c

^1da177e4 Linus Torvalds 2005-04-16 320
010a93bf9 Bjorn Helgaas 2018-09-27 321 /**
010a93bf9 Bjorn Helgaas 2018-09-27 322 * Finds the lowest iomem resource that covers part of [start..end]. The
010a93bf9 Bjorn Helgaas 2018-09-27 323 * caller must specify start, end, flags, and desc (which may be
010a93bf9 Bjorn Helgaas 2018-09-27 324 * IORES_DESC_NONE).
010a93bf9 Bjorn Helgaas 2018-09-27 325 *
010a93bf9 Bjorn Helgaas 2018-09-27 326 * If a resource is found, returns 0 and *res is overwritten with the part
010a93bf9 Bjorn Helgaas 2018-09-27 327 * of the resource that's within [start..end]; if none is found, returns
010a93bf9 Bjorn Helgaas 2018-09-27 328 * -1.
010a93bf9 Bjorn Helgaas 2018-09-27 329 *
010a93bf9 Bjorn Helgaas 2018-09-27 330 * This function walks the whole tree and not just first level children
010a93bf9 Bjorn Helgaas 2018-09-27 331 * unless @first_level_children_only is true.
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 332 */
010a93bf9 Bjorn Helgaas 2018-09-27 333 static int find_next_iomem_res(resource_size_t start, resource_size_t end,
010a93bf9 Bjorn Helgaas 2018-09-27 334 unsigned long flags, unsigned long desc,
010a93bf9 Bjorn Helgaas 2018-09-27 335 bool first_level_children_only,
010a93bf9 Bjorn Helgaas 2018-09-27 336 struct resource *res)
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 337 {
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 @338 struct resource *p;
8c86e70ac Vivek Goyal 2014-08-08 339 bool sibling_only = false;
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 340
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 341 BUG_ON(!res);
58c1b5b07 KAMEZAWA Hiroyuki 2006-08-05 342 BUG_ON(start >= end);
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 343
800df627e Vivek Goyal 2014-08-29 344 if (first_level_children_only)
8c86e70ac Vivek Goyal 2014-08-08 345 sibling_only = true;
8c86e70ac Vivek Goyal 2014-08-08 346
800df627e Vivek Goyal 2014-08-29 347 read_lock(&resource_lock);
800df627e Vivek Goyal 2014-08-29 348
800df627e Vivek Goyal 2014-08-29 349 for (p = iomem_resource.child; p; p = next_resource(p, sibling_only)) {
010a93bf9 Bjorn Helgaas 2018-09-27 350 if ((p->flags & flags) != flags)
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 351 continue;
3f33647c4 Toshi Kani 2016-01-26 352 if ((desc != IORES_DESC_NONE) && (desc != p->desc))
3f33647c4 Toshi Kani 2016-01-26 353 continue;
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 354 if (p->start > end) {
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 355 p = NULL;
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 356 break;
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 357 }
a98959fdb Bjorn Helgaas 2018-09-27 358 if ((p->end >= start) && (p->start <= end))
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 359 break;
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 360 }
8c86e70ac Vivek Goyal 2014-08-08 361
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 362 read_unlock(&resource_lock);
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 363 if (!p)
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 364 return -1;
010a93bf9 Bjorn Helgaas 2018-09-27 365
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 366 /* copy data */
010a93bf9 Bjorn Helgaas 2018-09-27 367 res->start = max(start, p->start);
010a93bf9 Bjorn Helgaas 2018-09-27 368 res->end = min(end, p->end);
0e4c12b45 Tom Lendacky 2017-10-20 369 res->flags = p->flags;
0e4c12b45 Tom Lendacky 2017-10-20 370 res->desc = p->desc;
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 371 return 0;
2842f1141 KAMEZAWA Hiroyuki 2006-06-27 372 }
908eedc61 KAMEZAWA Hiroyuki 2009-09-22 373

:::::: The code at line 338 was first introduced by commit
:::::: 2842f11419704f8707fffc82e10d2263427fc130 [PATCH] catch valid mem range at onlining memory

:::::: TO: KAMEZAWA Hiroyuki <kamezawa.hiroyu@xxxxxxxxxxxxxx>
:::::: CC: Linus Torvalds <torvalds@xxxxxxxxxxx>

---
0-DAY kernel test infrastructure Open Source Technology Center
https://lists.01.org/pipermail/kbuild-all Intel Corporation

Attachment: .config.gz
Description: application/gzip

Next message: Heiner Kallweit: "Re: R8169: Network lockups in 4.18.{8,9,10} (and 4.19 dev)"
Previous message: Andrew Morton: "Re: [PATCH] mm: Speed up mremap on large regions"
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]