[Intel-gfx] [PATCH] drm/i915/doc: add power management section to documentation

kbuild test robot lkp at intel.com
Wed Jan 20 02:42:00 PST 2016


Hi Jani,

[auto build test WARNING on v4.4-rc8]
[also build test WARNING on next-20160120]
[if your patch is applied to the wrong git tree, please drop us a note to help improving the system]

url:    https://github.com/0day-ci/linux/commits/Jani-Nikula/drm-i915-doc-add-power-management-section-to-documentation/20160120-180543
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

   drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'wedged'
   drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'fmt'
   include/drm/drm_crtc.h:310: warning: No description found for parameter 'mode_blob'
   include/drm/drm_crtc.h:737: warning: No description found for parameter 'tile_blob_ptr'
   include/drm/drm_crtc.h:776: warning: No description found for parameter 'rotation'
   include/drm/drm_crtc.h:872: warning: No description found for parameter 'mutex'
   include/drm/drm_crtc.h:872: warning: No description found for parameter 'helper_private'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tile_idr'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'delayed_event'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'edid_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'dpms_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'path_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tile_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'plane_type_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'rotation_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_src_x'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_src_y'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_src_w'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_src_h'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_crtc_x'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_crtc_y'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_crtc_w'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_crtc_h'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_fb_id'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_crtc_id'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_active'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_mode_id'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'dvi_i_subconnector_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'dvi_i_select_subconnector_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_subconnector_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_select_subconnector_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_mode_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_left_margin_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_right_margin_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_top_margin_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_bottom_margin_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_brightness_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_contrast_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_flicker_reduction_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_overscan_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_saturation_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_hue_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'scaling_mode_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'aspect_ratio_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'dirty_info_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'suggested_x_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'suggested_y_property'
   include/drm/drm_crtc.h:1157: warning: No description found for parameter 'allow_fb_modifiers'
   include/drm/drm_fb_helper.h:148: warning: No description found for parameter 'connector_info'
   include/drm/drm_dp_helper.h:713: warning: No description found for parameter 'i2c_nack_count'
   include/drm/drm_dp_helper.h:713: warning: No description found for parameter 'i2c_defer_count'
   drivers/gpu/drm/drm_dp_mst_topology.c:2227: warning: No description found for parameter 'connector'
   include/drm/drm_dp_mst_helper.h:97: warning: No description found for parameter 'cached_edid'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'max_dpcd_transaction_bytes'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'sink_count'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'total_slots'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'avail_slots'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'total_pbn'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'qlock'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_msg_downq'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_msg_upq'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_down_in_progress'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_up_in_progress'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'payload_lock'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'proposed_vcpis'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'payloads'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'payload_mask'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'vcpi_mask'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_waitq'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'work'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_work'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'destroy_connector_list'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'destroy_connector_lock'
   include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'destroy_connector_work'
   drivers/gpu/drm/drm_dp_mst_topology.c:2227: warning: No description found for parameter 'connector'
   drivers/gpu/drm/drm_irq.c:173: warning: No description found for parameter 'flags'
   include/drm/drmP.h:168: warning: No description found for parameter 'fmt'
   include/drm/drmP.h:184: warning: No description found for parameter 'fmt'
   include/drm/drmP.h:202: warning: No description found for parameter 'fmt'
   include/drm/drmP.h:247: warning: No description found for parameter 'dev'
   include/drm/drmP.h:247: warning: No description found for parameter 'data'
   include/drm/drmP.h:247: warning: No description found for parameter 'file_priv'
   include/drm/drmP.h:280: warning: No description found for parameter 'ioctl'
   include/drm/drmP.h:280: warning: No description found for parameter '_func'
   include/drm/drmP.h:280: warning: No description found for parameter '_flags'
   include/drm/drmP.h:358: warning: cannot understand function prototype: 'struct drm_lock_data '
   include/drm/drmP.h:411: warning: cannot understand function prototype: 'struct drm_driver '
   include/drm/drmP.h:661: warning: cannot understand function prototype: 'struct drm_info_list '
   include/drm/drmP.h:671: warning: cannot understand function prototype: 'struct drm_info_node '
   include/drm/drmP.h:681: warning: cannot understand function prototype: 'struct drm_minor '
   include/drm/drmP.h:729: warning: cannot understand function prototype: 'struct drm_device '
>> drivers/gpu/drm/i915/intel_pm.c:560: warning: No description found for parameter 'fifo_size'
>> drivers/gpu/drm/i915/intel_pm.c:4128: warning: No description found for parameter 'crtc'
>> drivers/gpu/drm/i915/intel_pm.c:4153: warning: No description found for parameter 'mchdev_lock'
>> drivers/gpu/drm/i915/intel_pm.c:1: warning: no structured comments found
       Was looking for 'RC6'.
>> drivers/gpu/drm/i915/intel_pm.c:560: warning: No description found for parameter 'fifo_size'
>> drivers/gpu/drm/i915/intel_pm.c:4128: warning: No description found for parameter 'crtc'
>> drivers/gpu/drm/i915/intel_pm.c:4153: warning: No description found for parameter 'mchdev_lock'
   drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'wedged'
   drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'fmt'
   drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'wedged'
   drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'fmt'
   drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'wedged'
   drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'fmt'
   drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'wedged'
   drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'fmt'
   drivers/gpu/drm/i915/i915_gem.c:421: warning: No description found for parameter 'dev'
   drivers/gpu/drm/i915/i915_gem.c:421: warning: No description found for parameter 'data'
   drivers/gpu/drm/i915/i915_gem.c:421: warning: No description found for parameter 'file'
   drivers/gpu/drm/i915/i915_gem.c:686: warning: No description found for parameter 'dev'
   drivers/gpu/drm/i915/i915_gem.c:686: warning: No description found for parameter 'data'
   drivers/gpu/drm/i915/i915_gem.c:686: warning: No description found for parameter 'file'
   drivers/gpu/drm/i915/i915_gem.c:767: warning: No description found for parameter 'dev'
   drivers/gpu/drm/i915/i915_gem.c:767: warning: No description found for parameter 'obj'
   drivers/gpu/drm/i915/i915_gem.c:767: warning: No description found for parameter 'args'
   drivers/gpu/drm/i915/i915_gem.c:767: warning: No description found for parameter 'file'
   drivers/gpu/drm/i915/i915_gem.c:1029: warning: No description found for parameter 'dev'
   drivers/gpu/drm/i915/i915_gem.c:1029: warning: No description found for parameter 'data'
   drivers/gpu/drm/i915/i915_gem.c:1029: warning: No description found for parameter 'file'
   drivers/gpu/drm/i915/i915_gem.c:1245: warning: No description found for parameter 'rps'
   drivers/gpu/drm/i915/i915_gem.c:1459: warning: No description found for parameter 'req'
   drivers/gpu/drm/i915/i915_gem.c:1494: warning: No description found for parameter 'obj'
   drivers/gpu/drm/i915/i915_gem.c:1494: warning: No description found for parameter 'readonly'
   drivers/gpu/drm/i915/i915_gem.c:1617: warning: No description found for parameter 'dev'
   drivers/gpu/drm/i915/i915_gem.c:1617: warning: No description found for parameter 'data'
   drivers/gpu/drm/i915/i915_gem.c:1617: warning: No description found for parameter 'file'
   drivers/gpu/drm/i915/i915_gem.c:1680: warning: No description found for parameter 'dev'
   drivers/gpu/drm/i915/i915_gem.c:1680: warning: No description found for parameter 'data'
   drivers/gpu/drm/i915/i915_gem.c:1680: warning: No description found for parameter 'file'
   drivers/gpu/drm/i915/i915_gem.c:1725: warning: No description found for parameter 'dev'
   drivers/gpu/drm/i915/i915_gem.c:1725: warning: No description found for parameter 'data'
   drivers/gpu/drm/i915/i915_gem.c:1725: warning: No description found for parameter 'file'
   drivers/gpu/drm/i915/i915_gem.c:2013: warning: No description found for parameter 'dev'
   drivers/gpu/drm/i915/i915_gem.c:2013: warning: No description found for parameter 'size'
   drivers/gpu/drm/i915/i915_gem.c:2013: warning: No description found for parameter 'tiling_mode'
   drivers/gpu/drm/i915/i915_gem.c:2013: warning: No description found for parameter 'fenced'
   drivers/gpu/drm/i915/i915_gem.c:2013: warning: Excess function parameter 'obj' description in 'i915_gem_get_gtt_alignment'
   drivers/gpu/drm/i915/i915_gem.c:2876: warning: No description found for parameter 'ring'
   drivers/gpu/drm/i915/i915_gem.c:3005: warning: No description found for parameter 'obj'
   drivers/gpu/drm/i915/i915_gem.c:3055: warning: No description found for parameter 'dev'
   drivers/gpu/drm/i915/i915_gem.c:3055: warning: No description found for parameter 'data'
   drivers/gpu/drm/i915/i915_gem.c:3055: warning: No description found for parameter 'file'
   drivers/gpu/drm/i915/i915_gem.c:3055: warning: Excess function parameter 'DRM_IOCTL_ARGS' description in 'i915_gem_wait_ioctl'
   drivers/gpu/drm/i915/i915_gem.c:3424: warning: No description found for parameter 'obj'
   drivers/gpu/drm/i915/i915_gem.c:3424: warning: No description found for parameter 'vm'
   drivers/gpu/drm/i915/i915_gem.c:3424: warning: No description found for parameter 'ggtt_view'
   drivers/gpu/drm/i915/i915_gem.c:3424: warning: No description found for parameter 'alignment'
   drivers/gpu/drm/i915/i915_gem.c:3424: warning: No description found for parameter 'flags'
   drivers/gpu/drm/i915/i915_gem.c:3659: warning: No description found for parameter 'obj'
   drivers/gpu/drm/i915/i915_gem.c:3659: warning: No description found for parameter 'write'
   drivers/gpu/drm/i915/i915_gem.c:3734: warning: No description found for parameter 'obj'
   drivers/gpu/drm/i915/i915_gem.c:3734: warning: No description found for parameter 'cache_level'
   drivers/gpu/drm/i915/i915_gem.c:4014: warning: No description found for parameter 'obj'
   drivers/gpu/drm/i915/i915_gem.c:4014: warning: No description found for parameter 'write'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: No description found for parameter 'params'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'dev' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'file' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'ring' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'ctx' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'batch_obj' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'exec_start' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'dispatch_flags' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: No description found for parameter 'params'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'dev' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'file' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'ring' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'ctx' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'batch_obj' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'exec_start' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'dispatch_flags' description in 'intel_execlists_submission'
   drivers/gpu/drm/i915/intel_guc_loader.c:1: warning: no structured comments found
       Was looking for 'GuC-specific firmware loader'.
   drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: No description found for parameter 'rq'
   drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: Excess function parameter 'ctx' description in 'i915_guc_submit'
   drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: Excess function parameter 'ring' description in 'i915_guc_submit'
   drivers/gpu/drm/i915/i915_guc_submission.c:741: warning: No description found for parameter 'ctx'
   drivers/gpu/drm/i915/i915_guc_submission.c:1: warning: no structured comments found
       Was looking for 'GuC-based command submissison'.
   drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: No description found for parameter 'rq'
   drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: Excess function parameter 'ctx' description in 'i915_guc_submit'
   drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: Excess function parameter 'ring' description in 'i915_guc_submit'
   drivers/gpu/drm/i915/i915_guc_submission.c:741: warning: No description found for parameter 'ctx'
   Warning: didn't use docs for i915_hotplug_interrupt_update
   Warning: didn't use docs for ilk_update_display_irq
   Warning: didn't use docs for ilk_update_gt_irq
   Warning: didn't use docs for snb_update_pm_irq
   Warning: didn't use docs for bdw_update_port_irq
   Warning: didn't use docs for ibx_display_interrupt_update
   Warning: didn't use docs for i915_enable_asle_pipestat
   Warning: didn't use docs for ivybridge_parity_work
   Warning: didn't use docs for i915_reset_and_wakeup
   Warning: didn't use docs for i915_handle_error
   Warning: didn't use docs for intel_irq_install
   Warning: didn't use docs for intel_irq_uninstall

vim +/fifo_size +560 drivers/gpu/drm/i915/intel_pm.c

b445e3b0 Eugeni Dodonov 2012-04-16  544   * Calculate the watermark level (the level at which the display plane will
b445e3b0 Eugeni Dodonov 2012-04-16  545   * start fetching from memory again).  Each chip has a different display
b445e3b0 Eugeni Dodonov 2012-04-16  546   * FIFO size and allocation, so the caller needs to figure that out and pass
b445e3b0 Eugeni Dodonov 2012-04-16  547   * in the correct intel_watermark_params structure.
b445e3b0 Eugeni Dodonov 2012-04-16  548   *
b445e3b0 Eugeni Dodonov 2012-04-16  549   * As the pixel clock runs, the FIFO will be drained at a rate that depends
b445e3b0 Eugeni Dodonov 2012-04-16  550   * on the pixel size.  When it reaches the watermark level, it'll start
b445e3b0 Eugeni Dodonov 2012-04-16  551   * fetching FIFO line sized based chunks from memory until the FIFO fills
b445e3b0 Eugeni Dodonov 2012-04-16  552   * past the watermark point.  If the FIFO drains completely, a FIFO underrun
b445e3b0 Eugeni Dodonov 2012-04-16  553   * will occur, and a display engine hang could result.
b445e3b0 Eugeni Dodonov 2012-04-16  554   */
b445e3b0 Eugeni Dodonov 2012-04-16  555  static unsigned long intel_calculate_wm(unsigned long clock_in_khz,
b445e3b0 Eugeni Dodonov 2012-04-16  556  					const struct intel_watermark_params *wm,
b445e3b0 Eugeni Dodonov 2012-04-16  557  					int fifo_size,
b445e3b0 Eugeni Dodonov 2012-04-16  558  					int pixel_size,
b445e3b0 Eugeni Dodonov 2012-04-16  559  					unsigned long latency_ns)
b445e3b0 Eugeni Dodonov 2012-04-16 @560  {
b445e3b0 Eugeni Dodonov 2012-04-16  561  	long entries_required, wm_size;
b445e3b0 Eugeni Dodonov 2012-04-16  562  
b445e3b0 Eugeni Dodonov 2012-04-16  563  	/*
b445e3b0 Eugeni Dodonov 2012-04-16  564  	 * Note: we need to make sure we don't overflow for various clock &
b445e3b0 Eugeni Dodonov 2012-04-16  565  	 * latency values.
b445e3b0 Eugeni Dodonov 2012-04-16  566  	 * clocks go from a few thousand to several hundred thousand.
b445e3b0 Eugeni Dodonov 2012-04-16  567  	 * latency is usually a few thousand
b445e3b0 Eugeni Dodonov 2012-04-16  568  	 */

:::::: The code at line 560 was first introduced by commit
:::::: b445e3b013adfcb05322ebde7fb16488f0644579 drm/i915: move watermarks settings into intel_pm module

:::::: TO: Eugeni Dodonov <eugeni.dodonov at intel.com>
:::::: 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/octet-stream
Size: 6125 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/intel-gfx/attachments/20160120/723e623f/attachment-0001.obj>


More information about the Intel-gfx mailing list