[android-common:android-4.19-stable 11093/30000] drivers/usb/gadget/udc/core.c:517: warning: Function parameter or member 'ep' not described in 'usb_gsi_ep_op'

[kernel test robot <lkp@intel.com>]

Hi Hridya,

FYI, the error/warning still remains.

tree:   https://android.googlesource.com/kernel/common android-4.19-stable
head:   a8bf86a0e0fa05070897a210d706d5c4d83c26ac
commit: 632093eced49c76aa97f564248efc6d041779135 [11093/30000] ANDROID: GKI: USB: Resolve ABI diff for usb_gadget and usb_gadget_ops
config: arm-randconfig-001-20241212 (https://download.01.org/0day-ci/archive/20241212/202412122006.XUaCvCQa-lkp@intel.com/config)
compiler: arm-linux-gnueabi-gcc (GCC) 14.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20241212/202412122006.XUaCvCQa-lkp@intel.com/reproduce)

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/202412122006.XUaCvCQa-lkp@intel.com/

All warnings (new ones prefixed by >>):

   drivers/usb/gadget/udc/core.c:25: warning: Incorrect use of kernel-doc format:  * struct usb_udc - describes one usb device controller
   drivers/usb/gadget/udc/core.c:36: warning: cannot understand function prototype: 'struct usb_udc '
>> drivers/usb/gadget/udc/core.c:517: warning: Function parameter or member 'ep' not described in 'usb_gsi_ep_op'
>> drivers/usb/gadget/udc/core.c:517: warning: Function parameter or member 'req' not described in 'usb_gsi_ep_op'
>> drivers/usb/gadget/udc/core.c:517: warning: Function parameter or member 'op' not described in 'usb_gsi_ep_op'
   drivers/usb/gadget/udc/core.c:933: warning: Function parameter or member 'ep' not described in 'usb_gadget_giveback_request'
   drivers/usb/gadget/udc/core.c:933: warning: Function parameter or member 'req' not described in 'usb_gadget_giveback_request'
   drivers/usb/gadget/udc/core.c:1130: warning: Function parameter or member 'udc' not described in 'usb_gadget_udc_stop'
   drivers/usb/gadget/udc/core.c:1130: warning: Excess function parameter 'gadget' description in 'usb_gadget_udc_stop'
   drivers/usb/gadget/udc/core.c:1130: warning: Excess function parameter 'driver' description in 'usb_gadget_udc_stop'


vim +517 drivers/usb/gadget/udc/core.c

   508	
   509	/**
   510	 * usb_gsi_ep_op - performs operation on GSI accelerated EP based on EP op code
   511	 *
   512	 * Operations such as EP configuration, TRB allocation, StartXfer etc.
   513	 * See gsi_ep_op for more details.
   514	 */
   515	int usb_gsi_ep_op(struct usb_ep *ep,
   516			struct usb_gsi_request *req, enum gsi_ep_op op)
 > 517	{
   518		if (ep && ep->ops && ep->ops->gsi_ep_op)
   519			return ep->ops->gsi_ep_op(ep, req, op);
   520	
   521		return -EOPNOTSUPP;
   522	}
   523	EXPORT_SYMBOL_GPL(usb_gsi_ep_op);
   524	

-- 
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki