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@bwidawsk.net :::::: CC: Daniel Vetter daniel.vetter@ffwll.ch

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