Subversion Repositories Kolibri OS

/*

  Copyright (c) 1990-2009 Info-ZIP.  All rights reserved.

  See the accompanying file LICENSE, version 2009-Jan-02 or later

  (the contents of which are also included in unzip.h) for terms of use.

  If, for some reason, all these files are missing, the Info-ZIP license

  also may be found at:  ftp://ftp.info-zip.org/pub/infozip/license.html

*/

/*---------------------------------------------------------------------------

  globals.h

  There is usually no need to include this file since unzip.h includes it.

  This header file is used by all of the UnZip source files.  It contains

  a struct definition that is used to "house" all of the global variables.

  This is done to allow for multithreaded environments (OS/2, NT, Win95,

  Unix) to call UnZip through an API without a semaphore.  REENTRANT should

  be defined for all platforms that require this.

  GLOBAL CONSTRUCTOR AND DESTRUCTOR (API WRITERS READ THIS!!!)

  ------------------------------------------------------------

  No, it's not C++, but it's as close as we can get with K&R.

  The main() of each process that uses these globals must include the

  CONSTRUCTGLOBALS; statement.  This will malloc enough memory for the

  structure and initialize any variables that require it.  This must

  also be done by any API function that jumps into the middle of the

  code.

  The DESTROYGLOBALS(); statement should be inserted before EVERY "EXIT(n)".

  Naturally, it also needs to be put before any API returns as well.

  In fact, it's much more important in API functions since the process

  will NOT end, and therefore the memory WON'T automatically be freed

  by the operating system.

  USING VARIABLES FROM THE STRUCTURE

  ----------------------------------

  All global variables must now be prefixed with `G.' which is either a

  global struct (in which case it should be the only global variable) or

  a macro for the value of a local pointer variable that is passed from

  function to function.  Yes, this is a pain.  But it's the only way to

  allow full reentrancy.

  ADDING VARIABLES TO THE STRUCTURE

  ---------------------------------

  If you make the inclusion of any variables conditional, be sure to only

  check macros that are GUARANTEED to be included in every module.

  For instance, newzip and pwdarg are needed only if CRYPT is TRUE,

  but this is defined after unzip.h has been read.  If you are not careful,

  some modules will expect your variable to be part of this struct while

  others won't.  This will cause BIG problems. (Inexplicable crashes at

  strange times, car fires, etc.)  When in doubt, always include it!

  Note also that UnZipSFX needs a few variables that UnZip doesn't.  However,

  it also includes some object files from UnZip.  If we were to conditionally

  include the extra variables that UnZipSFX needs, the object files from

  UnZip would not mesh with the UnZipSFX object files.  Result: we just

  include the UnZipSFX variables every time.  (It's only an extra 4 bytes

  so who cares!)

  ADDING FUNCTIONS

  ----------------

  To support this new global struct, all functions must now conditionally

  pass the globals pointer (pG) to each other.  This is supported by 5 macros:

  __GPRO, __GPRO__, __G, __G__ and __GDEF.  A function that needs no other

  parameters would look like this:

    int extract_or_test_files(__G)

      __GDEF

    {

       ... stuff ...

    }

  A function with other parameters would look like:

    int memextract(__G__ tgt, tgtsize, src, srcsize)

        __GDEF

        uch *tgt, *src;

        ulg tgtsize, srcsize;

    {

      ... stuff ...

    }

  In the Function Prototypes section of unzpriv.h, you should use __GPRO and

  __GPRO__ instead:

    int  uz_opts                   OF((__GPRO__ int *pargc, char ***pargv));

    int  process_zipfiles          OF((__GPRO));

  Note that there is NO comma after __G__ or __GPRO__ and no semi-colon after

  __GDEF.  I wish there was another way but I don't think there is.

  TESTING THE CODE

  -----------------

  Whether your platform requires reentrancy or not, you should always try

  building with REENTRANT defined if any functions have been added.  It is

  pretty easy to forget a __G__ or a __GDEF and this mistake will only show

  up if REENTRANT is defined.  All platforms should run with REENTRANT

  defined.  Platforms that can't take advantage of it will just be paying

  a performance penalty needlessly.

  SIGNAL MADNESS

  --------------

  This whole pointer passing scheme falls apart when it comes to SIGNALs.

  I handle this situation 2 ways right now.  If you define USETHREADID,

  UnZip will include a 64-entry table.  Each entry can hold a global

  pointer and thread ID for one thread.  This should allow up to 64

  threads to access UnZip simultaneously.  Calling DESTROYGLOBALS()

  will free the global struct and zero the table entry.  If somebody

  forgets to call DESTROYGLOBALS(), this table will eventually fill up

  and UnZip will exit with an error message.  A good way to test your

  code to make sure you didn't forget a DESTROYGLOBALS() is to change

  THREADID_ENTRIES to 3 or 4 in globals.c, making the table real small.

  Then make a small test program that calls your API a dozen times.

  Those platforms that don't have threads still need to be able to compile

  with REENTRANT defined to test and see if new code is correctly written

  to work either way.  For these platforms, I simply keep a global pointer

  called GG that points to the Globals structure.  Good enough for testing.

  I believe that NT has thread level storage.  This could probably be used

  to store a global pointer for the sake of the signal handler more cleanly

  than my table approach.

  ---------------------------------------------------------------------------*/

#ifndef __globals_h

#define __globals_h

#ifdef USE_ZLIB

#  include "zlib.h"

#  ifdef zlib_version           /* This name is used internally in unzip */

#    undef zlib_version         /*  and must not be defined as a macro. */

#  endif

#endif

#ifdef USE_BZIP2

#  include "bzlib.h"

#endif

/*************/

/*  Globals  */

/*************/

typedef struct Globals {

#ifdef DLL

    zvoid *callerglobs; /* pointer to structure of pass-through global vars */

#endif

    /* command options of general use */

    UzpOpts UzO;        /* command options of general use */

#ifndef FUNZIP

    /* command options specific to the high level command line interface */

#ifdef MORE

    int M_flag;         /* -M: built-in "more" function */

#endif

    /* internal flags and general globals */

#ifdef MORE

    int height;           /* check for SIGWINCH, etc., eventually... */

    int lines;            /* count of lines displayed on current screen */

# if (defined(SCREENWIDTH) && defined(SCREENLWRAP))

    int width;

    int chars;            /* count of screen characters in current line */

# endif

#endif /* MORE */

#if (defined(IZ_CHECK_TZ) && defined(USE_EF_UT_TIME))

    int tz_is_valid;      /* indicates that timezone info can be used */

#endif

    int noargs;           /* did true command line have *any* arguments? */

    unsigned filespecs;   /* number of real file specifications to be matched */

    unsigned xfilespecs;  /* number of excluded filespecs to be matched */

    int process_all_files;

    int overwrite_mode;   /* 0 - query, 1 - always, 2 - never */

    int create_dirs;      /* used by main(), mapname(), checkdir() */

    int extract_flag;

    int newzip;           /* reset in extract.c; used in crypt.c */

    zoff_t   real_ecrec_offset;

    zoff_t   expect_ecrec_offset;

    zoff_t   csize;       /* used by decompr. (NEXTBYTE): must be signed */

    zoff_t   used_csize;  /* used by extract_or_test_member(), explode() */

#ifdef DLL

     int fValidate;       /* true if only validating an archive */

     int filenotfound;

     int redirect_data;   /* redirect data to memory buffer */

     int redirect_text;   /* redirect text output to buffer */

# ifndef NO_SLIDE_REDIR

     int redirect_slide;  /* redirect decompression area to mem buffer */

#  if (defined(USE_DEFLATE64) && defined(INT_16BIT))

     ulg _wsize;          /* size of sliding window exceeds "unsigned" range */

#  else

     unsigned _wsize;     /* sliding window size can be hold in unsigned */

#  endif

# endif

     ulg redirect_size;            /* size of redirected output buffer */

     uch *redirect_buffer;         /* pointer to head of allocated buffer */

     uch *redirect_pointer;        /* pointer past end of written data */

# ifndef NO_SLIDE_REDIR

     uch *redirect_sldptr;         /* head of decompression slide buffer */

# endif

# ifdef OS2DLL

     cbList(processExternally);    /* call-back list */

# endif

#endif /* DLL */

    char **pfnames;

    char **pxnames;

    char sig[4];

    char answerbuf[10];

    min_info info[DIR_BLKSIZ];

    min_info *pInfo;

#endif /* !FUNZIP */

    union work area;                /* see unzpriv.h for definition of work */

#if (!defined(USE_ZLIB) || defined(USE_OWN_CRCTAB))

    ZCONST ulg near *crc_32_tab;

#else

    ZCONST ulg Far *crc_32_tab;

#endif

    ulg       crc32val;             /* CRC shift reg. (was static in funzip) */

#ifdef FUNZIP

    FILE      *in;                  /* file descriptor of compressed stream */

#endif

    uch       *inbuf;               /* input buffer (any size is OK) */

    uch       *inptr;               /* pointer into input buffer */

    int       incnt;

#ifndef FUNZIP

    ulg       bitbuf;

    int       bits_left;            /* unreduce and unshrink only */

    int       zipeof;

    char      *argv0;               /* used for NT and EXE_EXTENSION */

    char      *wildzipfn;

    char      *zipfn;    /* GRR:  WINDLL:  must nuke any malloc'd zipfn... */

#ifdef USE_STRM_INPUT

    FILE      *zipfd;               /* zipfile file descriptor */

#else

    int       zipfd;                /* zipfile file handle */

#endif

    zoff_t    ziplen;

    zoff_t    cur_zipfile_bufstart; /* extract_or_test, readbuf, ReadByte */

    zoff_t    extra_bytes;          /* used in unzip.c, misc.c */

    uch       *extra_field;         /* Unix, VMS, Mac, OS/2, Acorn, ... */

    uch       *hold;

    local_file_hdr  lrec;          /* used in unzip.c, extract.c */

    cdir_file_hdr   crec;          /* used in unzip.c, extract.c, misc.c */

    ecdir_rec       ecrec;         /* used in unzip.c, extract.c */

    z_stat   statbuf;              /* used by main, mapname, check_for_newer */

    int      mem_mode;

    uch      *outbufptr;           /* extract.c static */

    ulg      outsize;              /* extract.c static */

    int      reported_backslash;   /* extract.c static */

    int      disk_full;

    int      newfile;

    int      didCRlast;            /* fileio static */

    ulg      numlines;             /* fileio static: number of lines printed */

    int      sol;                  /* fileio static: at start of line */

    int      no_ecrec;             /* process static */

#ifdef SYMLINKS

    int      symlnk;

    slinkentry *slink_head;        /* pointer to head of symlinks list */

    slinkentry *slink_last;        /* pointer to last entry in symlinks list */

#endif

#ifdef NOVELL_BUG_FAILSAFE

    int      dne;                  /* true if stat() says file doesn't exist */

#endif

    FILE     *outfile;

    uch      *outbuf;

    uch      *realbuf;

#ifndef VMS                        /* if SMALL_MEM, outbuf2 is initialized in */

    uch      *outbuf2;             /*  process_zipfiles() (never changes); */

#endif                             /*  else malloc'd ONLY if unshrink and -a */

#endif /* !FUNZIP */

    uch      *outptr;

    ulg      outcnt;               /* number of chars stored in outbuf */

#ifndef FUNZIP

    char     filename[FILNAMSIZ];  /* also used by NT for temporary SFX path */

#ifdef UNICODE_SUPPORT

    char     *filename_full;       /* the full path so Unicode checks work */

    extent   fnfull_bufsize;       /* size of allocated filename buffer */

    int      unicode_escape_all;

    int      unicode_mismatch;

#ifdef UTF8_MAYBE_NATIVE

    int      native_is_utf8;       /* bool, TRUE => native charset == UTF-8 */

#endif

    int      unipath_version;      /* version of Unicode field */

    ulg      unipath_checksum;     /* Unicode field checksum */

    char     *unipath_filename;    /* UTF-8 path */

#endif /* UNICODE_SUPPORT */

#ifdef CMS_MVS

    char     *tempfn;              /* temp file used; erase on close */

#endif

    char *key;         /* crypt static: decryption password or NULL */

    int nopwd;         /* crypt static */

#endif /* !FUNZIP */

    z_uint4 keys[3];   /* crypt static: keys defining pseudo-random sequence */

#if (!defined(DOS_FLX_H68_NLM_OS2_W32) && !defined(AMIGA) && !defined(RISCOS))

#if (!defined(MACOS) && !defined(ATARI) && !defined(VMS))

    int echofd;        /* ttyio static: file descriptor whose echo is off */

#endif /* !(MACOS || ATARI || VMS) */

#endif /* !(DOS_FLX_H68_NLM_OS2_W32 || AMIGA || RISCOS) */

    unsigned hufts;    /* track memory usage */

#ifdef USE_ZLIB

    int inflInit;             /* inflate static: zlib inflate() initialized */

    z_stream dstrm;           /* inflate global: decompression stream */

#else

    struct huft *fixed_tl;              /* inflate static */

    struct huft *fixed_td;              /* inflate static */

    unsigned fixed_bl, fixed_bd;        /* inflate static */

#ifdef USE_DEFLATE64

    struct huft *fixed_tl64;            /* inflate static */

    struct huft *fixed_td64;            /* inflate static */

    unsigned fixed_bl64, fixed_bd64;    /* inflate static */

    struct huft *fixed_tl32;            /* inflate static */

    struct huft *fixed_td32;            /* inflate static */

    unsigned fixed_bl32, fixed_bd32;    /* inflate static */

    ZCONST ush *cplens;                 /* inflate static */

    ZCONST uch *cplext;                 /* inflate static */

    ZCONST uch *cpdext;                 /* inflate static */

#endif

    unsigned wp;              /* inflate static: current position in slide */

    ulg bb;                   /* inflate static: bit buffer */

    unsigned bk;              /* inflate static: bits count in bit buffer */

#endif /* ?USE_ZLIB */

#ifndef FUNZIP

    /* cylindric buffer space for formatting zoff_t values (fileio static) */

    char fzofft_buf[FZOFFT_NUM][FZOFFT_LEN];

    int fzofft_index;

#ifdef SMALL_MEM

    char rgchBigBuffer[512];

    char rgchSmallBuffer[96];

    char rgchSmallBuffer2[160];  /* boosted to 160 for local3[] in unzip.c */

#endif

    MsgFn *message;

    InputFn *input;

    PauseFn *mpause;

    PasswdFn *decr_passwd;

    StatCBFn *statreportcb;

#ifdef WINDLL

    LPUSERFUNCTIONS lpUserFunctions;

#endif

    int incnt_leftover;       /* so improved NEXTBYTE does not waste input */

    uch *inptr_leftover;

#ifdef VMS_TEXT_CONV

    unsigned VMS_line_length; /* so native VMS variable-length text files */

    int      VMS_line_state;  /*  are readable on other platforms */

    int      VMS_line_pad;

#endif

#if (defined(SFX) && defined(CHEAP_SFX_AUTORUN))

    char autorun_command[FILNAMSIZ];

#endif

#endif /* !FUNZIP */

#ifdef SYSTEM_SPECIFIC_GLOBALS

    SYSTEM_SPECIFIC_GLOBALS

#endif

} Uz_Globs;  /* end of struct Globals */

/***************************************************************************/

#define CRC_32_TAB      G.crc_32_tab

Uz_Globs *globalsCtor   OF((void));

/* pseudo constant sigs; they are initialized at runtime so unzip executable

 * won't look like a zipfile

 */

extern char local_hdr_sig[4];

extern char central_hdr_sig[4];

extern char end_central_sig[4];

extern char end_central32_sig[4];

extern char end_central64_sig[4];

extern char end_centloc64_sig[4];

/* extern char extd_local_sig[4];  NOT USED YET */

#ifdef REENTRANT

#  define G                   (*(Uz_Globs *)pG)

#  define __G                 pG

#  define __G__               pG,

#  define __GPRO              Uz_Globs *pG

#  define __GPRO__            Uz_Globs *pG,

#  define __GDEF              Uz_Globs *pG;

#  ifdef  USETHREADID

     extern int               lastScan;

     void deregisterGlobalPointer OF((__GPRO));

     Uz_Globs *getGlobalPointer   OF((void));

#    define GETGLOBALS()      Uz_Globs *pG = getGlobalPointer()

#    define DESTROYGLOBALS()  do {free_G_buffers(pG); \

                                  deregisterGlobalPointer(pG);} while (0)

#  else

     extern Uz_Globs          *GG;

#    define GETGLOBALS()      Uz_Globs *pG = GG

#    define DESTROYGLOBALS()  do {free_G_buffers(pG); free(pG);} while (0)

#  endif /* ?USETHREADID */

#  define CONSTRUCTGLOBALS()  Uz_Globs *pG = globalsCtor()

#else /* !REENTRANT */

   extern Uz_Globs            G;

#  define __G

#  define __G__

#  define __GPRO              void

#  define __GPRO__

#  define __GDEF

#  define GETGLOBALS()

#  define CONSTRUCTGLOBALS()  globalsCtor()

#  define DESTROYGLOBALS()

#endif /* ?REENTRANT */

#define uO              G.UzO

#endif /* __globals_h */