| Index: third_party/ijar/zip.h
|
| diff --git a/third_party/ijar/zip.h b/third_party/ijar/zip.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..c548cb3cdb08d6e527afd8a4b0f68667a680f96e
|
| --- /dev/null
|
| +++ b/third_party/ijar/zip.h
|
| @@ -0,0 +1,169 @@
|
| +// Copyright 2015 Google Inc. All rights reserved.
|
| +//
|
| +// Licensed under the Apache License, Version 2.0 (the "License");
|
| +// you may not use this file except in compliance with the License.
|
| +// You may obtain a copy of the License at
|
| +//
|
| +// http://www.apache.org/licenses/LICENSE-2.0
|
| +//
|
| +// Unless required by applicable law or agreed to in writing, software
|
| +// distributed under the License is distributed on an "AS IS" BASIS,
|
| +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
| +// See the License for the specific language governing permissions and
|
| +// limitations under the License.
|
| +//
|
| +// zip.h -- .zip (.jar) file reading/writing routines.
|
| +//
|
| +// This file specifies the interface to use the ZIP implementation of ijar.
|
| +//
|
| +
|
| +#ifndef INCLUDED_THIRD_PARTY_IJAR_ZIP_H
|
| +#define INCLUDED_THIRD_PARTY_IJAR_ZIP_H
|
| +
|
| +#include <sys/stat.h>
|
| +
|
| +#include "third_party/ijar/common.h"
|
| +
|
| +namespace devtools_ijar {
|
| +
|
| +// Tells if this is a directory entry from the mode. This method
|
| +// is safer than zipattr_to_mode(attr) & S_IFDIR because the unix
|
| +// mode might not be set in DOS zip files.
|
| +inline bool zipattr_is_dir(u4 attr) { return (attr & 0x10) != 0; }
|
| +
|
| +// Convert a Unix file mode to a ZIP file attribute
|
| +inline u4 mode_to_zipattr(mode_t m) {
|
| + return (((u4) m) << 16) + ((m & S_IFDIR) != 0 ? 0x10 : 0);
|
| +}
|
| +
|
| +// Convert a ZIP file attribute to a Unix file mode
|
| +inline mode_t zipattr_to_mode(u4 attr) {
|
| + return ((mode_t) ((attr >> 16) & 0xffff));
|
| +}
|
| +
|
| +//
|
| +// Class interface for building ZIP files
|
| +//
|
| +class ZipBuilder {
|
| + public:
|
| + virtual ~ZipBuilder() {}
|
| +
|
| + // Returns the text for the last error, or null on no last error.
|
| + virtual const char* GetError() = 0;
|
| +
|
| + // Add a new file to the ZIP, the file will have path "filename"
|
| + // and external attributes "attr". This function returns a pointer
|
| + // to a memory buffer to write the data of the file into. This buffer
|
| + // is owned by ZipBuilder and should not be free'd by the caller. The
|
| + // file length is then specified when the files is finished written
|
| + // using the FinishFile(size_t) function.
|
| + // On failure, returns NULL and GetError() will return an non-empty message.
|
| + virtual u1* NewFile(const char* filename, const u4 attr) = 0;
|
| +
|
| + // Finish writing a file and specify its length. After calling this method
|
| + // one should not reuse the pointer given by NewFile. The file can be
|
| + // compressed using the deflate algorithm by setting `compress` to true.
|
| + // On failure, returns -1 and GetError() will return an non-empty message.
|
| + virtual int FinishFile(size_t filelength, bool compress = false) = 0;
|
| +
|
| + // Write an empty file, it is equivalent to:
|
| + // NewFile(filename, 0);
|
| + // FinishFile(0);
|
| + // On failure, returns -1 and GetError() will return an non-empty message.
|
| + virtual int WriteEmptyFile(const char* filename) = 0;
|
| +
|
| + // Finish writing the ZIP file. This method can be called only once
|
| + // (subsequent calls will do nothing) and none of
|
| + // NewFile/FinishFile/WriteEmptyFile should be called after calling Finish. If
|
| + // this method was not called when the object is destroyed, it will be called.
|
| + // It is here as a convenience to get information on the final generated ZIP
|
| + // file.
|
| + // On failure, returns -1 and GetError() will return an non-empty message.
|
| + virtual int Finish() = 0;
|
| +
|
| + // Get the current size of the ZIP file. This size will not be matching the
|
| + // final ZIP file until Finish() has been called because Finish() is actually
|
| + // writing the central directory of the ZIP File.
|
| + virtual size_t GetSize() = 0;
|
| +
|
| + // Returns the current number of files stored in the ZIP.
|
| + virtual int GetNumberFiles() = 0;
|
| +
|
| + // Create a new ZipBuilder writing the file zip_file and the size of the
|
| + // output will be at most estimated_size. Use ZipBuilder::EstimateSize() or
|
| + // ZipExtractor::CalculateOuputLength() to have an estimated_size depending on
|
| + // a list of file to store.
|
| + // On failure, returns NULL. Refer to errno for error code.
|
| + static ZipBuilder* Create(const char* zip_file, u8 estimated_size);
|
| +
|
| + // Estimate the maximum size of the ZIP files containing files in the "files"
|
| + // null-terminated array.
|
| + // Returns 0 on error.
|
| + static u8 EstimateSize(char **files);
|
| +};
|
| +
|
| +//
|
| +// An abstract class to process data from a ZipExtractor.
|
| +// Derive from this class if you wish to process data from a ZipExtractor.
|
| +//
|
| +class ZipExtractorProcessor {
|
| + public:
|
| + virtual ~ZipExtractorProcessor() {}
|
| +
|
| + // Tells whether to skip or process the file "filename". "attr" is the
|
| + // external file attributes and can be converted to unix mode using the
|
| + // zipattr_to_mode() function. This method is suppoed to returns true
|
| + // if the file should be processed and false if it should be skipped.
|
| + virtual bool Accept(const char* filename, const u4 attr) = 0;
|
| +
|
| + // Process a file accepted by Accept. The file "filename" has external
|
| + // attributes "attr" and length "size". The file content is accessible
|
| + // in the buffer pointed by "data".
|
| + virtual void Process(const char* filename, const u4 attr,
|
| + const u1* data, const size_t size) = 0;
|
| +};
|
| +
|
| +//
|
| +// Class interface for reading ZIP files
|
| +//
|
| +class ZipExtractor {
|
| + public:
|
| + virtual ~ZipExtractor() {}
|
| +
|
| + // Returns the text for the last error, or null on no last error.
|
| + virtual const char* GetError() = 0;
|
| +
|
| + // Process the next files, returns false if the end of ZIP file has been
|
| + // reached. The processor provided by the Create method will be called
|
| + // if a file is encountered. If false is returned, check the return value
|
| + // of GetError() for potential errors.
|
| + virtual bool ProcessNext() = 0;
|
| +
|
| + // Process the all files, returns -1 on error (GetError() will be populated
|
| + // on error).
|
| + virtual int ProcessAll();
|
| +
|
| + // Reset the file pointer to the beginning.
|
| + virtual void Reset() = 0;
|
| +
|
| + // Return the size of the ZIP file.
|
| + virtual size_t GetSize() = 0;
|
| +
|
| + // Return the size of the resulting zip file by keeping only file
|
| + // accepted by the processor and storing them uncompressed. This
|
| + // method can be used to create a ZipBuilder for storing a subset
|
| + // of the input files.
|
| + // On error, 0 is returned and GetError() returns a non-empty message.
|
| + virtual u8 CalculateOutputLength() = 0;
|
| +
|
| + // Create a ZipExtractor that extract the zip file "filename" and process
|
| + // it with "processor".
|
| + // On error, a null pointer is returned and the value of errno should be
|
| + // checked.
|
| + static ZipExtractor* Create(const char* filename,
|
| + ZipExtractorProcessor *processor);
|
| +};
|
| +
|
| +} // namespace devtools_ijar
|
| +
|
| +#endif // INCLUDED_THIRD_PARTY_IJAR_ZIP_H
|
|
|