Re: [Qemu-devel] [PATCH v10 4/6] mm: function to offer a page block on the free list

[Michael S. Tsirkin]

On Fri, May 05, 2017 at 08:21:34AM +0800, kbuild test robot wrote:
> Hi Wei,
> 
> [auto build test WARNING on linus/master]
> [also build test WARNING on v4.11 next-20170504]
> [if your patch is applied to the wrong git tree, please drop us a note to 
> help improve the system]
> 
> url:    
> https://github.com/0day-ci/linux/commits/Wei-Wang/Extend-virtio-balloon-for-fast-de-inflating-fast-live-migration/20170505-052958
> 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)
>    arch/x86/include/asm/uaccess_32.h:1: warning: no structured comments found
> >> mm/page_alloc.c:4663: warning: No description found for parameter 'zone'
> >> mm/page_alloc.c:4663: warning: No description found for parameter 'order'
> >> mm/page_alloc.c:4663: warning: No description found for parameter 
> >> 'migratetype'
> >> mm/page_alloc.c:4663: warning: No description found for parameter 'page'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
>    include/net/cfg80211.h:1738: warning: No description found for parameter 
> 'report_results'
>    include/net/cfg80211.h:1738: warning: Excess struct/union/enum/typedef 
> member 'results_wk' description in 'cfg80211_sched_scan_request'
> 
> vim +/zone +4663 mm/page_alloc.c

the issue is actually aboe this line: it is:

/**

which is reserved for kernel-doc.

Either format properly for kernel-doc, or use simple /*
to start comments.


>   4647         * Heuristically get a page block in the system that is unused.
>   4648         * It is possible that pages from the page block are used 
> immediately after
>   4649         * report_unused_page_block() returns. It is the caller's 
> responsibility
>   4650         * to either detect or prevent the use of such pages.
>   4651         *
>   4652         * The free list to check: 
> zone->free_area[order].free_list[migratetype].
>   4653         *
>   4654         * If the caller supplied page block (i.e. **page) is on the 
> free list, offer
>   4655         * the next page block on the list to the caller. Otherwise, 
> offer the first
>   4656         * page block on the list.
>   4657         *
>   4658         * Return 0 when a page block is found on the caller specified 
> free list.
>   4659         */
>   4660        int report_unused_page_block(struct zone *zone, unsigned int 
> order,
>   4661                                     unsigned int migratetype, struct 
> page **page)
>   4662        {
> > 4663                struct zone *this_zone;
>   4664                struct list_head *this_list;
>   4665                int ret = 0;
>   4666                unsigned long flags;
>   4667        
>   4668                /* Sanity check */
>   4669                if (zone == NULL || page == NULL || order >= MAX_ORDER 
> ||
>   4670                    migratetype >= MIGRATE_TYPES)
>   4671                        return -EINVAL;
> 
> ---
> 0-DAY kernel test infrastructure                Open Source Technology Center
> https://lists.01.org/pipermail/kbuild-all                   Intel Corporation