author Chris Double <>
Wed, 06 Aug 2008 12:47:37 +1200
changeset 16410 d9167d3c4207f461b551ea7aa509b19bc54be418
parent 1 9b2a99adc05e53cd4010de512f50118594756650
child 30620 55955ee71c10022333105c2c5e9ec2a4199899c8
permissions -rw-r--r--
Bug 448834. Move Ogg libraries from modules/ to media/. r+sr=roc

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* ***** BEGIN LICENSE BLOCK *****
 * Version: MPL 1.1/GPL 2.0/LGPL 2.1
 * The contents of this file are subject to the Mozilla Public License Version
 * 1.1 (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 * for the specific language governing rights and limitations under the
 * License.
 * The Original Code is Mozilla Communicator client code, released
 * March 31, 1998.
 * The Initial Developer of the Original Code is
 * Netscape Communications Corporation.
 * Portions created by the Initial Developer are Copyright (C) 1998-1999
 * the Initial Developer. All Rights Reserved.
 * Contributor(s):
 *   Daniel Veditz <>
 *   Samir Gehani <>
 *   Mitch Stoltz <>
 * Alternatively, the contents of this file may be used under the terms of
 * either the GNU General Public License Version 2 or later (the "GPL"), or
 * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
 * in which case the provisions of the GPL or the LGPL are applicable instead
 * of those above. If you wish to allow use of your version of this file only
 * under the terms of either the GPL or the LGPL, and not to allow others to
 * use your version of this file under the terms of the MPL, indicate your
 * decision by deleting the provisions above and replace them with the notice
 * and other provisions required by the GPL or the LGPL. If you do not delete
 * the provisions above, a recipient may use your version of this file under
 * the terms of any one of the MPL, the GPL or the LGPL.
 * ***** END LICENSE BLOCK ***** */

#ifndef nsZipArchive_h_
#define nsZipArchive_h_

#define ZIP_MAGIC     0x5A49505FL   /* "ZIP_" */
#define ZIPFIND_MAGIC 0x5A495046L   /* "ZIPF" */
#define ZIP_TABSIZE   256
// Keep this odd. The -1 is significant.
#define ZIP_BUFLEN    (4 * 1024 - 1)

#define nsZipArchive nsZipArchiveStandalone

#define ZIP_Seek(fd,p,m) (fseek((fd),(p),(m))==0)


#include "plarena.h"
#define ZIP_Seek(fd,p,m) (PR_Seek((fd),((PROffset32)p),(m))==((PROffset32)p))


#include "zlib.h"

class nsZipFind;
class nsZipReadState;
class nsZipItemMetadata;

struct PRFileDesc;

 * This file defines some of the basic structures used by libjar to
 * read Zip files. It makes use of zlib in order to do the decompression.
 * A few notes on the classes/structs:
 * nsZipArchive   represents a single Zip file, and maintains an index
 *                of all the items in the file.
 * nsZipItem      represents a single item (file) in the Zip archive.
 * nsZipFind      represents the metadata involved in doing a search,
 *                and current state of the iteration of found objects.
 * There is a lot of #ifdef STANDALONE here, and that is so that these
 * basic structures can be reused in a standalone static
 * library. In order for the code to be reused, these structures
 * should never use anything from XPCOM, including such obvious things
 * as NS_ASSERTION(). Instead, use the basic NSPR equivalents.
 * There is one key difference in the way that this code behaves in
 * STANDALONE mode. The nsZipArchive owns a single file descriptor and 
 * that is used to read the ZIP file index, and for 'Test' and 'Extract'. 
 * Since there is only one nsZipArchive per file, you can only Test/Extract 
 * one file at a time from the Zip file.
 * 'MT''safe' reading from the zipfile is performed through JARInputStream,
 * which maintains its own file descriptor, allowing for multiple reads 
 * concurrently from the same zip file.

 * nsZipItem -- a helper struct for nsZipArchive
 * each nsZipItem represents one file in the archive and all the
 * information needed to manipulate it.
struct nsZipItem
  nsZipItem*  next;

  PRUint32    headerOffset;
  PRUint32    dataOffset;
  PRUint32    size;             /* size in original file */
  PRUint32    realsize;         /* inflated size */
  PRUint32    crc32;

   * Keep small items together, to avoid overhead.
  PRUint16     time;
  PRUint16     date;
  PRUint16     mode;
  PRUint8      compression;
  PRPackedBool hasDataOffset : 1;
  PRPackedBool isDirectory : 1; 
  PRPackedBool isSynthetic : 1;  /* whether item is an actual zip entry or was
                                    generated as part of a real entry's path,
                                    e.g. foo/ in a zip containing only foo/a.txt
                                    and no foo/ entry is synthetic */
#if defined(XP_UNIX) || defined(XP_BEOS)
  PRPackedBool isSymlink : 1;

  char        name[1]; // actually, bigger than 1

 * nsZipArchive -- a class for reading the PKZIP file format.
class nsZipArchive 
  friend class nsZipFind;

  /** cookie used to validate supposed objects passed from C code */
  const PRInt32 kMagic;

  /** constructing does not open the archive. See OpenArchive() */

  /** destructing the object closes the archive */

   * OpenArchive 
   * It's an error to call this more than once on the same nsZipArchive
   * object. If we were allowed to use exceptions this would have been 
   * part of the constructor 
   * @param   fd            File descriptor of file to open
   * @return  status code
  nsresult OpenArchive(PRFileDesc* fd);

   * Test the integrity of items in this archive by running
   * a CRC check after extracting each item into a memory 
   * buffer.  If an entry name is supplied only the 
   * specified item is tested.  Else, if null is supplied
   * then all the items in the archive are tested.
   * @return  status code       
  nsresult Test(const char *aEntryName);

   * Closes an open archive.
  nsresult CloseArchive();

   * GetItem
   * @param   aEntryName Name of file in the archive
   * @return  pointer to nsZipItem
  nsZipItem* GetItem(const char * aEntryName);
   * ExtractFile
   * @param   zipEntry   Name of file in archive to extract
   * @param   outFD      Filedescriptor to write contents to
   * @param   outname    Name of file to write to
   * @return  status code
  nsresult ExtractFile(nsZipItem * zipEntry, const char *outname, PRFileDesc * outFD);

   * FindInit
   * Initializes a search for files in the archive. FindNext() returns
   * the actual matches. The nsZipFind must be deleted when you're done
   * @param   aPattern    a string or RegExp pattern to search for
   *                      (may be NULL to find all files in archive)
   * @param   aFind       a pointer to a pointer to a structure used
   *                      in FindNext.  In the case of an error this
   *                      will be set to NULL.
   * @return  status code
  PRInt32 FindInit(const char * aPattern, nsZipFind** aFind);

   * Moves the filepointer aFd to the start of data of the aItem.
   * @param   aItem       Pointer to nsZipItem
   * @param   aFd         The filepointer to move
  nsresult  SeekToItem(nsZipItem* aItem, PRFileDesc* aFd);

  //--- private members ---

  nsZipItem*    mFiles[ZIP_TABSIZE];
  PLArenaPool   mArena;

  // Used for central directory reading, and for Test and Extract
  PRFileDesc    *mFd;

  // Whether we synthesized the directory entries
  PRPackedBool  mBuiltSynthetics;

  //--- private methods ---
  nsZipArchive& operator=(const nsZipArchive& rhs); // prevent assignments
  nsZipArchive(const nsZipArchive& rhs);            // prevent copies

  nsZipItem*        CreateZipItem(PRUint16 namelen);
  nsresult          BuildFileList();
  nsresult          BuildSynthetics();

  nsresult  CopyItemToDisk(PRUint32 size, PRUint32 crc, PRFileDesc* outFD);
  nsresult  InflateItem(const nsZipItem* aItem, PRFileDesc* outFD);

 * nsZipFind 
 * a helper class for nsZipArchive, representing a search
class nsZipFind
  const PRInt32       kMagic;

  nsZipFind(nsZipArchive* aZip, char* aPattern, PRBool regExp);

  nsresult      FindNext(const char ** aResult);

  nsZipArchive* mArchive;
  char*         mPattern;
  nsZipItem*    mItem;
  PRUint16      mSlot;
  PRPackedBool  mRegExp;

  //-- prevent copies and assignments
  nsZipFind& operator=(const nsZipFind& rhs);
  nsZipFind(const nsZipFind& rhs);

nsresult gZlibInit(z_stream *zs);

#endif /* nsZipArchive_h_ */