diff options
author | Jing Huang <huangj@brocade.com> | 2010-10-18 20:15:55 -0400 |
---|---|---|
committer | James Bottomley <James.Bottomley@suse.de> | 2010-10-25 17:26:57 -0400 |
commit | acdc79a60cb3cbbc9f07bb5032d890e9cf94f0ff (patch) | |
tree | cea700a23bf6e96e084bee54392b11bc4d307710 /drivers/scsi/bfa/bfa_fc.h | |
parent | e0a08a30c9451333c9c4a8981fbfccc80b87ce78 (diff) |
[SCSI] bfa: fix comments for header files
This patch addresses the comments from Randy Dunlap (Randy.Dunlap@oracle.com)
regarding comment blocks that begining with "/**". bfa driver comments
currently do not follow kernel-doc convention, we hence replace all
/** with /* and **/ with */.
Signed-off-by: Jing Huang <huangj@brocade.com>
Signed-off-by: James Bottomley <James.Bottomley@suse.de>
Diffstat (limited to 'drivers/scsi/bfa/bfa_fc.h')
-rw-r--r-- | drivers/scsi/bfa/bfa_fc.h | 30 |
1 files changed, 15 insertions, 15 deletions
diff --git a/drivers/scsi/bfa/bfa_fc.h b/drivers/scsi/bfa/bfa_fc.h index 6eff705564eb..e929d25b09e3 100644 --- a/drivers/scsi/bfa/bfa_fc.h +++ b/drivers/scsi/bfa/bfa_fc.h | |||
@@ -1029,7 +1029,7 @@ struct link_e2e_beacon_req_s { | |||
1029 | struct link_e2e_beacon_param_s beacon_parm; | 1029 | struct link_e2e_beacon_param_s beacon_parm; |
1030 | }; | 1030 | }; |
1031 | 1031 | ||
1032 | /** | 1032 | /* |
1033 | * If RPSC request is sent to the Domain Controller, the request is for | 1033 | * If RPSC request is sent to the Domain Controller, the request is for |
1034 | * all the ports within that domain (TODO - I don't think FOS implements | 1034 | * all the ports within that domain (TODO - I don't think FOS implements |
1035 | * this...). | 1035 | * this...). |
@@ -1049,7 +1049,7 @@ struct fc_rpsc_acc_s { | |||
1049 | struct fc_rpsc_speed_info_s speed_info[1]; | 1049 | struct fc_rpsc_speed_info_s speed_info[1]; |
1050 | }; | 1050 | }; |
1051 | 1051 | ||
1052 | /** | 1052 | /* |
1053 | * If RPSC2 request is sent to the Domain Controller, | 1053 | * If RPSC2 request is sent to the Domain Controller, |
1054 | */ | 1054 | */ |
1055 | #define FC_BRCD_TOKEN 0x42524344 | 1055 | #define FC_BRCD_TOKEN 0x42524344 |
@@ -1094,7 +1094,7 @@ struct fc_rpsc2_acc_s { | |||
1094 | struct fc_rpsc2_port_info_s port_info[1]; /* port information */ | 1094 | struct fc_rpsc2_port_info_s port_info[1]; /* port information */ |
1095 | }; | 1095 | }; |
1096 | 1096 | ||
1097 | /** | 1097 | /* |
1098 | * bit fields so that multiple classes can be specified | 1098 | * bit fields so that multiple classes can be specified |
1099 | */ | 1099 | */ |
1100 | enum fc_cos { | 1100 | enum fc_cos { |
@@ -1131,7 +1131,7 @@ struct fc_alpabm_s { | |||
1131 | #define FC_VF_ID_MAX 0xEFF | 1131 | #define FC_VF_ID_MAX 0xEFF |
1132 | #define FC_VF_ID_CTL 0xFEF /* control VF_ID */ | 1132 | #define FC_VF_ID_CTL 0xFEF /* control VF_ID */ |
1133 | 1133 | ||
1134 | /** | 1134 | /* |
1135 | * Virtual Fabric Tagging header format | 1135 | * Virtual Fabric Tagging header format |
1136 | * @caution This is defined only in BIG ENDIAN format. | 1136 | * @caution This is defined only in BIG ENDIAN format. |
1137 | */ | 1137 | */ |
@@ -1463,7 +1463,7 @@ struct fcgs_gidpn_resp_s { | |||
1463 | u32 dap:24; /* port identifier */ | 1463 | u32 dap:24; /* port identifier */ |
1464 | }; | 1464 | }; |
1465 | 1465 | ||
1466 | /** | 1466 | /* |
1467 | * RFT_ID | 1467 | * RFT_ID |
1468 | */ | 1468 | */ |
1469 | struct fcgs_rftid_req_s { | 1469 | struct fcgs_rftid_req_s { |
@@ -1472,7 +1472,7 @@ struct fcgs_rftid_req_s { | |||
1472 | u32 fc4_type[8]; /* fc4 types */ | 1472 | u32 fc4_type[8]; /* fc4 types */ |
1473 | }; | 1473 | }; |
1474 | 1474 | ||
1475 | /** | 1475 | /* |
1476 | * RFF_ID : Register FC4 features. | 1476 | * RFF_ID : Register FC4 features. |
1477 | */ | 1477 | */ |
1478 | 1478 | ||
@@ -1487,7 +1487,7 @@ struct fcgs_rffid_req_s { | |||
1487 | u32 fc4_type:8; /* corresponding FC4 Type */ | 1487 | u32 fc4_type:8; /* corresponding FC4 Type */ |
1488 | }; | 1488 | }; |
1489 | 1489 | ||
1490 | /** | 1490 | /* |
1491 | * GID_FT Request | 1491 | * GID_FT Request |
1492 | */ | 1492 | */ |
1493 | struct fcgs_gidft_req_s { | 1493 | struct fcgs_gidft_req_s { |
@@ -1497,7 +1497,7 @@ struct fcgs_gidft_req_s { | |||
1497 | u8 fc4_type; /* FC_TYPE_FCP for SCSI devices */ | 1497 | u8 fc4_type; /* FC_TYPE_FCP for SCSI devices */ |
1498 | }; /* GID_FT Request */ | 1498 | }; /* GID_FT Request */ |
1499 | 1499 | ||
1500 | /** | 1500 | /* |
1501 | * GID_FT Response | 1501 | * GID_FT Response |
1502 | */ | 1502 | */ |
1503 | struct fcgs_gidft_resp_s { | 1503 | struct fcgs_gidft_resp_s { |
@@ -1506,7 +1506,7 @@ struct fcgs_gidft_resp_s { | |||
1506 | u32 pid:24; /* port identifier */ | 1506 | u32 pid:24; /* port identifier */ |
1507 | }; /* GID_FT Response */ | 1507 | }; /* GID_FT Response */ |
1508 | 1508 | ||
1509 | /** | 1509 | /* |
1510 | * RSPN_ID | 1510 | * RSPN_ID |
1511 | */ | 1511 | */ |
1512 | struct fcgs_rspnid_req_s { | 1512 | struct fcgs_rspnid_req_s { |
@@ -1516,7 +1516,7 @@ struct fcgs_rspnid_req_s { | |||
1516 | u8 spn[256]; /* symbolic port name */ | 1516 | u8 spn[256]; /* symbolic port name */ |
1517 | }; | 1517 | }; |
1518 | 1518 | ||
1519 | /** | 1519 | /* |
1520 | * RPN_ID | 1520 | * RPN_ID |
1521 | */ | 1521 | */ |
1522 | struct fcgs_rpnid_req_s { | 1522 | struct fcgs_rpnid_req_s { |
@@ -1525,7 +1525,7 @@ struct fcgs_rpnid_req_s { | |||
1525 | wwn_t port_name; | 1525 | wwn_t port_name; |
1526 | }; | 1526 | }; |
1527 | 1527 | ||
1528 | /** | 1528 | /* |
1529 | * RNN_ID | 1529 | * RNN_ID |
1530 | */ | 1530 | */ |
1531 | struct fcgs_rnnid_req_s { | 1531 | struct fcgs_rnnid_req_s { |
@@ -1534,7 +1534,7 @@ struct fcgs_rnnid_req_s { | |||
1534 | wwn_t node_name; | 1534 | wwn_t node_name; |
1535 | }; | 1535 | }; |
1536 | 1536 | ||
1537 | /** | 1537 | /* |
1538 | * RCS_ID | 1538 | * RCS_ID |
1539 | */ | 1539 | */ |
1540 | struct fcgs_rcsid_req_s { | 1540 | struct fcgs_rcsid_req_s { |
@@ -1543,7 +1543,7 @@ struct fcgs_rcsid_req_s { | |||
1543 | u32 cos; | 1543 | u32 cos; |
1544 | }; | 1544 | }; |
1545 | 1545 | ||
1546 | /** | 1546 | /* |
1547 | * RPT_ID | 1547 | * RPT_ID |
1548 | */ | 1548 | */ |
1549 | struct fcgs_rptid_req_s { | 1549 | struct fcgs_rptid_req_s { |
@@ -1553,7 +1553,7 @@ struct fcgs_rptid_req_s { | |||
1553 | u32 rsvd1:24; | 1553 | u32 rsvd1:24; |
1554 | }; | 1554 | }; |
1555 | 1555 | ||
1556 | /** | 1556 | /* |
1557 | * GA_NXT Request | 1557 | * GA_NXT Request |
1558 | */ | 1558 | */ |
1559 | struct fcgs_ganxt_req_s { | 1559 | struct fcgs_ganxt_req_s { |
@@ -1561,7 +1561,7 @@ struct fcgs_ganxt_req_s { | |||
1561 | u32 port_id:24; | 1561 | u32 port_id:24; |
1562 | }; | 1562 | }; |
1563 | 1563 | ||
1564 | /** | 1564 | /* |
1565 | * GA_NXT Response | 1565 | * GA_NXT Response |
1566 | */ | 1566 | */ |
1567 | struct fcgs_ganxt_rsp_s { | 1567 | struct fcgs_ganxt_rsp_s { |