[PATCH 2/2] drm: Update old comment style

kbuild test robot lkp at intel.com
Fri Oct 13 00:40:04 UTC 2017


Hi Haneen,

[auto build test WARNING on drm/drm-next]
[also build test WARNING on v4.14-rc4 next-20171009]
[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/Haneen-Mohammed/drm-Extract-drm_debug-hc/20171013-052937
base:   git://people.freedesktop.org/~airlied/linux.git drm-next
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/trace/blktrace.c:824: warning: No description found for parameter 'cgid'
   drivers/gpio/gpiolib.c:593: warning: No description found for parameter '16'
   drivers/gpio/gpiolib.c:593: warning: Excess struct/union/enum/typedef member 'events' description in 'lineevent_state'
   include/linux/usb/gadget.h:232: warning: No description found for parameter 'claimed'
   include/linux/usb/gadget.h:232: warning: No description found for parameter 'enabled'
   include/linux/usb/gadget.h:414: warning: No description found for parameter 'quirk_altset_not_supp'
   include/linux/usb/gadget.h:414: warning: No description found for parameter 'quirk_stall_not_supp'
   include/linux/usb/gadget.h:414: warning: No description found for parameter 'quirk_zlp_not_supp'
   fs/inode.c:1680: warning: No description found for parameter 'rcu'
   include/linux/jbd2.h:443: warning: No description found for parameter 'i_transaction'
   include/linux/jbd2.h:443: warning: No description found for parameter 'i_next_transaction'
   include/linux/jbd2.h:443: warning: No description found for parameter 'i_list'
   include/linux/jbd2.h:443: warning: No description found for parameter 'i_vfs_inode'
   include/linux/jbd2.h:443: warning: No description found for parameter 'i_flags'
   include/linux/jbd2.h:497: warning: No description found for parameter 'h_rsv_handle'
   include/linux/jbd2.h:497: warning: No description found for parameter 'h_reserved'
   include/linux/jbd2.h:497: warning: No description found for parameter 'h_type'
   include/linux/jbd2.h:497: warning: No description found for parameter 'h_line_no'
   include/linux/jbd2.h:497: warning: No description found for parameter 'h_start_jiffies'
   include/linux/jbd2.h:497: warning: No description found for parameter 'h_requested_credits'
   include/linux/jbd2.h:497: warning: No description found for parameter 'saved_alloc_context'
   include/linux/jbd2.h:1050: warning: No description found for parameter 'j_chkpt_bhs'
   include/linux/jbd2.h:1050: warning: No description found for parameter 'j_devname'
   include/linux/jbd2.h:1050: warning: No description found for parameter 'j_average_commit_time'
   include/linux/jbd2.h:1050: warning: No description found for parameter 'j_min_batch_time'
   include/linux/jbd2.h:1050: warning: No description found for parameter 'j_max_batch_time'
   include/linux/jbd2.h:1050: warning: No description found for parameter 'j_commit_callback'
   include/linux/jbd2.h:1050: warning: No description found for parameter 'j_failed_commit'
   include/linux/jbd2.h:1050: warning: No description found for parameter 'j_chksum_driver'
   include/linux/jbd2.h:1050: warning: No description found for parameter 'j_csum_seed'
   fs/jbd2/transaction.c:511: warning: No description found for parameter 'type'
   fs/jbd2/transaction.c:511: warning: No description found for parameter 'line_no'
   fs/jbd2/transaction.c:641: warning: No description found for parameter 'gfp_mask'
   include/drm/drm_drv.h:594: warning: No description found for parameter 'gem_prime_pin'
   include/drm/drm_drv.h:594: warning: No description found for parameter 'gem_prime_unpin'
   include/drm/drm_drv.h:594: warning: No description found for parameter 'gem_prime_res_obj'
   include/drm/drm_drv.h:594: warning: No description found for parameter 'gem_prime_get_sg_table'
   include/drm/drm_drv.h:594: warning: No description found for parameter 'gem_prime_import_sg_table'
   include/drm/drm_drv.h:594: warning: No description found for parameter 'gem_prime_vmap'
   include/drm/drm_drv.h:594: warning: No description found for parameter 'gem_prime_vunmap'
   include/drm/drm_drv.h:594: warning: No description found for parameter 'gem_prime_mmap'
   include/drm/drm_mode_config.h:771: warning: No description found for parameter 'modifiers_property'
   include/drm/drm_mode_config.h:771: warning: Excess struct/union/enum/typedef member 'modifiers' description in 'drm_mode_config'
   include/drm/drm_plane.h:552: warning: No description found for parameter 'modifiers'
   include/drm/drm_plane.h:552: warning: No description found for parameter 'modifier_count'
   include/drm/drm_debug.h:76: warning: No description found for parameter 'dev'
>> include/drm/drm_debug.h:76: warning: Excess function parameter 'arg' description in 'DRM_DEV_ERROR'
   include/drm/drm_debug.h:94: warning: No description found for parameter 'dev'
>> include/drm/drm_debug.h:94: warning: Excess function parameter 'arg' description in 'DRM_DEV_ERROR_RATELIMITED'
   include/drm/drm_debug.h:119: warning: No description found for parameter 'dev'
>> include/drm/drm_debug.h:119: warning: Excess function parameter 'arg' description in 'DRM_DEV_DEBUG'
   include/drm/drm_debug.h:170: warning: No description found for parameter 'dev'
>> include/drm/drm_debug.h:170: warning: Excess function parameter 'arg' description in 'DRM_DEV_DEBUG_RATELIMITED'
   drivers/gpu/drm/drm_debug.c:1: warning: no structured comments found
   drivers/gpu/host1x/bus.c:50: warning: No description found for parameter 'driver'
   drivers/gpu/drm/tve200/tve200_drv.c:1: warning: no structured comments found
   Documentation/core-api/kernel-api.rst:354: ERROR: Error in "kernel-doc" directive:
   unknown option: "external".

vim +76 include/drm/drm_debug.h

9bb12800 Haneen Mohammed 2017-10-10   46  
9bb12800 Haneen Mohammed 2017-10-10   47  #define _DRM_PRINTK(once, level, fmt, ...)				\
9bb12800 Haneen Mohammed 2017-10-10   48  	do {								\
9bb12800 Haneen Mohammed 2017-10-10   49  		printk##once(KERN_##level "[" DRM_NAME "] " fmt,	\
9bb12800 Haneen Mohammed 2017-10-10   50  			     ##__VA_ARGS__);				\
9bb12800 Haneen Mohammed 2017-10-10   51  	} while (0)
9bb12800 Haneen Mohammed 2017-10-10   52  
9bb12800 Haneen Mohammed 2017-10-10   53  #define DRM_INFO(fmt, ...)						\
9bb12800 Haneen Mohammed 2017-10-10   54  	_DRM_PRINTK(, INFO, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10   55  #define DRM_NOTE(fmt, ...)						\
9bb12800 Haneen Mohammed 2017-10-10   56  	_DRM_PRINTK(, NOTICE, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10   57  #define DRM_WARN(fmt, ...)						\
9bb12800 Haneen Mohammed 2017-10-10   58  	_DRM_PRINTK(, WARNING, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10   59  
9bb12800 Haneen Mohammed 2017-10-10   60  #define DRM_INFO_ONCE(fmt, ...)						\
9bb12800 Haneen Mohammed 2017-10-10   61  	_DRM_PRINTK(_once, INFO, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10   62  #define DRM_NOTE_ONCE(fmt, ...)						\
9bb12800 Haneen Mohammed 2017-10-10   63  	_DRM_PRINTK(_once, NOTICE, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10   64  #define DRM_WARN_ONCE(fmt, ...)						\
9bb12800 Haneen Mohammed 2017-10-10   65  	_DRM_PRINTK(_once, WARNING, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10   66  
9bb12800 Haneen Mohammed 2017-10-10   67  /**
9bb12800 Haneen Mohammed 2017-10-10   68   * Error output.
9bb12800 Haneen Mohammed 2017-10-10   69   *
a9af8b82 Haneen Mohammed 2017-10-10   70   * @fmt: printf() like format string.
a9af8b82 Haneen Mohammed 2017-10-10   71   * @arg: arguments
9bb12800 Haneen Mohammed 2017-10-10   72   */
9bb12800 Haneen Mohammed 2017-10-10   73  #define DRM_DEV_ERROR(dev, fmt, ...)					\
9bb12800 Haneen Mohammed 2017-10-10   74  	drm_dev_printk(dev, KERN_ERR, DRM_UT_NONE, __func__, " *ERROR*",\
9bb12800 Haneen Mohammed 2017-10-10   75  		       fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10  @76  #define DRM_ERROR(fmt, ...)						\
9bb12800 Haneen Mohammed 2017-10-10   77  	drm_printk(KERN_ERR, DRM_UT_NONE, fmt,	##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10   78  
9bb12800 Haneen Mohammed 2017-10-10   79  /**
9bb12800 Haneen Mohammed 2017-10-10   80   * Rate limited error output.  Like DRM_ERROR() but won't flood the log.
9bb12800 Haneen Mohammed 2017-10-10   81   *
a9af8b82 Haneen Mohammed 2017-10-10   82   * @fmt: printf() like format string.
a9af8b82 Haneen Mohammed 2017-10-10   83   * @arg: arguments
9bb12800 Haneen Mohammed 2017-10-10   84   */
9bb12800 Haneen Mohammed 2017-10-10   85  #define DRM_DEV_ERROR_RATELIMITED(dev, fmt, ...)			\
9bb12800 Haneen Mohammed 2017-10-10   86  ({									\
9bb12800 Haneen Mohammed 2017-10-10   87  	static DEFINE_RATELIMIT_STATE(_rs,				\
9bb12800 Haneen Mohammed 2017-10-10   88  				      DEFAULT_RATELIMIT_INTERVAL,	\
9bb12800 Haneen Mohammed 2017-10-10   89  				      DEFAULT_RATELIMIT_BURST);		\
9bb12800 Haneen Mohammed 2017-10-10   90  									\
9bb12800 Haneen Mohammed 2017-10-10   91  	if (__ratelimit(&_rs))						\
9bb12800 Haneen Mohammed 2017-10-10   92  		DRM_DEV_ERROR(dev, fmt, ##__VA_ARGS__);			\
9bb12800 Haneen Mohammed 2017-10-10   93  })
9bb12800 Haneen Mohammed 2017-10-10  @94  #define DRM_ERROR_RATELIMITED(fmt, ...)					\
9bb12800 Haneen Mohammed 2017-10-10   95  	DRM_DEV_ERROR_RATELIMITED(NULL, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10   96  
9bb12800 Haneen Mohammed 2017-10-10   97  #define DRM_DEV_INFO(dev, fmt, ...)					\
9bb12800 Haneen Mohammed 2017-10-10   98  	drm_dev_printk(dev, KERN_INFO, DRM_UT_NONE, __func__, "", fmt,	\
9bb12800 Haneen Mohammed 2017-10-10   99  		       ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10  100  
9bb12800 Haneen Mohammed 2017-10-10  101  #define DRM_DEV_INFO_ONCE(dev, fmt, ...)				\
9bb12800 Haneen Mohammed 2017-10-10  102  ({									\
9bb12800 Haneen Mohammed 2017-10-10  103  	static bool __print_once __read_mostly;				\
9bb12800 Haneen Mohammed 2017-10-10  104  	if (!__print_once) {						\
9bb12800 Haneen Mohammed 2017-10-10  105  		__print_once = true;					\
9bb12800 Haneen Mohammed 2017-10-10  106  		DRM_DEV_INFO(dev, fmt, ##__VA_ARGS__);			\
9bb12800 Haneen Mohammed 2017-10-10  107  	}								\
9bb12800 Haneen Mohammed 2017-10-10  108  })
9bb12800 Haneen Mohammed 2017-10-10  109  
9bb12800 Haneen Mohammed 2017-10-10  110  /**
9bb12800 Haneen Mohammed 2017-10-10  111   * Debug output.
9bb12800 Haneen Mohammed 2017-10-10  112   *
a9af8b82 Haneen Mohammed 2017-10-10  113   * @fmt: printf() like format string.
a9af8b82 Haneen Mohammed 2017-10-10  114   * @arg: arguments
9bb12800 Haneen Mohammed 2017-10-10  115   */
9bb12800 Haneen Mohammed 2017-10-10  116  #define DRM_DEV_DEBUG(dev, fmt, args...)				\
9bb12800 Haneen Mohammed 2017-10-10  117  	drm_dev_printk(dev, KERN_DEBUG, DRM_UT_CORE, __func__, "", fmt,	\
9bb12800 Haneen Mohammed 2017-10-10  118  		       ##args)
9bb12800 Haneen Mohammed 2017-10-10 @119  #define DRM_DEBUG(fmt, ...)						\
9bb12800 Haneen Mohammed 2017-10-10  120  	drm_printk(KERN_DEBUG, DRM_UT_CORE, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10  121  
9bb12800 Haneen Mohammed 2017-10-10  122  #define DRM_DEV_DEBUG_DRIVER(dev, fmt, args...)				\
9bb12800 Haneen Mohammed 2017-10-10  123  	drm_dev_printk(dev, KERN_DEBUG, DRM_UT_DRIVER, __func__, "",	\
9bb12800 Haneen Mohammed 2017-10-10  124  		       fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10  125  #define DRM_DEBUG_DRIVER(fmt, ...)					\
9bb12800 Haneen Mohammed 2017-10-10  126  	drm_printk(KERN_DEBUG, DRM_UT_DRIVER, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10  127  
9bb12800 Haneen Mohammed 2017-10-10  128  #define DRM_DEV_DEBUG_KMS(dev, fmt, args...)				\
9bb12800 Haneen Mohammed 2017-10-10  129  	drm_dev_printk(dev, KERN_DEBUG, DRM_UT_KMS, __func__, "", fmt,	\
9bb12800 Haneen Mohammed 2017-10-10  130  		       ##args)
9bb12800 Haneen Mohammed 2017-10-10  131  #define DRM_DEBUG_KMS(fmt, ...)					\
9bb12800 Haneen Mohammed 2017-10-10  132  	drm_printk(KERN_DEBUG, DRM_UT_KMS, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10  133  
9bb12800 Haneen Mohammed 2017-10-10  134  #define DRM_DEV_DEBUG_PRIME(dev, fmt, args...)				\
9bb12800 Haneen Mohammed 2017-10-10  135  	drm_dev_printk(dev, KERN_DEBUG, DRM_UT_PRIME, __func__, "",	\
9bb12800 Haneen Mohammed 2017-10-10  136  		       fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10  137  #define DRM_DEBUG_PRIME(fmt, ...)					\
9bb12800 Haneen Mohammed 2017-10-10  138  	drm_printk(KERN_DEBUG, DRM_UT_PRIME, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10  139  
9bb12800 Haneen Mohammed 2017-10-10  140  #define DRM_DEV_DEBUG_ATOMIC(dev, fmt, args...)				\
9bb12800 Haneen Mohammed 2017-10-10  141  	drm_dev_printk(dev, KERN_DEBUG, DRM_UT_ATOMIC, __func__, "",	\
9bb12800 Haneen Mohammed 2017-10-10  142  		       fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10  143  #define DRM_DEBUG_ATOMIC(fmt, ...)					\
9bb12800 Haneen Mohammed 2017-10-10  144  	drm_printk(KERN_DEBUG, DRM_UT_ATOMIC, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10  145  
9bb12800 Haneen Mohammed 2017-10-10  146  #define DRM_DEV_DEBUG_VBL(dev, fmt, args...)				\
9bb12800 Haneen Mohammed 2017-10-10  147  	drm_dev_printk(dev, KERN_DEBUG, DRM_UT_VBL, __func__, "", fmt,	\
9bb12800 Haneen Mohammed 2017-10-10  148  		       ##args)
9bb12800 Haneen Mohammed 2017-10-10  149  #define DRM_DEBUG_VBL(fmt, ...)					\
9bb12800 Haneen Mohammed 2017-10-10  150  	drm_printk(KERN_DEBUG, DRM_UT_VBL, fmt, ##__VA_ARGS__)
9bb12800 Haneen Mohammed 2017-10-10  151  
9bb12800 Haneen Mohammed 2017-10-10  152  #define _DRM_DEV_DEFINE_DEBUG_RATELIMITED(dev, level, fmt, args...)	\
9bb12800 Haneen Mohammed 2017-10-10  153  ({									\
9bb12800 Haneen Mohammed 2017-10-10  154  	static DEFINE_RATELIMIT_STATE(_rs,				\
9bb12800 Haneen Mohammed 2017-10-10  155  				      DEFAULT_RATELIMIT_INTERVAL,	\
9bb12800 Haneen Mohammed 2017-10-10  156  				      DEFAULT_RATELIMIT_BURST);		\
9bb12800 Haneen Mohammed 2017-10-10  157  	if (__ratelimit(&_rs))						\
9bb12800 Haneen Mohammed 2017-10-10  158  		drm_dev_printk(dev, KERN_DEBUG, DRM_UT_ ## level,	\
9bb12800 Haneen Mohammed 2017-10-10  159  			       __func__, "", fmt, ##args);		\
9bb12800 Haneen Mohammed 2017-10-10  160  })
9bb12800 Haneen Mohammed 2017-10-10  161  
9bb12800 Haneen Mohammed 2017-10-10  162  /**
9bb12800 Haneen Mohammed 2017-10-10  163   * Rate limited debug output. Like DRM_DEBUG() but won't flood the log.
9bb12800 Haneen Mohammed 2017-10-10  164   *
a9af8b82 Haneen Mohammed 2017-10-10  165   * @fmt: printf() like format string.
a9af8b82 Haneen Mohammed 2017-10-10  166   * @arg: arguments
9bb12800 Haneen Mohammed 2017-10-10  167   */
9bb12800 Haneen Mohammed 2017-10-10  168  #define DRM_DEV_DEBUG_RATELIMITED(dev, fmt, args...)			\
9bb12800 Haneen Mohammed 2017-10-10  169  	DEV__DRM_DEFINE_DEBUG_RATELIMITED(dev, CORE, fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10 @170  #define DRM_DEBUG_RATELIMITED(fmt, args...)				\
9bb12800 Haneen Mohammed 2017-10-10  171  	DRM_DEV_DEBUG_RATELIMITED(NULL, fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10  172  #define DRM_DEV_DEBUG_DRIVER_RATELIMITED(dev, fmt, args...)		\
9bb12800 Haneen Mohammed 2017-10-10  173  	_DRM_DEV_DEFINE_DEBUG_RATELIMITED(dev, DRIVER, fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10  174  #define DRM_DEBUG_DRIVER_RATELIMITED(fmt, args...)			\
9bb12800 Haneen Mohammed 2017-10-10  175  	DRM_DEV_DEBUG_DRIVER_RATELIMITED(NULL, fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10  176  #define DRM_DEV_DEBUG_KMS_RATELIMITED(dev, fmt, args...)		\
9bb12800 Haneen Mohammed 2017-10-10  177  	_DRM_DEV_DEFINE_DEBUG_RATELIMITED(dev, KMS, fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10  178  #define DRM_DEBUG_KMS_RATELIMITED(fmt, args...)				\
9bb12800 Haneen Mohammed 2017-10-10  179  	DRM_DEV_DEBUG_KMS_RATELIMITED(NULL, fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10  180  #define DRM_DEV_DEBUG_PRIME_RATELIMITED(dev, fmt, args...)		\
9bb12800 Haneen Mohammed 2017-10-10  181  	_DRM_DEV_DEFINE_DEBUG_RATELIMITED(dev, PRIME, fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10  182  #define DRM_DEBUG_PRIME_RATELIMITED(fmt, args...)			\
9bb12800 Haneen Mohammed 2017-10-10  183  	DRM_DEV_DEBUG_PRIME_RATELIMITED(NULL, fmt, ##args)
9bb12800 Haneen Mohammed 2017-10-10  184  

:::::: The code at line 76 was first introduced by commit
:::::: 9bb12800de11fbffc46f4a438ef6829efeced9eb drm: Extract drm_debug.[hc]

:::::: TO: Haneen Mohammed <hamohammed.sa at gmail.com>
:::::: CC: 0day robot <fengguang.wu at intel.com>

---
0-DAY kernel test infrastructure                Open Source Technology Center
https://lists.01.org/pipermail/kbuild-all                   Intel Corporation
-------------- next part --------------
A non-text attachment was scrubbed...
Name: .config.gz
Type: application/gzip
Size: 6771 bytes
Desc: not available
URL: <https://lists.freedesktop.org/archives/dri-devel/attachments/20171013/80201324/attachment.gz>


More information about the dri-devel mailing list