[openeuler:OLK-6.6 3406/3406] htmldocs: ./include/ub/cdma/cdma_api.h:94: warning: Function parameter or member 'trans_mode' not described in 'queue_cfg'
tree: https://gitee.com/openeuler/kernel.git OLK-6.6 head: 4e0f6ff6542664d2a6d350e8490d042a466aa0e6 commit: 27d2c29e4512954c7efcee4fa62b13fd67ce0f93 [3406/3406] ub: cdma: add CDMA driver-api documentation description reproduce: (https://download.01.org/0day-ci/archive/20251128/202511280817.PxN8S1S4-lkp@i...) If you fix the issue in a separate patch/commit (i.e. not just a new version of the same patch/commit), kindly add following tags | Reported-by: kernel test robot <lkp@intel.com> | Closes: https://lore.kernel.org/oe-kbuild-all/202511280817.PxN8S1S4-lkp@intel.com/ All warnings (new ones prefixed by >>): Error: Cannot open file ./include/linux/tty_port.h Error: Cannot open file ./include/linux/tty_port.h Error: Cannot open file ./include/linux/tty.h Error: Cannot open file ./include/linux/tty.h Error: Cannot open file ./include/linux/tty.h
./include/ub/cdma/cdma_api.h:94: warning: Function parameter or member 'trans_mode' not described in 'queue_cfg' ./include/ub/ubase/ubase_comm_ctrlq.h:90: warning: Function parameter or member 'is_async' not described in 'ubase_ctrlq_msg' ./include/ub/ubase/ubase_comm_dev.h:318: warning: Function parameter or member 'sl_num' not described in 'ubase_adev_qos' ./include/ub/ubase/ubase_comm_dev.h:318: warning: Function parameter or member 'sl' not described in 'ubase_adev_qos' ./include/ub/ubase/ubase_comm_dev.h:318: warning: Function parameter or member 'tp_sl_num' not described in 'ubase_adev_qos' ./include/ub/ubase/ubase_comm_dev.h:318: warning: Function parameter or member 'tp_sl' not described in 'ubase_adev_qos' -- WARNING: kernel-doc './scripts/kernel-doc -rst -enable-lineno -sphinx-version 8.2.3 -function tty_port ./include/linux/tty_port.h' failed with return code 1 WARNING: kernel-doc './scripts/kernel-doc -rst -enable-lineno -sphinx-version 8.2.3 -function tty_port_operations ./include/linux/tty_port.h' failed with return code 1 WARNING: kernel-doc './scripts/kernel-doc -rst -enable-lineno -sphinx-version 8.2.3 -function tty_kref_get ./include/linux/tty.h' failed with return code 1 WARNING: kernel-doc './scripts/kernel-doc -rst -enable-lineno -sphinx-version 8.2.3 -function TTY Struct Flags ./include/linux/tty.h' failed with return code 1 WARNING: kernel-doc './scripts/kernel-doc -rst -enable-lineno -sphinx-version 8.2.3 -function tty_struct ./include/linux/tty.h' failed with return code 1 Documentation/driver-api/ub/cdma.rst:137: WARNING: Bullet list ends without a blank line; unexpected unindent. [docutils] Documentation/driver-api/ub/cdma.rst:137: WARNING: Inline emphasis start-string without end-string. [docutils] Documentation/driver-api/ub/cdma.rst:138: WARNING: Definition list ends without a blank line; unexpected unindent. [docutils] Documentation/driver-api/ub/index.rst:3: ERROR: Undefined substitution referenced: "copy". [docutils] Documentation/driver-api/ub/ubus:6: ./include/ub/ubus/ubus.h:317: WARNING: Inline emphasis start-string without end-string. [docutils] WARNING: kernel-doc './scripts/kernel-doc -rst -enable-lineno -sphinx-version 8.2.3 -internal ./include/linux/usb/gadget.h' failed with return code 2 WARNING: kernel-doc './scripts/kernel-doc -rst -enable-lineno -sphinx-version 8.2.3 -internal ./include/linux/usb/composite.h' failed with return code 2 WARNING: kernel-doc './scripts/kernel-doc -rst -enable-lineno -sphinx-version 8.2.3 -function typec_altmode_driver -function typec_altmode_ops ./include/linux/usb/typec_altmode.h' failed with return code 1
vim +94 ./include/ub/cdma/cdma_api.h 3aa7aa335383c2 Zhipeng Lu 2025-08-29 74 27d2c29e451295 Zhipeng Lu 2025-11-24 75 /** 27d2c29e451295 Zhipeng Lu 2025-11-24 76 * struct queue_cfg - DMA queue config structure 27d2c29e451295 Zhipeng Lu 2025-11-24 77 * @queue_depth: queue depth 27d2c29e451295 Zhipeng Lu 2025-11-24 78 * @priority: the priority of JFS, ranging from [0, 15] 27d2c29e451295 Zhipeng Lu 2025-11-24 79 * @user_ctx: user private data information, optional 27d2c29e451295 Zhipeng Lu 2025-11-24 80 * @dcna: remote device CNA 27d2c29e451295 Zhipeng Lu 2025-11-24 81 * @rmt_eid: remote device EID 27d2c29e451295 Zhipeng Lu 2025-11-24 82 * @rsv_bitmap: reserved field bitmap 27d2c29e451295 Zhipeng Lu 2025-11-24 83 * @rsvd: reserved field array 27d2c29e451295 Zhipeng Lu 2025-11-24 84 */ eecfd8889f72f8 Zhipeng Lu 2025-08-28 85 struct queue_cfg { eecfd8889f72f8 Zhipeng Lu 2025-08-28 86 u32 queue_depth; eecfd8889f72f8 Zhipeng Lu 2025-08-28 87 u8 priority; eecfd8889f72f8 Zhipeng Lu 2025-08-28 88 u64 user_ctx; eecfd8889f72f8 Zhipeng Lu 2025-08-28 89 u32 dcna; eecfd8889f72f8 Zhipeng Lu 2025-08-28 90 struct dev_eid rmt_eid; eecfd8889f72f8 Zhipeng Lu 2025-08-28 91 u32 trans_mode; 34c67ed8f4c107 Zhipeng Lu 2025-11-11 92 u32 rsv_bitmap; 34c67ed8f4c107 Zhipeng Lu 2025-11-11 93 u32 rsvd[6]; eecfd8889f72f8 Zhipeng Lu 2025-08-28 @94 }; eecfd8889f72f8 Zhipeng Lu 2025-08-28 95 :::::: The code at line 94 was first introduced by commit :::::: eecfd8889f72f8c03c8af731e508dc3cb46b4b14 ub: cdma: support for allocating queue :::::: TO: Zhipeng Lu <luzhipeng8@h-partners.com> :::::: CC: Zhipeng Lu <luzhipeng8@h-partners.com> -- 0-DAY CI Kernel Test Service https://github.com/intel/lkp-tests/wiki
participants (1)
-
kernel test robot