[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