[android-common:android12-5.4 5/5] drivers/acpi/arm64/iort.c:637: warning: Function parameter or member 'id' not described in 'iort_get_device_domain'

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

:::::: 
:::::: Manual check reason: "low confidence bisect report"
:::::: 

BCC: lkp@intel.com
CC: oe-kbuild-all@lists.linux.dev
TO: cros-kernel-buildreports@googlegroups.com

tree:   https://android.googlesource.com/kernel/common android12-5.4
head:   b2957a0ebc3b9949475a442f9e8ab64ccaa6e087
commit: da36a3ef32b476ca6464226010ef73135fc3c3a4 [5/5] ACPI/IORT: Make iort_get_device_domain IRQ domain agnostic
:::::: branch date: 5 days ago
:::::: commit date: 1 year, 11 months ago
config: arm64-allnoconfig-bpf (https://download.01.org/0day-ci/archive/20251122/202511220710.1FEPC3f1-lkp@intel.com/config)
compiler: aarch64-linux-gcc (GCC) 15.1.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20251122/202511220710.1FEPC3f1-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/r/202511220710.1FEPC3f1-lkp@intel.com/

All warnings (new ones prefixed by >>):

   drivers/acpi/arm64/iort.c:53: warning: Function parameter or member 'iort_node' not described in 'iort_set_fwnode'
   drivers/acpi/arm64/iort.c:53: warning: Excess function parameter 'node' description in 'iort_set_fwnode'
>> drivers/acpi/arm64/iort.c:637: warning: Function parameter or member 'id' not described in 'iort_get_device_domain'
>> drivers/acpi/arm64/iort.c:637: warning: Function parameter or member 'bus_token' not described in 'iort_get_device_domain'
>> drivers/acpi/arm64/iort.c:637: warning: Excess function parameter 'req_id' description in 'iort_get_device_domain'
   drivers/acpi/arm64/iort.c:1064: warning: Function parameter or member 'dma_size' not described in 'iort_dma_setup'
   drivers/acpi/arm64/iort.c:1064: warning: Excess function parameter 'size' description in 'iort_dma_setup'
   drivers/acpi/arm64/iort.c:1475: warning: Function parameter or member 'ops' not described in 'iort_add_platform_device'


vim +637 drivers/acpi/arm64/iort.c

4bf2efd26d7624 Tomasz Nowicki    2016-09-12  627  
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  628  /**
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  629   * iort_get_device_domain() - Find MSI domain related to a device
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  630   * @dev: The device.
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  631   * @req_id: Requester ID for the device.
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  632   *
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  633   * Returns: the MSI domain for this device, NULL otherwise
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  634   */
da36a3ef32b476 Lorenzo Pieralisi 2020-06-19  635  struct irq_domain *iort_get_device_domain(struct device *dev, u32 id,
da36a3ef32b476 Lorenzo Pieralisi 2020-06-19  636  					  enum irq_domain_bus_token bus_token)
4bf2efd26d7624 Tomasz Nowicki    2016-09-12 @637  {
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  638  	struct fwnode_handle *handle;
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  639  	int its_id;
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  640  
da36a3ef32b476 Lorenzo Pieralisi 2020-06-19  641  	if (iort_dev_find_its_id(dev, id, 0, &its_id))
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  642  		return NULL;
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  643  
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  644  	handle = iort_find_domain_token(its_id);
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  645  	if (!handle)
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  646  		return NULL;
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  647  
da36a3ef32b476 Lorenzo Pieralisi 2020-06-19  648  	return irq_find_matching_fwnode(handle, bus_token);
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  649  }
4bf2efd26d7624 Tomasz Nowicki    2016-09-12  650  

:::::: The code at line 637 was first introduced by commit
:::::: 4bf2efd26d7624372fb7adff8745b4c2e8407004 ACPI: Add new IORT functions to support MSI domain handling

:::::: TO: Tomasz Nowicki <tn@semihalf.com>
:::::: CC: Marc Zyngier <marc.zyngier@arm.com>

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