Hi Qais,

[auto build test WARNING on tip/irq/core -- if it's inappropriate base, please suggest rules for selecting the more suitable base]

url:    https://github.com/0day-ci/linux/commits/Qais-Yousef/Implement-generic-IPI-support-mechanism/20151103-192028
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

   include/linux/irq.h:168: warning: No description found for parameter 'ipi_mask'
>> kernel/irq/manage.c:2103: warning: No description found for parameter 'desc'
>> kernel/irq/manage.c:2103: warning: Excess function parameter 'irq_desc' description in '__irq_desc_send_ipi'
   kernel/irq/manage.c:2146: warning: No description found for parameter 'virq'
   kernel/irq/manage.c:2146: warning: Excess function parameter 'irq' description in 'irq_send_ipi'
   kernel/irq/handle.c:1: warning: no structured comments found
--
   lib/crc32.c:148: warning: No description found for parameter 'tab)[256]'
   lib/crc32.c:148: warning: Excess function parameter 'tab' description in 'crc32_le_generic'
   lib/crc32.c:293: warning: No description found for parameter 'tab)[256]'
   lib/crc32.c:293: warning: Excess function parameter 'tab' description in 'crc32_be_generic'
   lib/crc32.c:1: warning: no structured comments found
>> kernel/irq/manage.c:2103: warning: No description found for parameter 'desc'
>> kernel/irq/manage.c:2103: warning: Excess function parameter 'irq_desc' description in '__irq_desc_send_ipi'
   kernel/irq/manage.c:2146: warning: No description found for parameter 'virq'
   kernel/irq/manage.c:2146: warning: Excess function parameter 'irq' description in 'irq_send_ipi'
   block/blk-core.c:1549: warning: No description found for parameter 'same_queue_rq'
   block/blk-core.c:1549: warning: No description found for parameter 'same_queue_rq'

vim +/desc +2103 kernel/irq/manage.c

  2087		return 0;
  2088	}
  2089	
  2090	/**
  2091	 *	__irq_desc_send_ipi - send an IPI to target CPU(s)
  2092	 *	@irq_desc: pointer to irq_desc of the IRQ
  2093	 *	@dest: dest CPU(s), must be the same or a subset of the mask passed to
  2094	 *	       irq_reserve_ipi()
  2095	 *
  2096	 *	Sends an IPI to all cpus in dest mask.
  2097	 *	This function is meant to be used from arch code to save the need to do
  2098	 *	desc lookup that happens in the generic irq_send_ipi().
  2099	 *
  2100	 *	Returns zero on success and negative error number on failure.
  2101	 */
  2102	int __irq_desc_send_ipi(struct irq_desc *desc, const struct ipi_mask *dest)
> 2103	{
  2104		struct irq_data *data = irq_desc_get_irq_data(desc);
  2105		struct irq_chip *chip = irq_data_get_irq_chip(data);
  2106	
  2107		if (!chip || !chip->irq_send_ipi)
  2108			return -EINVAL;
  2109	
  2110		if (dest->nbits > data->common->ipi_mask->nbits)
  2111			return -EINVAL;

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