d7358c5566babff2f49978e16cade656fc1810a7
[openafs.git] / src / config / stds.h
1 /*
2  * Copyright 2000, International Business Machines Corporation and others.
3  * All Rights Reserved.
4  * 
5  * This software has been released under the terms of the IBM Public
6  * License.  For details, see the LICENSE file in the top-level source
7  * directory or online at http://www.openafs.org/dl/license10.html
8  */
9
10 #ifndef OPENAFS_AFS_CONFIG_STDS_H
11 #define OPENAFS_AFS_CONFIG_STDS_H       1
12
13 #include <afs/param.h>
14 #include <sys/types.h>
15
16 #define IN                      /* indicates a parameter is read in */
17 #define OUT                     /* indicates a parameter is sent out (a ptr) */
18 #define INOUT                   /* indicates a parameter is read in and sent out (a ptr) */
19
20 #ifndef MACRO_BEGIN
21 #define MACRO_BEGIN     do {
22 #endif
23 #ifndef MACRO_END
24 #define MACRO_END       } while (0)
25 #endif
26
27 typedef void *opaque;
28
29 #ifndef _ATT4
30 #if defined(__HIGHC__)
31 /*
32  * keep HC from complaining about the use of "old-style" function definitions
33  * with prototypes
34  */
35 pragma Off(Prototype_override_warnings);
36 #endif /* defined(__HIGHC__) */
37 #endif
38
39 /* Now some types to enhance portability.  Always use these on the wire or when
40  * laying out shared structures on disk. */
41
42 /* Imagine that this worked...
43 #if (sizeof(long) != 4) || (sizeof(short) != 2)
44 #error We require size of long and pointers to be equal
45 #endif */
46
47 #define MAX_AFS_INT32 0x7FFFFFFF
48 #define MIN_AFS_INT32 (-MAX_AFS_INT32 - 1)
49 #define MAX_AFS_UINT32 0xFFFFFFFF
50 #define MAX_AFS_INT64 0x7FFFFFFFFFFFFFFFL
51 #define MIN_AFS_INT64 (-MAX_AFS_INT64 - 1)
52 #define MAX_AFS_UINT64 0xFFFFFFFFFFFFFFFFL
53
54 #ifndef HAVE_SSIZE_T
55 typedef int ssize_t;
56 #endif
57
58 #ifndef HAVE_SIG_ATOMIC_T
59 typedef int sig_atomic_t;
60 #endif
61
62 #ifndef HAVE_SOCKLEN_T
63 typedef int socklen_t;
64 #endif
65
66 typedef short afs_int16;
67 typedef unsigned short afs_uint16;
68 #ifdef  AFS_64BIT_ENV
69 typedef int afs_int32;
70 typedef unsigned int afs_uint32;
71 #if defined(AFS_NT40_ENV) && defined(_MSC_VER)
72 typedef __int64 afs_int64;
73 typedef unsigned __int64 afs_uint64;
74 #else
75 typedef long long afs_int64;
76 typedef unsigned long long afs_uint64;
77 #endif
78 #define ZeroInt64(a)       (a = 0)
79 #define AssignInt64(a, b) *(b) = (a) 
80 #define IncInt64(a) (*(a))++
81 #define IncUInt64(a) (*(a))++
82 #define DecInt64(a) (*(a))--
83 #define DecUInt64(a) (*(a))--
84 #define GTInt64(a,b) ((a) > (b))
85 #define GEInt64(a,b) ((a) >= (b))
86 #define LEInt64(a,b) ((a) <= (b))
87 #define LTInt64(a,b) ((a) < (b))
88 #define AddInt64(a,b,c) *(c) = (afs_int64)(a) + (afs_int64)(b)
89 #define AddUInt64(a,b,c) *(c) = (afs_uint64)(a) + (afs_uint64)(b)
90 #define SubtractInt64(a,b,c) *(c) = (afs_int64)(a) - (afs_int64)(b)
91 #define SubtractUInt64(a,b,c) *(c) = (afs_uint64)(a) - (afs_uint64)(b)
92 #define CompareInt64(a,b) (afs_int64)(a) - (afs_int64)(b)
93 #define CompareUInt64(a,b) (afs_uint64)(a) - (afs_uint64)(b)
94 #define NonZeroInt64(a)                (a)
95 #define Int64ToInt32(a)    (a) & MAX_AFS_UINT32
96 #define FillInt64(t,h,l) (t) = ((afs_int64)(h) << 32) | (l);
97 #define SplitInt64(t,h,l) (h) = ((afs_int64)t) >> 32; (l) = (t) & MAX_AFS_UINT32;
98 #define RoundInt64ToInt32(a)    (a > MAX_AFS_UINT32) ? MAX_AFS_UINT32 : a;
99 #define RoundInt64ToInt31(a)    (a > MAX_AFS_INT32) ? MAX_AFS_INT32 : a;
100 #else /* AFS_64BIT_ENV */
101 typedef long afs_int32;
102 typedef unsigned long afs_uint32;
103
104 struct Int64 {
105     afs_int32 high;
106     afs_uint32 low;
107 };
108 typedef struct Int64 afs_int64;
109
110 struct u_Int64 {
111     afs_uint32 high;
112     afs_uint32 low;
113 };
114 typedef struct u_Int64 afs_uint64;
115 #define ZeroInt64(a) ((a).high = (a).low = 0)
116 #define AssignInt64(a, b) (b)->high = (a).high; (b)->low = (a).low
117 #define IncInt64(a) ((++((a)->low)) ? 0 : (a)->high++ )
118 #define IncUInt64(a) ((++((a)->low)) ? 0 : (a)->high++ )
119 #define DecInt64(a) (((a)->low)-- ? 0 : (a)->high-- )
120 #define DecUInt64(a) (((a)->low)-- ? 0 : (a)->high-- )
121 #define GTInt64(a,b) (((a).high > (b).high) || (((a).high == (b).high) && ((a).low > (b).low)))
122 #define GEInt64(a,b) (((a).high > (b).high) || (((a).high == (b).high) && ((a).low >= (b).low)))
123 #define LEInt64(a,b) (((a).high < (b).high) || (((a).high == (b).high) && ((a).low <= (b).low)))
124 #define LTInt64(a,b) (((a).high < (b).high) || (((a).high == (b).high) && ((a).low < (b).low)))
125 #define CompareInt64(a,b) (((afs_int32)(a).high - (afs_int32)(b).high) || (((a).high == (b).high) && ((a).low - (b).low))) 
126 #define AddInt64(a, b, c) {  afs_int64 _a, _b; _a = a; _b = b; (c)->low = _a.low + _b.low; (c)->high = _a.high + _b.high + ((c)->low < _b.low); } 
127 #define SubtractInt64(a, b, c) { afs_int64 _a, _b; _a = a; _b = b; (c)->low = _a.low - _b.low;  (c)->high = _a.high - _b.high - (_a.low < _b.low); } 
128 #define CompareUInt64(a,b) (((afs_uint32)(a).high - (afs_uint32)(b).high) || (((a).high == (b).high) && ((a).low - (b).low))) 
129 #define AddUInt64(a, b, c) {  afs_uint64 _a, _b; _a = a; _b = b; (c)->low = _a.low + _b.low; (c)->high = _a.high + _b.high + ((c)->low < _b.low); } 
130 #define SubtractUInt64(a, b, c) { afs_uint64 _a, _b; _a = a; _b = b; (c)->low = _a.low - _b.low;  (c)->high = _a.high - _b.high - (_a.low < _b.low); } 
131 #define NonZeroInt64(a)   (a).low || (a).high
132 #define Int64ToInt32(a)    (a).low
133 #define FillInt64(t,h,l) (t).high = (h); (t).low = (l);
134 #define SplitInt64(t,h,l) (h) = (t).high; (l) = (t).low;
135 #define RoundInt64ToInt32(a)    (a.high > 0) ? MAX_AFS_UINT32 : a.low;
136 #define RoundInt64ToInt31(a)    (a.high > 0) ? MAX_AFS_INT32 : a.low;
137 #endif /* AFS_64BIT_ENV */
138
139 /* AFS_64BIT_CLIENT should presently be set only for AFS_64BIT_ENV systems */
140
141 #ifdef AFS_64BIT_CLIENT
142 typedef afs_int64 afs_size_t;
143 typedef afs_uint64 afs_offs_t;
144 #else /* AFS_64BIT_CLIENT */
145 typedef afs_int32 afs_size_t;
146 typedef afs_uint32 afs_offs_t;
147 #endif /* AFS_64BIT_CLIENT */
148
149 typedef afs_int64 afs_foff_t;
150 typedef afs_uint64 afs_fsize_t;
151 typedef afs_int64 afs_sfsize_t;
152 #define SplitOffsetOrSize(t,h,l) SplitInt64(t,h,l)
153
154 /* Maximum integer sizes.  Also what is expected by %lld, %llu in
155  * afs_snprintf. */
156 #ifdef AFS_64BIT_CLIENT
157 typedef afs_int64 afs_intmax_t;
158 typedef afs_uint64 afs_uintmax_t;
159 #else /* !AFS_64BIT_CLIENT */
160 typedef afs_int32 afs_intmax_t;
161 typedef afs_uint32 afs_uintmax_t;
162 #endif /* !AFS_64BIT_CLIENT */
163
164 /* you still have to include <netinet/in.h> to make these work */
165
166 #define hton32 htonl
167 #define hton16 htons
168 #define ntoh32 ntohl
169 #define ntoh16 ntohs
170
171
172 /* Since there is going to be considerable use of 64 bit integers we provide
173  * some assistence in this matter.  The hyper type is supposed to be compatible
174  * with the afsHyper type: the same macros will work on both. */
175
176 #if     defined(AFS_64BIT_ENV) && 0
177
178 typedef unsigned long afs_hyper_t;
179
180 #define hcmp(a,b)       ((a) < (b) ? -1 : ((a) > (b) ? 1 : 0))
181 #define hsame(a,b)      ((a) == (b))
182 #define hiszero(a)      ((a) == 0)
183 #define hfitsin32(a)    ((a) & 0xffffffff00000000) == 0)
184 #define hset(a,b)       ((a) = (b))
185 #define hzero(a)        ((a) = 0)
186 #define hones(a)        ((a) = ~((unsigned long)0))
187 #define hget32(i,a)     ((i) = (unsigned int)(a))
188 #define hget64(hi,lo,a) ((lo) = ((unsigned int)(a)), (hi) = ((a) & (0xffffffff00000000)))
189 #define hset32(a,i)     ((a) = ((unsigned int)(i)))
190 #define hset64(a,hi,lo) ((a) = (((hi) << 32) | (lo)))
191 #define hgetlo(a)       ((a) & 0xffffffff)
192 #define hgethi(a)       (((unsigned int)(a)) >> 32)
193 #define hadd(a,b)       ((a) += (b))
194 /* XXX */
195 #define hadd32(a,b)     ((a) += (b))
196 #define hshlft(a,n)     ((a)<<(n))
197
198 #else /* AFS_64BIT_ENV */
199
200 typedef struct afs_hyper_t {    /* unsigned 64 bit integers */
201     unsigned int high;
202     unsigned int low;
203 } afs_hyper_t;
204
205 #define hcmp(a,b) ((a).high<(b).high? -1 : ((a).high > (b).high? 1 : \
206     ((a).low <(b).low? -1 : ((a).low > (b).low? 1 : 0))))
207 #define hsame(a,b) ((a).low == (b).low && (a).high == (b).high)
208 #define hiszero(a) ((a).low == 0 && (a).high == 0)
209 #define hfitsin32(a) ((a).high == 0)
210 #define hset(a,b) ((a) = (b))
211 #define hzero(a) ((a).low = 0, (a).high = 0)
212 #define hones(a) ((a).low = 0xffffffff, (a).high = 0xffffffff)
213 #define hget32(i,a) ((i) = (a).low)
214 #define hget64(hi,lo,a) ((lo) = (a).low, (hi) = (a).high)
215 #define hset32(a,i) ((a).high = 0, (a).low = (i))
216 #define hset64(a,hi,lo) ((a).high = (hi), (a).low = (lo))
217 #define hgetlo(a) ((a).low)
218 #define hgethi(a) ((a).high)
219 #define hshlft(a,n)                                                        \
220      { /*Shift Left n bits*/                                               \
221         int s = sizeof((a).low) * 8; /*#bits*/                             \
222         if ((n) <= 0) { /*No shift*/                                       \
223         } else if ((n) >= 2*s) { /*Shift off all bits*/                    \
224            (a).high = (a).low = 0;                                         \
225         } else if ((n) < s) { /*Part of low shifted into high*/            \
226            (a).high = ((a).high<<(n)) | (((a).low>>(s-(n))) & (1<<(n))-1); \
227            (a).low  = (a).low << (n);                                      \
228         } else if ((n) >= s) { /*All of low shifted into high plus some*/  \
229            (a).high = (a).low << ((n)-s);                                  \
230            (a).low=0;                                                      \
231         }                                                                  \
232      }
233
234 /* The algorithm here is to check for two cases that cause a carry.  If the top
235  * two bits are different then if the sum has the top bit off then there must
236  * have been a carry.  If the top bits are both one then there is always a
237  * carry.  We assume 32 bit ints and twos complement arithmetic. */
238
239 #define SIGN 0x80000000
240 #define hadd32(a,i) \
241     ((void)((((a).low ^ (int)(i)) & SIGN) \
242       ? (((((a).low + (int)(i)) & SIGN) == 0) && (a).high++) \
243       : (((a).low & (int)(i) & SIGN) && (a).high++)), \
244      (a).low += (int)(i))
245
246 #define hadd(a,b) (hadd32(a,(b).low), (a).high += (b).high)
247 #endif /* AFS_64BIT_ENV */
248
249 #if !defined(KERNEL) || defined(UKERNEL)
250 #ifndef AFS_NT40_ENV
251 #define max(a, b)               ((a) < (b) ? (b) : (a))
252 #define min(a, b)               ((a) > (b) ? (b) : (a))
253 #endif
254 /*#define abs(x)                  ((x) >= 0 ? (x) : -(x))*/
255 #endif
256
257 /* minumum length of string to pass to int_to_base64 */
258 typedef char b64_string_t[8];
259 #ifndef AFS_NT40_ENV
260 #if defined(AFS_HPUX_ENV) || defined(AFS_USR_HPUX_ENV) || (defined(AFS_SUN_ENV) && !defined(AFS_SUN5_ENV))
261 char *int_to_base64();
262 int base64_to_int();
263 #else
264 char *int_to_base64(b64_string_t s, int a);
265 int base64_to_int(char *s);
266 #endif
267 #endif /* AFS_NT40_ENV */
268 /*
269  * The afsUUID data type is built in to RX
270  */
271 struct afsUUID {
272     afs_uint32 time_low;
273     afs_uint16 time_mid;
274     afs_uint16 time_hi_and_version;
275     char clock_seq_hi_and_reserved;
276     char clock_seq_low;
277     char node[6];
278 };
279 typedef struct afsUUID afsUUID;
280
281 /* for now, demand attach fileserver is only support on unix pthreads builds */
282 #if defined(DEMAND_ATTACH_ENABLE) && defined(AFS_PTHREAD_ENV) && !defined(AFS_NT40_ENV)
283 #define AFS_DEMAND_ATTACH_FS 1
284 #endif
285
286 /* A macro that can be used when printf'ing 64 bit integers, as Unix and 
287  * windows use a different format string
288  */
289 #ifdef AFS_NT40_ENV
290 # define AFS_INT64_FMT "I64d"
291 # define AFS_UINT64_FMT "I64u"
292 # define AFS_PTR_FMT   "p"
293 # define AFS_SIZET_FMT "Iu"
294 #else
295 # define AFS_INT64_FMT "lld"
296 # define AFS_UINT64_FMT "llu"
297 # define AFS_PTR_FMT   "p"
298 # ifdef PRINTF_TAKES_Z_LEN
299 #  define AFS_SIZET_FMT "zu"
300 # else
301 #  define AFS_SIZET_FMT "lu"
302 # endif /* PRINTF_TAKES_Z_LEN */
303 #endif /* AFS_NT40_ENV */
304
305 /* Functions to safely cast afs_int32 and afs_uint32 so they can be used in 
306  * printf statemements with %ld and %lu
307  */
308 #ifdef AFS_NT40_ENV
309 #define static_inline __inline static
310 #define hdr_static_inline(x) __inline static x
311 #elif defined(AFS_HPUX_ENV) || defined(AFS_USR_HPUX_ENV)
312 /* The HPUX compiler can segfault on 'static __inline', so fall back to
313  * just 'static' so we can at least compile */
314 #define static_inline static
315 #define hdr_static_inline(x) static x
316 #elif defined(AFS_AIX_ENV) || defined(AFS_USR_AIX_ENV)
317 #define static_inline static
318 #define hdr_static_inline(x) static x
319 #elif defined(AFS_SGI_ENV) || defined(AFS_USR_SGI_ENV)
320 #define static_inline static
321 #define hdr_static_inline(x) x
322 #elif defined(AFS_NBSD_ENV)
323 #define static_inline static __inline __attribute__((always_inline))
324 #define hdr_static_inline(x) static __inline __attribute__((always_inline)) x
325 #else
326 #define static_inline static inline
327 #define hdr_static_inline(x) static inline x
328 #endif
329
330 hdr_static_inline(long) afs_printable_int32_ld(afs_int32 d) { return (long) d; }
331
332 hdr_static_inline(unsigned long) afs_printable_uint32_lu(afs_uint32 d) { return (unsigned long) d; }
333
334 #ifdef AFS_64BITUSERPOINTER_ENV
335 #define afs_pointer_to_int(p)      ((afs_uint32)  (afs_uint64) (p))
336 #define afs_int_to_pointer(i)     ((void *) (afs_uint64) (i))
337 #else
338 #define afs_pointer_to_int(p)      ((afs_uint32)   (p))
339 #define afs_int_to_pointer(i)      ((void *)  (i))
340 #endif
341
342 #if !defined(__GNUC__) || __GNUC__ < 2
343 #define AFS_UNUSED
344 #define AFS_ATTRIBUTE_FORMAT(style,x,y)
345 #else
346 #define AFS_UNUSED __attribute__((unused))
347 #define AFS_ATTRIBUTE_FORMAT(style,x,y) __attribute__((format(style, x, y)))
348 #endif
349
350 #endif /* OPENAFS_CONFIG_AFS_STDS_H */