| Message ID | 20191010035240.310347906@gmail.com (mailing list archive) |
|---|---|
| State | Accepted |
| Delegated to: | Jason Gunthorpe |
| Headers | show |
| Series | infiniband kernel-doc fixes & driver-api/ chapter | expand |
Randy, What do you want to do with this series? Is this error below related needing respin, or just noise? Thanks, Jason On Thu, Oct 10, 2019 at 11:45:28PM +0800, kbuild test robot wrote: > Hi, > > Thank you for the patch! Perhaps something to improve: > > [auto build test WARNING on rdma/for-next] > [cannot apply to v5.4-rc2 next-20191010] > [if your patch is applied to the wrong git tree, please drop us a note to help > improve the system. BTW, we also suggest to use '--base' option to specify the > base tree in git format-patch, please see https://stackoverflow.com/a/37406982] > > url: https://github.com/0day-ci/linux/commits/rd-dunlab-gmail-com/infiniband-kernel-doc-fixes-driver-api-chapter/20191010-220426 > base: https://git.kernel.org/pub/scm/linux/kernel/git/rdma/rdma.git for-next > reproduce: make htmldocs > > If you fix the issue, kindly add following tag > Reported-by: kbuild test robot <lkp@intel.com> > > All warnings (new ones prefixed by >>): > > Warning: The Sphinx 'sphinx_rtd_theme' HTML theme was not found. Make sure you have the theme installed to produce pretty HTML output. Falling back to the default theme. > WARNING: dot(1) not found, for better output quality install graphviz from http://www.graphviz.org > WARNING: convert(1) not found, for SVG to PDF conversion install ImageMagick (https://www.imagemagick.org) > Error: Cannot open file drivers/dma-buf/reservation.c > Error: Cannot open file drivers/dma-buf/reservation.c > Error: Cannot open file drivers/dma-buf/reservation.c > Error: Cannot open file include/linux/reservation.h > Error: Cannot open file include/linux/reservation.h > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'quotactl' not described in 'security_list_options' > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'quota_on' not described in 'security_list_options' > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'sb_free_mnt_opts' not described in 'security_list_options' > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'sb_eat_lsm_opts' not described in 'security_list_options' > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'sb_kern_mount' not described in 'security_list_options' > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'sb_show_options' not described in 'security_list_options' > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'sb_add_mnt_opt' not described in 'security_list_options' > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'd_instantiate' not described in 'security_list_options' > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'getprocattr' not described in 'security_list_options' > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'setprocattr' not described in 'security_list_options' > include/linux/lsm_hooks.h:1822: warning: Function parameter or member 'locked_down' not described in 'security_list_options' > include/linux/regulator/machine.h:196: warning: Function parameter or member 'max_uV_step' not described in 'regulation_constraints' > include/linux/regulator/driver.h:223: warning: Function parameter or member 'resume' not described in 'regulator_ops' > include/linux/spi/spi.h:190: warning: Function parameter or member 'driver_override' not described in 'spi_device' > fs/fs-writeback.c:913: warning: Excess function parameter 'nr_pages' description in 'cgroup_writeback_by_id' > 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' > drivers/usb/typec/bus.c:1: warning: 'typec_altmode_unregister_driver' not found > drivers/usb/typec/bus.c:1: warning: 'typec_altmode_register_driver' not found > drivers/usb/typec/class.c:1: warning: 'typec_altmode_register_notifier' not found > drivers/usb/typec/class.c:1: warning: 'typec_altmode_unregister_notifier' not found > include/linux/w1.h:277: warning: Function parameter or member 'of_match_table' not described in 'w1_family' > drivers/gpio/gpiolib-of.c:92: warning: Excess function parameter 'dev' description in 'of_gpio_need_valid_mask' > include/linux/i2c.h:337: warning: Function parameter or member 'init_irq' not described in 'i2c_client' > >> drivers/infiniband/ulp/iser/iscsi_iser.h:401: warning: Function parameter or member 'all_list' not described in 'iser_fr_desc' > >> drivers/infiniband/ulp/iser/iscsi_iser.h:415: warning: Function parameter or member 'all_list' not described in 'iser_fr_pool' > kernel/dma/coherent.c:1: warning: no structured comments found > include/linux/input/sparse-keymap.h:43: warning: Function parameter or member 'sw' not described in 'key_entry' > include/linux/skbuff.h:888: warning: Function parameter or member 'dev_scratch' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'list' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'ip_defrag_offset' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'skb_mstamp_ns' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member '__cloned_offset' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'head_frag' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member '__pkt_type_offset' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'encapsulation' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'encap_hdr_csum' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'csum_valid' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member '__pkt_vlan_present_offset' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'vlan_present' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'csum_complete_sw' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'csum_level' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'inner_protocol_type' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'remcsum_offload' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'sender_cpu' not described in 'sk_buff' > include/linux/skbuff.h:888: warning: Function parameter or member 'reserved_tailroom' not described in 'sk_buff' > include/linux/skbuff.h:888: 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:2053: warning: Function parameter or member 'gso_partial_features' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'l3mdev_ops' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'xfrmdev_ops' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'tlsdev_ops' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'name_assign_type' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'ieee802154_ptr' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'mpls_ptr' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'xdp_prog' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'gro_flush_timeout' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'nf_hooks_ingress' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member '____cacheline_aligned_in_smp' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'qdisc_hash' not described in 'net_device' > include/linux/netdevice.h:2053: warning: Function parameter or member 'xps_cpus_map' not described in 'net_device' > include/linux/netdevice.h:2053: 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:595: warning: Function parameter or member 'config' not described in 'phylink_create' > drivers/net/phy/phylink.c:595: 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/linux/bitmap.h:341: warning: Function parameter or member 'nbits' not described in 'bitmap_or_equal' > include/linux/rculist.h:374: warning: Excess function parameter 'cond' description in 'list_for_each_entry_rcu' > include/linux/rculist.h:651: warning: Excess function parameter 'cond' description in 'hlist_for_each_entry_rcu' > 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' > drivers/gpu/drm/amd/amdgpu/amdgpu_dma_buf.c:335: warning: Excess function parameter 'dev' description in 'amdgpu_gem_prime_export' > drivers/gpu/drm/amd/amdgpu/amdgpu_dma_buf.c:336: warning: Excess function parameter 'dev' description in 'amdgpu_gem_prime_export' > drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c:142: warning: Function parameter or member 'blockable' not described in 'amdgpu_mn_read_lock' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:347: warning: cannot understand function prototype: 'struct amdgpu_vm_pt_cursor ' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:348: warning: cannot understand function prototype: 'struct amdgpu_vm_pt_cursor ' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:494: warning: Function parameter or member 'start' not described in 'amdgpu_vm_pt_first_dfs' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or member 'adev' not described in 'for_each_amdgpu_vm_pt_dfs_safe' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or member 'vm' not described in 'for_each_amdgpu_vm_pt_dfs_safe' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or member 'start' not described in 'for_each_amdgpu_vm_pt_dfs_safe' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or member 'cursor' not described in 'for_each_amdgpu_vm_pt_dfs_safe' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or member 'entry' not described in 'for_each_amdgpu_vm_pt_dfs_safe' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:823: warning: Function parameter or member 'level' not described in 'amdgpu_vm_bo_param' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'params' not described in 'amdgpu_vm_update_flags' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'bo' not described in 'amdgpu_vm_update_flags' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'level' not described in 'amdgpu_vm_update_flags' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'pe' not described in 'amdgpu_vm_update_flags' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'addr' not described in 'amdgpu_vm_update_flags' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'count' not described in 'amdgpu_vm_update_flags' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'incr' not described in 'amdgpu_vm_update_flags' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'flags' not described in 'amdgpu_vm_update_flags' > drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:2823: warning: Function parameter or member 'pasid' not described in 'amdgpu_vm_make_compute' > drivers/gpu/drm/amd/amdgpu/amdgpu_irq.c:378: warning: Excess function parameter 'entry' description in 'amdgpu_irq_dispatch' > drivers/gpu/drm/amd/amdgpu/amdgpu_irq.c:379: warning: Function parameter or member 'ih' not described in 'amdgpu_irq_dispatch' > drivers/gpu/drm/amd/amdgpu/amdgpu_irq.c:379: warning: Excess function parameter 'entry' description in 'amdgpu_irq_dispatch' > drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c:1: warning: no structured comments found > drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c:1: warning: no structured comments found > drivers/gpu/drm/amd/amdgpu/amdgpu_pm.c:1: warning: 'pp_dpm_sclk pp_dpm_mclk pp_dpm_pcie' not found > drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:132: warning: Incorrect use of kernel-doc format: Documentation Makefile include scripts source @atomic_obj > drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:238: warning: Incorrect use of kernel-doc format: Documentation Makefile include scripts source gpu_info FW provided soc bounding box struct or 0 if not > drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:243: warning: Function parameter or member 'atomic_obj' not described in 'amdgpu_display_manager' > > vim +401 drivers/infiniband/ulp/iser/iscsi_iser.h > > 5587856c9659ac Sagi Grimberg 2013-07-28 @401 > 385ad87d4b637c Sagi Grimberg 2015-08-06 402 /** > e506e0f630a40d rd.dunlab@gmail.com 2019-10-09 403 * struct iser_fr_pool - connection fast registration pool > 385ad87d4b637c Sagi Grimberg 2015-08-06 404 * > 2b3bf958103899 Adir Lev 2015-08-06 405 * @list: list of fastreg descriptors > 385ad87d4b637c Sagi Grimberg 2015-08-06 406 * @lock: protects fmr/fastreg pool > 2b3bf958103899 Adir Lev 2015-08-06 407 * @size: size of the pool > 385ad87d4b637c Sagi Grimberg 2015-08-06 408 */ > 385ad87d4b637c Sagi Grimberg 2015-08-06 409 struct iser_fr_pool { > 2b3bf958103899 Adir Lev 2015-08-06 410 struct list_head list; > 385ad87d4b637c Sagi Grimberg 2015-08-06 411 spinlock_t lock; > 2b3bf958103899 Adir Lev 2015-08-06 412 int size; > ea174c9573b0e0 Sagi Grimberg 2017-02-27 413 struct list_head all_list; > 385ad87d4b637c Sagi Grimberg 2015-08-06 414 }; > 385ad87d4b637c Sagi Grimberg 2015-08-06 @415 > > :::::: The code at line 401 was first introduced by commit > :::::: 5587856c9659ac2d6ab201141aa8a5c2ff3be4cd IB/iser: Introduce fast memory registration model (FRWR) > > :::::: TO: Sagi Grimberg <sagig@mellanox.com> > :::::: CC: Roland Dreier <roland@purestorage.com> > > 0-DAY kernel test infrastructure Open Source Technology Center > https://lists.01.org/pipermail/kbuild-all Intel Corporation
On 10/21/19 10:07 AM, Jason Gunthorpe wrote: > Randy, > > What do you want to do with this series? Is this error below related > needing respin, or just noise? > > Thanks, > Jason Hi Jason, I certainly would like to see patches 1-11 merged since they do lots of cleanups/fixes that I prefer not to be lost. If you don't want to merge patch 12, so be it. My docs build has a total of 8 errors and 173 warnings, so I consider these just more noise. Please note that I am also working on cleaning up lots of that noise. Patches 3 and 7 mention new warnings that I am already aware of. If you can tell me what the 'all_list' field [below] is/means, I'll be glad to add a patch for that. > On Thu, Oct 10, 2019 at 11:45:28PM +0800, kbuild test robot wrote: >> Hi, >> >> Thank you for the patch! Perhaps something to improve: >> >> [auto build test WARNING on rdma/for-next] >> [cannot apply to v5.4-rc2 next-20191010] >> [if your patch is applied to the wrong git tree, please drop us a note to help >> improve the system. BTW, we also suggest to use '--base' option to specify the >> base tree in git format-patch, please see https://stackoverflow.com/a/37406982] >> >> url: https://github.com/0day-ci/linux/commits/rd-dunlab-gmail-com/infiniband-kernel-doc-fixes-driver-api-chapter/20191010-220426 >> base: https://git.kernel.org/pub/scm/linux/kernel/git/rdma/rdma.git for-next >> reproduce: make htmldocs >> >> If you fix the issue, kindly add following tag >> Reported-by: kbuild test robot <lkp@intel.com> >> >> All warnings (new ones prefixed by >>): >> [cutting non-related errors/warnings] >>>> drivers/infiniband/ulp/iser/iscsi_iser.h:401: warning: Function parameter or member 'all_list' not described in 'iser_fr_desc' >>>> drivers/infiniband/ulp/iser/iscsi_iser.h:415: warning: Function parameter or member 'all_list' not described in 'iser_fr_pool' >> >> vim +401 drivers/infiniband/ulp/iser/iscsi_iser.h >> >> 5587856c9659ac Sagi Grimberg 2013-07-28 @401 >> 385ad87d4b637c Sagi Grimberg 2015-08-06 402 /** >> e506e0f630a40d rd.dunlab@gmail.com 2019-10-09 403 * struct iser_fr_pool - connection fast registration pool >> 385ad87d4b637c Sagi Grimberg 2015-08-06 404 * >> 2b3bf958103899 Adir Lev 2015-08-06 405 * @list: list of fastreg descriptors >> 385ad87d4b637c Sagi Grimberg 2015-08-06 406 * @lock: protects fmr/fastreg pool >> 2b3bf958103899 Adir Lev 2015-08-06 407 * @size: size of the pool >> 385ad87d4b637c Sagi Grimberg 2015-08-06 408 */ >> 385ad87d4b637c Sagi Grimberg 2015-08-06 409 struct iser_fr_pool { >> 2b3bf958103899 Adir Lev 2015-08-06 410 struct list_head list; >> 385ad87d4b637c Sagi Grimberg 2015-08-06 411 spinlock_t lock; >> 2b3bf958103899 Adir Lev 2015-08-06 412 int size; >> ea174c9573b0e0 Sagi Grimberg 2017-02-27 413 struct list_head all_list; >> 385ad87d4b637c Sagi Grimberg 2015-08-06 414 }; >> 385ad87d4b637c Sagi Grimberg 2015-08-06 @415 >> >> :::::: The code at line 401 was first introduced by commit >> :::::: 5587856c9659ac2d6ab201141aa8a5c2ff3be4cd IB/iser: Introduce fast memory registration model (FRWR) thanks,
--- linux-next-20191009.orig/Documentation/driver-api/index.rst +++ linux-next-20191009/Documentation/driver-api/index.rst @@ -26,6 +26,7 @@ available subsections can be seen below. device_link component message-based + infiniband sound frame-buffer regulator --- /dev/null +++ linux-next-20191009/Documentation/driver-api/infiniband.rst @@ -0,0 +1,127 @@ +=========================================== +InfiniBand and Remote DMA (RDMA) Interfaces +=========================================== + +Introduction and Overview +========================= + +TBD + +InfiniBand core interfaces +========================== + +.. kernel-doc:: drivers/infiniband/core/iwpm_util.h + :internal: + +.. kernel-doc:: drivers/infiniband/core/cq.c + :export: + +.. kernel-doc:: drivers/infiniband/core/cm.c + :export: + +.. kernel-doc:: drivers/infiniband/core/rw.c + :export: + +.. kernel-doc:: drivers/infiniband/core/device.c + :export: + +.. kernel-doc:: drivers/infiniband/core/verbs.c + :export: + +.. kernel-doc:: drivers/infiniband/core/packer.c + :export: + +.. kernel-doc:: drivers/infiniband/core/sa_query.c + :export: + +.. kernel-doc:: drivers/infiniband/core/ud_header.c + :export: + +.. kernel-doc:: drivers/infiniband/core/fmr_pool.c + :export: + +.. kernel-doc:: drivers/infiniband/core/umem.c + :export: + +.. kernel-doc:: drivers/infiniband/core/umem_odp.c + :export: + +RDMA Verbs transport library +============================ + +.. kernel-doc:: drivers/infiniband/sw/rdmavt/mr.c + :export: + +.. kernel-doc:: drivers/infiniband/sw/rdmavt/rc.c + :export: + +.. kernel-doc:: drivers/infiniband/sw/rdmavt/ah.c + :export: + +.. kernel-doc:: drivers/infiniband/sw/rdmavt/vt.c + :export: + +.. kernel-doc:: drivers/infiniband/sw/rdmavt/cq.c + :export: + +.. kernel-doc:: drivers/infiniband/sw/rdmavt/qp.c + :export: + +.. kernel-doc:: drivers/infiniband/sw/rdmavt/mcast.c + :export: + +Upper Layer Protocols +===================== + +iSCSI Extensions for RDMA (iSER) +-------------------------------- + +.. kernel-doc:: drivers/infiniband/ulp/iser/iscsi_iser.h + :internal: + +.. kernel-doc:: drivers/infiniband/ulp/iser/iscsi_iser.c + :functions: iscsi_iser_pdu_alloc iser_initialize_task_headers \ + iscsi_iser_task_init iscsi_iser_mtask_xmit iscsi_iser_task_xmit \ + iscsi_iser_cleanup_task iscsi_iser_check_protection \ + iscsi_iser_conn_create iscsi_iser_conn_bind \ + iscsi_iser_conn_start iscsi_iser_conn_stop \ + iscsi_iser_session_destroy iscsi_iser_session_create \ + iscsi_iser_set_param iscsi_iser_ep_connect iscsi_iser_ep_poll \ + iscsi_iser_ep_disconnect + +.. kernel-doc:: drivers/infiniband/ulp/iser/iser_initiator.c + :internal: + +.. kernel-doc:: drivers/infiniband/ulp/iser/iser_verbs.c + :internal: + +Omni-Path (OPA) Virtual NIC support +----------------------------------- + +.. kernel-doc:: drivers/infiniband/ulp/opa_vnic/opa_vnic_internal.h + :internal: + +.. kernel-doc:: drivers/infiniband/ulp/opa_vnic/opa_vnic_encap.h + :internal: + +.. kernel-doc:: drivers/infiniband/ulp/opa_vnic/opa_vnic_vema_iface.c + :internal: + +.. kernel-doc:: drivers/infiniband/ulp/opa_vnic/opa_vnic_vema.c + :internal: + +InfiniBand SCSI RDMA protocol target support +-------------------------------------------- + +.. kernel-doc:: drivers/infiniband/ulp/srpt/ib_srpt.h + :internal: + +.. kernel-doc:: drivers/infiniband/ulp/srpt/ib_srpt.c + :internal: + +iSCSI Extensions for RDMA (iSER) target support +----------------------------------------------- + +.. kernel-doc:: drivers/infiniband/ulp/isert/ib_isert.c + :internal: +
Add a driver-api chapter for InfiniBand interfaces. Signed-off-by: Randy Dunlap <rd.dunlab@gmail.com> Cc: Randy Dunlap <rdunlap@infradead.org> Cc: Doug Ledford <dledford@redhat.com> Cc: Jason Gunthorpe <jgg@mellanox.com> Cc: linux-doc@vger.kernel.org --- Documentation/driver-api/index.rst | 1 Documentation/driver-api/infiniband.rst | 127 ++++++++++++++++++++++ 2 files changed, 128 insertions(+)