Hi Lionel,

Thank you for the patch! Perhaps something to improve:

[auto build test WARNING on drm-intel/for-linux-next]
[cannot apply to v5.3-rc6 next-20190827]
[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/Lionel-Landwerlin/drm-i915-Vulkan-performance-query-support/20190829-020841
base:   git://anongit.freedesktop.org/drm-intel for-linux-next
reproduce: make htmldocs

If you fix the issue, kindly add following tag
Reported-by: kbuild test robot <l...@intel.com>

All warnings (new ones prefixed by >>):

   fs/direct-io.c:258: warning: Excess function parameter 'offset' description 
in 'dio_complete'
   fs/libfs.c:496: warning: Excess function parameter 'available' description 
in 'simple_write_end'
   fs/posix_acl.c:647: warning: Function parameter or member 'inode' not 
described in 'posix_acl_update_mode'
   fs/posix_acl.c:647: warning: Function parameter or member 'mode_p' not 
described in 'posix_acl_update_mode'
   fs/posix_acl.c:647: warning: Function parameter or member 'acl' not 
described in 'posix_acl_update_mode'
   mm/util.c:1: warning: 'get_user_pages_fast' not found
   mm/slab.c:4215: warning: Function parameter or member 'objp' not described 
in '__ksize'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'dev_scratch' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'list' not 
described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'ip_defrag_offset' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'skb_mstamp_ns' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'__cloned_offset' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'head_frag' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'__pkt_type_offset' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'encapsulation' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'encap_hdr_csum' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'csum_valid' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'__pkt_vlan_present_offset' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'vlan_present' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'csum_complete_sw' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'csum_level' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'inner_protocol_type' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'remcsum_offload' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'sender_cpu' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'reserved_tailroom' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 
'inner_ipproto' not described in 'sk_buff'
   include/net/sock.h:233: warning: Function parameter or member 'skc_addrpair' 
not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_portpair' 
not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_ipv6only' 
not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 
'skc_net_refcnt' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_v6_daddr' 
not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 
'skc_v6_rcv_saddr' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_cookie' 
not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_listener' 
not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_tw_dr' 
not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_rcv_wnd' 
not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 
'skc_tw_rcv_nxt' not described in 'sock_common'
   include/net/sock.h:515: warning: Function parameter or member 
'sk_rx_skb_cache' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 'sk_wq_raw' 
not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 
'tcp_rtx_queue' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 
'sk_tx_skb_cache' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 
'sk_route_forced_caps' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 
'sk_txtime_report_errors' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 
'sk_validate_xmit_skb' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 
'sk_bpf_storage' not described in 'sock'
   include/net/sock.h:2439: warning: Function parameter or member 
'tcp_rx_skb_cache_key' not described in 'DECLARE_STATIC_KEY_FALSE'
   include/net/sock.h:2439: warning: Excess function parameter 'sk' description 
in 'DECLARE_STATIC_KEY_FALSE'
   include/net/sock.h:2439: warning: Excess function parameter 'skb' 
description in 'DECLARE_STATIC_KEY_FALSE'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'gso_partial_features' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'l3mdev_ops' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'xfrmdev_ops' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'tlsdev_ops' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'name_assign_type' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'ieee802154_ptr' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'mpls_ptr' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'xdp_prog' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'gro_flush_timeout' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'nf_hooks_ingress' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'____cacheline_aligned_in_smp' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'qdisc_hash' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'xps_cpus_map' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 
'xps_rxqs_map' not described in 'net_device'
   include/linux/phylink.h:56: warning: Function parameter or member 
'__ETHTOOL_DECLARE_LINK_MODE_MASK(advertising' not described in 
'phylink_link_state'
   include/linux/phylink.h:56: warning: Function parameter or member 
'__ETHTOOL_DECLARE_LINK_MODE_MASK(lp_advertising' not described in 
'phylink_link_state'
   drivers/net/phy/phylink.c:593: warning: Function parameter or member 
'config' not described in 'phylink_create'
   drivers/net/phy/phylink.c:593: warning: Excess function parameter 'ndev' 
description in 'phylink_create'
   lib/genalloc.c:1: warning: 'gen_pool_add_virt' not found
   lib/genalloc.c:1: warning: 'gen_pool_alloc' not found
   lib/genalloc.c:1: warning: 'gen_pool_free' not found
   lib/genalloc.c:1: warning: 'gen_pool_alloc_algo' not found
   include/drm/drm_modeset_helper_vtables.h:1053: warning: Function parameter 
or member 'prepare_writeback_job' not described in 'drm_connector_helper_funcs'
   include/drm/drm_modeset_helper_vtables.h:1053: warning: Function parameter 
or member 'cleanup_writeback_job' not described in 'drm_connector_helper_funcs'
   include/drm/drm_atomic_state_helper.h:1: warning: no structured comments 
found
   include/drm/drm_gem_shmem_helper.h:87: warning: Function parameter or member 
'madv' not described in 'drm_gem_shmem_object'
   include/drm/drm_gem_shmem_helper.h:87: warning: Function parameter or member 
'madv_list' not described in 'drm_gem_shmem_object'
   drivers/gpu/drm/i915/display/intel_dpll_mgr.h:158: warning: Enum value 
'DPLL_ID_TGL_MGPLL5' not described in enum 'intel_dpll_id'
   drivers/gpu/drm/i915/display/intel_dpll_mgr.h:158: warning: Enum value 
'DPLL_ID_TGL_MGPLL6' not described in enum 'intel_dpll_id'
   drivers/gpu/drm/i915/display/intel_dpll_mgr.h:158: warning: Excess enum 
value 'DPLL_ID_TGL_TCPLL5' description in 'intel_dpll_id'
   drivers/gpu/drm/i915/display/intel_dpll_mgr.h:158: warning: Excess enum 
value 'DPLL_ID_TGL_TCPLL6' description in 'intel_dpll_id'
   drivers/gpu/drm/i915/display/intel_dpll_mgr.h:342: warning: Function 
parameter or member 'wakeref' not described in 'intel_shared_dpll'
   Error: Cannot open file drivers/gpu/drm/i915/i915_gem_batch_pool.c
   Error: Cannot open file drivers/gpu/drm/i915/i915_gem_batch_pool.c
   Error: Cannot open file drivers/gpu/drm/i915/i915_gem_batch_pool.c
   drivers/gpu/drm/i915/i915_drv.h:1142: warning: Incorrect use of kernel-doc 
format:          * The OA context specific information.
   drivers/gpu/drm/i915/i915_drv.h:1156: warning: Incorrect use of kernel-doc 
format:          * State of the OA buffer.
   drivers/gpu/drm/i915/i915_drv.h:1167: warning: Incorrect use of kernel-doc 
format:                  * Locks reads and writes to all head/tail state
   drivers/gpu/drm/i915/i915_drv.h:1189: warning: Incorrect use of kernel-doc 
format:                  * One 'aging' tail pointer and one 'aged' tail pointer 
ready to
   drivers/gpu/drm/i915/i915_drv.h:1201: warning: Incorrect use of kernel-doc 
format:                  * Index for the aged tail ready to read() data up to.
   drivers/gpu/drm/i915/i915_drv.h:1206: warning: Incorrect use of kernel-doc 
format:                  * A monotonic timestamp for when the current aging 
tail pointer
   drivers/gpu/drm/i915/i915_drv.h:1212: warning: Incorrect use of kernel-doc 
format:                  * Although we can always read back the head pointer 
register,
   drivers/gpu/drm/i915/i915_drv.h:1222: warning: Incorrect use of kernel-doc 
format:          * A batch buffer doing a wait on the GPU for the NOA logic to 
be
   drivers/gpu/drm/i915/i915_drv.h:1226: warning: Function parameter or member 
'pinned_ctx' not described in 'i915_perf_stream'
   drivers/gpu/drm/i915/i915_drv.h:1226: warning: Function parameter or member 
'specific_ctx_id' not described in 'i915_perf_stream'
   drivers/gpu/drm/i915/i915_drv.h:1226: warning: Function parameter or member 
'specific_ctx_id_mask' not described in 'i915_perf_stream'
   drivers/gpu/drm/i915/i915_drv.h:1226: warning: Function parameter or member 
'poll_check_timer' not described in 'i915_perf_stream'
   drivers/gpu/drm/i915/i915_drv.h:1226: warning: Function parameter or member 
'poll_wq' not described in 'i915_perf_stream'
   drivers/gpu/drm/i915/i915_drv.h:1226: warning: Function parameter or member 
'pollin' not described in 'i915_perf_stream'
   drivers/gpu/drm/i915/i915_drv.h:1226: warning: Function parameter or member 
'periodic' not described in 'i915_perf_stream'
   drivers/gpu/drm/i915/i915_drv.h:1226: warning: Function parameter or member 
'period_exponent' not described in 'i915_perf_stream'
   drivers/gpu/drm/i915/i915_drv.h:1226: warning: Function parameter or member 
'oa_buffer' not described in 'i915_perf_stream'
>> drivers/gpu/drm/i915/i915_drv.h:1226: warning: Function parameter or member 
>> 'noa_wait' not described in 'i915_perf_stream'
   drivers/gpu/drm/i915/i915_drv.h:1142: warning: Incorrect use of kernel-doc 
format:          * The OA context specific information.
   drivers/gpu/drm/i915/i915_drv.h:1156: warning: Incorrect use of kernel-doc 
format:          * State of the OA buffer.
   drivers/gpu/drm/i915/i915_drv.h:1167: warning: Incorrect use of kernel-doc 
format:                  * Locks reads and writes to all head/tail state
   drivers/gpu/drm/i915/i915_drv.h:1189: warning: Incorrect use of kernel-doc 
format:                  * One 'aging' tail pointer and one 'aged' tail pointer 
ready to
   drivers/gpu/drm/i915/i915_drv.h:1201: warning: Incorrect use of kernel-doc 
format:                  * Index for the aged tail ready to read() data up to.
   drivers/gpu/drm/i915/i915_drv.h:1206: warning: Incorrect use of kernel-doc 
format:                  * A monotonic timestamp for when the current aging 
tail pointer
   drivers/gpu/drm/i915/i915_drv.h:1212: warning: Incorrect use of kernel-doc 
format:                  * Although we can always read back the head pointer 
register,
   drivers/gpu/drm/i915/i915_drv.h:1222: warning: Incorrect use of kernel-doc 
format:          * A batch buffer doing a wait on the GPU for the NOA logic to 
be
   drivers/gpu/drm/i915/i915_drv.h:1142: warning: Incorrect use of kernel-doc 
format:          * The OA context specific information.
   drivers/gpu/drm/i915/i915_drv.h:1156: warning: Incorrect use of kernel-doc 
format:          * State of the OA buffer.
   drivers/gpu/drm/i915/i915_drv.h:1167: warning: Incorrect use of kernel-doc 
format:                  * Locks reads and writes to all head/tail state
   drivers/gpu/drm/i915/i915_drv.h:1189: warning: Incorrect use of kernel-doc 
format:                  * One 'aging' tail pointer and one 'aged' tail pointer 
ready to
   drivers/gpu/drm/i915/i915_drv.h:1201: warning: Incorrect use of kernel-doc 
format:                  * Index for the aged tail ready to read() data up to.
   drivers/gpu/drm/i915/i915_drv.h:1206: warning: Incorrect use of kernel-doc 
format:                  * A monotonic timestamp for when the current aging 
tail pointer
   drivers/gpu/drm/i915/i915_drv.h:1212: warning: Incorrect use of kernel-doc 
format:                  * Although we can always read back the head pointer 
register,
   drivers/gpu/drm/i915/i915_drv.h:1222: warning: Incorrect use of kernel-doc 
format:          * A batch buffer doing a wait on the GPU for the NOA logic to 
be
   drivers/gpu/drm/mcde/mcde_drv.c:1: warning: 'ST-Ericsson MCDE DRM Driver' 
not found
   include/net/cfg80211.h:1092: warning: Function parameter or member 'txpwr' 
not described in 'station_parameters'
   include/net/mac80211.h:4043: warning: Function parameter or member 
'sta_set_txpwr' not described in 'ieee80211_ops'
   include/net/mac80211.h:2006: warning: Function parameter or member 'txpwr' 
not described in 'ieee80211_sta'
   Documentation/index.rst:94: WARNING: toctree contains reference to 
nonexisting document 'virtual/index'
   Documentation/admin-guide/xfs.rst:257: WARNING: Block quote ends without a 
blank line; unexpected unindent.
   Documentation/crypto/crypto_engine.rst:2: WARNING: Explicit markup ends 
without a blank line; unexpected unindent.
   Documentation/trace/kprobetrace.rst:99: WARNING: Explicit markup ends 
without a blank line; unexpected unindent.
   WARNING: kernel-doc 'scripts/kernel-doc -rst -enable-lineno -function 
Reservation Object Overview drivers/dma-buf/reservation.c' failed with return 
code 1
   WARNING: kernel-doc 'scripts/kernel-doc -rst -enable-lineno -export 
drivers/dma-buf/reservation.c' failed with return code 2
   WARNING: kernel-doc 'scripts/kernel-doc -rst -enable-lineno -internal 
include/linux/reservation.h' failed with return code 2
   Documentation/translations/it_IT/process/maintainer-pgp-guide.rst:458: 
WARNING: Unknown target name: "nitrokey pro".
   Documentation/kbuild/makefiles.rst:1142: WARNING: Inline emphasis 
start-string without end-string.
   Documentation/kbuild/makefiles.rst:1152: WARNING: Inline emphasis 
start-string without end-string.
   Documentation/kbuild/makefiles.rst:1154: WARNING: Inline emphasis 
start-string without end-string.
   Documentation/security/keys/core.rst:1110: WARNING: Inline emphasis 
start-string without end-string.
   Documentation/security/keys/core.rst:1110: WARNING: Inline emphasis 
start-string without end-string.
   Documentation/security/keys/core.rst:1108: WARNING: Inline emphasis 
start-string without end-string.
   Documentation/security/keys/core.rst:1108: WARNING: Inline emphasis 
start-string without end-string.
   Documentation/security/keys/core.rst:1108: WARNING: Inline emphasis 
start-string without end-string.
   include/uapi/linux/firewire-cdev.h:312: WARNING: Inline literal start-string 
without end-string.
   drivers/firewire/core-transaction.c:606: WARNING: Inline strong start-string 
without end-string.
   drivers/message/fusion/mptbase.c:5057: WARNING: Definition list ends without 
a blank line; unexpected unindent.
   drivers/tty/serial/serial_core.c:1964: WARNING: Definition list ends without 
a blank line; unexpected unindent.
   drivers/gpu/drm/amd/amdgpu/amdgpu_drv.c:245: WARNING: Unexpected indentation.
   drivers/gpu/drm/amd/amdgpu/amdgpu_drv.c:248: WARNING: Block quote ends 
without a blank line; unexpected unindent.
   drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c:211: WARNING: Unexpected indentation.
   drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c:222: WARNING: Unexpected indentation.
   drivers/gpu/drm/amd/amdgpu/amdgpu_pm.c:2199: WARNING: Inline emphasis 
start-string without end-string.
   drivers/gpu/drm/amd/amdgpu/amdgpu_pm.c:2201: WARNING: Inline emphasis 
start-string without end-string.
   include/linux/regulator/driver.h:284: WARNING: Unknown target name: 
"regulator_regmap_x_voltage".
   include/linux/i2c.h:522: WARNING: Inline strong start-string without 
end-string.
   include/linux/spi/spi.h:382: WARNING: Unexpected indentation.
   drivers/ata/libata-core.c:5945: WARNING: Unknown target name: "hw".
   fs/seq_file.c:40: WARNING: Inline strong start-string without end-string.
   fs/seq_file.c:40: WARNING: Inline strong start-string without end-string.
   fs/seq_file.c:40: WARNING: Inline strong start-string without end-string.
   fs/seq_file.c:40: WARNING: Inline strong start-string without end-string.
   fs/posix_acl.c:636: WARNING: Inline emphasis start-string without end-string.
   fs/debugfs/inode.c:399: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/inode.c:478: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/inode.c:510: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/inode.c:603: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:394: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:400: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:439: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:445: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:484: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:490: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:530: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:536: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:578: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:584: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:845: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:851: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:898: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:904: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:1090: WARNING: Inline literal start-string without 
end-string.
   fs/debugfs/file.c:1096: WARNING: Inline literal start-string without 
end-string.
   include/linux/xarray.h:232: WARNING: Unexpected indentation.
   include/linux/netdevice.h:3482: WARNING: Inline emphasis start-string 
without end-string.
   include/linux/netdevice.h:3482: WARNING: Inline emphasis start-string 
without end-string.
   net/core/dev.c:5008: WARNING: Unknown target name: "page_is".
   WARNING: kernel-doc 'scripts/kernel-doc -rst -enable-lineno -function batch 
pool drivers/gpu/drm/i915/i915_gem_batch_pool.c' failed with return code 1
   WARNING: kernel-doc 'scripts/kernel-doc -rst -enable-lineno -internal 
drivers/gpu/drm/i915/i915_gem_batch_pool.c' failed with return code 2
   Documentation/virt/index.rst: WARNING: document isn't included in any toctree
   include/linux/slab.h:500: WARNING: undefined label: memory-allocation (if 
the link has no caption the label must precede a section header)
   Documentation/gpu/drm-internals.rst:302: WARNING: Could not lex 
literal_block as "c". Highlighting skipped.
   WARNING: LaTeX command 'latex' cannot be run (needed for math display), 
check the imgmath_latex setting
   WARNING: LaTeX command 'latex' cannot be run (needed for math display), 
check the imgmath_latex setting
   Documentation/trace/kprobetrace.rst:68: WARNING: undefined label: 
user_mem_access (if the link has no caption the label must precede a section 
header)
   WARNING: LaTeX command 'latex' cannot be run (needed for math display), 
check the imgmath_latex setting

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

eec688e1420da5 Robert Bragg          2016-11-07  1076  
16d98b31f80775 Robert Bragg          2016-12-07  1077  /**
16d98b31f80775 Robert Bragg          2016-12-07  1078   * struct 
i915_perf_stream - state for a single open stream FD
16d98b31f80775 Robert Bragg          2016-12-07  1079   */
eec688e1420da5 Robert Bragg          2016-11-07  1080  struct i915_perf_stream {
16d98b31f80775 Robert Bragg          2016-12-07  1081   /**
16d98b31f80775 Robert Bragg          2016-12-07  1082    * @dev_priv: i915 drm 
device
16d98b31f80775 Robert Bragg          2016-12-07  1083    */
eec688e1420da5 Robert Bragg          2016-11-07  1084   struct drm_i915_private 
*dev_priv;
eec688e1420da5 Robert Bragg          2016-11-07  1085  
16d98b31f80775 Robert Bragg          2016-12-07  1086   /**
16d98b31f80775 Robert Bragg          2016-12-07  1087    * @link: Links the 
stream into ``&drm_i915_private->streams``
16d98b31f80775 Robert Bragg          2016-12-07  1088    */
eec688e1420da5 Robert Bragg          2016-11-07  1089   struct list_head link;
eec688e1420da5 Robert Bragg          2016-11-07  1090  
6d2438c8233bd0 Chris Wilson          2019-01-15  1091   /**
6d2438c8233bd0 Chris Wilson          2019-01-15  1092    * @wakeref: As we keep 
the device awake while the perf stream is
6d2438c8233bd0 Chris Wilson          2019-01-15  1093    * active, we track our 
runtime pm reference for later release.
6d2438c8233bd0 Chris Wilson          2019-01-15  1094    */
6619c0075f784d Chris Wilson          2019-01-14  1095   intel_wakeref_t wakeref;
6619c0075f784d Chris Wilson          2019-01-14  1096  
16d98b31f80775 Robert Bragg          2016-12-07  1097   /**
16d98b31f80775 Robert Bragg          2016-12-07  1098    * @sample_flags: Flags 
representing the `DRM_I915_PERF_PROP_SAMPLE_*`
16d98b31f80775 Robert Bragg          2016-12-07  1099    * properties given 
when opening a stream, representing the contents
16d98b31f80775 Robert Bragg          2016-12-07  1100    * of a single sample 
as read() by userspace.
16d98b31f80775 Robert Bragg          2016-12-07  1101    */
eec688e1420da5 Robert Bragg          2016-11-07  1102   u32 sample_flags;
16d98b31f80775 Robert Bragg          2016-12-07  1103  
16d98b31f80775 Robert Bragg          2016-12-07  1104   /**
16d98b31f80775 Robert Bragg          2016-12-07  1105    * @sample_size: 
Considering the configured contents of a sample
16d98b31f80775 Robert Bragg          2016-12-07  1106    * combined with the 
required header size, this is the total size
16d98b31f80775 Robert Bragg          2016-12-07  1107    * of a single sample 
record.
16d98b31f80775 Robert Bragg          2016-12-07  1108    */
d79651522e89c4 Robert Bragg          2016-11-07  1109   int sample_size;
eec688e1420da5 Robert Bragg          2016-11-07  1110  
16d98b31f80775 Robert Bragg          2016-12-07  1111   /**
16d98b31f80775 Robert Bragg          2016-12-07  1112    * @ctx: %NULL if 
measuring system-wide across all contexts or a
16d98b31f80775 Robert Bragg          2016-12-07  1113    * specific context 
that is being monitored.
16d98b31f80775 Robert Bragg          2016-12-07  1114    */
eec688e1420da5 Robert Bragg          2016-11-07  1115   struct i915_gem_context 
*ctx;
16d98b31f80775 Robert Bragg          2016-12-07  1116  
16d98b31f80775 Robert Bragg          2016-12-07  1117   /**
16d98b31f80775 Robert Bragg          2016-12-07  1118    * @enabled: Whether 
the stream is currently enabled, considering
16d98b31f80775 Robert Bragg          2016-12-07  1119    * whether the stream 
was opened in a disabled state and based
16d98b31f80775 Robert Bragg          2016-12-07  1120    * on 
`I915_PERF_IOCTL_ENABLE` and `I915_PERF_IOCTL_DISABLE` calls.
16d98b31f80775 Robert Bragg          2016-12-07  1121    */
eec688e1420da5 Robert Bragg          2016-11-07  1122   bool enabled;
eec688e1420da5 Robert Bragg          2016-11-07  1123  
16d98b31f80775 Robert Bragg          2016-12-07  1124   /**
16d98b31f80775 Robert Bragg          2016-12-07  1125    * @ops: The callbacks 
providing the implementation of this specific
16d98b31f80775 Robert Bragg          2016-12-07  1126    * type of configured 
stream.
16d98b31f80775 Robert Bragg          2016-12-07  1127    */
d79651522e89c4 Robert Bragg          2016-11-07  1128   const struct 
i915_perf_stream_ops *ops;
701f8231a2fe17 Lionel Landwerlin     2017-08-03  1129  
701f8231a2fe17 Lionel Landwerlin     2017-08-03  1130   /**
701f8231a2fe17 Lionel Landwerlin     2017-08-03  1131    * @oa_config: The OA 
configuration used by the stream.
701f8231a2fe17 Lionel Landwerlin     2017-08-03  1132    */
701f8231a2fe17 Lionel Landwerlin     2017-08-03  1133   struct i915_oa_config 
*oa_config;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1134  
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1135   /**
5356b5242c2b4e Lionel Landwerlin     2019-08-28  1136    * @oa_config_bos: A 
list of struct i915_oa_config_bo allocated lazily
5356b5242c2b4e Lionel Landwerlin     2019-08-28  1137    * each time @oa_config 
changes.
5356b5242c2b4e Lionel Landwerlin     2019-08-28  1138    */
5356b5242c2b4e Lionel Landwerlin     2019-08-28  1139   struct list_head 
oa_config_bos;
5356b5242c2b4e Lionel Landwerlin     2019-08-28  1140  
5356b5242c2b4e Lionel Landwerlin     2019-08-28  1141   /**
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1142    * The OA context 
specific information.
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1143    */
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1144   struct intel_context 
*pinned_ctx;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1145   u32 specific_ctx_id;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1146   u32 
specific_ctx_id_mask;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1147  
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1148   struct hrtimer 
poll_check_timer;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1149   wait_queue_head_t 
poll_wq;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1150   bool pollin;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1151  
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1152   bool periodic;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1153   int period_exponent;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1154  
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1155   /**
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1156    * State of the OA 
buffer.
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1157    */
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1158   struct {
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1159           struct i915_vma 
*vma;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1160           u8 *vaddr;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1161           u32 last_ctx_id;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1162           int format;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1163           int format_size;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1164           int 
size_exponent;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1165  
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1166           /**
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1167            * Locks reads 
and writes to all head/tail state
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1168            *
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1169            * Consider: 
the head and tail pointer state needs to be read
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1170            * consistently 
from a hrtimer callback (atomic context) and
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1171            * read() fop 
(user context) with tail pointer updates happening
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1172            * in atomic 
context and head updates in user context and the
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1173            * (unlikely) 
possibility of read() errors needing to reset all
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1174            * head/tail 
state.
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1175            *
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1176            * Note: 
Contention/performance aren't currently a significant
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1177            * concern here 
considering the relatively low frequency of
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1178            * hrtimer 
callbacks (5ms period) and that reads typically only
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1179            * happen in 
response to a hrtimer event and likely complete
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1180            * before the 
next callback.
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1181            *
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1182            * Note: This 
lock is not held *while* reading and copying data
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1183            * to userspace 
so the value of head observed in htrimer
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1184            * callbacks 
won't represent any partial consumption of data.
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1185            */
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1186           spinlock_t 
ptr_lock;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1187  
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1188           /**
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1189            * One 'aging' 
tail pointer and one 'aged' tail pointer ready to
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1190            * used for 
reading.
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1191            *
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1192            * Initial 
values of 0xffffffff are invalid and imply that an
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1193            * update is 
required (and should be ignored by an attempted
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1194            * read)
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1195            */
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1196           struct {
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1197                   u32 
offset;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1198           } tails[2];
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1199  
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1200           /**
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1201            * Index for 
the aged tail ready to read() data up to.
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1202            */
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1203           unsigned int 
aged_tail_idx;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1204  
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1205           /**
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1206            * A monotonic 
timestamp for when the current aging tail pointer
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1207            * was read; 
used to determine when it is old enough to trust.
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1208            */
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1209           u64 
aging_timestamp;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1210  
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1211           /**
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1212            * Although we 
can always read back the head pointer register,
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1213            * we prefer to 
avoid trusting the HW state, just to avoid any
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1214            * risk that 
some hardware condition could * somehow bump the
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1215            * head pointer 
unpredictably and cause us to forward the wrong
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1216            * OA buffer 
data to userspace.
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1217            */
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1218           u32 head;
a37f08a882b01a Umesh Nerlige Ramappa 2019-08-06  1219   } oa_buffer;
6ebf99d59259bb Lionel Landwerlin     2019-08-28  1220  
6ebf99d59259bb Lionel Landwerlin     2019-08-28  1221   /**
6ebf99d59259bb Lionel Landwerlin     2019-08-28  1222    * A batch buffer doing 
a wait on the GPU for the NOA logic to be
6ebf99d59259bb Lionel Landwerlin     2019-08-28  1223    * reprogrammed.
6ebf99d59259bb Lionel Landwerlin     2019-08-28  1224    */
6ebf99d59259bb Lionel Landwerlin     2019-08-28  1225   struct i915_vma 
*noa_wait;
d79651522e89c4 Robert Bragg          2016-11-07 @1226  };
d79651522e89c4 Robert Bragg          2016-11-07  1227  

:::::: The code at line 1226 was first introduced by commit
:::::: d79651522e89c4ffa8992b48dfe449f0c583f809 drm/i915: Enable i915 perf 
stream for Haswell OA unit

:::::: TO: Robert Bragg <rob...@sixbynine.org>
:::::: CC: Daniel Vetter <daniel.vet...@ffwll.ch>

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

Attachment: .config.gz
Description: application/gzip

_______________________________________________
Intel-gfx mailing list
Intel-gfx@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/intel-gfx

Reply via email to