home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0020 - 0029 / ibm0020-0029 / ibm0028.tar / ibm0028 / INSTALL2.TD0 / SOURCES.LIF / VALIDATE.C < prev    next >
Encoding:
C/C++ Source or Header  |  1990-09-27  |  2.4 KB  |  65 lines
  1. /*=============================================================================
  2.  
  3.      The INSTALL program source code, object code, sample  script files,
  4.      executable  program,  and  documentation  are  subject to copyright
  5.      protection under the laws of the United States and other countries.
  6.  
  7.      This software is licensed, not sold, and may only be  redistributed
  8.      in  executable format and only in accordance with the provisions of
  9.      the INSTALL Source Code License Agreement.
  10.  
  11.         INSTALL is Copyright(C) 1987-1989 by Knowledge Dynamics Corp
  12.        Highway Contract 4 Box 185-H, Canyon Lake, TX (USA) 78133-3508
  13.               512-964-3994 (Voice)   512-964-3958 (24-hr FAX)
  14.  
  15.                       All rights reserved worldwide.
  16.  
  17. ===============================================================================
  18.  
  19. FILENAME:
  20.     validate.c
  21.  
  22. AUTHOR:
  23.     eric jon heflin
  24.  
  25. PUBLIC FUNCTIONS:
  26.     validate() - test compile-time conditions
  27.  
  28. LOCAL FUNCTIONS:
  29.     none
  30.  
  31. DESCRIPTION:
  32.     The function test() has a rather unique purpose: to verify that some
  33.     critical compiler conditions were properly implemented when compiling
  34.     the INSTALL sources.  This testing is particularly important since
  35.     the INSTALL source code is frequently recompiled.
  36.  
  37.     Specifically, INSTALL has four requirements regarding structure allocation:
  38.     1) structures are byte aligned,  2) the first named element of a
  39.     given structure is assigned a lower address than the second named
  40.     element, and 3) bitfields are implemented as binary digits of a word,
  41.     4) bitfields are allocated with the first named element assigned to the
  42.     zero bit of the word.  If any of these conditions are not satisfied,
  43.     INSTALL will not execute properly and it would probably be very difficult
  44.     to discover the alignment problem.  Thus this validation function.
  45.  
  46.     Note: Under DOS, structure assignment and alignment is not a requirement,
  47.     only under some non-DOS operating systems.  Thus, the validation function
  48.     is always successful under DOS.
  49.  
  50. REVISION HISTORY:
  51.     DATE:    AUTHOR:             DESCRIPTION OF CHANGES:
  52.     900131  eric jon heflin     Initial version.
  53.  
  54. ==============================================================================*/
  55.  
  56. #include "install.h"
  57.  
  58. void validate(void)
  59.     {           /* validate */
  60.     return;
  61.     }           /* validate */
  62.  
  63.  
  64. /* end-of-file */
  65.