scsi: doc: fix iscsi-related kernel-doc warnings (ccd4a430) · Commits · 戴 / test

drivers/scsi/iscsi_tcp.c

+2 −0

Original line number	Diff line number	Diff line
		@@ -307,6 +307,7 @@ static int iscsi_sw_tcp_xmit_segment(struct iscsi_tcp_conn *tcp_conn,

		/**
		* iscsi_sw_tcp_xmit - TCP transmit
		* @conn: iscsi connection
		**/
		static int iscsi_sw_tcp_xmit(struct iscsi_conn *conn)
		{
		@@ -357,6 +358,7 @@ error:

		/**
		* iscsi_tcp_xmit_qlen - return the number of bytes queued for xmit
		* @conn: iscsi connection
		*/
		static inline int iscsi_sw_tcp_xmit_qlen(struct iscsi_conn *conn)
		{

+3 −1

Original line number	Diff line number	Diff line
		@@ -2744,8 +2744,10 @@ static void iscsi_host_dec_session_cnt(struct Scsi_Host *shost)
		* @iscsit: iscsi transport template
		* @shost: scsi host
		* @cmds_max: session can queue
		* @dd_size: private driver data size, added to session allocation size
		* @cmd_task_size: LLD task private data size
		* @initial_cmdsn: initial CmdSN
		* @id: target ID to add to this session
		*
		* This can be used by software iscsi_transports that allocate
		* a session per scsi host.
		@@ -2973,7 +2975,7 @@ EXPORT_SYMBOL_GPL(iscsi_conn_setup);

		/**
		* iscsi_conn_teardown - teardown iscsi connection
		* cls_conn: iscsi class connection
		* @cls_conn: iscsi class connection
		*
		* TODO: we may need to make this into a two step process
		* like scsi-mls remove + put host

+5 −4

Original line number	Diff line number	Diff line
		@@ -798,6 +798,8 @@ iscsi_tcp_hdr_dissect(struct iscsi_conn conn, struct iscsi_hdr hdr)

		/**
		* iscsi_tcp_hdr_recv_done - process PDU header
		* @tcp_conn: iSCSI TCP connection
		* @segment: the buffer segment being processed
		*
		* This is the callback invoked when the PDU header has
		* been received. If the header is followed by additional
		@@ -876,9 +878,10 @@ EXPORT_SYMBOL_GPL(iscsi_tcp_recv_segment_is_hdr);
		* @conn: iscsi connection
		* @skb: network buffer with header and/or data segment
		* @offset: offset in skb
		* @offload: bool indicating if transfer was offloaded
		* @offloaded: bool indicating if transfer was offloaded
		* @status: iscsi TCP status result
		*
		* Will return status of transfer in status. And will return
		* Will return status of transfer in @status. And will return
		* number of bytes copied.
		*/
		int iscsi_tcp_recv_skb(struct iscsi_conn conn, struct sk_buff skb,
		@@ -955,9 +958,7 @@ EXPORT_SYMBOL_GPL(iscsi_tcp_recv_skb);

		/**
		* iscsi_tcp_task_init - Initialize iSCSI SCSI_READ or SCSI_WRITE commands
		* @conn: iscsi connection
		* @task: scsi command task
		* @sc: scsi command
		*/
		int iscsi_tcp_task_init(struct iscsi_task *task)
		{