Commit 48f02b88 authored Sep 04, 2018 by Randy Dunlap Committed by Jonathan Corbet Sep 06, 2018

FireWire: clean up core-iso.c kernel-doc

Clean up kernel-doc warnings in <drivers/firewire/core-iso.c> so that
it can be added to a Firewire/IEEE 1394 driver-api chapter
without adding lots of noisy warnings to the documentation build.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Stefan Richter <stefanr@s5r6.in-berlin.de>
Cc: Takashi Sakamoto <o-takashi@sakamocchi.jp>
Cc: linux-doc@vger.kernel.org
Cc: linux-scsi@vger.kernel.org
Cc: Randy Dunlap <rdunlap@infradead.org>
Cc: Andrew Morton <akpm@linux-foundation.org>
Cc: "James E.J. Bottomley" <jejb@linux.vnet.ibm.com>
Cc: "Martin K. Petersen" <martin.petersen@oracle.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

parent 9a400682

drivers/firewire/core-iso.c

+7 −0

Original line number	Diff line number	Diff line
		@@ -337,9 +337,16 @@ static void deallocate_channel(struct fw_card *card, int irm_id,

		/**
		* fw_iso_resource_manage() - Allocate or deallocate a channel and/or bandwidth
		* @card: card interface for this action
		* @generation: bus generation
		* @channels_mask: bitmask for channel allocation
		* @channel: pointer for returning channel allocation result
		* @bandwidth: pointer for returning bandwidth allocation result
		* @allocate: whether to allocate (true) or deallocate (false)
		*
		* In parameters: card, generation, channels_mask, bandwidth, allocate
		* Out parameters: channel, bandwidth
		*
		* This function blocks (sleeps) during communication with the IRM.
		*
		* Allocates or deallocates at most one channel out of channels_mask.