Staging: winbond: fix comments coding style issue in mac_structures.h
authorRuslan Pisarev <ruslan@rpisarev.org.ua>
Sat, 20 Mar 2010 14:29:01 +0000 (16:29 +0200)
committerGreg Kroah-Hartman <gregkh@suse.de>
Tue, 11 May 2010 18:35:48 +0000 (11:35 -0700)
This is a patch to the mac_structures.h file that fixed up a comments
Errors found by the checkpatch.pl tool

Signed-off-by: Ruslan Pisarev <ruslan@rpisarev.org.ua>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
drivers/staging/winbond/mac_structures.h

index f24dbb9..80d7e4a 100644 (file)
@@ -1,4 +1,4 @@
-//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+/*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 // MAC_Structures.h
 //
 // This file contains the definitions and data structures used by SW-MAC.
 //                      Deleted some unused.
 //          20021129    PD43 Austin
 //                     20030617        increase the 802.11g definition
-//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*/
 
 #ifndef _MAC_Structures_H_
 #define _MAC_Structures_H_
 
 #include <linux/skbuff.h>
 
-//=========================================================
+/*=========================================================
 // Some miscellaneous definitions
-//-----
+//-----*/
 #define MAX_CHANNELS                        30
 #define MAC_ADDR_LENGTH                     6
-#define MAX_WEP_KEY_SIZE                    16  // 128 bits
-#define        MAX_802_11_FRAGMENT_NUMBER              10 // By spec
+#define MAX_WEP_KEY_SIZE                    16  /* 128 bits */
+#define        MAX_802_11_FRAGMENT_NUMBER              10 /* By spec */
 
-//========================================================
+/========================================================
 // 802.11 Frame define
-//-----
+//----- */
 #define MASK_PROTOCOL_VERSION_TYPE     0x0F
 #define MASK_FRAGMENT_NUMBER           0x000F
 #define SEQUENCE_NUMBER_SHIFT          4
@@ -41,8 +41,8 @@
 #define DOT_11_MAC_HEADER_SIZE         24
 #define DOT_11_SNAP_SIZE                       6
 #define DOT_11_DURATION_OFFSET         2
-#define DOT_11_SEQUENCE_OFFSET         22 //Sequence control offset
-#define DOT_11_TYPE_OFFSET                     30 //The start offset of 802.11 Frame//
+#define DOT_11_SEQUENCE_OFFSET         22 /* Sequence control offset */
+#define DOT_11_TYPE_OFFSET                     30 /* The start offset of 802.11 Frame// */
 #define DOT_11_DATA_OFFSET          24
 #define DOT_11_DA_OFFSET                       4
 #define DOT_3_TYPE_ARP                         0x80F3
@@ -54,7 +54,7 @@
 #define MAX_ETHERNET_PACKET_SIZE               1514
 
 
-//-----  management : Type of Bits (2, 3) and Subtype of Bits (4, 5, 6, 7)
+/* -----  management : Type of Bits (2, 3) and Subtype of Bits (4, 5, 6, 7) */
 #define MAC_SUBTYPE_MNGMNT_ASSOC_REQUEST    0x00
 #define MAC_SUBTYPE_MNGMNT_ASSOC_RESPONSE   0x10
 #define MAC_SUBTYPE_MNGMNT_REASSOC_REQUEST  0x20
@@ -67,7 +67,7 @@
 #define MAC_SUBTYPE_MNGMNT_AUTHENTICATION   0xB0
 #define MAC_SUBTYPE_MNGMNT_DEAUTHENTICATION 0xC0
 
-//-----  control : Type of Bits (2, 3) and Subtype of Bits (4, 5, 6, 7)
+/* -----  control : Type of Bits (2, 3) and Subtype of Bits (4, 5, 6, 7) */
 #define MAC_SUBTYPE_CONTROL_PSPOLL          0xA4
 #define MAC_SUBTYPE_CONTROL_RTS             0xB4
 #define MAC_SUBTYPE_CONTROL_CTS             0xC4
@@ -75,7 +75,7 @@
 #define MAC_SUBTYPE_CONTROL_CFEND           0xE4
 #define MAC_SUBTYPE_CONTROL_CFEND_CFACK     0xF4
 
-//-----  data : Type of Bits (2, 3) and Subtype of Bits (4, 5, 6, 7)
+/* -----  data : Type of Bits (2, 3) and Subtype of Bits (4, 5, 6, 7) */
 #define MAC_SUBTYPE_DATA                    0x08
 #define MAC_SUBTYPE_DATA_CFACK              0x18
 #define MAC_SUBTYPE_DATA_CFPOLL             0x28
 #define MAC_SUBTYPE_DATA_CFPOLL_NULL        0x68
 #define MAC_SUBTYPE_DATA_CFACK_CFPOLL_NULL  0x78
 
-//-----  Frame Type of Bits (2, 3)
+/* -----  Frame Type of Bits (2, 3) */
 #define MAC_TYPE_MANAGEMENT                 0x00
 #define MAC_TYPE_CONTROL                    0x04
 #define MAC_TYPE_DATA                       0x08
 
-//----- definitions for Management Frame Element ID (1 BYTE)
+/* ----- definitions for Management Frame Element ID (1 BYTE) */
 #define ELEMENT_ID_SSID                     0
 #define ELEMENT_ID_SUPPORTED_RATES          1
 #define ELEMENT_ID_FH_PARAMETER_SET         2
 #define REASON_CLASS3_FRAME_FROM_NONASSO_STA    7
 #define DISASS_REASON_LEFT_BSS      8
 #define REASON_NOT_AUTH_YET         9
-//802.11i define
+/* 802.11i define */
 #define REASON_INVALID_IE                                              13
 #define REASON_MIC_ERROR                                               14
 #define REASON_4WAY_HANDSHAKE_TIMEOUT                  15
@@ -175,11 +175,11 @@ enum enum_MMPDUResultCode
 } WB_MMPDURESULTCODE, *PWB_MMPDURESULTCODE;
 */
 
-//===========================================================
+/*===========================================================
 // enum_TxRate --
 //   Define the transmission constants based on W89C32 MAC
 //   target specification.
-//===========================================================
+//===========================================================*/
 typedef enum enum_TxRate
 {
     TXRATE_1M               = 0,
@@ -189,7 +189,7 @@ typedef enum enum_TxRate
     TXRATE_55MSHORT         = 5,
     TXRATE_11MLONG          = 6,
     TXRATE_11MSHORT         = 7,
-    TXRATE_AUTO             = 255           // PD43 20021108
+    TXRATE_AUTO             = 255           /* PD43 20021108 */
 } WB_TXRATE, *PWB_TXRATE;
 
 
@@ -225,7 +225,7 @@ typedef enum enum_TxRate
 #define RATE_54M                                       108
 #define RATE_MAX                                       255
 
-//CAPABILITY
+/* CAPABILITY */
 #define CAPABILITY_ESS_BIT                             0x0001
 #define CAPABILITY_IBSS_BIT                            0x0002
 #define CAPABILITY_CF_POLL_BIT                 0x0004
@@ -243,10 +243,10 @@ struct Capability_Information_Element
   union
   {
        u16 __attribute__ ((packed)) wValue;
-    #ifdef _BIG_ENDIAN_  //20060926 add by anson's endian
+    #ifdef _BIG_ENDIAN_  /* 20060926 add by anson's endian */
     struct _Capability
     {
-        //--  11G  --
+        /* --  11G  -- */
        u8      Reserved3 : 2;
        u8      DSSS_OFDM : 1;
        u8      Reserved2 : 2;
@@ -273,7 +273,7 @@ struct Capability_Information_Element
         u8    PBCC : 1;
         u8    Channel_Agility : 1;
         u8    Reserved1 : 2;
-               //--  11G  --
+               /* --  11G  -- */
                u8      Short_Slot_Time : 1;
                u8      Reserved2 : 2;
                u8      DSSS_OFDM : 1;
@@ -320,8 +320,8 @@ struct CF_Parameter_Set_Element
     u8    Length;
     u8    CFP_Count;
     u8    CFP_Period;
-    u8    CFP_MaxDuration[2];     // in Time Units
-    u8    CFP_DurRemaining[2];    // in time units
+    u8    CFP_MaxDuration[2];     /* in Time Units */
+    u8    CFP_DurRemaining[2];    /* in time units */
 };
 
 struct TIM_Element
@@ -350,8 +350,8 @@ struct Challenge_Text_Element
 
 struct PHY_Parameter_Set_Element
 {
-//  int     aSlotTime;
-//  int     aSifsTime;
+/*  int     aSlotTime; */
+/*  int     aSifsTime; */
     s32     aCCATime;
     s32     aRxTxTurnaroundTime;
     s32     aTxPLCPDelay;
@@ -367,17 +367,17 @@ struct PHY_Parameter_Set_Element
     s32     aPLCPHeaderLength;
     s32     aMPDUDurationFactor;
     s32     aMPDUMaxLength;
-//  int     aCWmin;
-//  int     aCWmax;
+/*  int     aCWmin; */
+/*  int     aCWmax; */
 };
 
-//--  11G  --
+/* --  11G  -- */
 struct ERP_Information_Element
 {
     u8 Element_ID;
     u8 Length;
-    #ifdef _BIG_ENDIAN_ //20060926 add by anson's endian
-       u8      Reserved:5;   //20060926 add by anson
+    #ifdef _BIG_ENDIAN_ /* 20060926 add by anson's endian */
+       u8      Reserved:5;   /* 20060926 add by anson */
        u8      Barker_Preamble_Mode:1;
        u8      Use_Protection:1;
        u8      NonERP_Present:1;
@@ -396,41 +396,41 @@ struct Extended_Supported_Rates_Element
     u8 ExtendedSupportedRates[255];
 }__attribute__ ((packed));
 
-//WPA(802.11i draft 3.0)
+/* WPA(802.11i draft 3.0) */
 #define VERSION_WPA                            1
 #ifdef _WPA2_
 #define VERSION_WPA2            1
-#endif //end def  _WPA2_
-#define OUI_WPA                                        0x00F25000      //WPA2.0 OUI=00:50:F2, the MSB is reserved for suite type
+#endif /* end def  _WPA2_ */
+#define OUI_WPA                                        0x00F25000      /* WPA2.0 OUI=00:50:F2, the MSB is reserved for suite type */
 #ifdef _WPA2_
-#define OUI_WPA2                               0x00AC0F00      // for wpa2 change to 0x00ACOF04 by Ws 26/04/04
-#endif //end def _WPA2_
+#define OUI_WPA2                               0x00AC0F00      /* for wpa2 change to 0x00ACOF04 by Ws 26/04/04 */
+#endif /* end def _WPA2_ */
 
 #define OUI_WPA_ADDITIONAL             0x01
-#define WLAN_MIN_RSN_WPA_LENGTH                 6 //added by ws 09/10/04
+#define WLAN_MIN_RSN_WPA_LENGTH                 6 /* added by ws 09/10/04 */
 #ifdef _WPA2_
-#define WLAN_MIN_RSN_WPA2_LENGTH                2 // Fix to 2 09/14/05
-#endif //end def _WPA2_
+#define WLAN_MIN_RSN_WPA2_LENGTH                2 /* Fix to 2 09/14/05 */
+#endif /* end def _WPA2_ */
 
 #define oui_wpa                  (u32)(OUI_WPA|OUI_WPA_ADDITIONAL)
 
-#define WPA_OUI_BIG    ((u32) 0x01F25000)//added by ws 09/23/04
-#define WPA_OUI_LITTLE  ((u32) 0x01F25001)//added by ws 09/23/04
+#define WPA_OUI_BIG    ((u32) 0x01F25000)/* added by ws 09/23/04 */
+#define WPA_OUI_LITTLE  ((u32) 0x01F25001)/* added by ws 09/23/04 */
 
-#define WPA_WPS_OUI                            cpu_to_le32(0x04F25000) // 20061108 For WPS. It's little endian. Big endian is 0x0050F204
+#define WPA_WPS_OUI                            cpu_to_le32(0x04F25000) /* 20061108 For WPS. It's little endian. Big endian is 0x0050F204 */
 
-//-----WPA2-----
+/* -----WPA2----- */
 #ifdef _WPA2_
 #define WPA2_OUI_BIG    ((u32)0x01AC0F00)
 #define WPA2_OUI_LITTLE ((u32)0x01AC0F01)
-#endif //end def _WPA2_
+#endif /* end def _WPA2_ */
 
-//Authentication suite
-#define OUI_AUTH_WPA_NONE           0x00 //for WPA_NONE
+/* Authentication suite */
+#define OUI_AUTH_WPA_NONE           0x00 /* for WPA_NONE */
 #define OUI_AUTH_8021X                         0x01
 #define OUI_AUTH_PSK                           0x02
-//Cipher suite
-#define OUI_CIPHER_GROUP_KEY        0x00  //added by ws 05/21/04
+/* Cipher suite */
+#define OUI_CIPHER_GROUP_KEY        0x00  /* added by ws 05/21/04 */
 #define OUI_CIPHER_WEP_40                      0x01
 #define OUI_CIPHER_TKIP                                0x02
 #define OUI_CIPHER_CCMP                                0x04
@@ -466,16 +466,16 @@ struct RSN_Auth_Sub_Information_Element
        struct suite_selector   AuthKeyMngtSuite[1];
 }__attribute__ ((packed));
 
-//--  WPA2  --
+/* --  WPA2  -- */
 struct RSN_Capability_Element
 {
   union
   {
        u16     __attribute__ ((packed))        wValue;
-    #ifdef _BIG_ENDIAN_         //20060927 add by anson's endian
+    #ifdef _BIG_ENDIAN_         /* 20060927 add by anson's endian */
     struct _RSN_Capability
     {
-       u16   __attribute__ ((packed))  Reserved2 : 8; // 20051201
+       u16   __attribute__ ((packed))  Reserved2 : 8; /* 20051201 */
        u16   __attribute__ ((packed))  Reserved1 : 2;
        u16   __attribute__ ((packed))  GTK_Replay_Counter : 2;
        u16   __attribute__ ((packed))  PTK_Replay_Counter : 2;
@@ -490,7 +490,7 @@ struct RSN_Capability_Element
         u16   __attribute__ ((packed))  PTK_Replay_Counter : 2;
            u16   __attribute__ ((packed))  GTK_Replay_Counter : 2;
            u16   __attribute__ ((packed))  Reserved1 : 2;
-           u16   __attribute__ ((packed))  Reserved2 : 8; // 20051201
+           u16   __attribute__ ((packed))  Reserved2 : 8; /* 20051201 */
     }__attribute__ ((packed))  RSN_Capability;
     #endif
 
@@ -527,14 +527,14 @@ struct PMKID_Information_Element
        struct pmkid pmkid[16];
 }__attribute__ ((packed));
 
-#endif //enddef _WPA2_
-//============================================================
+#endif /* enddef _WPA2_ */
+/*============================================================
 // MAC Frame structure (different type) and subfield structure
-//============================================================
+//============================================================*/
 struct MAC_frame_control
 {
-    u8    mac_frame_info; // a combination of the [Protocol Version, Control Type, Control Subtype]
-    #ifdef _BIG_ENDIAN_ //20060927 add by anson's endian
+    u8    mac_frame_info; /* a combination of the [Protocol Version, Control Type, Control Subtype]*/
+    #ifdef _BIG_ENDIAN_ /* 20060927 add by anson's endian */
     u8    order:1;
     u8    WEP:1;
     u8    more_data:1;
@@ -556,19 +556,19 @@ struct MAC_frame_control
 } __attribute__ ((packed));
 
 struct Management_Frame {
-    struct MAC_frame_control frame_control; // 2B, ToDS,FromDS,MoreFrag,MoreData,Order=0
+    struct MAC_frame_control frame_control; /* 2B, ToDS,FromDS,MoreFrag,MoreData,Order=0 */
     u16                duration;
-    u8         DA[MAC_ADDR_LENGTH];                    // Addr1
-    u8         SA[MAC_ADDR_LENGTH];                    // Addr2
-    u8         BSSID[MAC_ADDR_LENGTH];                 // Addr3
+    u8         DA[MAC_ADDR_LENGTH];                    /* Addr1 */
+    u8         SA[MAC_ADDR_LENGTH];                    /* Addr2 */
+    u8         BSSID[MAC_ADDR_LENGTH];                 /* Addr3 */
     u16                Sequence_Control;
-    // Management Frame Body <= 325 bytes
-    // FCS 4 bytes
+    /* Management Frame Body <= 325 bytes */
+    /* FCS 4 bytes */
 }__attribute__ ((packed));
 
-// SW-MAC don't Tx/Rx Control-Frame, HW-MAC do it.
+/* SW-MAC don't Tx/Rx Control-Frame, HW-MAC do it. */
 struct Control_Frame {
-    struct MAC_frame_control frame_control; // ToDS,FromDS,MoreFrag,Retry,MoreData,WEP,Order=0
+    struct MAC_frame_control frame_control; /* ToDS,FromDS,MoreFrag,Retry,MoreData,WEP,Order=0 */
     u16                duration;
     u8         RA[MAC_ADDR_LENGTH];
     u8         TA[MAC_ADDR_LENGTH];
@@ -582,9 +582,9 @@ struct Data_Frame {
     u8         Addr2[MAC_ADDR_LENGTH];
     u8         Addr3[MAC_ADDR_LENGTH];
     u16                Sequence_Control;
-    u8         Addr4[MAC_ADDR_LENGTH]; // only exist when ToDS=FromDS=1
-    // Data Frame Body <= 2312
-    // FCS
+    u8         Addr4[MAC_ADDR_LENGTH]; /* only exist when ToDS=FromDS=1 */
+    /* Data Frame Body <= 2312 */
+    /* FCS */
 }__attribute__ ((packed));
 
 struct Disassociation_Frame_Body
@@ -596,9 +596,9 @@ struct Association_Request_Frame_Body
 {
     u16    capability_information;
     u16    listenInterval;
-    u8     Current_AP_Address[MAC_ADDR_LENGTH];//for reassociation only
-    // SSID (2+32 bytes)
-    // Supported_Rates (2+8 bytes)
+    u8     Current_AP_Address[MAC_ADDR_LENGTH];/* for reassociation only */
+    /*  SSID (2+32 bytes) */
+    /*  Supported_Rates (2+8 bytes) */
 }__attribute__ ((packed));
 
 struct Association_Response_Frame_Body
@@ -617,7 +617,7 @@ struct Association_Response_Frame_Body
     // SSID (2+32 bytes)
     // Supported_Rates (2+8 bytes)
 };*/
-// eliminated by WS 07/22/04 comboined with associateion request frame.
+/* eliminated by WS 07/22/04 comboined with associateion request frame. */
 
 struct Reassociation_Response_Frame_Body
 {
@@ -638,11 +638,11 @@ struct Probe_Response_Frame_Body
     u16    Timestamp;
     u16    Beacon_Interval;
     u16    Capability_Information;
-    // SSID
+    /* SSID
     // Supported_Rates
     // PHY parameter Set (DS Parameters)
     // CF parameter Set
-    // IBSS parameter Set
+    // IBSS parameter Set */
 }__attribute__ ((packed));
 
 struct Authentication_Frame_Body
@@ -650,11 +650,11 @@ struct Authentication_Frame_Body
     u16    algorithmNumber;
     u16    sequenceNumber;
     u16    statusCode;
-    // NB: don't include ChallengeText in this structure
-       // struct Challenge_Text_Element sChallengeTextElement; // wkchen added
+    /* NB: don't include ChallengeText in this structure
+       // struct Challenge_Text_Element sChallengeTextElement; // wkchen added */
 }__attribute__ ((packed));
 
 
-#endif // _MAC_Structure_H_
+#endif /* _MAC_Structure_H_ */