[drm-intel:drm-intel-next-queued 1/1] htmldocs: drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'i915'

kbuild test robot fengguang.wu at intel.com
Fri Dec 9 13:31:47 UTC 2016


tree:   git://anongit.freedesktop.org/drm-intel drm-intel-next-queued
head:   16d98b31f807756269106f9a71b1a3dc0d19c629
commit: 16d98b31f807756269106f9a71b1a3dc0d19c629 [1/1] drm/i915/perf: More documentation hooked to i915.rst
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

   make[3]: warning: jobserver unavailable: using -j1.  Add '+' to parent make rule.
   include/linux/init.h:1: warning: no structured comments found
   include/linux/workqueue.h:392: warning: No description found for parameter '...'
   include/linux/workqueue.h:392: warning: Excess function parameter 'args' description in 'alloc_workqueue'
   include/linux/workqueue.h:413: warning: No description found for parameter '...'
   include/linux/workqueue.h:413: warning: Excess function parameter 'args' description in 'alloc_ordered_workqueue'
   include/linux/kthread.h:26: warning: No description found for parameter '...'
   kernel/sys.c:1: warning: no structured comments found
   drivers/dma-buf/seqno-fence.c:1: warning: no structured comments found
   include/sound/core.h:324: warning: No description found for parameter '...'
   include/sound/core.h:335: warning: No description found for parameter '...'
   include/sound/core.h:388: warning: No description found for parameter '...'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'load'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'firstopen'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'open'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'preclose'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'postclose'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'lastclose'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'unload'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'dma_ioctl'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'dma_quiescent'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'context_dtor'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'set_busid'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'irq_handler'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'irq_preinstall'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'irq_postinstall'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'irq_uninstall'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'debugfs_init'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'debugfs_cleanup'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_open_object'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_close_object'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'prime_handle_to_fd'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'prime_fd_to_handle'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_prime_export'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_prime_import'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_prime_pin'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_prime_unpin'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_prime_res_obj'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_prime_get_sg_table'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_prime_import_sg_table'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_prime_vmap'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_prime_vunmap'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_prime_mmap'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'vgaarb_irq'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'gem_vm_ops'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'major'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'minor'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'patchlevel'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'name'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'desc'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'date'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'driver_features'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'dev_priv_size'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'ioctls'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'num_ioctls'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'fops'
   include/drm/drm_drv.h:409: warning: No description found for parameter 'legacy_dev_list'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'i915'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'pid'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'name'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'hw_id'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'priority'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'ggtt_alignment'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'engine[I915_NUM_ENGINES]'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'ring_size'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'desc_template'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'status_notifier'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'execlists_force_single_submission'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'closed'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'bannable'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'banned'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'guilty_count'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'active_count'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: No description found for parameter 'ban_score'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: Excess struct/union/enum/typedef member 'hang_stats' description in 'i915_gem_context'
>> drivers/gpu/drm/i915/i915_drv.h:1106: warning: Excess struct/union/enum/typedef member 'legacy_hw_ctx' description in 'i915_gem_context'
>> drivers/gpu/drm/i915/i915_drv.h:1190: warning: cannot understand function prototype: 'enum drrs_refresh_rate_type '

vim +/i915 +1106 drivers/gpu/drm/i915/i915_drv.h

bc1d53c6 Mika Kuoppala  2016-11-16  1100  	unsigned int active_count; /* active during hang */
bc1d53c6 Mika Kuoppala  2016-11-16  1101  
bc1d53c6 Mika Kuoppala  2016-11-16  1102  #define CONTEXT_SCORE_GUILTY		10
bc1d53c6 Mika Kuoppala  2016-11-16  1103  #define CONTEXT_SCORE_BAN_THRESHOLD	40
bc1d53c6 Mika Kuoppala  2016-11-16  1104  	/* Accumulated score of hangs caused by this context */
bc1d53c6 Mika Kuoppala  2016-11-16  1105  	int ban_score;
40521054 Ben Widawsky   2012-06-04 @1106  };
40521054 Ben Widawsky   2012-06-04  1107  
a4001f1b Paulo Zanoni   2015-02-13  1108  enum fb_op_origin {
a4001f1b Paulo Zanoni   2015-02-13  1109  	ORIGIN_GTT,
a4001f1b Paulo Zanoni   2015-02-13  1110  	ORIGIN_CPU,
a4001f1b Paulo Zanoni   2015-02-13  1111  	ORIGIN_CS,
a4001f1b Paulo Zanoni   2015-02-13  1112  	ORIGIN_FLIP,
74b4ea1e Paulo Zanoni   2015-07-14  1113  	ORIGIN_DIRTYFB,
a4001f1b Paulo Zanoni   2015-02-13  1114  };
a4001f1b Paulo Zanoni   2015-02-13  1115  
ab34a7e8 Paulo Zanoni   2016-01-11  1116  struct intel_fbc {
25ad93fd Paulo Zanoni   2015-07-02  1117  	/* This is always the inner lock when overlapping with struct_mutex and
25ad93fd Paulo Zanoni   2015-07-02  1118  	 * it's the outer lock when overlapping with stolen_lock. */
25ad93fd Paulo Zanoni   2015-07-02  1119  	struct mutex lock;
5e59f717 Ben Widawsky   2014-06-30  1120  	unsigned threshold;
dbef0f15 Paulo Zanoni   2015-02-13  1121  	unsigned int possible_framebuffer_bits;
dbef0f15 Paulo Zanoni   2015-02-13  1122  	unsigned int busy_bits;
010cf73d Paulo Zanoni   2016-01-19  1123  	unsigned int visible_pipes_mask;
e35fef21 Paulo Zanoni   2015-02-09  1124  	struct intel_crtc *crtc;
5c3fe8b0 Ben Widawsky   2013-06-27  1125  
c4213885 Ben Widawsky   2014-06-19  1126  	struct drm_mm_node compressed_fb;
5c3fe8b0 Ben Widawsky   2013-06-27  1127  	struct drm_mm_node *compressed_llb;
5c3fe8b0 Ben Widawsky   2013-06-27  1128  
da46f936 Rodrigo Vivi   2014-08-01  1129  	bool false_color;
da46f936 Rodrigo Vivi   2014-08-01  1130  
d029bcad Paulo Zanoni   2015-10-15  1131  	bool enabled;
0e631adc Paulo Zanoni   2015-10-14  1132  	bool active;
9adccc60 Paulo Zanoni   2014-09-19  1133  
61a585d6 Paulo Zanoni   2016-09-13  1134  	bool underrun_detected;
61a585d6 Paulo Zanoni   2016-09-13  1135  	struct work_struct underrun_work;
61a585d6 Paulo Zanoni   2016-09-13  1136  
aaf78d27 Paulo Zanoni   2016-01-19  1137  	struct intel_fbc_state_cache {
aaf78d27 Paulo Zanoni   2016-01-19  1138  		struct {
aaf78d27 Paulo Zanoni   2016-01-19  1139  			unsigned int mode_flags;
aaf78d27 Paulo Zanoni   2016-01-19  1140  			uint32_t hsw_bdw_pixel_rate;
aaf78d27 Paulo Zanoni   2016-01-19  1141  		} crtc;
aaf78d27 Paulo Zanoni   2016-01-19  1142  
aaf78d27 Paulo Zanoni   2016-01-19  1143  		struct {
aaf78d27 Paulo Zanoni   2016-01-19  1144  			unsigned int rotation;
aaf78d27 Paulo Zanoni   2016-01-19  1145  			int src_w;
aaf78d27 Paulo Zanoni   2016-01-19  1146  			int src_h;
aaf78d27 Paulo Zanoni   2016-01-19  1147  			bool visible;
aaf78d27 Paulo Zanoni   2016-01-19  1148  		} plane;
aaf78d27 Paulo Zanoni   2016-01-19  1149  
aaf78d27 Paulo Zanoni   2016-01-19  1150  		struct {
aaf78d27 Paulo Zanoni   2016-01-19  1151  			u64 ilk_ggtt_offset;
aaf78d27 Paulo Zanoni   2016-01-19  1152  			uint32_t pixel_format;
aaf78d27 Paulo Zanoni   2016-01-19  1153  			unsigned int stride;
aaf78d27 Paulo Zanoni   2016-01-19  1154  			int fence_reg;
aaf78d27 Paulo Zanoni   2016-01-19  1155  			unsigned int tiling_mode;
aaf78d27 Paulo Zanoni   2016-01-19  1156  		} fb;
aaf78d27 Paulo Zanoni   2016-01-19  1157  	} state_cache;
aaf78d27 Paulo Zanoni   2016-01-19  1158  
b183b3f1 Paulo Zanoni   2015-12-23  1159  	struct intel_fbc_reg_params {
b183b3f1 Paulo Zanoni   2015-12-23  1160  		struct {
b183b3f1 Paulo Zanoni   2015-12-23  1161  			enum pipe pipe;
b183b3f1 Paulo Zanoni   2015-12-23  1162  			enum plane plane;
b183b3f1 Paulo Zanoni   2015-12-23  1163  			unsigned int fence_y_offset;
b183b3f1 Paulo Zanoni   2015-12-23  1164  		} crtc;
b183b3f1 Paulo Zanoni   2015-12-23  1165  
b183b3f1 Paulo Zanoni   2015-12-23  1166  		struct {
b183b3f1 Paulo Zanoni   2015-12-23  1167  			u64 ggtt_offset;
b183b3f1 Paulo Zanoni   2015-12-23  1168  			uint32_t pixel_format;
b183b3f1 Paulo Zanoni   2015-12-23  1169  			unsigned int stride;
b183b3f1 Paulo Zanoni   2015-12-23  1170  			int fence_reg;
b183b3f1 Paulo Zanoni   2015-12-23  1171  		} fb;
b183b3f1 Paulo Zanoni   2015-12-23  1172  
b183b3f1 Paulo Zanoni   2015-12-23  1173  		int cfb_size;
b183b3f1 Paulo Zanoni   2015-12-23  1174  	} params;
b183b3f1 Paulo Zanoni   2015-12-23  1175  
5c3fe8b0 Ben Widawsky   2013-06-27  1176  	struct intel_fbc_work {
128d7356 Paulo Zanoni   2015-10-26  1177  		bool scheduled;
ca18d51d Paulo Zanoni   2016-01-21  1178  		u32 scheduled_vblank;
128d7356 Paulo Zanoni   2015-10-26  1179  		struct work_struct work;
128d7356 Paulo Zanoni   2015-10-26  1180  	} work;
5c3fe8b0 Ben Widawsky   2013-06-27  1181  
bf6189c6 Paulo Zanoni   2015-10-27  1182  	const char *no_fbc_reason;
b5e50c3f Jesse Barnes   2010-02-05  1183  };
b5e50c3f Jesse Barnes   2010-02-05  1184  
96178eeb Vandana Kannan 2015-01-10  1185  /**
96178eeb Vandana Kannan 2015-01-10  1186   * HIGH_RR is the highest eDP panel refresh rate read from EDID
96178eeb Vandana Kannan 2015-01-10  1187   * LOW_RR is the lowest eDP panel refresh rate found from EDID
96178eeb Vandana Kannan 2015-01-10  1188   * parsing for same resolution.
96178eeb Vandana Kannan 2015-01-10  1189   */
96178eeb Vandana Kannan 2015-01-10 @1190  enum drrs_refresh_rate_type {
96178eeb Vandana Kannan 2015-01-10  1191  	DRRS_HIGH_RR,
96178eeb Vandana Kannan 2015-01-10  1192  	DRRS_LOW_RR,
96178eeb Vandana Kannan 2015-01-10  1193  	DRRS_MAX_RR, /* RR count */

:::::: The code at line 1106 was first introduced by commit
:::::: 40521054fd46f94e0368cead312d56e9e442aaab drm/i915: context basic create & destroy

:::::: TO: Ben Widawsky <ben at bwidawsk.net>
:::::: CC: Daniel Vetter <daniel.vetter at ffwll.ch>

---
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: 6425 bytes
Desc: not available
URL: <https://lists.freedesktop.org/archives/dri-devel/attachments/20161209/4b507515/attachment-0001.gz>


More information about the dri-devel mailing list