Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

staging: rtl8712: fix block comments

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

Signed-off-by: Shaily Sangwan <shaily15297@yahoo.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Shaily Sangwan and committed by
Greg Kroah-Hartman
4a2a867f 12bc1d1e

+139 -139
+7 -7
drivers/staging/rtl8712/rtl8712_recv.h
··· 116 116 }; 117 117 118 118 /* 119 - head -----> 120 - data -----> 121 - payload 122 - tail -----> 123 - end -----> 124 - len = (unsigned int )(tail - data); 125 - */ 119 + * head -----> 120 + * data -----> 121 + * payload 122 + * tail -----> 123 + * end -----> 124 + * len = (unsigned int )(tail - data); 125 + */ 126 126 struct recv_frame_hdr { 127 127 struct list_head list; 128 128 _pkt *pkt;
+132 -132
drivers/staging/rtl8712/rtl871x_cmd.h
··· 217 217 }; 218 218 219 219 /* 220 - Caller Ad-Hoc/AP 221 - 222 - Command -Rsp(AID == CAMID) mode 223 - 224 - This is to force fw to add an sta_data entry per driver's request. 225 - 226 - FW will write an cam entry associated with it. 227 - 228 - */ 220 + * Caller Ad-Hoc/AP 221 + * 222 + * Command -Rsp(AID == CAMID) mode 223 + * 224 + * This is to force fw to add an sta_data entry per driver's request. 225 + * 226 + * FW will write an cam entry associated with it. 227 + * 228 + */ 229 229 struct set_assocsta_parm { 230 230 u8 addr[ETH_ALEN]; 231 231 }; ··· 236 236 }; 237 237 238 238 /* 239 - Caller Ad-Hoc/AP 240 - 241 - Command mode 242 - 243 - This is to force fw to del an sta_data entry per driver's request 244 - 245 - FW will invalidate the cam entry associated with it. 246 - 247 - */ 239 + * Caller Ad-Hoc/AP 240 + * 241 + * Command mode 242 + * 243 + * This is to force fw to del an sta_data entry per driver's request 244 + * 245 + * FW will invalidate the cam entry associated with it. 246 + * 247 + */ 248 248 struct del_assocsta_parm { 249 249 u8 addr[ETH_ALEN]; 250 250 }; 251 251 252 252 /* 253 - Caller Mode: AP/Ad-HoC(M) 254 - 255 - Notes: To notify fw that given staid has changed its power state 256 - 257 - Command Mode 258 - 259 - */ 253 + * Caller Mode: AP/Ad-HoC(M) 254 + * 255 + * Notes: To notify fw that given staid has changed its power state 256 + * 257 + * Command Mode 258 + * 259 + */ 260 260 struct setstapwrstate_parm { 261 261 u8 staid; 262 262 u8 status; ··· 264 264 }; 265 265 266 266 /* 267 - Caller Mode: Any 268 - 269 - Notes: To setup the basic rate of RTL8711 270 - 271 - Command Mode 272 - 273 - */ 267 + * Caller Mode: Any 268 + * 269 + * Notes: To setup the basic rate of RTL8711 270 + * 271 + * Command Mode 272 + * 273 + */ 274 274 struct setbasicrate_parm { 275 275 u8 basicrates[NumRates]; 276 276 }; 277 277 278 278 /* 279 - Caller Mode: Any 280 - 281 - Notes: To read the current basic rate 282 - 283 - Command-Rsp Mode 284 - 285 - */ 279 + * Caller Mode: Any 280 + * 281 + * Notes: To read the current basic rate 282 + * 283 + * Command-Rsp Mode 284 + * 285 + */ 286 286 struct getbasicrate_parm { 287 287 u32 rsvd; 288 288 }; ··· 292 292 }; 293 293 294 294 /* 295 - Caller Mode: Any 296 - 297 - Notes: To setup the data rate of RTL8711 298 - 299 - Command Mode 300 - 301 - */ 295 + * Caller Mode: Any 296 + * 297 + * Notes: To setup the data rate of RTL8711 298 + * 299 + * Command Mode 300 + * 301 + */ 302 302 struct setdatarate_parm { 303 303 u8 mac_id; 304 304 u8 datarates[NumRates]; ··· 334 334 }; 335 335 336 336 /* 337 - Caller Mode: Any 338 - 339 - Notes: To read the current data rate 340 - 341 - Command-Rsp Mode 342 - 343 - */ 337 + * Caller Mode: Any 338 + * 339 + * Notes: To read the current data rate 340 + * 341 + * Command-Rsp Mode 342 + * 343 + */ 344 344 struct getdatarate_parm { 345 345 u32 rsvd; 346 346 ··· 351 351 352 352 353 353 /* 354 - Caller Mode: Any 355 - AP: AP can use the info for the contents of beacon frame 356 - Infra: STA can use the info when sitesurveying 357 - Ad-HoC(M): Like AP 358 - Ad-HoC(C): Like STA 359 - 360 - 361 - Notes: To set the phy capability of the NIC 362 - 363 - Command Mode 364 - 365 - */ 354 + * Caller Mode: Any 355 + * AP: AP can use the info for the contents of beacon frame 356 + * Infra: STA can use the info when sitesurveying 357 + * Ad-HoC(M): Like AP 358 + * Ad-HoC(C): Like STA 359 + * 360 + * 361 + * Notes: To set the phy capability of the NIC 362 + * 363 + * Command Mode 364 + * 365 + */ 366 366 367 367 /* 368 - Caller Mode: Any 369 - 370 - Notes: To set the channel/modem/band 371 - This command will be used when channel/modem/band is changed. 372 - 373 - Command Mode 374 - 375 - */ 368 + * Caller Mode: Any 369 + * 370 + * Notes: To set the channel/modem/band 371 + * This command will be used when channel/modem/band is changed. 372 + * 373 + * Command Mode 374 + * 375 + */ 376 376 /* 377 - Caller Mode: Any 378 - 379 - Notes: To get the current setting of channel/modem/band 380 - 381 - Command-Rsp Mode 382 - 383 - */ 377 + * Caller Mode: Any 378 + * 379 + * Notes: To get the current setting of channel/modem/band 380 + * 381 + * Command-Rsp Mode 382 + * 383 + */ 384 384 struct getphy_rsp { 385 385 u8 rfchannel; 386 386 u8 modem; ··· 430 430 }; 431 431 432 432 /* 433 - Notes: This command is used for H2C/C2H loopback testing 434 - 435 - mac[0] == 0 436 - ==> CMD mode, return H2C_SUCCESS. 437 - The following condition must be ture under CMD mode 438 - mac[1] == mac[4], mac[2] == mac[3], mac[0]=mac[5]= 0; 439 - s0 == 0x1234, s1 == 0xabcd, w0 == 0x78563412, w1 == 0x5aa5def7; 440 - s2 == (b1 << 8 | b0); 441 - 442 - mac[0] == 1 443 - ==> CMD_RSP mode, return H2C_SUCCESS_RSP 444 - 445 - The rsp layout shall be: 446 - rsp: parm: 447 - mac[0] = mac[5]; 448 - mac[1] = mac[4]; 449 - mac[2] = mac[3]; 450 - mac[3] = mac[2]; 451 - mac[4] = mac[1]; 452 - mac[5] = mac[0]; 453 - s0 = s1; 454 - s1 = swap16(s0); 455 - w0 = swap32(w1); 456 - b0 = b1 457 - s2 = s0 + s1 458 - b1 = b0 459 - w1 = w0 460 - 461 - mac[0] == 2 462 - ==> CMD_EVENT mode, return H2C_SUCCESS 463 - The event layout shall be: 464 - event: parm: 465 - mac[0] = mac[5]; 466 - mac[1] = mac[4]; 467 - mac[2] = event's sequence number, starting from 1 to parm's marc[3] 468 - mac[3] = mac[2]; 469 - mac[4] = mac[1]; 470 - mac[5] = mac[0]; 471 - s0 = swap16(s0) - event.mac[2]; 472 - s1 = s1 + event.mac[2]; 473 - w0 = swap32(w0); 474 - b0 = b1 475 - s2 = s0 + event.mac[2] 476 - b1 = b0 477 - w1 = swap32(w1) - event.mac[2]; 478 - 479 - parm->mac[3] is the total event counts that host requested. 480 - 481 - 482 - event will be the same with the cmd's param. 483 - 484 - */ 433 + * Notes: This command is used for H2C/C2H loopback testing 434 + * 435 + * mac[0] == 0 436 + * ==> CMD mode, return H2C_SUCCESS. 437 + * The following condition must be ture under CMD mode 438 + * mac[1] == mac[4], mac[2] == mac[3], mac[0]=mac[5]= 0; 439 + * s0 == 0x1234, s1 == 0xabcd, w0 == 0x78563412, w1 == 0x5aa5def7; 440 + * s2 == (b1 << 8 | b0); 441 + * 442 + * mac[0] == 1 443 + * ==> CMD_RSP mode, return H2C_SUCCESS_RSP 444 + * 445 + * The rsp layout shall be: 446 + * rsp: parm: 447 + * mac[0] = mac[5]; 448 + * mac[1] = mac[4]; 449 + * mac[2] = mac[3]; 450 + * mac[3] = mac[2]; 451 + * mac[4] = mac[1]; 452 + * mac[5] = mac[0]; 453 + * s0 = s1; 454 + * s1 = swap16(s0); 455 + * w0 = swap32(w1); 456 + * b0 = b1 457 + * s2 = s0 + s1 458 + * b1 = b0 459 + * w1 = w0 460 + * 461 + * mac[0] == 2 462 + * ==> CMD_EVENT mode, return H2C_SUCCESS 463 + * The event layout shall be: 464 + * event: parm: 465 + * mac[0] = mac[5]; 466 + * mac[1] = mac[4]; 467 + * mac[2] = event's sequence number, starting from 1 to parm's marc[3] 468 + * mac[3] = mac[2]; 469 + * mac[4] = mac[1]; 470 + * mac[5] = mac[0]; 471 + * s0 = swap16(s0) - event.mac[2]; 472 + * s1 = s1 + event.mac[2]; 473 + * w0 = swap32(w0); 474 + * b0 = b1 475 + * s2 = s0 + event.mac[2] 476 + * b1 = b0 477 + * w1 = swap32(w1) - event.mac[2]; 478 + * 479 + * parm->mac[3] is the total event counts that host requested. 480 + * 481 + * 482 + * event will be the same with the cmd's param. 483 + * 484 + */ 485 485 486 486 /* CMD param Formart for DRV INTERNAL CMD HDL*/ 487 487 struct drvint_cmd_parm {