granicus.if.org Git - zziplib/blob - TODO

   1 SHORTTERM
   2 - handle international filenames more gracefully (unicode API?)
   3 - most is multithreaded ... but zzip_dir_open (Thorsten Schöning)
   4 - rboerdijk@ does also report errors on overlapping reads, another
   5    one pointed to the usage of seek_set that may cause the problems
   6
   7 WISHLIST
   8
   9 - Check the CRC value at the end of read... and add more error codes.
  10
  11 - Do more test. Currently use only with tested "friendly" archives.
  12   This is also related to usages of zziplib in virus detection
  13   code which should better have a hardened library code. That does
  14   also include inflate interface code to need the most testing.
  15
  16 - the buffer reusage code was not strictly multithreading. It should
  17   be fixed by now but it would be better to have an automatic test
  18   routine to check reentrancy/multithreaded functionality.
  19
  20 - Sligthly More documentation. With the generation of man pages and
  21   multiple pages for the website, it does already look acceptable.
  22   It should still get better of course - kinda newbie friendly *g*
  23
  24 - Boris Schäling likes to open a zzip archive in memory.
  25
  26 KNOWN PROBLEMS
  27
  28 The win32 compilers need each a different config.h derivate that
  29 matches both the headers shipped with the compiler and installed
  30 with updates of the SDK. There is no autoconfigure on win32 as
  31 that - unless you install some unix tools along.
  32
  33 The sparc-sun-solaris2.* will utter warnings for "char subscript"
  34 which is caused by isdigit() from ctype.h - this will NOT FIX as
  35 it is only in the example source code and we want to keep those
  36 lean and mean to make them easy to adopt by developers.
  37
  38 The hppa1.1-hp-hpux10.20 did show spurious problems of making
  39 shared libraries - this may well fix with an update of the
  40 libtool package, the libtool 1.4 is dated 2001/04/24
  41
  42 There are reports of misaligned access to some zip fields that
  43 I would guess to be on little-endian non-x86 platforms. The current
  44 bytewise access of multibyte fields is targetted towards the
  45 bigendian unix machines. The fix would need to go to fetch.h but
  46 so far no response came about as that one could test a solution.
  47
  48 There are spurious reports of users on win32 platforms that tell
  49 of some problems with a specific zip file they have but it was
  50 not possible so far to recreate an environment abroad to show
  51 the problem too. One can not say if that is due some general
  52 instability out of DLL hell, or if there is a bug hiding somewhere.
  53 Please send all those zip files to the maintainer, perhaps it
  54 can help to find the real cause (I doubt it is in zziplib, but..)
  55
  56 Since lately the xml docbook tools have hardened the checks on the
  57 input xml that is used for manpage generation. Interestingly the
  58 resulting manpages are still okay but one should try to fixaway the
  59 warnings as may be later the result would lead to garbage output
  60 due more changes in the tools. Needs to change the xml generator
  61 used in zzip (a python script).
  62
  63 TESTED PLATFORMS
  64 sparc-sun-solaris2.6/gcc2.95.3
  65 sparc-sun-solaris2.8/gcc2.95.3
  66 hppa1.1-hp-hpux10.20
  67 i686-mandrake-linux-9.0/gcc3.2
  68 i686-mandrake-linux-9.1/gcc3.2.2
  69 i686-debian-linux-2.2/gcc2.95.2
  70 i386-unknown-freebsd4.7/gcc2.95.4          (formerly with wrapwrap)
  71 powerpc-apple-darwin5.5                    (formerly with wrapwrap)
  72 alphaev67-unknown-linux-gnu/gcc2.95.4      (that's a 64bit platform)
  73 i386-ms-win32/msvc6
  74 i386-ms-win32/msvc7
  75 i386-ms-win32/mingw+msys
  76 ... and probably a lot of others not known to the maintainer.
  77
  78 Additionally, note that Sourceforge has discontinued their compilefarm
  79 server laboratory. That makes it unlikely that proper support for
  80 crossplatform functionality can be provided. Expect a compile problem
  81 here or there - the code however should be prepared to get around any
  82 problems easily. Send patches! (especially Linux distributions makers
  83 are usually not sending their patches to upstream maintainers).
  84
  85 Note: the latest cross platform tests are done indirectly by using
  86 the build.opensuse.org rpm packaging where one can run "make check"
  87 just before doing the "make install" of the compiled library.
  88
  89
  90 SUSE BUILDSERVER INFO
  91
  92 I: A function overflows or underflows an array access. This could be a real error,
  93 but occasionaly this condition is also misdetected due to loop unrolling or strange pointer
  94 handling. So this is warning only, please review.
  95 W: zziplib arraysubscript ../../zzip/memdisk.c:114
  96
  97 I: File is compiled without RPM_OPT_FLAGS
  98 W: zziplib no-rpm-opt-flags <cmdline>:../../SDL/SDL_rwops_zzcat.c, ../../SDL/SDL_rwops_zzip.c
  99
 100 I: Program is likely to break with new gcc. Try -fno-strict-aliasing.
 101 W: zziplib strict-aliasing-punning ../../zzip/file.c:275
 102 W: zziplib strict-aliasing-punning ../../zzip/fseeko.c:99, 126, 147, 158, 182, 281, 288, 301, 360, 539, 543, 546, 563
 103 W: zziplib strict-aliasing-punning ../../zzip/memdisk.c:181, 182, 183, 185, 186, 187, 188, 189, 192, 193, 194, 195, 247, 455, 456
 104 W: zziplib strict-aliasing-punning ../../zzip/mmapped.c:277, 289, 311, 314, 339, 340, 393, 397, 410, 438, 440, 443, 444, 549, 551, 552, 558, 559, 561
 105 W: zziplib strict-aliasing-punning ../../zzip/zip.c:318, 320, 321, 322, 339, 341, 342, 343, 484, 485, 486, 497, 498, 499, 500, 501
 106 E: zziplib 64bit-portability-issue ../../zzip/memdisk.c:112
 107 System halted.