/******************************************************************* Copyright © 1995 - 1998, 3Com Corporation or its subsidiaries ("3Com"). All rights reserved. This software may be copied and used solely for developing products for the Palm Computing platform and for archival and backup purposes. Except for the foregoing, no part of this software may be reproduced or transmitted in any form or by any means or used to make any derivative work (such as translation, transformation or adaptation) without express written consent from 3Com. 3Com reserves the right to revise this software and to make changes in content from time to time without obligation on the part of 3Com to provide notification of such revision or changes. 3COM MAKES NO REPRESENTATIONS OR WARRANTIES THAT THE SOFTWARE IS FREE OF ERRORS OR THAT THE SOFTWARE IS SUITABLE FOR YOUR USE. THE SOFTWARE IS PROVIDED ON AN "AS IS" BASIS. 3COM MAKES NO WARRANTIES, TERMS OR CONDITIONS, EXPRESS OR IMPLIED, EITHER IN FACT OR BY OPERATION OF LAW, STATUTORY OR OTHERWISE, INCLUDING WARRANTIES, TERMS, OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND SATISFACTORY QUALITY. TO THE FULL EXTENT ALLOWED BY LAW, 3COM ALSO EXCLUDES FOR ITSELF AND ITS SUPPLIERS ANY LIABILITY, WHETHER BASED IN CONTRACT OR TORT (INCLUDING NEGLIGENCE), FOR DIRECT, INCIDENTAL, CONSEQUENTIAL, INDIRECT, SPECIAL, OR PUNITIVE DAMAGES OF ANY KIND, OR FOR LOSS OF REVENUE OR PROFITS, LOSS OF BUSINESS, LOSS OF INFORMATION OR DATA, OR OTHER FINANCIAL LOSS ARISING OUT OF OR IN CONNECTION WITH THIS SOFTWARE, EVEN IF 3COM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 3Com, HotSync, Palm Computing, and Graffiti are registered trademarks, and Palm III and Palm OS are trademarks of 3Com Corporation or its subsidiaries. IF THIS SOFTWARE IS PROVIDED ON A COMPACT DISK, THE OTHER SOFTWARE AND DOCUMENTATION ON THE COMPACT DISK ARE SUBJECT TO THE LICENSE AGREEMENT ACCOMPANYING THE COMPACT DISK. *------------------------------------------------------------------- * FileName: * Common.h * * Description: * Common header file for all Pilot routines. * Contains elementary data types * * History: * 10/19/94 RM - Created by Ron Marianetti * 4/24/97 SL - Changes for PalmOS 2.0 SDK * *******************************************************************/ #ifndef __COMMON_H__ #define __COMMON_H__ /************************************************************ * Build Rules *************************************************************/ #include /************************************************************ * Metrowerks will substitute strlen and strcpy with inline * 68K assembly code. Prevent this. *************************************************************/ #ifdef __MC68K__ #define _NO_FAST_STRING_INLINES_ 0 #endif /************************************************************ * Define whether or not we are direct linking, or going through * traps. * * When eumulating we use directy linking. * When running under native mode, we use traps EXCEPT for the * modules that actually install the routines into the trap table. * These modules will set the DIRECT_LINK define to 1 *************************************************************/ #ifndef EMULATION_LEVEL #error "This should not happen!" #endif #ifndef USE_TRAPS #if EMULATION_LEVEL == EMULATION_NONE #define USE_TRAPS 1 /* use Pilot traps*/ #else #define USE_TRAPS 0 /* direct link (Simulator)*/ #endif #endif #if USE_TRAPS == 0 #define ONEWORD_INLINE(trapNum) #define TWOWORD_INLINE(w1, w2) #define THREEWORD_INLINE(w1, w2, w3) #define FOURWORD_INLINE(w1, w2, w3, w4) #define FIVEWORD_INLINE(w1, w2, w3, w4, w5) #define SIXWORD_INLINE(w1, w2, w3, w4, w5, w6) #define SEVENWORD_INLINE(w1, w2, w3, w4, w5, w6, w7) #define EIGHTWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8) #define NINEWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9) #define TENWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9, w10) #define ELEVENWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9, w10, w11) #define TWELVEWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9, w10, w11, w12) #else /* Define the traps differently depending on the compiler*/ #ifdef __GNUC__ #define ASMWORD(W) asm("dc.w %c0"::"i"(W)); #define ONEWORD_INLINE(trapNum) \ {ASMWORD(trapNum)} #define TWOWORD_INLINE(w1, w2) \ {ASMWORD(w1)ASMWORD(w2)} #define THREEWORD_INLINE(w1, w2, w3) \ {ASMWORD(w1)ASMWORD(w2)ASMWORD(w3)} #define FOURWORD_INLINE(w1, w2, w3, w4) \ {ASMWORD(w1)ASMWORD(w2)ASMWORD(w3)ASMWORD(w4)} #define FIVEWORD_INLINE(w1, w2, w3, w4, w5) \ {ASMWORD(w1)ASMWORD(w2)ASMWORD(w3)ASMWORD(w4)ASMWORD(w5)} #define SIXWORD_INLINE(w1, w2, w3, w4, w5, w6) \ {ASMWORD(w1)ASMWORD(w2)ASMWORD(w3)ASMWORD(w4)ASMWORD(w5)ASMWORD(w6)} #define SEVENWORD_INLINE(w1, w2, w3, w4, w5, w6, w7) \ {ASMWORD(w1)ASMWORD(w2)ASMWORD(w3)ASMWORD(w4)ASMWORD(w5)ASMWORD(w6)ASMWORD(w7)} #define EIGHTWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8) \ {ASMWORD(w1)ASMWORD(w2)ASMWORD(w3)ASMWORD(w4)ASMWORD(w5)ASMWORD(w6)ASMWORD(w7)ASMWORD(w8)} #define NINEWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9) \ {ASMWORD(w1)ASMWORD(w2)ASMWORD(w3)ASMWORD(w4)ASMWORD(w5)ASMWORD(w6)ASMWORD(w7)ASMWORD(w8)ASMWORD(w9)} #define TENWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9, w10) \ {ASMWORD(w1)ASMWORD(w2)ASMWORD(w3)ASMWORD(w4)ASMWORD(w5)ASMWORD(w6)ASMWORD(w7)ASMWORD(w8)ASMWORD(w9)ASMWORD(w10)} #define ELEVENWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9, w10, w11) \ {ASMWORD(w1)ASMWORD(w2)ASMWORD(w3)ASMWORD(w4)ASMWORD(w5)ASMWORD(w6)ASMWORD(w7)ASMWORD(w8)ASMWORD(w9)ASMWORD(w10)ASMWORD(w11)} #define TWELVEWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9, w10, w11, w12) \ {ASMWORD(w1)ASMWORD(w2)ASMWORD(w3)ASMWORD(w4)ASMWORD(w5)ASMWORD(w6)ASMWORD(w7)ASMWORD(w8)ASMWORD(w9)ASMWORD(w10)ASMWORD(w11)ASMWORD(w12)} #else /* Define the traps for Metrowerks IDE or MPW 68K compiler*/ #define ONEWORD_INLINE(trapNum) \ = trapNum #define TWOWORD_INLINE(w1, w2) \ = {w1,w2} #define THREEWORD_INLINE(w1, w2, w3) \ = {w1,w2,w3} #define FOURWORD_INLINE(w1, w2, w3, w4) \ = {w1,w2,w3,w4} #define FIVEWORD_INLINE(w1, w2, w3, w4, w5) \ = {w1,w2,w3,w4,w5} #define SIXWORD_INLINE(w1, w2, w3, w4, w5, w6) \ = {w1,w2,w3,w4,w5,w6} #define SEVENWORD_INLINE(w1, w2, w3, w4, w5, w6, w7) \ = {w1,w2,w3,w4,w5,w6,w7} #define EIGHTWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8) \ = {w1,w2,w3,w4,w5,w6,w7,w8} #define NINEWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9) \ = {w1,w2,w3,w4,w5,w6,w7,w8,w9} #define TENWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9, w10) \ = {w1,w2,w3,w4,w5,w6,w7,w8,w9,w10} #define ELEVENWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9, w10, w11) \ = {w1,w2,w3,w4,w5,w6,w7,w8,w9,w10,w11} #define TWELVEWORD_INLINE(w1, w2, w3, w4, w5, w6, w7, w8, w9, w10, w11, w12) \ = {w1,w2,w3,w4,w5,w6,w7,w8,w9,w10,w11,w12} #endif #endif /******************************************************************** * Elementary data types ********************************************************************/ /* Fixed size data types*/ typedef char SByte; /* 8 bits*/ #ifndef __TYPES__ /* (Already defined in CW11)*/ typedef unsigned char Byte; typedef unsigned short UInt16; typedef unsigned long UInt32; #endif typedef short SWord; /* 16 bits*/ typedef short Int16; typedef unsigned short Word; typedef long SDWord; /* 32 bits*/ typedef long Int32; typedef unsigned long DWord; /* Logical data types*/ #ifndef __TYPES__ /* (Already defined in CW11)*/ typedef unsigned char Boolean; #endif typedef char Char; /* Used for character strings*/ typedef unsigned char UChar; typedef short Short; /* >= Byte*/ typedef unsigned short UShort; typedef short Int; /* >= Word (use short so MPW and CW agree)*/ typedef unsigned short UInt; typedef long Long; /* >= DWord*/ typedef unsigned long ULong; typedef short Err; typedef DWord LocalID; /* local (card relative) chunk ID*/ /************************************************************ * Pointer Types *************************************************************/ typedef void* VoidPtr; typedef VoidPtr* VoidHand; /* Fixed size data types*/ typedef SByte* SBytePtr; #ifndef __TYPES__ /* (Already defined in CW11)*/ typedef Byte* BytePtr; #endif typedef SWord* SWordPtr; typedef Word* WordPtr; typedef unsigned short* UInt16Ptr; typedef SDWord* SDWordPtr; typedef DWord* DWordPtr; /* Logical data types*/ typedef Boolean* BooleanPtr; typedef Char* CharPtr; typedef UChar* UCharPtr; typedef Short* ShortPtr; typedef UShort* UShortPtr; typedef Int* IntPtr; typedef UInt* UIntPtr; typedef Long* LongPtr; typedef ULong* ULongPtr; /* Include the following typedefs if types.h wasn't read.*/ #ifndef __TYPES__ /* Generic Pointer types used by Memory Manager*/ /* We have to define Ptr as char* because that's what the Mac includes do.*/ typedef char* Ptr; /* global pointer*/ typedef Ptr* Handle; /* global handle*/ /* Function types*/ typedef Long (*ProcPtr)(); #endif /* __TYPES__ */ /************************************************************ * Common constants *************************************************************/ #ifndef NULL #undef NULL #define NULL 0 #endif /* Include the following typedefs if types.h wasn't read.*/ #ifndef __TYPES__ #ifdef __MWERKS__ #if !__option(bool) #ifndef true #define true 1 #endif #ifndef false #define false 0 #endif #endif #else #ifndef __cplusplus #ifndef true enum {false, true}; #endif #endif #endif #endif /* __TYPES__ */ #endif