Commit 4a2a867f authored by Shaily Sangwan's avatar Shaily Sangwan Committed by Greg Kroah-Hartman
Browse files

staging: rtl8712: fix block comments 



This patch fixes the following checkpatch.pl warning:
Block comments use * on subsequent lines

Signed-off-by: default avatarShaily Sangwan <shaily15297@yahoo.com>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 12bc1d1e

drivers/staging/rtl8712/rtl8712_recv.h

+7 −7
Original line number Diff line number Diff line
@@ -116,12 +116,12 @@ struct recv_buf { 
};



/*

	head  ----->

		data  ----->

			payload

		tail  ----->

	end   ----->

	len = (unsigned int )(tail - data);

 *	head  ----->

 *		data  ----->

 *			payload

 *		tail  ----->

 *	end   ----->

 *	len = (unsigned int )(tail - data);

 */

struct recv_frame_hdr {

	struct list_head list;

drivers/staging/rtl8712/rtl871x_cmd.h

+132 −132
Original line number Diff line number Diff line
@@ -217,14 +217,14 @@ struct SetMacAddr_param { 
};



/*

Caller Ad-Hoc/AP



Command -Rsp(AID == CAMID) mode



This is to force fw to add an sta_data entry per driver's request.



FW will write an cam entry associated with it.



 *	Caller Ad-Hoc/AP

 *

 *	Command -Rsp(AID == CAMID) mode

 *

 *	This is to force fw to add an sta_data entry per driver's request.

 *

 *	FW will write an cam entry associated with it.

 *

 */

struct set_assocsta_parm {

	u8	addr[ETH_ALEN];
@@ -236,26 +236,26 @@ struct set_assocsta_rsp { 
};



/*

	Caller Ad-Hoc/AP



	Command mode



	This is to force fw to del an sta_data entry per driver's request



	FW will invalidate the cam entry associated with it.



 *	Caller Ad-Hoc/AP

 *

 *	Command mode

 *

 *	This is to force fw to del an sta_data entry per driver's request

 *

 *	FW will invalidate the cam entry associated with it.

 *

 */

struct del_assocsta_parm {

	u8	addr[ETH_ALEN];

};



/*

Caller Mode: AP/Ad-HoC(M)



Notes: To notify fw that given staid has changed its power state



Command Mode



 *	Caller Mode: AP/Ad-HoC(M)

 *

 *	Notes: To notify fw that given staid has changed its power state

 *

 *	Command Mode

 *

 */

struct setstapwrstate_parm {

	u8	staid;
@@ -264,24 +264,24 @@ struct setstapwrstate_parm { 
};



/*

Caller Mode: Any



Notes: To setup the basic rate of RTL8711



Command Mode



 *	Caller Mode: Any

 *

 *	Notes: To setup the basic rate of RTL8711

 *

 *	Command Mode

 *

 */

struct	setbasicrate_parm {

	u8	basicrates[NumRates];

};



/*

Caller Mode: Any



Notes: To read the current basic rate



Command-Rsp Mode



 *	Caller Mode: Any

 *

 *	Notes: To read the current basic rate

 *

 *	Command-Rsp Mode

 *

 */

struct getbasicrate_parm {

	u32 rsvd;
@@ -292,12 +292,12 @@ struct getbasicrate_rsp { 
};



/*

Caller Mode: Any



Notes: To setup the data rate of RTL8711



Command Mode



 *	Caller Mode: Any

 *

 *	Notes: To setup the data rate of RTL8711

 *

 *	Command Mode

 *

 */

struct setdatarate_parm {

	u8	mac_id;
@@ -334,12 +334,12 @@ struct SetChannelPlan_param { 
};



/*

Caller Mode: Any



Notes: To read the current data rate



Command-Rsp Mode



 *	Caller Mode: Any

 *

 *	Notes: To read the current data rate

 *

 *	Command-Rsp Mode

 *

 */

struct getdatarate_parm {

	u32 rsvd;
@@ -351,35 +351,35 @@ struct getdatarate_rsp { 




/*

Caller Mode: Any

AP: AP can use the info for the contents of beacon frame

Infra: STA can use the info when sitesurveying

Ad-HoC(M): Like AP

Ad-HoC(C): Like STA





Notes: To set the phy capability of the NIC



Command Mode



 *	Caller Mode: Any

 *	AP: AP can use the info for the contents of beacon frame

 *	Infra: STA can use the info when sitesurveying

 *	Ad-HoC(M): Like AP

 *	Ad-HoC(C): Like STA

 *

 *

 *	Notes: To set the phy capability of the NIC

 *

 *	Command Mode

 *

 */



/*

Caller Mode: Any



Notes: To set the channel/modem/band

This command will be used when channel/modem/band is changed.



Command Mode



 *	Caller Mode: Any

 *

 *	Notes: To set the channel/modem/band

 *	This command will be used when channel/modem/band is changed.

 *

 *	Command Mode

 *

 */

/*

Caller Mode: Any



Notes: To get the current setting of channel/modem/band



Command-Rsp Mode



 *	Caller Mode: Any

 *

 *	Notes: To get the current setting of channel/modem/band

 *

 *	Command-Rsp Mode

 *

 */

struct	getphy_rsp {

	u8	rfchannel;
@@ -430,57 +430,57 @@ struct getrfintfs_parm { 
};



/*

	Notes: This command is used for H2C/C2H loopback testing



	mac[0] == 0

	==> CMD mode, return H2C_SUCCESS.

	The following condition must be ture under CMD mode

		mac[1] == mac[4], mac[2] == mac[3], mac[0]=mac[5]= 0;

		s0 == 0x1234, s1 == 0xabcd, w0 == 0x78563412, w1 == 0x5aa5def7;

		s2 == (b1 << 8 | b0);



	mac[0] == 1

	==> CMD_RSP mode, return H2C_SUCCESS_RSP



	The rsp layout shall be:

	rsp:			parm:

		mac[0]  =   mac[5];

		mac[1]  =   mac[4];

		mac[2]  =   mac[3];

		mac[3]  =   mac[2];

		mac[4]  =   mac[1];

		mac[5]  =   mac[0];

		s0		=   s1;

		s1		=   swap16(s0);

		w0		=	swap32(w1);

		b0		=	b1

		s2		=	s0 + s1

		b1		=	b0

		w1		=	w0



	mac[0] ==	2

	==> CMD_EVENT mode, return	H2C_SUCCESS

	The event layout shall be:

	event:	     parm:

	mac[0]  =   mac[5];

	mac[1]  =   mac[4];

	mac[2]  =   event's sequence number, starting from 1 to parm's marc[3]

	mac[3]  =   mac[2];

	mac[4]  =   mac[1];

	mac[5]  =   mac[0];

	s0		=   swap16(s0) - event.mac[2];

	s1		=   s1 + event.mac[2];

	w0		=	swap32(w0);

	b0		=	b1

	s2		=	s0 + event.mac[2]

	b1		=	b0

	w1		=	swap32(w1) - event.mac[2];



	parm->mac[3] is the total event counts that host requested.





	event will be the same with the cmd's param.



 *	Notes: This command is used for H2C/C2H loopback testing

 *

 *	mac[0] == 0

 *	==> CMD mode, return H2C_SUCCESS.

 *	The following condition must be ture under CMD mode

 *		mac[1] == mac[4], mac[2] == mac[3], mac[0]=mac[5]= 0;

 *		s0 == 0x1234, s1 == 0xabcd, w0 == 0x78563412, w1 == 0x5aa5def7;

 *		s2 == (b1 << 8 | b0);

 *

 *	mac[0] == 1

 *	==> CMD_RSP mode, return H2C_SUCCESS_RSP

 *

 *	The rsp layout shall be:

 *	rsp:			parm:

 *		mac[0]  =   mac[5];

 *		mac[1]  =   mac[4];

 *		mac[2]  =   mac[3];

 *		mac[3]  =   mac[2];

 *		mac[4]  =   mac[1];

 *		mac[5]  =   mac[0];

 *		s0		=   s1;

 *		s1		=   swap16(s0);

 *		w0		=	swap32(w1);

 *		b0		=	b1

 *		s2		=	s0 + s1

 *		b1		=	b0

 *		w1		=	w0

 *

 *	mac[0] ==	2

 *	==> CMD_EVENT mode, return	H2C_SUCCESS

 *	The event layout shall be:

 *	event:	     parm:

 *	mac[0]  =   mac[5];

 *	mac[1]  =   mac[4];

 *	mac[2]  =   event's sequence number, starting from 1 to parm's marc[3]

 *	mac[3]  =   mac[2];

 *	mac[4]  =   mac[1];

 *	mac[5]  =   mac[0];

 *	s0		=   swap16(s0) - event.mac[2];

 *	s1		=   s1 + event.mac[2];

 *	w0		=	swap32(w0);

 *	b0		=	b1

 *	s2		=	s0 + event.mac[2]

 *	b1		=	b0

 *	w1		=	swap32(w1) - event.mac[2];

 *

 *	parm->mac[3] is the total event counts that host requested.

 *

 *

 *	event will be the same with the cmd's param.

 *

 */



/* CMD param Formart for DRV INTERNAL CMD HDL*/