Commit | Line | Data |
---|---|---|
1b4a7c03 LJ |
1 | /* |
2 | * Declare directives for structure packing. No padding will be provided | |
3 | * between the members of packed structures, and therefore, there is no | |
4 | * guarantee that structure members will be aligned. | |
5 | * | |
6 | * Declaring packed structures is compiler specific. In order to handle all | |
7 | * cases, packed structures should be delared as: | |
8 | * | |
9 | * #include <packed_section_start.h> | |
10 | * | |
11 | * typedef BWL_PRE_PACKED_STRUCT struct foobar_t { | |
12 | * some_struct_members; | |
13 | * } BWL_POST_PACKED_STRUCT foobar_t; | |
14 | * | |
15 | * #include <packed_section_end.h> | |
16 | * | |
17 | * | |
18 | * Copyright (C) 2020, Broadcom. | |
19 | * | |
20 | * Unless you and Broadcom execute a separate written software license | |
21 | * agreement governing use of this software, this software is licensed to you | |
22 | * under the terms of the GNU General Public License version 2 (the "GPL"), | |
23 | * available at http://www.broadcom.com/licenses/GPLv2.php, with the | |
24 | * following added to such license: | |
25 | * | |
26 | * As a special exception, the copyright holders of this software give you | |
27 | * permission to link this software with independent modules, and to copy and | |
28 | * distribute the resulting executable under terms of your choice, provided that | |
29 | * you also meet, for each linked independent module, the terms and conditions of | |
30 | * the license of that module. An independent module is a module which is not | |
31 | * derived from this software. The special exception does not apply to any | |
32 | * modifications of the software. | |
33 | * | |
34 | * | |
35 | * <<Broadcom-WL-IPTag/Dual:>> | |
36 | */ | |
37 | ||
38 | /* EFI does not support STATIC_ASSERT */ | |
39 | ||
40 | #ifndef _alignment_test_ | |
41 | #define _alignment_test_ | |
42 | ||
43 | /* ASSERT default packing */ | |
44 | typedef struct T4 { | |
45 | uint8 a; | |
46 | uint32 b; | |
47 | uint16 c; | |
48 | uint8 d; | |
49 | } T4_t; | |
50 | ||
51 | /* 4 byte alignment support */ | |
52 | /* | |
53 | * a . . . | |
54 | * b b b b | |
55 | * c c d . | |
56 | */ | |
57 | ||
58 | /* | |
59 | * Below function is meant to verify that this file is compiled with the default alignment of 4. | |
60 | * Function will fail to compile if the condition is not met. | |
61 | */ | |
62 | #ifdef __GNUC__ | |
63 | #define VARIABLE_IS_NOT_USED __attribute__ ((unused)) | |
64 | #else | |
65 | #define VARIABLE_IS_NOT_USED | |
66 | #endif | |
67 | static void alignment_test(void); | |
68 | static void | |
69 | VARIABLE_IS_NOT_USED alignment_test(void) | |
70 | { | |
71 | /* verify 4 byte alignment support */ | |
72 | STATIC_ASSERT(sizeof(T4_t) == 12); | |
73 | } | |
74 | #endif /* _alignment_test_ */ | |
75 | ||
76 | /* Error check - BWL_PACKED_SECTION is defined in packed_section_start.h | |
77 | * and undefined in packed_section_end.h. If it is already defined at this | |
78 | * point, then there is a missing include of packed_section_end.h. | |
79 | */ | |
80 | #ifdef BWL_PACKED_SECTION | |
81 | #error "BWL_PACKED_SECTION is already defined!" | |
82 | #else | |
83 | #define BWL_PACKED_SECTION | |
84 | #endif | |
85 | ||
86 | #if defined(BWL_DEFAULT_PACKING) | |
87 | /* generate an error if BWL_DEFAULT_PACKING is defined */ | |
88 | #error "BWL_DEFAULT_PACKING not supported any more." | |
89 | #endif /* BWL_PACKED_SECTION */ | |
90 | ||
91 | /* Declare compiler-specific directives for structure packing. */ | |
92 | #if defined(__GNUC__) || defined(__lint) | |
93 | #define BWL_PRE_PACKED_STRUCT | |
94 | #define BWL_POST_PACKED_STRUCT __attribute__ ((packed)) | |
95 | #elif defined(__CC_ARM) | |
96 | #define BWL_PRE_PACKED_STRUCT __packed | |
97 | #define BWL_POST_PACKED_STRUCT | |
98 | #else | |
99 | #error "Unknown compiler!" | |
100 | #endif |