home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / zip22.zip / vms / 00readme.txt < prev    next >
Text File  |  1997-10-15  |  6KB  |  127 lines

  1. *****************************************
  2. ************ vms/00readme.txt ***********
  3. *****************************************
  4.  
  5. Additional information for compiling Zip for VMS:
  6.  
  7. A) Support for storing VMS specific file attributes
  8.    ================================================
  9.  
  10. The current version of Zip comes with two different types of support
  11. to store VMS file attributes in extra blocks:
  12.  
  13.   -- the traditional Info-ZIP format in vms/vms_im.c
  14. and
  15.  
  16.   -- a new PKware (ASI) type extra field structure in vms/vms_pk.c
  17.  
  18. Both versions should supply exactly the same functionality.
  19. Up to Zip 2.1, the default configuration was to use the traditional IM style,
  20. since it was well tested and known to be stable.
  21. ==> NEW <==
  22. As of Zip 2.2, this default has been changed to use PK style extra field
  23. format. This change is needed to support indexed VMS files. The
  24. IM style code in UnZip (!!) has a known problem that prevents the correct
  25. restoring operation for some (but not all) indexed VMS files.
  26.  
  27. IMPORTANT: To extract new PK style extra fields, Info-ZIP's
  28.            UnZip version 5.2 or newer is required, previous
  29.            versions will crash with an access violation !!!!
  30.  
  31. If you want to use the old IM style support (to achieve compatibility
  32. with older versions of UnZip), the preprocessor symbol VMS_IM_EXTRA
  33. has to be defined at compile time.
  34.  
  35. MMS (MMK) users have to edit vms/descrip.mms and add this symbol to
  36. the definition of the COMMON_DEFS macro; for example:
  37.  
  38. COMMON_DEFS = VMS_IM_EXTRA,
  39.  
  40. if VMS_IM_EXTRA is the only option. (NOTE the trailing comma!)
  41.  
  42. Users of the DCL make procedure can select the PK style support by defining
  43. the DCL symbol LOCAL_ZIP as a list of user specific compilation options
  44. (do not forget the trailing comma!!). Example:
  45. $ LOCAL_ZIP == "VMS_IM_EXTRA,"
  46.  
  47.  
  48. B) Notes on the compiler switches used on VMS:
  49.    ===========================================
  50.  
  51. The source has been successfully compiled on VMS 6.1 (VMS 6.2 for AXP), using
  52.  - DEC C 5.2 and 5.6 for Alpha AXP
  53.  - DEC C 4.0 for VMS VAX
  54.  - VAX C 3.2
  55.  
  56. 1. Discussion of the /STANDARD switch:
  57.  
  58. With the exception of some few rough spots in the VMS specific sources,
  59. the code is fully compatible with the "RELAXED_ANSI" mode of the DEC C
  60. compilers. The problems found in vmsmunch.c and vms_pk.c are caused
  61. by incompatibles between the system include headers supplied for DEC C
  62. (AXP) and DEC C (VAX) which cannot get worked around. (Some system
  63. service structure members have type "unsigned int"  in the VAX version,
  64. but "pointer to [miscellanous]" in the AXP headers.)
  65. I consider the AXP headers to show the direction of `future developement'
  66. and have adapted the sources to match the AXP's header files.
  67. This means:
  68. On Alpha AXP, we can equally well use "/STANDARD=RELAXED" instead of
  69. "/STANDARD=VAXC" without getting any warnings.
  70. With the current release of DEC C on VAX, the /STANDARD=VAXC switch is
  71. required to suppress the "assignment to incompatible type" warnings.
  72. Beginning with the Zip 2.1 release, the compiler mode for Alpha AXP has
  73. been changed to "/STANDARD=RELAX", since the "ANSI mode" executables are
  74. slightly smaller.
  75.  
  76. 2. The /PREFIX_LIBRARY_ENTRIES switch:
  77.  
  78. In (strict and relaxed) ANSI mode on Alpha AXP, only the standard ANSI
  79. RTL function names get prefixed with "DECC$" by the compiler per default.
  80. This results in unresolved references to such functions as "read()", "open()"
  81. "lseek()" at link step. (The same might be true for earlier releases of DEC C
  82. on VAX.) To resolve this problem, one has to explicitely request prefixing
  83. of all DEC C RTL function by applying the "/PREFIX=ALL" switch.
  84. Although this switch is not needed in "VAXC" mode, it does not hurt either.
  85. Therefore, "/PREFIX=ALL" is applied regardless of the compilation mode,
  86. to avoid any problems when switching over to ANSI standard mode in the future.
  87.  
  88. C) Support for UT extra field UTC time stamps
  89.    ==========================================
  90. Beginning with Zip 2.1 and UnZip 5.2, the Info-ZIP compression utilities
  91. do principally support saving and restoring the modification time of
  92. Zipfile entries as UTC (GMT) universal time. This new information is
  93. stored in an "extra field" labeled "UT" (Unix style GMT modification/access
  94. times, ...).
  95. Previous version of Zip and UnZip used local time, stored in MSDOS compatible
  96. format (as specified by PKware for the Zip file format). This practice caused
  97. a lot of "time synchronization" trouble when transporting Zip archives world
  98. wide between largely different time zones.
  99.  
  100. Unfortunately, VMS (and the VMS C runtime environment) up to VMS 6.x does not
  101. contain support for timezone handling and assumes "local time == UTC time".
  102. This has changed with the release of VMS 7.0, which does (finally) support
  103. the concept of "universal world time" that is required for time synchronization
  104. in intercontinental networks...
  105.  
  106. For this reason, the UTC time stamp support is disabled in VMS Zip by default,
  107. otherwise users would experience annoying time stamp deviations when
  108. locally transfering Zip archives between VMS nodes and other (UNIX, OS/2,
  109. WinNT/Win95, MSDOS) systems.
  110. But when compiled on a VMS 7.x system, the UTC "UT extra field" support is
  111. automatically enabled.
  112.  
  113. For users located in the GMT time zone (or a nearby timezone, like CET),
  114. it might be worthwhile to enable UTC support by hand.
  115.  
  116. The default configuration can be overridden by defining one of the
  117. following preprocessor macro:
  118.  
  119.   USE_EF_UT_TIME        includes "UT" time stamp support
  120.   NO_EF_UT_TIME         disables "UT" time stamp support
  121.  
  122. When using MMS/MMK, you should add the appropiate symbol to the "COMMON_DEFS"
  123. list in vms/descrip.mms; if the command procedure is used for compiling,
  124. you can add the macro to the "LOCAL_ZIP" DCL symbol.
  125.  
  126. 14-Oct-1997 Christian Spieler
  127.