aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/libs/c-ares/ares_rules.h
blob: 0c24445e12b21234c84baaa1eb5cb83645b7e8c8 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
#ifndef __CARES_RULES_H 
#define __CARES_RULES_H 
 
 
/* Copyright (C) 2009 by Daniel Stenberg et al 
 * 
 * Permission to use, copy, modify, and distribute this software and its 
 * documentation for any purpose and without fee is hereby granted, provided 
 * that the above copyright notice appear in all copies and that both that 
 * copyright notice and this permission notice appear in supporting 
 * documentation, and that the name of M.I.T. not be used in advertising or 
 * publicity pertaining to distribution of the software without specific, 
 * written prior permission.  M.I.T. makes no representations about the 
 * suitability of this software for any purpose.  It is provided "as is" 
 * without express or implied warranty. 
 */ 
 
/* ================================================================ */ 
/*                    COMPILE TIME SANITY CHECKS                    */ 
/* ================================================================ */ 
 
/* 
 * NOTE 1: 
 * ------- 
 * 
 * All checks done in this file are intentionally placed in a public 
 * header file which is pulled by ares.h when an application is 
 * being built using an already built c-ares library. Additionally 
 * this file is also included and used when building the library. 
 * 
 * If compilation fails on this file it is certainly sure that the 
 * problem is elsewhere. It could be a problem in the ares_build.h 
 * header file, or simply that you are using different compilation 
 * settings than those used to build the library. 
 * 
 * Nothing in this file is intended to be modified or adjusted by the 
 * c-ares library user nor by the c-ares library builder. 
 * 
 * Do not deactivate any check, these are done to make sure that the 
 * library is properly built and used. 
 * 
 * You can find further help on the c-ares development mailing list: 
 * http://cool.haxx.se/mailman/listinfo/c-ares/ 
 * 
 * NOTE 2 
 * ------ 
 * 
 * Some of the following compile time checks are based on the fact 
 * that the dimension of a constant array can not be a negative one. 
 * In this way if the compile time verification fails, the compilation 
 * will fail issuing an error. The error description wording is compiler 
 * dependent but it will be quite similar to one of the following: 
 * 
 *   "negative subscript or subscript is too large" 
 *   "array must have at least one element" 
 *   "-1 is an illegal array size" 
 *   "size of array is negative" 
 * 
 * If you are building an application which tries to use an already 
 * built c-ares library and you are getting this kind of errors on 
 * this file, it is a clear indication that there is a mismatch between 
 * how the library was built and how you are trying to use it for your 
 * application. Your already compiled or binary library provider is the 
 * only one who can give you the details you need to properly use it. 
 */ 
 
/* 
 * Verify that some macros are actually defined. 
 */ 
 
#ifndef CARES_TYPEOF_ARES_SOCKLEN_T 
#  error "CARES_TYPEOF_ARES_SOCKLEN_T definition is missing!" 
   Error Compilation_aborted_CARES_TYPEOF_ARES_SOCKLEN_T_is_missing 
#endif 
 
/* 
 * Macros private to this header file. 
 */ 
 
#define CareschkszEQ(t, s) sizeof(t) == s ? 1 : -1 
 
#define CareschkszGE(t1, t2) sizeof(t1) >= sizeof(t2) ? 1 : -1 
 
/* 
 * Verify that the size previously defined and expected for 
 * ares_socklen_t is actually the same as the one reported
 * by sizeof() at compile time. 
 */ 
 
typedef char 
  __cares_rule_02__ 
    [CareschkszEQ(ares_socklen_t, sizeof(CARES_TYPEOF_ARES_SOCKLEN_T))];
 
/* 
 * Verify at compile time that the size of ares_socklen_t as reported 
 * by sizeof() is greater or equal than the one reported for int for 
 * the current compilation. 
 */ 
 
typedef char 
  __cares_rule_03__ 
    [CareschkszGE(ares_socklen_t, int)]; 
 
/* ================================================================ */ 
/*          EXTERNALLY AND INTERNALLY VISIBLE DEFINITIONS           */ 
/* ================================================================ */ 
 
/* 
 * Get rid of macros private to this header file. 
 */ 
 
#undef CareschkszEQ 
#undef CareschkszGE 
 
/* 
 * Get rid of macros not intended to exist beyond this point. 
 */ 
 
#undef CARES_PULL_WS2TCPIP_H 
#undef CARES_PULL_SYS_TYPES_H 
#undef CARES_PULL_SYS_SOCKET_H 
 
#undef CARES_TYPEOF_ARES_SOCKLEN_T 
 
#endif /* __CARES_RULES_H */