[PATCH] kernel-doc: fix fusion and i2o docs (d9489fb6) · Commits · e / devices / android_kernel_teracube_2e

drivers/message/fusion/mptbase.c

+137 −118

drivers/message/fusion/mptfc.c

+2 −3

Original line number	Original line	Diff line number	Diff line
	@@ -1395,8 +1395,7 @@ mptfc_ioc_reset(MPT_ADAPTER *ioc, int reset_phase)

	/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/		/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/
	/**		/**
	* mptfc_init - Register MPT adapter(s) as SCSI host(s) with		* mptfc_init - Register MPT adapter(s) as SCSI host(s) with SCSI mid-layer.
	* linux scsi mid-layer.
	*		*
	* Returns 0 for success, non-zero for failure.		* Returns 0 for success, non-zero for failure.
	*/		*/
	@@ -1440,7 +1439,7 @@ mptfc_init(void)

	/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/		/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/
	/**		/**
	* mptfc_remove - Removed fc infrastructure for devices		* mptfc_remove - Remove fc infrastructure for devices
	* @pdev: Pointer to pci_dev structure		* @pdev: Pointer to pci_dev structure
	*		*
	*/		*/

drivers/message/fusion/mptscsih.c

+11 −13

Original line number	Original line	Diff line number	Diff line
	@@ -1230,15 +1230,15 @@ mptscsih_host_info(MPT_ADAPTER ioc, char pbuf, off_t offset, int len)
	/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/		/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/
	/**		/**
	* mptscsih_proc_info - Return information about MPT adapter		* mptscsih_proc_info - Return information about MPT adapter
			* @host: scsi host struct
			* @buffer: if write, user data; if read, buffer for user
			* @start: returns the buffer address
			* @offset: if write, 0; if read, the current offset into the buffer from
			* the previous read.
			* @length: if write, return length;
			* @func: write = 1; read = 0
	*		*
	* (linux scsi_host_template.info routine)		* (linux scsi_host_template.info routine)
	*
	* buffer: if write, user data; if read, buffer for user
	* length: if write, return length;
	* offset: if write, 0; if read, the current offset into the buffer from
	* the previous read.
	* hostno: scsi host number
	* func: if write = 1; if read = 0
	*/		*/
	int		int
	mptscsih_proc_info(struct Scsi_Host host, char buffer, char **start, off_t offset,		mptscsih_proc_info(struct Scsi_Host host, char buffer, char **start, off_t offset,
	@@ -1902,8 +1902,7 @@ mptscsih_bus_reset(struct scsi_cmnd * SCpnt)

	/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/		/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/
	/**		/**
	* mptscsih_host_reset - Perform a SCSI host adapter RESET!		* mptscsih_host_reset - Perform a SCSI host adapter RESET (new_eh variant)
	* new_eh variant
	* @SCpnt: Pointer to scsi_cmnd structure, IO which reset is due to		* @SCpnt: Pointer to scsi_cmnd structure, IO which reset is due to
	*		*
	* (linux scsi_host_template.eh_host_reset_handler routine)		* (linux scsi_host_template.eh_host_reset_handler routine)
	@@ -1949,8 +1948,7 @@ mptscsih_host_reset(struct scsi_cmnd *SCpnt)

	/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/		/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/
	/**		/**
	* mptscsih_tm_pending_wait - wait for pending task management request to		* mptscsih_tm_pending_wait - wait for pending task management request to complete
	* complete.
	* @hd: Pointer to MPT host structure.		* @hd: Pointer to MPT host structure.
	*		*
	* Returns {SUCCESS,FAILED}.		* Returns {SUCCESS,FAILED}.
	@@ -1982,6 +1980,7 @@ mptscsih_tm_pending_wait(MPT_SCSI_HOST * hd)
	/**		/**
	* mptscsih_tm_wait_for_completion - wait for completion of TM task		* mptscsih_tm_wait_for_completion - wait for completion of TM task
	* @hd: Pointer to MPT host structure.		* @hd: Pointer to MPT host structure.
			* @timeout: timeout in seconds
	*		*
	* Returns {SUCCESS,FAILED}.		* Returns {SUCCESS,FAILED}.
	*/		*/
	@@ -3429,8 +3428,7 @@ mptscsih_do_cmd(MPT_SCSI_HOST hd, INTERNAL_CMD io)
	/**		/**
	* mptscsih_synchronize_cache - Send SYNCHRONIZE_CACHE to all disks.		* mptscsih_synchronize_cache - Send SYNCHRONIZE_CACHE to all disks.
	* @hd: Pointer to a SCSI HOST structure		* @hd: Pointer to a SCSI HOST structure
	* @vtarget: per device private data		* @vdevice: virtual target device
	* @lun: lun
	*		*
	* Uses the ISR, but with special processing.		* Uses the ISR, but with special processing.
	* MUST be single-threaded.		* MUST be single-threaded.

drivers/message/fusion/mptspi.c

+1 −3

File changed.

Preview size limit exceeded, changes collapsed.

drivers/message/i2o/bus-osm.c

+3 −0

File changed.

Preview size limit exceeded, changes collapsed.

Original line number	Original line	Diff line number	Diff line
	@@ -347,7 +347,7 @@ mpt_reply(MPT_ADAPTER *ioc, u32 pa)
	}		}

	/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/		/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/
	/*		/**
	* mpt_interrupt - MPT adapter (IOC) specific interrupt handler.		* mpt_interrupt - MPT adapter (IOC) specific interrupt handler.
	* @irq: irq number (not used)		* @irq: irq number (not used)
	* @bus_id: bus identifier cookie == pointer to MPT_ADAPTER structure		* @bus_id: bus identifier cookie == pointer to MPT_ADAPTER structure
	@@ -387,14 +387,16 @@ mpt_interrupt(int irq, void *bus_id)
	}		}

	/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/		/=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/
	/*		/**
	* mpt_base_reply - MPT base driver's callback routine; all base driver		* mpt_base_reply - MPT base driver's callback routine
	* "internal" request/reply processing is routed here.
	* Currently used for EventNotification and EventAck handling.
	* @ioc: Pointer to MPT_ADAPTER structure		* @ioc: Pointer to MPT_ADAPTER structure
	* @mf: Pointer to original MPT request frame		* @mf: Pointer to original MPT request frame
	* @reply: Pointer to MPT reply frame (NULL if TurboReply)		* @reply: Pointer to MPT reply frame (NULL if TurboReply)
	*		*
			* MPT base driver's callback routine; all base driver
			* "internal" request/reply processing is routed here.
			* Currently used for EventNotification and EventAck handling.
			*
	* Returns 1 indicating original alloc'd request frame ptr		* Returns 1 indicating original alloc'd request frame ptr
	* should be freed, or 0 if it shouldn't.		* should be freed, or 0 if it shouldn't.
	*/		*/
	@@ -530,7 +532,7 @@ mpt_base_reply(MPT_ADAPTER ioc, MPT_FRAME_HDR mf, MPT_FRAME_HDR *reply)
	* @dclass: Protocol driver's class (%MPT_DRIVER_CLASS enum value)		* @dclass: Protocol driver's class (%MPT_DRIVER_CLASS enum value)
	*		*
	* This routine is called by a protocol-specific driver (SCSI host,		* This routine is called by a protocol-specific driver (SCSI host,
	* LAN, SCSI target) to register it's reply callback routine. Each		* LAN, SCSI target) to register its reply callback routine. Each
	* protocol-specific driver must do this before it will be able to		* protocol-specific driver must do this before it will be able to
	* use any IOC resources, such as obtaining request frames.		* use any IOC resources, such as obtaining request frames.
	*		*
	@@ -572,7 +574,7 @@ mpt_register(MPT_CALLBACK cbfunc, MPT_DRIVER_CLASS dclass)
	* mpt_deregister - Deregister a protocol drivers resources.		* mpt_deregister - Deregister a protocol drivers resources.
	* @cb_idx: previously registered callback handle		* @cb_idx: previously registered callback handle
	*		*
	* Each protocol-specific driver should call this routine when it's		* Each protocol-specific driver should call this routine when its