| /* MIT License |
| * |
| * Copyright (c) 2009 Daniel Stenberg |
| * |
| * Permission is hereby granted, free of charge, to any person obtaining a copy |
| * of this software and associated documentation files (the "Software"), to deal |
| * in the Software without restriction, including without limitation the rights |
| * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
| * copies of the Software, and to permit persons to whom the Software is |
| * furnished to do so, subject to the following conditions: |
| * |
| * The above copyright notice and this permission notice (including the next |
| * paragraph) shall be included in all copies or substantial portions of the |
| * Software. |
| * |
| * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
| * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
| * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
| * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
| * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
| * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE |
| * SOFTWARE. |
| * |
| * SPDX-License-Identifier: MIT |
| */ |
| #ifndef __CARES_RULES_H |
| #define __CARES_RULES_H |
| |
| /* ================================================================ */ |
| /* 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://lists.haxx.se/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 */ |