| 1 | /* $Id: odin32validate.h,v 1.2 2000-04-16 04:06:11 bird Exp $ | 
|---|
| 2 | * | 
|---|
| 3 | * Parameter validation macros. | 
|---|
| 4 | * | 
|---|
| 5 | * Note that these are not fully implemented yet. Pointers and memory areas | 
|---|
| 6 | * are not checked if valid yet, since this requires some more effort. So, | 
|---|
| 7 | * for the time being pointers and memory areas are checked agains the | 
|---|
| 8 | * maximum user virtual address space limits. | 
|---|
| 9 | * | 
|---|
| 10 | * Copyright (c) 2000 knut st. osmundsen (knut.stange.osmundsen@pmsc.no) | 
|---|
| 11 | * | 
|---|
| 12 | * Project Odin Software License can be found in LICENSE.TXT | 
|---|
| 13 | * | 
|---|
| 14 | */ | 
|---|
| 15 | #ifndef _odin32validate_h_ | 
|---|
| 16 | #define _odin32validate_h_ | 
|---|
| 17 |  | 
|---|
| 18 | /** | 
|---|
| 19 | * ADDRESS_SPACE_LIMIT holds the largest possible address in the user virtual | 
|---|
| 20 | * address virtual space + 1. | 
|---|
| 21 | * 3GB is the higest possible address in the user virtual address space in OS/2. | 
|---|
| 22 | */ | 
|---|
| 23 | #define ADDRESS_SPACE_LIMIT 0xc0000000 | 
|---|
| 24 |  | 
|---|
| 25 |  | 
|---|
| 26 | /** | 
|---|
| 27 | * Validates that the specified pointer points at valid. | 
|---|
| 28 | * (Currently it only check that it's within the user virtual address space.) | 
|---|
| 29 | * @returns   TRUE if valid. | 
|---|
| 30 | *            FALSE if invalid. | 
|---|
| 31 | * @param     p     Pointer value. | 
|---|
| 32 | */ | 
|---|
| 33 | #define VALID_PTR(p) \ | 
|---|
| 34 | ((char*)(p) >= (char*)0x10000 \ | 
|---|
| 35 | && (char*)(p) < (char*)ADDRESS_SPACE_LIMIT) | 
|---|
| 36 |  | 
|---|
| 37 |  | 
|---|
| 38 | /** | 
|---|
| 39 | * Validates that the area pointed to is valid. | 
|---|
| 40 | * (Currently it only check that it's within the user virtual address space.) | 
|---|
| 41 | * @returns   TRUE if valid. | 
|---|
| 42 | *            FALSE if invalid. | 
|---|
| 43 | * @param     p     Pointer value. | 
|---|
| 44 | * @param     cb    Size of data pointer to by the pointer. | 
|---|
| 45 | */ | 
|---|
| 46 | #define VALID_PTRSIZE(p, cb) \ | 
|---|
| 47 | ((char*)(p) >= (char*)0x10000 \ | 
|---|
| 48 | && (char*)(p) < (char*)ADDRESS_SPACE_LIMIT \ | 
|---|
| 49 | && (char*)(p) + (unsigned)(cb) < (char*)ADDRESS_SPACE_LIMIT) | 
|---|
| 50 |  | 
|---|
| 51 |  | 
|---|
| 52 | /** | 
|---|
| 53 | * Validates that a string pointer is valid and that the entire string is valid. | 
|---|
| 54 | * (Currently it only checks that the first byte of the string is within | 
|---|
| 55 | * the user virtual address space.) | 
|---|
| 56 | * @returns   TRUE if valid. | 
|---|
| 57 | *            FALSE if invalid. | 
|---|
| 58 | * @param     psz       String pointer. | 
|---|
| 59 | * @param     cchMax    Max string length | 
|---|
| 60 | */ | 
|---|
| 61 | #define VALID_PSZ(psz) \ | 
|---|
| 62 | (VALID_PTRSIZE(psz, 1)) | 
|---|
| 63 |  | 
|---|
| 64 | /** | 
|---|
| 65 | * Validates that a string less or equal to a given max length. | 
|---|
| 66 | * Note! the pointer isn't validated. That you'll have to do separatly using | 
|---|
| 67 | * VALID_PSZ(psz) which is defined right above. | 
|---|
| 68 | * @returns   TRUE if valid. | 
|---|
| 69 | *            FALSE if invalid. | 
|---|
| 70 | * @param     psz       String pointer. | 
|---|
| 71 | * @param     cchMax    Max string length | 
|---|
| 72 | */ | 
|---|
| 73 | #define VALID_PSZMAXSIZE(psz, cchMax) \ | 
|---|
| 74 | (strlen(psz) <= cchMax) | 
|---|
| 75 |  | 
|---|
| 76 |  | 
|---|
| 77 |  | 
|---|
| 78 | #endif /* !defined(_odin32validate_h_) */ | 
|---|