mirror of https://github.com/c-ares/c-ares.git
Yang Tse
16 years ago
parent
488a855a4a
commit
5fc305a0ba
11 changed files with 689 additions and 5 deletions
@ -0,0 +1,234 @@ |
||||
#ifndef __CARES_BUILD_H |
||||
#define __CARES_BUILD_H |
||||
|
||||
/* $Id$ */ |
||||
|
||||
/* 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. |
||||
*/ |
||||
|
||||
/* ================================================================ */ |
||||
/* NOTES FOR CONFIGURE CAPABLE SYSTEMS */ |
||||
/* ================================================================ */ |
||||
|
||||
/* |
||||
* NOTE 1: |
||||
* ------- |
||||
* |
||||
* See file ares_build.h.in, run configure, and forget that this file |
||||
* exists it is only used for non-configure systems. |
||||
* But you can keep reading if you want ;-) |
||||
* |
||||
*/ |
||||
|
||||
/* ================================================================ */ |
||||
/* NOTES FOR NON-CONFIGURE SYSTEMS */ |
||||
/* ================================================================ */ |
||||
|
||||
/* |
||||
* NOTE 1: |
||||
* ------- |
||||
* |
||||
* Nothing in this file is intended to be modified or adjusted by the |
||||
* c-ares library user nor by the c-ares library builder. |
||||
* |
||||
* If you think that something actually needs to be changed, adjusted |
||||
* or fixed in this file, then, report it on the c-ares development |
||||
* mailing list: http://cool.haxx.se/mailman/listinfo/c-ares/ |
||||
* |
||||
* Try to keep one section per platform, compiler and architecture, |
||||
* otherwise, if an existing section is reused for a different one and |
||||
* later on the original is adjusted, probably the piggybacking one can |
||||
* be adversely changed. |
||||
* |
||||
* In order to differentiate between platforms/compilers/architectures |
||||
* use only compiler built in predefined preprocessor symbols. |
||||
* |
||||
* This header file shall only export symbols which are 'cares' or 'CARES' |
||||
* prefixed, otherwise public name space would be polluted. |
||||
* |
||||
* NOTE 2: |
||||
* ------- |
||||
* |
||||
* Right now you might be staring at file ares_build.h.dist or ares_build.h, |
||||
* this is due to the following reason: file ares_build.h.dist is renamed |
||||
* to ares_build.h when the c-ares source code distribution archive file is |
||||
* created. |
||||
* |
||||
* File ares_build.h.dist is not included in the distribution archive. |
||||
* File ares_build.h is not present in the CVS tree. |
||||
* |
||||
* The distributed ares_build.h file is only intended to be used on systems |
||||
* which can not run the also distributed configure script. |
||||
* |
||||
* On systems capable of running the configure script, the configure process |
||||
* will overwrite the distributed ares_build.h file with one that is suitable |
||||
* and specific to the library being configured and built, which is generated |
||||
* from the ares_build.h.in template file. |
||||
* |
||||
* If you check out from CVS on a non-configure platform, you must run the |
||||
* appropriate buildconf* script to set up ares_build.h and other local files. |
||||
* |
||||
*/ |
||||
|
||||
/* ================================================================ */ |
||||
/* DEFINITION OF THESE SYMBOLS SHALL NOT TAKE PLACE ANYWHERE ELSE */ |
||||
/* ================================================================ */ |
||||
|
||||
#ifdef CARES_SIZEOF_LONG |
||||
# error "CARES_SIZEOF_LONG shall not be defined except in ares_build.h" |
||||
Error Compilation_aborted_CARES_SIZEOF_LONG_already_defined |
||||
#endif |
||||
|
||||
#ifdef CARES_TYPEOF_ARES_SOCKLEN_T |
||||
# error "CARES_TYPEOF_ARES_SOCKLEN_T shall not be defined except in ares_build.h" |
||||
Error Compilation_aborted_CARES_TYPEOF_ARES_SOCKLEN_T_already_defined |
||||
#endif |
||||
|
||||
#ifdef CARES_SIZEOF_ARES_SOCKLEN_T |
||||
# error "CARES_SIZEOF_ARES_SOCKLEN_T shall not be defined except in ares_build.h" |
||||
Error Compilation_aborted_CARES_SIZEOF_ARES_SOCKLEN_T_already_defined |
||||
#endif |
||||
|
||||
/* ================================================================ */ |
||||
/* EXTERNAL INTERFACE SETTINGS FOR NON-CONFIGURE SYSTEMS ONLY */ |
||||
/* ================================================================ */ |
||||
|
||||
#if defined(__DJGPP__) || defined(__GO32__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T int |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T 4 |
||||
|
||||
#elif defined(__SALFORDC__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(__BORLANDC__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(__TURBOC__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(__WATCOMC__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(__POCC__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(__LCC__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(__SYMBIAN32__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(__MWERKS__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(_WIN32_WCE) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(__MINGW32__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(__VMS) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
|
||||
#elif defined(__OS400__) |
||||
# if defined(__ILEC400__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
# endif |
||||
|
||||
#elif defined(__MVS__) |
||||
# if defined(__IBMC__) || defined(__IBMCPP__) |
||||
# if defined(_ILP32) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
# elif defined(_LP64) |
||||
# define CARES_SIZEOF_LONG 8 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
# endif |
||||
# endif |
||||
|
||||
#elif defined(__370__) |
||||
# if defined(__IBMC__) || defined(__IBMCPP__) |
||||
# if defined(_ILP32) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
# elif defined(_LP64) |
||||
# define CARES_SIZEOF_LONG 8 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
# endif |
||||
# endif |
||||
|
||||
/* ===================================== */ |
||||
/* KEEP MSVC THE PENULTIMATE ENTRY */ |
||||
/* ===================================== */ |
||||
|
||||
#elif defined(_MSC_VER) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T int |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T 4 |
||||
|
||||
/* ===================================== */ |
||||
/* KEEP GENERIC GCC THE LAST ENTRY */ |
||||
/* ===================================== */ |
||||
|
||||
#elif defined(__GNUC__) |
||||
# if defined(__i386__) || defined(__ppc__) |
||||
# define CARES_SIZEOF_LONG 4 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
# elif defined(__x86_64__) || defined(__ppc64__) |
||||
# define CARES_SIZEOF_LONG 8 |
||||
# define CARES_TYPEOF_ARES_SOCKLEN_T FIXME |
||||
# define CARES_SIZEOF_ARES_SOCKLEN_T -1 |
||||
# endif |
||||
|
||||
#else |
||||
# error "Unknown non-configure build target!" |
||||
Error Compilation_aborted_Unknown_non_configure_build_target |
||||
#endif |
||||
|
||||
/* Data type definition of ares_socklen_t. */ |
||||
|
||||
#ifdef CARES_TYPEOF_ARES_SOCKLEN_T |
||||
typedef CARES_TYPEOF_ARES_SOCKLEN_T ares_socklen_t; |
||||
#endif |
||||
|
||||
#endif /* __CARES_BUILD_H */ |
||||
@ -0,0 +1,99 @@ |
||||
#ifndef __CARES_BUILD_H |
||||
#define __CARES_BUILD_H |
||||
|
||||
/* $Id$ */ |
||||
|
||||
/* 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. |
||||
*/ |
||||
|
||||
/* ================================================================ */ |
||||
/* NOTES FOR CONFIGURE CAPABLE SYSTEMS */ |
||||
/* ================================================================ */ |
||||
|
||||
/*
|
||||
* NOTE 1: |
||||
* ------- |
||||
* |
||||
* Nothing in this file is intended to be modified or adjusted by the |
||||
* c-ares library user nor by the c-ares library builder. |
||||
* |
||||
* If you think that something actually needs to be changed, adjusted |
||||
* or fixed in this file, then, report it on the c-ares development |
||||
* mailing list: http://cool.haxx.se/mailman/listinfo/c-ares/
|
||||
* |
||||
* This header file shall only export symbols which are 'cares' or 'CARES' |
||||
* prefixed, otherwise public name space would be polluted. |
||||
* |
||||
* NOTE 2: |
||||
* ------- |
||||
* |
||||
* Right now you might be staring at file ares_build.h.in or ares_build.h, |
||||
* this is due to the following reason: |
||||
* |
||||
* On systems capable of running the configure script, the configure process |
||||
* will overwrite the distributed ares_build.h file with one that is suitable |
||||
* and specific to the library being configured and built, which is generated |
||||
* from the ares_build.h.in template file. |
||||
* |
||||
*/ |
||||
|
||||
/* ================================================================ */ |
||||
/* DEFINITION OF THESE SYMBOLS SHALL NOT TAKE PLACE ANYWHERE ELSE */ |
||||
/* ================================================================ */ |
||||
|
||||
#ifdef CARES_SIZEOF_LONG |
||||
# error "CARES_SIZEOF_LONG shall not be defined except in ares_build.h" |
||||
Error Compilation_aborted_CARES_SIZEOF_LONG_already_defined |
||||
#endif |
||||
|
||||
#ifdef CARES_TYPEOF_ARES_SOCKLEN_T |
||||
# error "CARES_TYPEOF_ARES_SOCKLEN_T shall not be defined except in ares_build.h" |
||||
Error Compilation_aborted_CARES_TYPEOF_ARES_SOCKLEN_T_already_defined |
||||
#endif |
||||
|
||||
#ifdef CARES_SIZEOF_ARES_SOCKLEN_T |
||||
# error "CARES_SIZEOF_ARES_SOCKLEN_T shall not be defined except in ares_build.h" |
||||
Error Compilation_aborted_CARES_SIZEOF_ARES_SOCKLEN_T_already_defined |
||||
#endif |
||||
|
||||
/* ================================================================ */ |
||||
/* EXTERNAL INTERFACE SETTINGS FOR CONFIGURE CAPABLE SYSTEMS ONLY */ |
||||
/* ================================================================ */ |
||||
|
||||
/* Configure process defines this to 1 when it finds out that system */ |
||||
/* header file sys/types.h must be included by the external interface. */ |
||||
#undef CARES_PULL_SYS_TYPES_H |
||||
#ifdef CARES_PULL_SYS_TYPES_H |
||||
# include <sys/types.h> |
||||
#endif |
||||
|
||||
/* Configure process defines this to 1 when it finds out that system */ |
||||
/* header file sys/socket.h must be included by the external interface. */ |
||||
#undef CARES_PULL_SYS_SOCKET_H |
||||
#ifdef CARES_PULL_SYS_SOCKET_H |
||||
# include <sys/socket.h> |
||||
#endif |
||||
|
||||
/* The size of `long', as computed by sizeof. */ |
||||
#undef CARES_SIZEOF_LONG |
||||
|
||||
/* Integral data type used for ares_socklen_t. */ |
||||
#undef CARES_TYPEOF_ARES_SOCKLEN_T |
||||
|
||||
/* The size of `ares_socklen_t', as computed by sizeof. */ |
||||
#undef CARES_SIZEOF_ARES_SOCKLEN_T |
||||
|
||||
/* Data type definition of ares_socklen_t. */ |
||||
typedef CARES_TYPEOF_ARES_SOCKLEN_T ares_socklen_t; |
||||
|
||||
#endif /* __CARES_BUILD_H */ |
||||
@ -0,0 +1,144 @@ |
||||
#ifndef __CARES_RULES_H |
||||
#define __CARES_RULES_H |
||||
|
||||
/* $Id$ */ |
||||
|
||||
/* 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 |
||||
* dependant 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_SIZEOF_LONG |
||||
# error "CARES_SIZEOF_LONG definition is missing!" |
||||
Error Compilation_aborted_CARES_SIZEOF_LONG_is_missing |
||||
#endif |
||||
|
||||
#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 |
||||
|
||||
#ifndef CARES_SIZEOF_ARES_SOCKLEN_T |
||||
# error "CARES_SIZEOF_ARES_SOCKLEN_T definition is missing!" |
||||
Error Compilation_aborted_CARES_SIZEOF_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 long |
||||
* is the same as the one reported by sizeof() at compile time. |
||||
*/ |
||||
|
||||
typedef char |
||||
__cares_rule_01__ |
||||
[CareschkszEQ(long, CARES_SIZEOF_LONG)]; |
||||
|
||||
/*
|
||||
* Verify that the size previously defined and expected for |
||||
* ares_socklen_t is actually the the same as the one reported |
||||
* by sizeof() at compile time. |
||||
*/ |
||||
|
||||
typedef char |
||||
__cares_rule_02__ |
||||
[CareschkszEQ(ares_socklen_t, CARES_SIZEOF_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_SYS_TYPES_H |
||||
#undef CARES_PULL_SYS_SOCKET_H |
||||
|
||||
#undef CARES_TYPEOF_ARES_SOCKLEN_T |
||||
|
||||
#endif /* __CARES_RULES_H */ |
||||
Loading…
Reference in new issue