From 7e2c90a5605fecbc51cda8d514eee4d2d6066c80 Mon Sep 17 00:00:00 2001 From: Donato Fiore <50346119+donato-fiore@users.noreply.github.com> Date: Thu, 30 Nov 2023 21:06:53 -0500 Subject: [PATCH] Initial Commit --- Makefile | 25 + Payload/TrollDecrypt.app/AppIcon60x60.png | Bin 0 -> 6602 bytes .../TrollDecrypt.app/AppIcon76x76~ipad.png | Bin 0 -> 9104 bytes Payload/TrollDecrypt.app/Info.plist | 68 + Payload/TrollDecrypt.app/TrollDecrypt | Bin 0 -> 762512 bytes Resources/AppIcon60x60.png | Bin 0 -> 6602 bytes Resources/AppIcon76x76~ipad.png | Bin 0 -> 9104 bytes Resources/Info.plist | 68 + SSZipArchive/SSZipArchive.h | 146 ++ SSZipArchive/SSZipArchive.m | 1069 +++++++++ SSZipArchive/SSZipCommon.h | 66 + SSZipArchive/ZipArchive.h | 19 + SSZipArchive/minizip/aes/aes.h | 270 +++ SSZipArchive/minizip/aes/aes_ni.c | 687 ++++++ SSZipArchive/minizip/aes/aes_ni.h | 59 + SSZipArchive/minizip/aes/aescrypt.c | 301 +++ SSZipArchive/minizip/aes/aeskey.c | 554 +++++ SSZipArchive/minizip/aes/aesopt.h | 776 +++++++ SSZipArchive/minizip/aes/aestab.c | 418 ++++ SSZipArchive/minizip/aes/aestab.h | 173 ++ SSZipArchive/minizip/aes/brg_endian.h | 127 ++ SSZipArchive/minizip/aes/brg_types.h | 191 ++ SSZipArchive/minizip/aes/fileenc.c | 145 ++ SSZipArchive/minizip/aes/fileenc.h | 121 + SSZipArchive/minizip/aes/hmac.c | 209 ++ SSZipArchive/minizip/aes/hmac.h | 119 + SSZipArchive/minizip/aes/prng.c | 155 ++ SSZipArchive/minizip/aes/prng.h | 82 + SSZipArchive/minizip/aes/pwd2key.c | 181 ++ SSZipArchive/minizip/aes/pwd2key.h | 45 + SSZipArchive/minizip/aes/sha1.c | 283 +++ SSZipArchive/minizip/aes/sha1.h | 72 + SSZipArchive/minizip/crypt.c | 144 ++ SSZipArchive/minizip/crypt.h | 64 + SSZipArchive/minizip/ioapi.c | 353 +++ SSZipArchive/minizip/ioapi.h | 154 ++ SSZipArchive/minizip/ioapi_buf.c | 461 ++++ SSZipArchive/minizip/ioapi_buf.h | 52 + SSZipArchive/minizip/ioapi_mem.c | 167 ++ SSZipArchive/minizip/ioapi_mem.h | 52 + SSZipArchive/minizip/minishared.c | 292 +++ SSZipArchive/minizip/minishared.h | 51 + SSZipArchive/minizip/unzip.c | 1999 ++++++++++++++++ SSZipArchive/minizip/unzip.h | 254 +++ SSZipArchive/minizip/zip.c | 2009 +++++++++++++++++ SSZipArchive/minizip/zip.h | 215 ++ TDAppDelegate.h | 8 + TDAppDelegate.m | 14 + TDDumpDecrypted.h | 17 + TDDumpDecrypted.m | 615 +++++ TDFileManagerViewController.h | 7 + TDFileManagerViewController.m | 97 + TDRootViewController.h | 7 + TDRootViewController.m | 109 + TDUtils.h | 58 + TDUtils.m | 372 +++ control | 8 + entitlements.plist | 38 + main.m | 8 + 59 files changed, 14054 insertions(+) create mode 100644 Makefile create mode 100644 Payload/TrollDecrypt.app/AppIcon60x60.png create mode 100644 Payload/TrollDecrypt.app/AppIcon76x76~ipad.png create mode 100644 Payload/TrollDecrypt.app/Info.plist create mode 100644 Payload/TrollDecrypt.app/TrollDecrypt create mode 100644 Resources/AppIcon60x60.png create mode 100644 Resources/AppIcon76x76~ipad.png create mode 100644 Resources/Info.plist create mode 100644 SSZipArchive/SSZipArchive.h create mode 100644 SSZipArchive/SSZipArchive.m create mode 100644 SSZipArchive/SSZipCommon.h create mode 100644 SSZipArchive/ZipArchive.h create mode 100644 SSZipArchive/minizip/aes/aes.h create mode 100644 SSZipArchive/minizip/aes/aes_ni.c create mode 100644 SSZipArchive/minizip/aes/aes_ni.h create mode 100644 SSZipArchive/minizip/aes/aescrypt.c create mode 100644 SSZipArchive/minizip/aes/aeskey.c create mode 100644 SSZipArchive/minizip/aes/aesopt.h create mode 100644 SSZipArchive/minizip/aes/aestab.c create mode 100644 SSZipArchive/minizip/aes/aestab.h create mode 100644 SSZipArchive/minizip/aes/brg_endian.h create mode 100644 SSZipArchive/minizip/aes/brg_types.h create mode 100644 SSZipArchive/minizip/aes/fileenc.c create mode 100644 SSZipArchive/minizip/aes/fileenc.h create mode 100644 SSZipArchive/minizip/aes/hmac.c create mode 100644 SSZipArchive/minizip/aes/hmac.h create mode 100644 SSZipArchive/minizip/aes/prng.c create mode 100644 SSZipArchive/minizip/aes/prng.h create mode 100644 SSZipArchive/minizip/aes/pwd2key.c create mode 100644 SSZipArchive/minizip/aes/pwd2key.h create mode 100644 SSZipArchive/minizip/aes/sha1.c create mode 100644 SSZipArchive/minizip/aes/sha1.h create mode 100644 SSZipArchive/minizip/crypt.c create mode 100644 SSZipArchive/minizip/crypt.h create mode 100644 SSZipArchive/minizip/ioapi.c create mode 100644 SSZipArchive/minizip/ioapi.h create mode 100644 SSZipArchive/minizip/ioapi_buf.c create mode 100644 SSZipArchive/minizip/ioapi_buf.h create mode 100644 SSZipArchive/minizip/ioapi_mem.c create mode 100644 SSZipArchive/minizip/ioapi_mem.h create mode 100644 SSZipArchive/minizip/minishared.c create mode 100644 SSZipArchive/minizip/minishared.h create mode 100644 SSZipArchive/minizip/unzip.c create mode 100644 SSZipArchive/minizip/unzip.h create mode 100644 SSZipArchive/minizip/zip.c create mode 100644 SSZipArchive/minizip/zip.h create mode 100644 TDAppDelegate.h create mode 100644 TDAppDelegate.m create mode 100644 TDDumpDecrypted.h create mode 100644 TDDumpDecrypted.m create mode 100644 TDFileManagerViewController.h create mode 100644 TDFileManagerViewController.m create mode 100644 TDRootViewController.h create mode 100644 TDRootViewController.m create mode 100644 TDUtils.h create mode 100644 TDUtils.m create mode 100644 control create mode 100644 entitlements.plist create mode 100644 main.m diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..6c66155 --- /dev/null +++ b/Makefile @@ -0,0 +1,25 @@ +TARGET := iphone:clang:latest:14.0 +INSTALL_TARGET_PROCESSES = TrollDecrypt + +GO_EASY_ON_ME = 1 +PACKAGE_FORMAT = ipa + +include $(THEOS)/makefiles/common.mk + +APPLICATION_NAME = TrollDecrypt + +TrollDecrypt_FILES = SSZipArchive/minizip/unzip.c SSZipArchive/minizip/crypt.c SSZipArchive/minizip/ioapi_buf.c SSZipArchive/minizip/ioapi_mem.c SSZipArchive/minizip/ioapi.c SSZipArchive/minizip/minishared.c SSZipArchive/minizip/zip.c SSZipArchive/minizip/aes/aes_ni.c SSZipArchive/minizip/aes/aescrypt.c SSZipArchive/minizip/aes/aeskey.c SSZipArchive/minizip/aes/aestab.c SSZipArchive/minizip/aes/fileenc.c SSZipArchive/minizip/aes/hmac.c SSZipArchive/minizip/aes/prng.c SSZipArchive/minizip/aes/pwd2key.c SSZipArchive/minizip/aes/sha1.c SSZipArchive/SSZipArchive.m +TrollDecrypt_FILES += main.m TDAppDelegate.m TDRootViewController.m TDDumpDecrypted.m TDUtils.m TDFileManagerViewController.m +TrollDecrypt_FRAMEWORKS = UIKit CoreGraphics MobileCoreServices +TrollDecrypt_CFLAGS = -fobjc-arc +TrollDecrypt_CODESIGN_FLAGS = -Sentitlements.plist + +include $(THEOS_MAKE_PATH)/application.mk + +after-stage:: + rm -rf Payload + mkdir -p $(THEOS_STAGING_DIR)/Payload + ldid -Sentitlements.plist $(THEOS_STAGING_DIR)/Applications/TrollDecrypt.app/TrollDecrypt + cp -a $(THEOS_STAGING_DIR)/Applications/* $(THEOS_STAGING_DIR)/Payload + mv $(THEOS_STAGING_DIR)/Payload . + zip -q -r TrollDecrypt.ipa Payload diff --git a/Payload/TrollDecrypt.app/AppIcon60x60.png b/Payload/TrollDecrypt.app/AppIcon60x60.png new file mode 100644 index 0000000000000000000000000000000000000000..998962965a7facf8e1a6dc115104907e5c97dc38 GIT binary patch literal 6602 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 literal 0 HcmV?d00001 diff --git a/Payload/TrollDecrypt.app/AppIcon76x76~ipad.png b/Payload/TrollDecrypt.app/AppIcon76x76~ipad.png new file mode 100644 index 0000000000000000000000000000000000000000..b2d07fb4bee937321196dcfa6265f564bec67325 GIT binary patch literal 9104 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 KT%D{%#D4)&Qj1mq literal 0 HcmV?d00001 diff --git a/Payload/TrollDecrypt.app/Info.plist b/Payload/TrollDecrypt.app/Info.plist new file mode 100644 index 0000000..598a85f --- /dev/null +++ b/Payload/TrollDecrypt.app/Info.plist @@ -0,0 +1,68 @@ + + + + + CFBundleExecutable + TrollDecrypt + CFBundleIcons + + CFBundlePrimaryIcon + + CFBundleIconFiles + + AppIcon60x60 + + UIPrerenderedIcon + + + + CFBundleIcons~ipad + + CFBundlePrimaryIcon + + CFBundleIconFiles + + AppIcon60x60 + AppIcon76x76~ipad + + UIPrerenderedIcon + + + + CFBundleIdentifier + com.fiore.trolldecrypt + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + CFBundleSignature + ???? + CFBundleSupportedPlatforms + + iPhoneOS + + CFBundleVersion + 1.0 + LSRequiresIPhoneOS + + UIDeviceFamily + + 1 + 2 + + UIRequiredDeviceCapabilities + + armv7 + + UILaunchStoryboardName + LaunchScreen + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + + UISupportedInterfaceOrientations~ipad + + UIInterfaceOrientationPortrait + + + diff --git a/Payload/TrollDecrypt.app/TrollDecrypt b/Payload/TrollDecrypt.app/TrollDecrypt new file mode 100644 index 0000000000000000000000000000000000000000..33c01bc8e706f81e5ac28118d2eaced9dfe455c4 GIT binary patch literal 762512 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°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

}3V(C)bV| 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 literal 0 HcmV?d00001 diff --git a/Resources/AppIcon76x76~ipad.png b/Resources/AppIcon76x76~ipad.png new file mode 100644 index 0000000000000000000000000000000000000000..b2d07fb4bee937321196dcfa6265f564bec67325 GIT binary patch literal 9104 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 KT%D{%#D4)&Qj1mq literal 0 HcmV?d00001 diff --git a/Resources/Info.plist b/Resources/Info.plist new file mode 100644 index 0000000..598a85f --- /dev/null +++ b/Resources/Info.plist @@ -0,0 +1,68 @@ + + + + + CFBundleExecutable + TrollDecrypt + CFBundleIcons + + CFBundlePrimaryIcon + + CFBundleIconFiles + + AppIcon60x60 + + UIPrerenderedIcon + + + + CFBundleIcons~ipad + + CFBundlePrimaryIcon + + CFBundleIconFiles + + AppIcon60x60 + AppIcon76x76~ipad + + UIPrerenderedIcon + + + + CFBundleIdentifier + com.fiore.trolldecrypt + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + CFBundleSignature + ???? + CFBundleSupportedPlatforms + + iPhoneOS + + CFBundleVersion + 1.0 + LSRequiresIPhoneOS + + UIDeviceFamily + + 1 + 2 + + UIRequiredDeviceCapabilities + + armv7 + + UILaunchStoryboardName + LaunchScreen + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + + UISupportedInterfaceOrientations~ipad + + UIInterfaceOrientationPortrait + + + diff --git a/SSZipArchive/SSZipArchive.h b/SSZipArchive/SSZipArchive.h new file mode 100644 index 0000000..e5768b1 --- /dev/null +++ b/SSZipArchive/SSZipArchive.h @@ -0,0 +1,146 @@ +// +// SSZipArchive.h +// SSZipArchive +// +// Created by Sam Soffes on 7/21/10. +// Copyright (c) Sam Soffes 2010-2015. All rights reserved. +// + +#ifndef _SSZIPARCHIVE_H +#define _SSZIPARCHIVE_H + +#import +#include "SSZipCommon.h" + +NS_ASSUME_NONNULL_BEGIN + +extern NSString *const SSZipArchiveErrorDomain; +typedef NS_ENUM(NSInteger, SSZipArchiveErrorCode) { + SSZipArchiveErrorCodeFailedOpenZipFile = -1, + SSZipArchiveErrorCodeFailedOpenFileInZip = -2, + SSZipArchiveErrorCodeFileInfoNotLoadable = -3, + SSZipArchiveErrorCodeFileContentNotReadable = -4, + SSZipArchiveErrorCodeFailedToWriteFile = -5, + SSZipArchiveErrorCodeInvalidArguments = -6, +}; + +@protocol SSZipArchiveDelegate; + +@interface SSZipArchive : NSObject + +// Password check ++ (BOOL)isFilePasswordProtectedAtPath:(NSString *)path; ++ (BOOL)isPasswordValidForArchiveAtPath:(NSString *)path password:(NSString *)pw error:(NSError * _Nullable * _Nullable)error NS_SWIFT_NOTHROW; + +// Unzip ++ (BOOL)unzipFileAtPath:(NSString *)path toDestination:(NSString *)destination; ++ (BOOL)unzipFileAtPath:(NSString *)path toDestination:(NSString *)destination delegate:(nullable id)delegate; + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + overwrite:(BOOL)overwrite + password:(nullable NSString *)password + error:(NSError * *)error; + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + overwrite:(BOOL)overwrite + password:(nullable NSString *)password + error:(NSError * *)error + delegate:(nullable id)delegate NS_REFINED_FOR_SWIFT; + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + preserveAttributes:(BOOL)preserveAttributes + overwrite:(BOOL)overwrite + password:(nullable NSString *)password + error:(NSError * *)error + delegate:(nullable id)delegate; + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + progressHandler:(void (^_Nullable)(NSString *entry, unz_file_info zipInfo, long entryNumber, long total))progressHandler + completionHandler:(void (^_Nullable)(NSString *path, BOOL succeeded, NSError * _Nullable error))completionHandler; + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + overwrite:(BOOL)overwrite + password:(nullable NSString *)password + progressHandler:(void (^_Nullable)(NSString *entry, unz_file_info zipInfo, long entryNumber, long total))progressHandler + completionHandler:(void (^_Nullable)(NSString *path, BOOL succeeded, NSError * _Nullable error))completionHandler; + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + preserveAttributes:(BOOL)preserveAttributes + overwrite:(BOOL)overwrite + nestedZipLevel:(NSInteger)nestedZipLevel + password:(nullable NSString *)password + error:(NSError **)error + delegate:(nullable id)delegate + progressHandler:(void (^_Nullable)(NSString *entry, unz_file_info zipInfo, long entryNumber, long total))progressHandler + completionHandler:(void (^_Nullable)(NSString *path, BOOL succeeded, NSError * _Nullable error))completionHandler; + +// Zip +// default compression level is Z_DEFAULT_COMPRESSION (from "zlib.h") + +// without password ++ (BOOL)createZipFileAtPath:(NSString *)path withFilesAtPaths:(NSArray *)paths; ++ (BOOL)createZipFileAtPath:(NSString *)path withContentsOfDirectory:(NSString *)directoryPath; + ++ (BOOL)createZipFileAtPath:(NSString *)path withContentsOfDirectory:(NSString *)directoryPath keepParentDirectory:(BOOL)keepParentDirectory; + +// with optional password, default encryption is AES +// don't use AES if you need compatibility with native macOS unzip and Archive Utility ++ (BOOL)createZipFileAtPath:(NSString *)path withFilesAtPaths:(NSArray *)paths withPassword:(nullable NSString *)password; ++ (BOOL)createZipFileAtPath:(NSString *)path withContentsOfDirectory:(NSString *)directoryPath withPassword:(nullable NSString *)password; ++ (BOOL)createZipFileAtPath:(NSString *)path withContentsOfDirectory:(NSString *)directoryPath keepParentDirectory:(BOOL)keepParentDirectory withPassword:(nullable NSString *)password; ++ (BOOL)createZipFileAtPath:(NSString *)path + withContentsOfDirectory:(NSString *)directoryPath + keepParentDirectory:(BOOL)keepParentDirectory + withPassword:(nullable NSString *)password + andProgressHandler:(void(^ _Nullable)(NSUInteger entryNumber, NSUInteger total))progressHandler; ++ (BOOL)createZipFileAtPath:(NSString *)path + withContentsOfDirectory:(NSString *)directoryPath + keepParentDirectory:(BOOL)keepParentDirectory + compressionLevel:(int)compressionLevel + password:(nullable NSString *)password + AES:(BOOL)aes + progressHandler:(void(^ _Nullable)(NSUInteger entryNumber, NSUInteger total))progressHandler; + +- (instancetype)init NS_UNAVAILABLE; +- (instancetype)initWithPath:(NSString *)path NS_DESIGNATED_INITIALIZER; +- (BOOL)open; + +/// write empty folder +- (BOOL)writeFolderAtPath:(NSString *)path withFolderName:(NSString *)folderName withPassword:(nullable NSString *)password; +/// write file +- (BOOL)writeFile:(NSString *)path withPassword:(nullable NSString *)password; +- (BOOL)writeFileAtPath:(NSString *)path withFileName:(nullable NSString *)fileName withPassword:(nullable NSString *)password; +- (BOOL)writeFileAtPath:(NSString *)path withFileName:(nullable NSString *)fileName compressionLevel:(int)compressionLevel password:(nullable NSString *)password AES:(BOOL)aes; +/// write data +- (BOOL)writeData:(NSData *)data filename:(nullable NSString *)filename withPassword:(nullable NSString *)password; +- (BOOL)writeData:(NSData *)data filename:(nullable NSString *)filename compressionLevel:(int)compressionLevel password:(nullable NSString *)password AES:(BOOL)aes; + +- (BOOL)close; + +@end + +@protocol SSZipArchiveDelegate + +@optional + +- (void)zipArchiveWillUnzipArchiveAtPath:(NSString *)path zipInfo:(unz_global_info)zipInfo; +- (void)zipArchiveDidUnzipArchiveAtPath:(NSString *)path zipInfo:(unz_global_info)zipInfo unzippedPath:(NSString *)unzippedPath; + +- (BOOL)zipArchiveShouldUnzipFileAtIndex:(NSInteger)fileIndex totalFiles:(NSInteger)totalFiles archivePath:(NSString *)archivePath fileInfo:(unz_file_info)fileInfo; +- (void)zipArchiveWillUnzipFileAtIndex:(NSInteger)fileIndex totalFiles:(NSInteger)totalFiles archivePath:(NSString *)archivePath fileInfo:(unz_file_info)fileInfo; +- (void)zipArchiveDidUnzipFileAtIndex:(NSInteger)fileIndex totalFiles:(NSInteger)totalFiles archivePath:(NSString *)archivePath fileInfo:(unz_file_info)fileInfo; +- (void)zipArchiveDidUnzipFileAtIndex:(NSInteger)fileIndex totalFiles:(NSInteger)totalFiles archivePath:(NSString *)archivePath unzippedFilePath:(NSString *)unzippedFilePath; + +- (void)zipArchiveProgressEvent:(unsigned long long)loaded total:(unsigned long long)total; + +@end + +NS_ASSUME_NONNULL_END + +#endif /* _SSZIPARCHIVE_H */ diff --git a/SSZipArchive/SSZipArchive.m b/SSZipArchive/SSZipArchive.m new file mode 100644 index 0000000..79897d4 --- /dev/null +++ b/SSZipArchive/SSZipArchive.m @@ -0,0 +1,1069 @@ +// +// SSZipArchive.m +// SSZipArchive +// +// Created by Sam Soffes on 7/21/10. +// Copyright (c) Sam Soffes 2010-2015. All rights reserved. +// + +#import "SSZipArchive.h" +#include "./minizip/unzip.h" +#include "./minizip/zip.h" +#include "./minizip/minishared.h" + +#include + +NSString *const SSZipArchiveErrorDomain = @"SSZipArchiveErrorDomain"; + +#define CHUNK 16384 + +int _zipOpenEntry(zipFile entry, NSString *name, const zip_fileinfo *zipfi, int level, NSString *password, BOOL aes); +BOOL _fileIsSymbolicLink(const unz_file_info *fileInfo); + +#ifndef API_AVAILABLE +// Xcode 7- compatibility +#define API_AVAILABLE(...) +#endif + +@interface NSData(SSZipArchive) +- (NSString *)_base64RFC4648 API_AVAILABLE(macos(10.9), ios(7.0), watchos(2.0), tvos(9.0)); +- (NSString *)_hexString; +@end + +@interface SSZipArchive () +- (instancetype)init NS_DESIGNATED_INITIALIZER; +@end + +@implementation SSZipArchive +{ + /// path for zip file + NSString *_path; + zipFile _zip; +} + +#pragma mark - Password check + ++ (BOOL)isFilePasswordProtectedAtPath:(NSString *)path { + // Begin opening + zipFile zip = unzOpen(path.fileSystemRepresentation); + if (zip == NULL) { + return NO; + } + + int ret = unzGoToFirstFile(zip); + if (ret == UNZ_OK) { + do { + ret = unzOpenCurrentFile(zip); + if (ret != UNZ_OK) { + return NO; + } + unz_file_info fileInfo = {}; + ret = unzGetCurrentFileInfo(zip, &fileInfo, NULL, 0, NULL, 0, NULL, 0); + if (ret != UNZ_OK) { + return NO; + } else if ((fileInfo.flag & 1) == 1) { + return YES; + } + + unzCloseCurrentFile(zip); + ret = unzGoToNextFile(zip); + } while (ret == UNZ_OK); + } + + return NO; +} + ++ (BOOL)isPasswordValidForArchiveAtPath:(NSString *)path password:(NSString *)pw error:(NSError **)error { + if (error) { + *error = nil; + } + + zipFile zip = unzOpen(path.fileSystemRepresentation); + if (zip == NULL) { + if (error) { + *error = [NSError errorWithDomain:SSZipArchiveErrorDomain + code:SSZipArchiveErrorCodeFailedOpenZipFile + userInfo:@{NSLocalizedDescriptionKey: @"failed to open zip file"}]; + } + return NO; + } + + int ret = unzGoToFirstFile(zip); + if (ret == UNZ_OK) { + do { + if (pw.length == 0) { + ret = unzOpenCurrentFile(zip); + } else { + ret = unzOpenCurrentFilePassword(zip, [pw cStringUsingEncoding:NSUTF8StringEncoding]); + } + if (ret != UNZ_OK) { + if (ret != UNZ_BADPASSWORD) { + if (error) { + *error = [NSError errorWithDomain:SSZipArchiveErrorDomain + code:SSZipArchiveErrorCodeFailedOpenFileInZip + userInfo:@{NSLocalizedDescriptionKey: @"failed to open first file in zip file"}]; + } + } + return NO; + } + unz_file_info fileInfo = {}; + ret = unzGetCurrentFileInfo(zip, &fileInfo, NULL, 0, NULL, 0, NULL, 0); + if (ret != UNZ_OK) { + if (error) { + *error = [NSError errorWithDomain:SSZipArchiveErrorDomain + code:SSZipArchiveErrorCodeFileInfoNotLoadable + userInfo:@{NSLocalizedDescriptionKey: @"failed to retrieve info for file"}]; + } + return NO; + } else if ((fileInfo.flag & 1) == 1) { + unsigned char buffer[10] = {0}; + int readBytes = unzReadCurrentFile(zip, buffer, (unsigned)MIN(10UL,fileInfo.uncompressed_size)); + if (readBytes < 0) { + // Let's assume error Z_DATA_ERROR is caused by an invalid password + // Let's assume other errors are caused by Content Not Readable + if (readBytes != Z_DATA_ERROR) { + if (error) { + *error = [NSError errorWithDomain:SSZipArchiveErrorDomain + code:SSZipArchiveErrorCodeFileContentNotReadable + userInfo:@{NSLocalizedDescriptionKey: @"failed to read contents of file entry"}]; + } + } + return NO; + } + return YES; + } + + unzCloseCurrentFile(zip); + ret = unzGoToNextFile(zip); + } while (ret == UNZ_OK); + } + + // No password required + return YES; +} + +#pragma mark - Unzipping + ++ (BOOL)unzipFileAtPath:(NSString *)path toDestination:(NSString *)destination +{ + return [self unzipFileAtPath:path toDestination:destination delegate:nil]; +} + ++ (BOOL)unzipFileAtPath:(NSString *)path toDestination:(NSString *)destination overwrite:(BOOL)overwrite password:(nullable NSString *)password error:(NSError **)error +{ + return [self unzipFileAtPath:path toDestination:destination preserveAttributes:YES overwrite:overwrite password:password error:error delegate:nil progressHandler:nil completionHandler:nil]; +} + ++ (BOOL)unzipFileAtPath:(NSString *)path toDestination:(NSString *)destination delegate:(nullable id)delegate +{ + return [self unzipFileAtPath:path toDestination:destination preserveAttributes:YES overwrite:YES password:nil error:nil delegate:delegate progressHandler:nil completionHandler:nil]; +} + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + overwrite:(BOOL)overwrite + password:(nullable NSString *)password + error:(NSError **)error + delegate:(nullable id)delegate +{ + return [self unzipFileAtPath:path toDestination:destination preserveAttributes:YES overwrite:overwrite password:password error:error delegate:delegate progressHandler:nil completionHandler:nil]; +} + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + overwrite:(BOOL)overwrite + password:(NSString *)password + progressHandler:(void (^)(NSString *entry, unz_file_info zipInfo, long entryNumber, long total))progressHandler + completionHandler:(void (^)(NSString *path, BOOL succeeded, NSError * _Nullable error))completionHandler +{ + return [self unzipFileAtPath:path toDestination:destination preserveAttributes:YES overwrite:overwrite password:password error:nil delegate:nil progressHandler:progressHandler completionHandler:completionHandler]; +} + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + progressHandler:(void (^_Nullable)(NSString *entry, unz_file_info zipInfo, long entryNumber, long total))progressHandler + completionHandler:(void (^_Nullable)(NSString *path, BOOL succeeded, NSError * _Nullable error))completionHandler +{ + return [self unzipFileAtPath:path toDestination:destination preserveAttributes:YES overwrite:YES password:nil error:nil delegate:nil progressHandler:progressHandler completionHandler:completionHandler]; +} + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + preserveAttributes:(BOOL)preserveAttributes + overwrite:(BOOL)overwrite + password:(nullable NSString *)password + error:(NSError * *)error + delegate:(nullable id)delegate +{ + return [self unzipFileAtPath:path toDestination:destination preserveAttributes:preserveAttributes overwrite:overwrite password:password error:error delegate:delegate progressHandler:nil completionHandler:nil]; +} + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + preserveAttributes:(BOOL)preserveAttributes + overwrite:(BOOL)overwrite + password:(nullable NSString *)password + error:(NSError **)error + delegate:(nullable id)delegate + progressHandler:(void (^_Nullable)(NSString *entry, unz_file_info zipInfo, long entryNumber, long total))progressHandler + completionHandler:(void (^_Nullable)(NSString *path, BOOL succeeded, NSError * _Nullable error))completionHandler +{ + return [self unzipFileAtPath:path toDestination:destination preserveAttributes:preserveAttributes overwrite:overwrite nestedZipLevel:0 password:password error:error delegate:delegate progressHandler:progressHandler completionHandler:completionHandler]; +} + ++ (BOOL)unzipFileAtPath:(NSString *)path + toDestination:(NSString *)destination + preserveAttributes:(BOOL)preserveAttributes + overwrite:(BOOL)overwrite + nestedZipLevel:(NSInteger)nestedZipLevel + password:(nullable NSString *)password + error:(NSError **)error + delegate:(nullable id)delegate + progressHandler:(void (^_Nullable)(NSString *entry, unz_file_info zipInfo, long entryNumber, long total))progressHandler + completionHandler:(void (^_Nullable)(NSString *path, BOOL succeeded, NSError * _Nullable error))completionHandler +{ + // Guard against empty strings + if (path.length == 0 || destination.length == 0) + { + NSDictionary *userInfo = @{NSLocalizedDescriptionKey: @"received invalid argument(s)"}; + NSError *err = [NSError errorWithDomain:SSZipArchiveErrorDomain code:SSZipArchiveErrorCodeInvalidArguments userInfo:userInfo]; + if (error) + { + *error = err; + } + if (completionHandler) + { + completionHandler(nil, NO, err); + } + return NO; + } + + // Begin opening + zipFile zip = unzOpen(path.fileSystemRepresentation); + if (zip == NULL) + { + NSDictionary *userInfo = @{NSLocalizedDescriptionKey: @"failed to open zip file"}; + NSError *err = [NSError errorWithDomain:SSZipArchiveErrorDomain code:SSZipArchiveErrorCodeFailedOpenZipFile userInfo:userInfo]; + if (error) + { + *error = err; + } + if (completionHandler) + { + completionHandler(nil, NO, err); + } + return NO; + } + + NSDictionary * fileAttributes = [[NSFileManager defaultManager] attributesOfItemAtPath:path error:nil]; + unsigned long long fileSize = [fileAttributes[NSFileSize] unsignedLongLongValue]; + unsigned long long currentPosition = 0; + + unz_global_info globalInfo = {}; + unzGetGlobalInfo(zip, &globalInfo); + + // Begin unzipping + int ret = 0; + ret = unzGoToFirstFile(zip); + if (ret != UNZ_OK && ret != UNZ_END_OF_LIST_OF_FILE) + { + NSDictionary *userInfo = @{NSLocalizedDescriptionKey: @"failed to open first file in zip file"}; + NSError *err = [NSError errorWithDomain:SSZipArchiveErrorDomain code:SSZipArchiveErrorCodeFailedOpenFileInZip userInfo:userInfo]; + if (error) + { + *error = err; + } + if (completionHandler) + { + completionHandler(nil, NO, err); + } + return NO; + } + + BOOL success = YES; + BOOL canceled = NO; + int crc_ret = 0; + unsigned char buffer[4096] = {0}; + NSFileManager *fileManager = [NSFileManager defaultManager]; + NSMutableArray *directoriesModificationDates = [[NSMutableArray alloc] init]; + + // Message delegate + if ([delegate respondsToSelector:@selector(zipArchiveWillUnzipArchiveAtPath:zipInfo:)]) { + [delegate zipArchiveWillUnzipArchiveAtPath:path zipInfo:globalInfo]; + } + if ([delegate respondsToSelector:@selector(zipArchiveProgressEvent:total:)]) { + [delegate zipArchiveProgressEvent:currentPosition total:fileSize]; + } + + NSInteger currentFileNumber = -1; + NSError *unzippingError; + do { + currentFileNumber++; + if (ret == UNZ_END_OF_LIST_OF_FILE) + break; + @autoreleasepool { + if (password.length == 0) { + ret = unzOpenCurrentFile(zip); + } else { + ret = unzOpenCurrentFilePassword(zip, [password cStringUsingEncoding:NSUTF8StringEncoding]); + } + + if (ret != UNZ_OK) { + unzippingError = [NSError errorWithDomain:@"SSZipArchiveErrorDomain" code:SSZipArchiveErrorCodeFailedOpenFileInZip userInfo:@{NSLocalizedDescriptionKey: @"failed to open file in zip file"}]; + success = NO; + break; + } + + // Reading data and write to file + unz_file_info fileInfo; + memset(&fileInfo, 0, sizeof(unz_file_info)); + + ret = unzGetCurrentFileInfo(zip, &fileInfo, NULL, 0, NULL, 0, NULL, 0); + if (ret != UNZ_OK) { + unzippingError = [NSError errorWithDomain:@"SSZipArchiveErrorDomain" code:SSZipArchiveErrorCodeFileInfoNotLoadable userInfo:@{NSLocalizedDescriptionKey: @"failed to retrieve info for file"}]; + success = NO; + unzCloseCurrentFile(zip); + break; + } + + currentPosition += fileInfo.compressed_size; + + // Message delegate + if ([delegate respondsToSelector:@selector(zipArchiveShouldUnzipFileAtIndex:totalFiles:archivePath:fileInfo:)]) { + if (![delegate zipArchiveShouldUnzipFileAtIndex:currentFileNumber + totalFiles:(NSInteger)globalInfo.number_entry + archivePath:path + fileInfo:fileInfo]) { + success = NO; + canceled = YES; + break; + } + } + if ([delegate respondsToSelector:@selector(zipArchiveWillUnzipFileAtIndex:totalFiles:archivePath:fileInfo:)]) { + [delegate zipArchiveWillUnzipFileAtIndex:currentFileNumber totalFiles:(NSInteger)globalInfo.number_entry + archivePath:path fileInfo:fileInfo]; + } + if ([delegate respondsToSelector:@selector(zipArchiveProgressEvent:total:)]) { + [delegate zipArchiveProgressEvent:(NSInteger)currentPosition total:(NSInteger)fileSize]; + } + + char *filename = (char *)malloc(fileInfo.size_filename + 1); + if (filename == NULL) + { + success = NO; + break; + } + + unzGetCurrentFileInfo(zip, &fileInfo, filename, fileInfo.size_filename + 1, NULL, 0, NULL, 0); + filename[fileInfo.size_filename] = '\0'; + + BOOL fileIsSymbolicLink = _fileIsSymbolicLink(&fileInfo); + + NSString * strPath = [SSZipArchive _filenameStringWithCString:filename size:fileInfo.size_filename]; + if ([strPath hasPrefix:@"__MACOSX/"]) { + // ignoring resource forks: https://superuser.com/questions/104500/what-is-macosx-folder + unzCloseCurrentFile(zip); + ret = unzGoToNextFile(zip); + free(filename); + continue; + } + if (!strPath.length) { + // if filename data is unsalvageable, we default to currentFileNumber + strPath = @(currentFileNumber).stringValue; + } + + // Check if it contains directory + BOOL isDirectory = NO; + if (filename[fileInfo.size_filename-1] == '/' || filename[fileInfo.size_filename-1] == '\\') { + isDirectory = YES; + } + free(filename); + + // Contains a path + if ([strPath rangeOfCharacterFromSet:[NSCharacterSet characterSetWithCharactersInString:@"/\\"]].location != NSNotFound) { + strPath = [strPath stringByReplacingOccurrencesOfString:@"\\" withString:@"/"]; + } + + NSString *fullPath = [destination stringByAppendingPathComponent:strPath]; + NSError *err = nil; + NSDictionary *directoryAttr; + if (preserveAttributes) { + NSDate *modDate = [[self class] _dateWithMSDOSFormat:(UInt32)fileInfo.dos_date]; + directoryAttr = @{NSFileCreationDate: modDate, NSFileModificationDate: modDate}; + [directoriesModificationDates addObject: @{@"path": fullPath, @"modDate": modDate}]; + } + if (isDirectory) { + [fileManager createDirectoryAtPath:fullPath withIntermediateDirectories:YES attributes:directoryAttr error:&err]; + } else { + [fileManager createDirectoryAtPath:fullPath.stringByDeletingLastPathComponent withIntermediateDirectories:YES attributes:directoryAttr error:&err]; + } + if (nil != err) { + if ([err.domain isEqualToString:NSCocoaErrorDomain] && + err.code == 640) { + unzippingError = err; + unzCloseCurrentFile(zip); + success = NO; + break; + } + NSLog(@"[SSZipArchive] Error: %@", err.localizedDescription); + } + + if ([fileManager fileExistsAtPath:fullPath] && !isDirectory && !overwrite) { + //FIXME: couldBe CRC Check? + unzCloseCurrentFile(zip); + ret = unzGoToNextFile(zip); + continue; + } + + if (!fileIsSymbolicLink) { + // ensure we are not creating stale file entries + int readBytes = unzReadCurrentFile(zip, buffer, 4096); + if (readBytes >= 0) { + FILE *fp = fopen(fullPath.fileSystemRepresentation, "wb"); + while (fp) { + if (readBytes > 0) { + if (0 == fwrite(buffer, readBytes, 1, fp)) { + if (ferror(fp)) { + NSString *message = [NSString stringWithFormat:@"Failed to write file (check your free space)"]; + NSLog(@"[SSZipArchive] %@", message); + success = NO; + unzippingError = [NSError errorWithDomain:@"SSZipArchiveErrorDomain" code:SSZipArchiveErrorCodeFailedToWriteFile userInfo:@{NSLocalizedDescriptionKey: message}]; + break; + } + } + } else { + break; + } + readBytes = unzReadCurrentFile(zip, buffer, 4096); + if (readBytes < 0) { + // Let's assume error Z_DATA_ERROR is caused by an invalid password + // Let's assume other errors are caused by Content Not Readable + success = NO; + } + } + + if (fp) { + fclose(fp); + + if (nestedZipLevel + && [fullPath.pathExtension.lowercaseString isEqualToString:@"zip"] + && [self unzipFileAtPath:fullPath + toDestination:fullPath.stringByDeletingLastPathComponent + preserveAttributes:preserveAttributes + overwrite:overwrite + nestedZipLevel:nestedZipLevel - 1 + password:password + error:nil + delegate:nil + progressHandler:nil + completionHandler:nil]) { + [directoriesModificationDates removeLastObject]; + [[NSFileManager defaultManager] removeItemAtPath:fullPath error:nil]; + } else if (preserveAttributes) { + + // Set the original datetime property + if (fileInfo.dos_date != 0) { + NSDate *orgDate = [[self class] _dateWithMSDOSFormat:(UInt32)fileInfo.dos_date]; + NSDictionary *attr = @{NSFileModificationDate: orgDate}; + + if (attr) { + if (![fileManager setAttributes:attr ofItemAtPath:fullPath error:nil]) { + // Can't set attributes + NSLog(@"[SSZipArchive] Failed to set attributes - whilst setting modification date"); + } + } + } + + // Set the original permissions on the file (+read/write to solve #293) + uLong permissions = fileInfo.external_fa >> 16 | 0b110000000; + if (permissions != 0) { + // Store it into a NSNumber + NSNumber *permissionsValue = @(permissions); + + // Retrieve any existing attributes + NSMutableDictionary *attrs = [[NSMutableDictionary alloc] initWithDictionary:[fileManager attributesOfItemAtPath:fullPath error:nil]]; + + // Set the value in the attributes dict + attrs[NSFilePosixPermissions] = permissionsValue; + + // Update attributes + if (![fileManager setAttributes:attrs ofItemAtPath:fullPath error:nil]) { + // Unable to set the permissions attribute + NSLog(@"[SSZipArchive] Failed to set attributes - whilst setting permissions"); + } + } + } + } + else + { + // if we couldn't open file descriptor we can validate global errno to see the reason + if (errno == ENOSPC) { + NSError *enospcError = [NSError errorWithDomain:NSPOSIXErrorDomain + code:ENOSPC + userInfo:nil]; + unzippingError = enospcError; + unzCloseCurrentFile(zip); + success = NO; + break; + } + } + } else { + // Let's assume error Z_DATA_ERROR is caused by an invalid password + // Let's assume other errors are caused by Content Not Readable + success = NO; + break; + } + } + else + { + // Assemble the path for the symbolic link + NSMutableString *destinationPath = [NSMutableString string]; + int bytesRead = 0; + while ((bytesRead = unzReadCurrentFile(zip, buffer, 4096)) > 0) + { + buffer[bytesRead] = 0; + [destinationPath appendString:@((const char *)buffer)]; + } + if (bytesRead < 0) { + // Let's assume error Z_DATA_ERROR is caused by an invalid password + // Let's assume other errors are caused by Content Not Readable + success = NO; + break; + } + + // Check if the symlink exists and delete it if we're overwriting + if (overwrite) + { + if ([fileManager fileExistsAtPath:fullPath]) + { + NSError *error = nil; + BOOL removeSuccess = [fileManager removeItemAtPath:fullPath error:&error]; + if (!removeSuccess) + { + NSString *message = [NSString stringWithFormat:@"Failed to delete existing symbolic link at \"%@\"", error.localizedDescription]; + NSLog(@"[SSZipArchive] %@", message); + success = NO; + unzippingError = [NSError errorWithDomain:SSZipArchiveErrorDomain code:error.code userInfo:@{NSLocalizedDescriptionKey: message}]; + } + } + } + + // Create the symbolic link (making sure it stays relative if it was relative before) + int symlinkError = symlink([destinationPath cStringUsingEncoding:NSUTF8StringEncoding], + [fullPath cStringUsingEncoding:NSUTF8StringEncoding]); + + if (symlinkError != 0) + { + // Bubble the error up to the completion handler + NSString *message = [NSString stringWithFormat:@"Failed to create symbolic link at \"%@\" to \"%@\" - symlink() error code: %d", fullPath, destinationPath, errno]; + NSLog(@"[SSZipArchive] %@", message); + success = NO; + unzippingError = [NSError errorWithDomain:NSPOSIXErrorDomain code:symlinkError userInfo:@{NSLocalizedDescriptionKey: message}]; + } + } + + crc_ret = unzCloseCurrentFile(zip); + if (crc_ret == UNZ_CRCERROR) { + // CRC ERROR + success = NO; + break; + } + ret = unzGoToNextFile(zip); + + // Message delegate + if ([delegate respondsToSelector:@selector(zipArchiveDidUnzipFileAtIndex:totalFiles:archivePath:fileInfo:)]) { + [delegate zipArchiveDidUnzipFileAtIndex:currentFileNumber totalFiles:(NSInteger)globalInfo.number_entry + archivePath:path fileInfo:fileInfo]; + } else if ([delegate respondsToSelector: @selector(zipArchiveDidUnzipFileAtIndex:totalFiles:archivePath:unzippedFilePath:)]) { + [delegate zipArchiveDidUnzipFileAtIndex: currentFileNumber totalFiles: (NSInteger)globalInfo.number_entry + archivePath:path unzippedFilePath: fullPath]; + } + + if (progressHandler) + { + progressHandler(strPath, fileInfo, currentFileNumber, globalInfo.number_entry); + } + } + } while (ret == UNZ_OK && success); + + // Close + unzClose(zip); + + // The process of decompressing the .zip archive causes the modification times on the folders + // to be set to the present time. So, when we are done, they need to be explicitly set. + // set the modification date on all of the directories. + if (success && preserveAttributes) { + NSError * err = nil; + for (NSDictionary * d in directoriesModificationDates) { + if (![[NSFileManager defaultManager] setAttributes:@{NSFileModificationDate: d[@"modDate"]} ofItemAtPath:d[@"path"] error:&err]) { + NSLog(@"[SSZipArchive] Set attributes failed for directory: %@.", d[@"path"]); + } + if (err) { + NSLog(@"[SSZipArchive] Error setting directory file modification date attribute: %@", err.localizedDescription); + } + } + } + + // Message delegate + if (success && [delegate respondsToSelector:@selector(zipArchiveDidUnzipArchiveAtPath:zipInfo:unzippedPath:)]) { + [delegate zipArchiveDidUnzipArchiveAtPath:path zipInfo:globalInfo unzippedPath:destination]; + } + // final progress event = 100% + if (!canceled && [delegate respondsToSelector:@selector(zipArchiveProgressEvent:total:)]) { + [delegate zipArchiveProgressEvent:fileSize total:fileSize]; + } + + NSError *retErr = nil; + if (crc_ret == UNZ_CRCERROR) + { + NSDictionary *userInfo = @{NSLocalizedDescriptionKey: @"crc check failed for file"}; + retErr = [NSError errorWithDomain:SSZipArchiveErrorDomain code:SSZipArchiveErrorCodeFileInfoNotLoadable userInfo:userInfo]; + } + + if (error) { + if (unzippingError) { + *error = unzippingError; + } + else { + *error = retErr; + } + } + if (completionHandler) + { + if (unzippingError) { + completionHandler(path, success, unzippingError); + } + else + { + completionHandler(path, success, retErr); + } + } + return success; +} + +#pragma mark - Zipping ++ (BOOL)createZipFileAtPath:(NSString *)path withFilesAtPaths:(NSArray *)paths +{ + return [SSZipArchive createZipFileAtPath:path withFilesAtPaths:paths withPassword:nil]; +} ++ (BOOL)createZipFileAtPath:(NSString *)path withContentsOfDirectory:(NSString *)directoryPath { + return [SSZipArchive createZipFileAtPath:path withContentsOfDirectory:directoryPath withPassword:nil]; +} + ++ (BOOL)createZipFileAtPath:(NSString *)path withContentsOfDirectory:(NSString *)directoryPath keepParentDirectory:(BOOL)keepParentDirectory { + return [SSZipArchive createZipFileAtPath:path withContentsOfDirectory:directoryPath keepParentDirectory:keepParentDirectory withPassword:nil]; +} + ++ (BOOL)createZipFileAtPath:(NSString *)path withFilesAtPaths:(NSArray *)paths withPassword:(NSString *)password +{ + SSZipArchive *zipArchive = [[SSZipArchive alloc] initWithPath:path]; + BOOL success = [zipArchive open]; + if (success) { + for (NSString *filePath in paths) { + success &= [zipArchive writeFile:filePath withPassword:password]; + } + success &= [zipArchive close]; + } + return success; +} + ++ (BOOL)createZipFileAtPath:(NSString *)path withContentsOfDirectory:(NSString *)directoryPath withPassword:(nullable NSString *)password { + return [SSZipArchive createZipFileAtPath:path withContentsOfDirectory:directoryPath keepParentDirectory:NO withPassword:password]; +} + + ++ (BOOL)createZipFileAtPath:(NSString *)path withContentsOfDirectory:(NSString *)directoryPath keepParentDirectory:(BOOL)keepParentDirectory withPassword:(nullable NSString *)password { + return [SSZipArchive createZipFileAtPath:path + withContentsOfDirectory:directoryPath + keepParentDirectory:keepParentDirectory + withPassword:password + andProgressHandler:nil + ]; +} + ++ (BOOL)createZipFileAtPath:(NSString *)path + withContentsOfDirectory:(NSString *)directoryPath + keepParentDirectory:(BOOL)keepParentDirectory + withPassword:(nullable NSString *)password + andProgressHandler:(void(^ _Nullable)(NSUInteger entryNumber, NSUInteger total))progressHandler { + return [self createZipFileAtPath:path withContentsOfDirectory:directoryPath keepParentDirectory:keepParentDirectory compressionLevel:Z_DEFAULT_COMPRESSION password:password AES:YES progressHandler:progressHandler]; +} + ++ (BOOL)createZipFileAtPath:(NSString *)path + withContentsOfDirectory:(NSString *)directoryPath + keepParentDirectory:(BOOL)keepParentDirectory + compressionLevel:(int)compressionLevel + password:(nullable NSString *)password + AES:(BOOL)aes + progressHandler:(void(^ _Nullable)(NSUInteger entryNumber, NSUInteger total))progressHandler { + + SSZipArchive *zipArchive = [[SSZipArchive alloc] initWithPath:path]; + BOOL success = [zipArchive open]; + if (success) { + // use a local fileManager (queue/thread compatibility) + NSFileManager *fileManager = [[NSFileManager alloc] init]; + NSDirectoryEnumerator *dirEnumerator = [fileManager enumeratorAtPath:directoryPath]; + NSArray *allObjects = dirEnumerator.allObjects; + NSUInteger total = allObjects.count, complete = 0; + NSString *fileName; + for (fileName in allObjects) { + BOOL isDir; + NSString *fullFilePath = [directoryPath stringByAppendingPathComponent:fileName]; + [fileManager fileExistsAtPath:fullFilePath isDirectory:&isDir]; + + if (keepParentDirectory) + { + fileName = [directoryPath.lastPathComponent stringByAppendingPathComponent:fileName]; + } + + if (!isDir) { + success &= [zipArchive writeFileAtPath:fullFilePath withFileName:fileName compressionLevel:compressionLevel password:password AES:aes]; + } + else + { + if ([[NSFileManager defaultManager] subpathsOfDirectoryAtPath:fullFilePath error:nil].count == 0) + { + success &= [zipArchive writeFolderAtPath:fullFilePath withFolderName:fileName withPassword:password]; + } + } + complete++; + if (progressHandler) { + progressHandler(complete, total); + } + } + success &= [zipArchive close]; + } + return success; +} + +// disabling `init` because designated initializer is `initWithPath:` +- (instancetype)init { @throw nil; } + +// designated initializer +- (instancetype)initWithPath:(NSString *)path +{ + if ((self = [super init])) { + _path = [path copy]; + } + return self; +} + + +- (BOOL)open +{ + NSAssert((_zip == NULL), @"Attempting to open an archive which is already open"); + _zip = zipOpen(_path.fileSystemRepresentation, APPEND_STATUS_CREATE); + return (NULL != _zip); +} + +- (BOOL)writeFolderAtPath:(NSString *)path withFolderName:(NSString *)folderName withPassword:(nullable NSString *)password +{ + NSAssert((_zip != NULL), @"Attempting to write to an archive which was never opened"); + + zip_fileinfo zipInfo = {}; + + [SSZipArchive zipInfo:&zipInfo setAttributesOfItemAtPath:path]; + + int error = _zipOpenEntry(_zip, [folderName stringByAppendingString:@"/"], &zipInfo, Z_NO_COMPRESSION, password, 0); + const void *buffer = NULL; + zipWriteInFileInZip(_zip, buffer, 0); + zipCloseFileInZip(_zip); + return error == ZIP_OK; +} + +- (BOOL)writeFile:(NSString *)path withPassword:(nullable NSString *)password +{ + return [self writeFileAtPath:path withFileName:nil withPassword:password]; +} + +- (BOOL)writeFileAtPath:(NSString *)path withFileName:(nullable NSString *)fileName withPassword:(nullable NSString *)password +{ + return [self writeFileAtPath:path withFileName:fileName compressionLevel:Z_DEFAULT_COMPRESSION password:password AES:YES]; +} + +// supports writing files with logical folder/directory structure +// *path* is the absolute path of the file that will be compressed +// *fileName* is the relative name of the file how it is stored within the zip e.g. /folder/subfolder/text1.txt +- (BOOL)writeFileAtPath:(NSString *)path withFileName:(nullable NSString *)fileName compressionLevel:(int)compressionLevel password:(nullable NSString *)password AES:(BOOL)aes +{ + NSAssert((_zip != NULL), @"Attempting to write to an archive which was never opened"); + + FILE *input = fopen(path.fileSystemRepresentation, "r"); + if (NULL == input) { + return NO; + } + + if (!fileName) { + fileName = path.lastPathComponent; + } + + zip_fileinfo zipInfo = {}; + + [SSZipArchive zipInfo:&zipInfo setAttributesOfItemAtPath:path]; + + void *buffer = malloc(CHUNK); + if (buffer == NULL) + { + fclose(input); + return NO; + } + + int error = _zipOpenEntry(_zip, fileName, &zipInfo, compressionLevel, password, aes); + + while (!feof(input) && !ferror(input)) + { + unsigned int len = (unsigned int) fread(buffer, 1, CHUNK, input); + zipWriteInFileInZip(_zip, buffer, len); + } + + zipCloseFileInZip(_zip); + free(buffer); + fclose(input); + return error == ZIP_OK; +} + +- (BOOL)writeData:(NSData *)data filename:(nullable NSString *)filename withPassword:(nullable NSString *)password +{ + return [self writeData:data filename:filename compressionLevel:Z_DEFAULT_COMPRESSION password:password AES:YES]; +} + +- (BOOL)writeData:(NSData *)data filename:(nullable NSString *)filename compressionLevel:(int)compressionLevel password:(nullable NSString *)password AES:(BOOL)aes +{ + if (!_zip) { + return NO; + } + if (!data) { + return NO; + } + zip_fileinfo zipInfo = {}; + [SSZipArchive zipInfo:&zipInfo setDate:[NSDate date]]; + + int error = _zipOpenEntry(_zip, filename, &zipInfo, compressionLevel, password, aes); + + zipWriteInFileInZip(_zip, data.bytes, (unsigned int)data.length); + + zipCloseFileInZip(_zip); + return error == ZIP_OK; +} + +- (BOOL)close +{ + NSAssert((_zip != NULL), @"[SSZipArchive] Attempting to close an archive which was never opened"); + int error = zipClose(_zip, NULL); + _zip = nil; + return error == UNZ_OK; +} + +#pragma mark - Private + ++ (NSString *)_filenameStringWithCString:(const char *)filename size:(uint16_t)size_filename +{ + // attempting unicode encoding + NSString * strPath = @(filename); + if (strPath) { + return strPath; + } + + // if filename is non-unicode, detect and transform Encoding + NSData *data = [NSData dataWithBytes:(const void *)filename length:sizeof(unsigned char) * size_filename]; +#ifdef __MAC_10_13 + // Xcode 9+ + if (@available(macOS 10.10, iOS 8.0, watchOS 2.0, tvOS 9.0, *)) { + // supported encodings are in [NSString availableStringEncodings] + [NSString stringEncodingForData:data encodingOptions:nil convertedString:&strPath usedLossyConversion:nil]; + } +#else + // Xcode 8- + if (floor(NSFoundationVersionNumber) > NSFoundationVersionNumber10_9_2) { + // supported encodings are in [NSString availableStringEncodings] + [NSString stringEncodingForData:data encodingOptions:nil convertedString:&strPath usedLossyConversion:nil]; + } +#endif + else { + // fallback to a simple manual detect for macOS 10.9 or older + NSArray *encodings = @[@(kCFStringEncodingGB_18030_2000), @(kCFStringEncodingShiftJIS)]; + for (NSNumber *encoding in encodings) { + strPath = [NSString stringWithCString:filename encoding:(NSStringEncoding)CFStringConvertEncodingToNSStringEncoding(encoding.unsignedIntValue)]; + if (strPath) { + break; + } + } + } + if (strPath) { + return strPath; + } + + // if filename encoding is non-detected, we default to something based on data + // _hexString is more readable than _base64RFC4648 for debugging unknown encodings + strPath = [data _hexString]; + return strPath; +} + ++ (void)zipInfo:(zip_fileinfo *)zipInfo setAttributesOfItemAtPath:(NSString *)path +{ + NSDictionary *attr = [[NSFileManager defaultManager] attributesOfItemAtPath:path error: nil]; + if (attr) + { + NSDate *fileDate = (NSDate *)attr[NSFileModificationDate]; + if (fileDate) + { + [self zipInfo:zipInfo setDate:fileDate]; + } + + // Write permissions into the external attributes, for details on this see here: http://unix.stackexchange.com/a/14727 + // Get the permissions value from the files attributes + NSNumber *permissionsValue = (NSNumber *)attr[NSFilePosixPermissions]; + if (permissionsValue != nil) { + // Get the short value for the permissions + short permissionsShort = permissionsValue.shortValue; + + // Convert this into an octal by adding 010000, 010000 being the flag for a regular file + NSInteger permissionsOctal = 0100000 + permissionsShort; + + // Convert this into a long value + uLong permissionsLong = @(permissionsOctal).unsignedLongValue; + + // Store this into the external file attributes once it has been shifted 16 places left to form part of the second from last byte + + // Casted back to an unsigned int to match type of external_fa in minizip + zipInfo->external_fa = (unsigned int)(permissionsLong << 16L); + } + } +} + ++ (void)zipInfo:(zip_fileinfo *)zipInfo setDate:(NSDate *)date +{ + NSCalendar *currentCalendar = SSZipArchive._gregorian; + NSCalendarUnit flags = NSCalendarUnitYear | NSCalendarUnitMonth | NSCalendarUnitDay | NSCalendarUnitHour | NSCalendarUnitMinute | NSCalendarUnitSecond; + NSDateComponents *components = [currentCalendar components:flags fromDate:date]; + struct tm tmz_date; + tmz_date.tm_sec = (unsigned int)components.second; + tmz_date.tm_min = (unsigned int)components.minute; + tmz_date.tm_hour = (unsigned int)components.hour; + tmz_date.tm_mday = (unsigned int)components.day; + // ISO/IEC 9899 struct tm is 0-indexed for January but NSDateComponents for gregorianCalendar is 1-indexed for January + tmz_date.tm_mon = (unsigned int)components.month - 1; + // ISO/IEC 9899 struct tm is 0-indexed for AD 1900 but NSDateComponents for gregorianCalendar is 1-indexed for AD 1 + tmz_date.tm_year = (unsigned int)components.year - 1900; + zipInfo->dos_date = tm_to_dosdate(&tmz_date); +} + ++ (NSCalendar *)_gregorian +{ + static NSCalendar *gregorian; + static dispatch_once_t onceToken; + dispatch_once(&onceToken, ^{ + gregorian = [[NSCalendar alloc] initWithCalendarIdentifier:NSCalendarIdentifierGregorian]; + }); + + return gregorian; +} + +// Format from http://newsgroups.derkeiler.com/Archive/Comp/comp.os.msdos.programmer/2009-04/msg00060.html +// Two consecutive words, or a longword, YYYYYYYMMMMDDDDD hhhhhmmmmmmsssss +// YYYYYYY is years from 1980 = 0 +// sssss is (seconds/2). +// +// 3658 = 0011 0110 0101 1000 = 0011011 0010 11000 = 27 2 24 = 2007-02-24 +// 7423 = 0111 0100 0010 0011 - 01110 100001 00011 = 14 33 3 = 14:33:06 ++ (NSDate *)_dateWithMSDOSFormat:(UInt32)msdosDateTime +{ + // the whole `_dateWithMSDOSFormat:` method is equivalent but faster than this one line, + // essentially because `mktime` is slow: + //NSDate *date = [NSDate dateWithTimeIntervalSince1970:dosdate_to_time_t(msdosDateTime)]; + static const UInt32 kYearMask = 0xFE000000; + static const UInt32 kMonthMask = 0x1E00000; + static const UInt32 kDayMask = 0x1F0000; + static const UInt32 kHourMask = 0xF800; + static const UInt32 kMinuteMask = 0x7E0; + static const UInt32 kSecondMask = 0x1F; + + NSAssert(0xFFFFFFFF == (kYearMask | kMonthMask | kDayMask | kHourMask | kMinuteMask | kSecondMask), @"[SSZipArchive] MSDOS date masks don't add up"); + + NSDateComponents *components = [[NSDateComponents alloc] init]; + components.year = 1980 + ((msdosDateTime & kYearMask) >> 25); + components.month = (msdosDateTime & kMonthMask) >> 21; + components.day = (msdosDateTime & kDayMask) >> 16; + components.hour = (msdosDateTime & kHourMask) >> 11; + components.minute = (msdosDateTime & kMinuteMask) >> 5; + components.second = (msdosDateTime & kSecondMask) * 2; + + NSDate *date = [self._gregorian dateFromComponents:components]; + return date; +} + +@end + +int _zipOpenEntry(zipFile entry, NSString *name, const zip_fileinfo *zipfi, int level, NSString *password, BOOL aes) +{ + return zipOpenNewFileInZip5(entry, name.fileSystemRepresentation, zipfi, NULL, 0, NULL, 0, NULL, 0, 0, Z_DEFLATED, level, 0, -MAX_WBITS, DEF_MEM_LEVEL, Z_DEFAULT_STRATEGY, password.UTF8String, aes, 0); +} + +#pragma mark - Private tools for file info + +BOOL _fileIsSymbolicLink(const unz_file_info *fileInfo) +{ + // + // Determine whether this is a symbolic link: + // - File is stored with 'version made by' value of UNIX (3), + // as per http://www.pkware.com/documents/casestudies/APPNOTE.TXT + // in the upper byte of the version field. + // - BSD4.4 st_mode constants are stored in the high 16 bits of the + // external file attributes (defacto standard, verified against libarchive) + // + // The original constants can be found here: + // http://minnie.tuhs.org/cgi-bin/utree.pl?file=4.4BSD/usr/include/sys/stat.h + // + const uLong ZipUNIXVersion = 3; + const uLong BSD_SFMT = 0170000; + const uLong BSD_IFLNK = 0120000; + + BOOL fileIsSymbolicLink = ((fileInfo->version >> 8) == ZipUNIXVersion) && BSD_IFLNK == (BSD_SFMT & (fileInfo->external_fa >> 16)); + return fileIsSymbolicLink; +} + +#pragma mark - Private tools for unreadable encodings + +@implementation NSData (SSZipArchive) + +// `base64EncodedStringWithOptions` uses a base64 alphabet with '+' and '/'. +// we got those alternatives to make it compatible with filenames: https://en.wikipedia.org/wiki/Base64 +// * modified Base64 encoding for IMAP mailbox names (RFC 3501): uses '+' and ',' +// * modified Base64 for URL and filenames (RFC 4648): uses '-' and '_' +- (NSString *)_base64RFC4648 +{ + NSString *strName = [self base64EncodedStringWithOptions:0]; + strName = [strName stringByReplacingOccurrencesOfString:@"+" withString:@"-"]; + strName = [strName stringByReplacingOccurrencesOfString:@"/" withString:@"_"]; + return strName; +} + +// initWithBytesNoCopy from NSProgrammer, Jan 25 '12: https://stackoverflow.com/a/9009321/1033581 +// hexChars from Peter, Aug 19 '14: https://stackoverflow.com/a/25378464/1033581 +// not implemented as too lengthy: a potential mapping improvement from Moose, Nov 3 '15: https://stackoverflow.com/a/33501154/1033581 +- (NSString *)_hexString +{ + const char *hexChars = "0123456789ABCDEF"; + NSUInteger length = self.length; + const unsigned char *bytes = self.bytes; + char *chars = malloc(length * 2); + if (chars == NULL) { + // we directly raise an exception instead of using NSAssert to make sure assertion is not disabled as this is irrecoverable + [NSException raise:@"NSInternalInconsistencyException" format:@"failed malloc" arguments:nil]; + return nil; + } + char *s = chars; + NSUInteger i = length; + while (i--) { + *s++ = hexChars[*bytes >> 4]; + *s++ = hexChars[*bytes & 0xF]; + bytes++; + } + NSString *str = [[NSString alloc] initWithBytesNoCopy:chars + length:length * 2 + encoding:NSASCIIStringEncoding + freeWhenDone:YES]; + return str; +} + +@end diff --git a/SSZipArchive/SSZipCommon.h b/SSZipArchive/SSZipCommon.h new file mode 100644 index 0000000..91670e1 --- /dev/null +++ b/SSZipArchive/SSZipCommon.h @@ -0,0 +1,66 @@ +#ifndef SSZipCommon +#define SSZipCommon + +/* unz_global_info structure contain global data about the ZIPfile + These data comes from the end of central dir */ +typedef struct unz_global_info64_s +{ + uint64_t number_entry; /* total number of entries in the central dir on this disk */ + uint32_t number_disk_with_CD; /* number the the disk with central dir, used for spanning ZIP*/ + uint16_t size_comment; /* size of the global comment of the zipfile */ +} unz_global_info64; + +typedef struct unz_global_info_s +{ + uint32_t number_entry; /* total number of entries in the central dir on this disk */ + uint32_t number_disk_with_CD; /* number the the disk with central dir, used for spanning ZIP*/ + uint16_t size_comment; /* size of the global comment of the zipfile */ +} unz_global_info; + +/* unz_file_info contain information about a file in the zipfile */ +/* https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT */ +typedef struct unz_file_info64_s +{ + uint16_t version; /* version made by 2 bytes */ + uint16_t version_needed; /* version needed to extract 2 bytes */ + uint16_t flag; /* general purpose bit flag 2 bytes */ + uint16_t compression_method; /* compression method 2 bytes */ + uint32_t dos_date; /* last mod file date in Dos fmt 4 bytes */ + uint32_t crc; /* crc-32 4 bytes */ + uint64_t compressed_size; /* compressed size 8 bytes */ + uint64_t uncompressed_size; /* uncompressed size 8 bytes */ + uint16_t size_filename; /* filename length 2 bytes */ + uint16_t size_file_extra; /* extra field length 2 bytes */ + uint16_t size_file_comment; /* file comment length 2 bytes */ + + uint32_t disk_num_start; /* disk number start 4 bytes */ + uint16_t internal_fa; /* internal file attributes 2 bytes */ + uint32_t external_fa; /* external file attributes 4 bytes */ + + uint64_t disk_offset; + + uint16_t size_file_extra_internal; +} unz_file_info64; + +typedef struct unz_file_info_s +{ + uint16_t version; /* version made by 2 bytes */ + uint16_t version_needed; /* version needed to extract 2 bytes */ + uint16_t flag; /* general purpose bit flag 2 bytes */ + uint16_t compression_method; /* compression method 2 bytes */ + uint32_t dos_date; /* last mod file date in Dos fmt 4 bytes */ + uint32_t crc; /* crc-32 4 bytes */ + uint32_t compressed_size; /* compressed size 4 bytes */ + uint32_t uncompressed_size; /* uncompressed size 4 bytes */ + uint16_t size_filename; /* filename length 2 bytes */ + uint16_t size_file_extra; /* extra field length 2 bytes */ + uint16_t size_file_comment; /* file comment length 2 bytes */ + + uint16_t disk_num_start; /* disk number start 2 bytes */ + uint16_t internal_fa; /* internal file attributes 2 bytes */ + uint32_t external_fa; /* external file attributes 4 bytes */ + + uint64_t disk_offset; +} unz_file_info; + +#endif diff --git a/SSZipArchive/ZipArchive.h b/SSZipArchive/ZipArchive.h new file mode 100644 index 0000000..7a53df8 --- /dev/null +++ b/SSZipArchive/ZipArchive.h @@ -0,0 +1,19 @@ +// +// ZipArchive.h +// ZipArchive +// +// Created by Serhii Mumriak on 12/1/15. +// Copyright © 2015 smumryak. All rights reserved. +// + +#import + +//! Project version number for ZipArchive. +FOUNDATION_EXPORT double ZipArchiveVersionNumber; + +//! Project version string for ZipArchive. +FOUNDATION_EXPORT const unsigned char ZipArchiveVersionString[]; + +// In this header, you should import all the public headers of your framework using statements like #import + +#import "SSZipArchive.h" diff --git a/SSZipArchive/minizip/aes/aes.h b/SSZipArchive/minizip/aes/aes.h new file mode 100644 index 0000000..92e23c2 --- /dev/null +++ b/SSZipArchive/minizip/aes/aes.h @@ -0,0 +1,270 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2013, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 + + This file contains the definitions required to use AES in C. See aesopt.h + for optimisation details. +*/ + +#ifndef _AES_H +#define _AES_H + +#include + +/* This include is used to find 8 & 32 bit unsigned integer types */ +#include "brg_types.h" + +#if defined(__cplusplus) +extern "C" +{ +#endif + +#define AES_128 /* if a fast 128 bit key scheduler is needed */ +#define AES_192 /* if a fast 192 bit key scheduler is needed */ +#define AES_256 /* if a fast 256 bit key scheduler is needed */ +#define AES_VAR /* if variable key size scheduler is needed */ +#define AES_MODES /* if support is needed for modes */ + +/* The following must also be set in assembler files if being used */ + +#define AES_ENCRYPT /* if support for encryption is needed */ +#define AES_DECRYPT /* if support for decryption is needed */ + +#define AES_BLOCK_SIZE 16 /* the AES block size in bytes */ +#define N_COLS 4 /* the number of columns in the state */ + +/* The key schedule length is 11, 13 or 15 16-byte blocks for 128, */ +/* 192 or 256-bit keys respectively. That is 176, 208 or 240 bytes */ +/* or 44, 52 or 60 32-bit words. */ + +#if defined( AES_VAR ) || defined( AES_256 ) +#define KS_LENGTH 60 +#elif defined( AES_192 ) +#define KS_LENGTH 52 +#else +#define KS_LENGTH 44 +#endif + +#define AES_RETURN INT_RETURN + +/* the character array 'inf' in the following structures is used */ +/* to hold AES context information. This AES code uses cx->inf.b[0] */ +/* to hold the number of rounds multiplied by 16. The other three */ +/* elements can be used by code that implements additional modes */ + +typedef union +{ uint32_t l; + uint8_t b[4]; +} aes_inf; + +#ifdef _MSC_VER +# pragma warning( disable : 4324 ) +#endif + +#if defined(_MSC_VER) && defined(_WIN64) +#define ALIGNED_(x) __declspec(align(x)) +#elif defined(__GNUC__) && defined(__x86_64__) +#define ALIGNED_(x) __attribute__ ((aligned(x))) +#else +#define ALIGNED_(x) +#endif + +typedef struct ALIGNED_(16) +{ uint32_t ks[KS_LENGTH]; + aes_inf inf; +} aes_encrypt_ctx; + +typedef struct ALIGNED_(16) +{ uint32_t ks[KS_LENGTH]; + aes_inf inf; +} aes_decrypt_ctx; + +#ifdef _MSC_VER +# pragma warning( default : 4324 ) +#endif + +/* This routine must be called before first use if non-static */ +/* tables are being used */ + +AES_RETURN aes_init(void); + +/* Key lengths in the range 16 <= key_len <= 32 are given in bytes, */ +/* those in the range 128 <= key_len <= 256 are given in bits */ + +#if defined( AES_ENCRYPT ) + +#if defined( AES_128 ) || defined( AES_VAR) +AES_RETURN aes_encrypt_key128(const unsigned char *key, aes_encrypt_ctx cx[1]); +#endif + +#if defined( AES_192 ) || defined( AES_VAR) +AES_RETURN aes_encrypt_key192(const unsigned char *key, aes_encrypt_ctx cx[1]); +#endif + +#if defined( AES_256 ) || defined( AES_VAR) +AES_RETURN aes_encrypt_key256(const unsigned char *key, aes_encrypt_ctx cx[1]); +#endif + +#if defined( AES_VAR ) +AES_RETURN aes_encrypt_key(const unsigned char *key, int key_len, aes_encrypt_ctx cx[1]); +#endif + +AES_RETURN aes_encrypt(const unsigned char *in, unsigned char *out, const aes_encrypt_ctx cx[1]); + +#endif + +#if defined( AES_DECRYPT ) + +#if defined( AES_128 ) || defined( AES_VAR) +AES_RETURN aes_decrypt_key128(const unsigned char *key, aes_decrypt_ctx cx[1]); +#endif + +#if defined( AES_192 ) || defined( AES_VAR) +AES_RETURN aes_decrypt_key192(const unsigned char *key, aes_decrypt_ctx cx[1]); +#endif + +#if defined( AES_256 ) || defined( AES_VAR) +AES_RETURN aes_decrypt_key256(const unsigned char *key, aes_decrypt_ctx cx[1]); +#endif + +#if defined( AES_VAR ) +AES_RETURN aes_decrypt_key(const unsigned char *key, int key_len, aes_decrypt_ctx cx[1]); +#endif + +AES_RETURN aes_decrypt(const unsigned char *in, unsigned char *out, const aes_decrypt_ctx cx[1]); + +#endif + +#if defined( AES_MODES ) + +/* Multiple calls to the following subroutines for multiple block */ +/* ECB, CBC, CFB, OFB and CTR mode encryption can be used to handle */ +/* long messages incrementally provided that the context AND the iv */ +/* are preserved between all such calls. For the ECB and CBC modes */ +/* each individual call within a series of incremental calls must */ +/* process only full blocks (i.e. len must be a multiple of 16) but */ +/* the CFB, OFB and CTR mode calls can handle multiple incremental */ +/* calls of any length. Each mode is reset when a new AES key is */ +/* set but ECB needs no reset and CBC can be reset without setting */ +/* a new key by setting a new IV value. To reset CFB, OFB and CTR */ +/* without setting the key, aes_mode_reset() must be called and the */ +/* IV must be set. NOTE: All these calls update the IV on exit so */ +/* this has to be reset if a new operation with the same IV as the */ +/* previous one is required (or decryption follows encryption with */ +/* the same IV array). */ + +AES_RETURN aes_test_alignment_detection(unsigned int n); + +AES_RETURN aes_ecb_encrypt(const unsigned char *ibuf, unsigned char *obuf, + int len, const aes_encrypt_ctx cx[1]); + +AES_RETURN aes_ecb_decrypt(const unsigned char *ibuf, unsigned char *obuf, + int len, const aes_decrypt_ctx cx[1]); + +AES_RETURN aes_cbc_encrypt(const unsigned char *ibuf, unsigned char *obuf, + int len, unsigned char *iv, const aes_encrypt_ctx cx[1]); + +AES_RETURN aes_cbc_decrypt(const unsigned char *ibuf, unsigned char *obuf, + int len, unsigned char *iv, const aes_decrypt_ctx cx[1]); + +AES_RETURN aes_mode_reset(aes_encrypt_ctx cx[1]); + +AES_RETURN aes_cfb_encrypt(const unsigned char *ibuf, unsigned char *obuf, + int len, unsigned char *iv, aes_encrypt_ctx cx[1]); + +AES_RETURN aes_cfb_decrypt(const unsigned char *ibuf, unsigned char *obuf, + int len, unsigned char *iv, aes_encrypt_ctx cx[1]); + +#define aes_ofb_encrypt aes_ofb_crypt +#define aes_ofb_decrypt aes_ofb_crypt + +AES_RETURN aes_ofb_crypt(const unsigned char *ibuf, unsigned char *obuf, + int len, unsigned char *iv, aes_encrypt_ctx cx[1]); + +typedef void cbuf_inc(unsigned char *cbuf); + +#define aes_ctr_encrypt aes_ctr_crypt +#define aes_ctr_decrypt aes_ctr_crypt + +AES_RETURN aes_ctr_crypt(const unsigned char *ibuf, unsigned char *obuf, + int len, unsigned char *cbuf, cbuf_inc ctr_inc, aes_encrypt_ctx cx[1]); + +#endif + +#if 0 +# define ADD_AESNI_MODE_CALLS +#endif + +#if 0 && defined( ADD_AESNI_MODE_CALLS ) +# define USE_AES_CONTEXT +#endif + +#ifdef ADD_AESNI_MODE_CALLS +# ifdef USE_AES_CONTEXT + +AES_RETURN aes_CBC_encrypt(const unsigned char *in, + unsigned char *out, + unsigned char ivec[16], + unsigned long length, + const aes_encrypt_ctx cx[1]); + +AES_RETURN aes_CBC_decrypt(const unsigned char *in, + unsigned char *out, + unsigned char ivec[16], + unsigned long length, + const aes_decrypt_ctx cx[1]); + +AES_RETURN AES_CTR_encrypt(const unsigned char *in, + unsigned char *out, + const unsigned char ivec[8], + const unsigned char nonce[4], + unsigned long length, + const aes_encrypt_ctx cx[1]); + +# else + +void aes_CBC_encrypt(const unsigned char *in, + unsigned char *out, + unsigned char ivec[16], + unsigned long length, + unsigned char *key, + int number_of_rounds); + +void aes_CBC_decrypt(const unsigned char *in, + unsigned char *out, + unsigned char ivec[16], + unsigned long length, + unsigned char *key, + int number_of_rounds); + +void AES_CTR_encrypt(const unsigned char *in, + unsigned char *out, + const unsigned char ivec[8], + const unsigned char nonce[4], + unsigned long length, + const unsigned char *key, + int number_of_rounds); + +# endif +#endif + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/aes_ni.c b/SSZipArchive/minizip/aes/aes_ni.c new file mode 100644 index 0000000..8afae91 --- /dev/null +++ b/SSZipArchive/minizip/aes/aes_ni.c @@ -0,0 +1,687 @@ +/* +Copyright (c) 1998-2013, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 09/09/2014 +*/ + +#include "aes_ni.h" + +#if defined( USE_INTEL_AES_IF_PRESENT ) + +#if defined(_MSC_VER) + +#include +#pragma intrinsic(__cpuid) +#define INLINE __inline + +INLINE int has_aes_ni(void) +{ + static int test = -1; + if(test < 0) + { + int cpu_info[4]; + __cpuid(cpu_info, 1); + test = cpu_info[2] & 0x02000000; + } + return test; +} + +#elif defined( __GNUC__ ) + +#include + +#if !defined(__clang__) +#pragma GCC target ("ssse3") +#pragma GCC target ("sse4.1") +#pragma GCC target ("aes") +#endif + +#include +#define INLINE static __inline + +INLINE int has_aes_ni() +{ + static int test = -1; + if(test < 0) + { + unsigned int a, b, c, d; + if(!__get_cpuid(1, &a, &b, &c, &d)) + test = 0; + else + test = (c & 0x2000000); + } + return test; +} + +#else +#error AES New Instructions require Microsoft, Intel, GNU C, or CLANG +#endif + +INLINE __m128i aes_128_assist(__m128i t1, __m128i t2) +{ + __m128i t3; + t2 = _mm_shuffle_epi32(t2, 0xff); + t3 = _mm_slli_si128(t1, 0x4); + t1 = _mm_xor_si128(t1, t3); + t3 = _mm_slli_si128(t3, 0x4); + t1 = _mm_xor_si128(t1, t3); + t3 = _mm_slli_si128(t3, 0x4); + t1 = _mm_xor_si128(t1, t3); + t1 = _mm_xor_si128(t1, t2); + return t1; +} + +AES_RETURN aes_ni(encrypt_key128)(const unsigned char *key, aes_encrypt_ctx cx[1]) +{ + __m128i t1, t2; + __m128i *ks = (__m128i*)cx->ks; + + if(!has_aes_ni()) + { + return aes_xi(encrypt_key128)(key, cx); + } + + t1 = _mm_loadu_si128((__m128i*)key); + + ks[0] = t1; + + t2 = _mm_aeskeygenassist_si128(t1, 0x1); + t1 = aes_128_assist(t1, t2); + ks[1] = t1; + + t2 = _mm_aeskeygenassist_si128(t1, 0x2); + t1 = aes_128_assist(t1, t2); + ks[2] = t1; + + t2 = _mm_aeskeygenassist_si128(t1, 0x4); + t1 = aes_128_assist(t1, t2); + ks[3] = t1; + + t2 = _mm_aeskeygenassist_si128(t1, 0x8); + t1 = aes_128_assist(t1, t2); + ks[4] = t1; + + t2 = _mm_aeskeygenassist_si128(t1, 0x10); + t1 = aes_128_assist(t1, t2); + ks[5] = t1; + + t2 = _mm_aeskeygenassist_si128(t1, 0x20); + t1 = aes_128_assist(t1, t2); + ks[6] = t1; + + t2 = _mm_aeskeygenassist_si128(t1, 0x40); + t1 = aes_128_assist(t1, t2); + ks[7] = t1; + + t2 = _mm_aeskeygenassist_si128(t1, 0x80); + t1 = aes_128_assist(t1, t2); + ks[8] = t1; + + t2 = _mm_aeskeygenassist_si128(t1, 0x1b); + t1 = aes_128_assist(t1, t2); + ks[9] = t1; + + t2 = _mm_aeskeygenassist_si128(t1, 0x36); + t1 = aes_128_assist(t1, t2); + ks[10] = t1; + + cx->inf.l = 0; + cx->inf.b[0] = 10 * 16; + return EXIT_SUCCESS; +} + +INLINE void aes_192_assist(__m128i* t1, __m128i * t2, __m128i * t3) +{ + __m128i t4; + *t2 = _mm_shuffle_epi32(*t2, 0x55); + t4 = _mm_slli_si128(*t1, 0x4); + *t1 = _mm_xor_si128(*t1, t4); + t4 = _mm_slli_si128(t4, 0x4); + *t1 = _mm_xor_si128(*t1, t4); + t4 = _mm_slli_si128(t4, 0x4); + *t1 = _mm_xor_si128(*t1, t4); + *t1 = _mm_xor_si128(*t1, *t2); + *t2 = _mm_shuffle_epi32(*t1, 0xff); + t4 = _mm_slli_si128(*t3, 0x4); + *t3 = _mm_xor_si128(*t3, t4); + *t3 = _mm_xor_si128(*t3, *t2); +} + +AES_RETURN aes_ni(encrypt_key192)(const unsigned char *key, aes_encrypt_ctx cx[1]) +{ + __m128i t1, t2, t3; + __m128i *ks = (__m128i*)cx->ks; + + if(!has_aes_ni()) + { + return aes_xi(encrypt_key192)(key, cx); + } + + t1 = _mm_loadu_si128((__m128i*)key); + t3 = _mm_loadu_si128((__m128i*)(key + 16)); + + ks[0] = t1; + ks[1] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x1); + aes_192_assist(&t1, &t2, &t3); + + ks[1] = _mm_castpd_si128(_mm_shuffle_pd(_mm_castsi128_pd(ks[1]), _mm_castsi128_pd(t1), 0)); + ks[2] = _mm_castpd_si128(_mm_shuffle_pd(_mm_castsi128_pd(t1), _mm_castsi128_pd(t3), 1)); + + t2 = _mm_aeskeygenassist_si128(t3, 0x2); + aes_192_assist(&t1, &t2, &t3); + ks[3] = t1; + ks[4] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x4); + aes_192_assist(&t1, &t2, &t3); + ks[4] = _mm_castpd_si128(_mm_shuffle_pd(_mm_castsi128_pd(ks[4]), _mm_castsi128_pd(t1), 0)); + ks[5] = _mm_castpd_si128(_mm_shuffle_pd(_mm_castsi128_pd(t1), _mm_castsi128_pd(t3), 1)); + + t2 = _mm_aeskeygenassist_si128(t3, 0x8); + aes_192_assist(&t1, &t2, &t3); + ks[6] = t1; + ks[7] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x10); + aes_192_assist(&t1, &t2, &t3); + ks[7] = _mm_castpd_si128(_mm_shuffle_pd(_mm_castsi128_pd(ks[7]), _mm_castsi128_pd(t1), 0)); + ks[8] = _mm_castpd_si128(_mm_shuffle_pd(_mm_castsi128_pd(t1), _mm_castsi128_pd(t3), 1)); + + t2 = _mm_aeskeygenassist_si128(t3, 0x20); + aes_192_assist(&t1, &t2, &t3); + ks[9] = t1; + ks[10] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x40); + aes_192_assist(&t1, &t2, &t3); + ks[10] = _mm_castpd_si128(_mm_shuffle_pd(_mm_castsi128_pd(ks[10]), _mm_castsi128_pd(t1), 0)); + ks[11] = _mm_castpd_si128(_mm_shuffle_pd(_mm_castsi128_pd(t1), _mm_castsi128_pd(t3), 1)); + + t2 = _mm_aeskeygenassist_si128(t3, 0x80); + aes_192_assist(&t1, &t2, &t3); + ks[12] = t1; + + cx->inf.l = 0; + cx->inf.b[0] = 12 * 16; + return EXIT_SUCCESS; +} + +INLINE void aes_256_assist1(__m128i* t1, __m128i * t2) +{ + __m128i t4; + *t2 = _mm_shuffle_epi32(*t2, 0xff); + t4 = _mm_slli_si128(*t1, 0x4); + *t1 = _mm_xor_si128(*t1, t4); + t4 = _mm_slli_si128(t4, 0x4); + *t1 = _mm_xor_si128(*t1, t4); + t4 = _mm_slli_si128(t4, 0x4); + *t1 = _mm_xor_si128(*t1, t4); + *t1 = _mm_xor_si128(*t1, *t2); +} + +INLINE void aes_256_assist2(__m128i* t1, __m128i * t3) +{ + __m128i t2, t4; + t4 = _mm_aeskeygenassist_si128(*t1, 0x0); + t2 = _mm_shuffle_epi32(t4, 0xaa); + t4 = _mm_slli_si128(*t3, 0x4); + *t3 = _mm_xor_si128(*t3, t4); + t4 = _mm_slli_si128(t4, 0x4); + *t3 = _mm_xor_si128(*t3, t4); + t4 = _mm_slli_si128(t4, 0x4); + *t3 = _mm_xor_si128(*t3, t4); + *t3 = _mm_xor_si128(*t3, t2); +} + +AES_RETURN aes_ni(encrypt_key256)(const unsigned char *key, aes_encrypt_ctx cx[1]) +{ + __m128i t1, t2, t3; + __m128i *ks = (__m128i*)cx->ks; + + if(!has_aes_ni()) + { + return aes_xi(encrypt_key256)(key, cx); + } + + t1 = _mm_loadu_si128((__m128i*)key); + t3 = _mm_loadu_si128((__m128i*)(key + 16)); + + ks[0] = t1; + ks[1] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x01); + aes_256_assist1(&t1, &t2); + ks[2] = t1; + aes_256_assist2(&t1, &t3); + ks[3] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x02); + aes_256_assist1(&t1, &t2); + ks[4] = t1; + aes_256_assist2(&t1, &t3); + ks[5] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x04); + aes_256_assist1(&t1, &t2); + ks[6] = t1; + aes_256_assist2(&t1, &t3); + ks[7] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x08); + aes_256_assist1(&t1, &t2); + ks[8] = t1; + aes_256_assist2(&t1, &t3); + ks[9] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x10); + aes_256_assist1(&t1, &t2); + ks[10] = t1; + aes_256_assist2(&t1, &t3); + ks[11] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x20); + aes_256_assist1(&t1, &t2); + ks[12] = t1; + aes_256_assist2(&t1, &t3); + ks[13] = t3; + + t2 = _mm_aeskeygenassist_si128(t3, 0x40); + aes_256_assist1(&t1, &t2); + ks[14] = t1; + + cx->inf.l = 0; + cx->inf.b[0] = 14 * 16; + return EXIT_SUCCESS; +} + +INLINE void enc_to_dec(aes_decrypt_ctx cx[1]) +{ + __m128i *ks = (__m128i*)cx->ks; + int j; + + for( j = 1 ; j < (cx->inf.b[0] >> 4) ; ++j ) + ks[j] = _mm_aesimc_si128(ks[j]); +} + +AES_RETURN aes_ni(decrypt_key128)(const unsigned char *key, aes_decrypt_ctx cx[1]) +{ + if(!has_aes_ni()) + { + return aes_xi(decrypt_key128)(key, cx); + } + + if(aes_ni(encrypt_key128)(key, (aes_encrypt_ctx*)cx) == EXIT_SUCCESS) + { + enc_to_dec(cx); + return EXIT_SUCCESS; + } + else + return EXIT_FAILURE; + +} + +AES_RETURN aes_ni(decrypt_key192)(const unsigned char *key, aes_decrypt_ctx cx[1]) +{ + if(!has_aes_ni()) + { + return aes_xi(decrypt_key192)(key, cx); + } + + if(aes_ni(encrypt_key192)(key, (aes_encrypt_ctx*)cx) == EXIT_SUCCESS) + { + enc_to_dec(cx); + return EXIT_SUCCESS; + } + else + return EXIT_FAILURE; +} + +AES_RETURN aes_ni(decrypt_key256)(const unsigned char *key, aes_decrypt_ctx cx[1]) +{ + if(!has_aes_ni()) + { + return aes_xi(decrypt_key256)(key, cx); + } + + if(aes_ni(encrypt_key256)(key, (aes_encrypt_ctx*)cx) == EXIT_SUCCESS) + { + enc_to_dec(cx); + return EXIT_SUCCESS; + } + else + return EXIT_FAILURE; +} + +AES_RETURN aes_ni(encrypt)(const unsigned char *in, unsigned char *out, const aes_encrypt_ctx cx[1]) +{ + __m128i *key = (__m128i*)cx->ks, t; + + if(cx->inf.b[0] != 10 * 16 && cx->inf.b[0] != 12 * 16 && cx->inf.b[0] != 14 * 16) + return EXIT_FAILURE; + + if(!has_aes_ni()) + { + return aes_xi(encrypt)(in, out, cx); + } + + t = _mm_xor_si128(_mm_loadu_si128((__m128i*)in), *(__m128i*)key); + + switch(cx->inf.b[0]) + { + case 14 * 16: + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenc_si128(t, *(__m128i*)++key); + case 12 * 16: + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenc_si128(t, *(__m128i*)++key); + case 10 * 16: + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenc_si128(t, *(__m128i*)++key); + t = _mm_aesenclast_si128(t, *(__m128i*)++key); + } + + _mm_storeu_si128(&((__m128i*)out)[0], t); + return EXIT_SUCCESS; +} + +AES_RETURN aes_ni(decrypt)(const unsigned char *in, unsigned char *out, const aes_decrypt_ctx cx[1]) +{ + __m128i *key = (__m128i*)cx->ks + (cx->inf.b[0] >> 4), t; + + if(cx->inf.b[0] != 10 * 16 && cx->inf.b[0] != 12 * 16 && cx->inf.b[0] != 14 * 16) + return EXIT_FAILURE; + + if(!has_aes_ni()) + { + return aes_xi(decrypt)(in, out, cx); + } + + t = _mm_xor_si128(_mm_loadu_si128((__m128i*)in), *(__m128i*)key); + + switch(cx->inf.b[0]) + { + case 14 * 16: + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdec_si128(t, *(__m128i*)--key); + case 12 * 16: + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdec_si128(t, *(__m128i*)--key); + case 10 * 16: + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdec_si128(t, *(__m128i*)--key); + t = _mm_aesdeclast_si128(t, *(__m128i*)--key); + } + + _mm_storeu_si128((__m128i*)out, t); + return EXIT_SUCCESS; +} + +#ifdef ADD_AESNI_MODE_CALLS +#ifdef USE_AES_CONTEXT + +AES_RETURN aes_CBC_encrypt(const unsigned char *in, + unsigned char *out, + unsigned char ivec[16], + unsigned long length, + const aes_encrypt_ctx cx[1]) +{ + __m128i feedback, data, *key = (__m128i*)cx->ks; + int number_of_rounds = cx->inf.b[0] >> 4, j; + unsigned long i; + + if(number_of_rounds != 10 && number_of_rounds != 12 && number_of_rounds != 14) + return EXIT_FAILURE; + + if(!has_aes_ni()) + { + return aes_cbc_encrypt(in, out, length, ivec, cx); + } + + if(length % 16) + length = length / 16 + 1; + else length /= 16; + feedback = _mm_loadu_si128((__m128i*)ivec); + for(i = 0; i < length; i++) + { + data = _mm_loadu_si128(&((__m128i*)in)[i]); + feedback = _mm_xor_si128(data, feedback); + feedback = _mm_xor_si128(feedback, ((__m128i*)key)[0]); + for(j = 1; j ks; + int number_of_rounds = cx->inf.b[0] >> 4, j; + unsigned long i; + + if(number_of_rounds != 10 && number_of_rounds != 12 && number_of_rounds != 14) + return EXIT_FAILURE; + + if(!has_aes_ni()) + { + return aes_cbc_decrypt(in, out, length, ivec, cx); + } + + if(length % 16) + length = length / 16 + 1; + else length /= 16; + feedback = _mm_loadu_si128((__m128i*)ivec); + for(i = 0; i < length; i++) + { + last_in = _mm_loadu_si128(&((__m128i*)in)[i]); + data = _mm_xor_si128(last_in, ((__m128i*)key)[number_of_rounds]); + for(j = number_of_rounds - 1; j > 0; j--) + { + data = _mm_aesdec_si128(data, ((__m128i*)key)[j]); + } + data = _mm_aesdeclast_si128(data, ((__m128i*)key)[0]); + data = _mm_xor_si128(data, feedback); + _mm_storeu_si128(&((__m128i*)out)[i], data); + feedback = last_in; + } + return EXIT_SUCCESS; +} + +static void ctr_inc(unsigned char *ctr_blk) +{ + uint32_t c; + + c = *(uint32_t*)(ctr_blk + 8); + c++; + *(uint32_t*)(ctr_blk + 8) = c; + + if(!c) + *(uint32_t*)(ctr_blk + 12) = *(uint32_t*)(ctr_blk + 12) + 1; +} + +AES_RETURN AES_CTR_encrypt(const unsigned char *in, + unsigned char *out, + const unsigned char ivec[8], + const unsigned char nonce[4], + unsigned long length, + const aes_encrypt_ctx cx[1]) +{ + __m128i ctr_block = { 0 }, *key = (__m128i*)cx->ks, tmp, ONE, BSWAP_EPI64; + int number_of_rounds = cx->inf.b[0] >> 4, j; + unsigned long i; + + if(number_of_rounds != 10 && number_of_rounds != 12 && number_of_rounds != 14) + return EXIT_FAILURE; + + if(!has_aes_ni()) + { + unsigned char ctr_blk[16]; + *(uint64_t*)ctr_blk = *(uint64_t*)ivec; + *(uint32_t*)(ctr_blk + 8) = *(uint32_t*)nonce; + return aes_ctr_crypt(in, out, length, (unsigned char*)ctr_blk, ctr_inc, cx); + } + + if(length % 16) + length = length / 16 + 1; + else length /= 16; + ONE = _mm_set_epi32(0, 1, 0, 0); + BSWAP_EPI64 = _mm_setr_epi8(7, 6, 5, 4, 3, 2, 1, 0, 15, 14, 13, 12, 11, 10, 9, 8); +#ifdef _MSC_VER + ctr_block = _mm_insert_epi64(ctr_block, *(long long*)ivec, 1); +#else + ctr_block = _mm_set_epi64(*(__m64*)ivec, *(__m64*)&ctr_block); +#endif + ctr_block = _mm_insert_epi32(ctr_block, *(long*)nonce, 1); + ctr_block = _mm_srli_si128(ctr_block, 4); + ctr_block = _mm_shuffle_epi8(ctr_block, BSWAP_EPI64); + ctr_block = _mm_add_epi64(ctr_block, ONE); + for(i = 0; i < length; i++) + { + tmp = _mm_shuffle_epi8(ctr_block, BSWAP_EPI64); + ctr_block = _mm_add_epi64(ctr_block, ONE); + tmp = _mm_xor_si128(tmp, ((__m128i*)key)[0]); + for(j = 1; j 'aes_name_i') */ +#define aes_xi(x) aes_ ## x ## _i + +/* map names here to provide the external API ('name' -> 'aes_name') */ +#define aes_ni(x) aes_ ## x + +AES_RETURN aes_ni(encrypt_key128)(const unsigned char *key, aes_encrypt_ctx cx[1]); +AES_RETURN aes_ni(encrypt_key192)(const unsigned char *key, aes_encrypt_ctx cx[1]); +AES_RETURN aes_ni(encrypt_key256)(const unsigned char *key, aes_encrypt_ctx cx[1]); + +AES_RETURN aes_ni(decrypt_key128)(const unsigned char *key, aes_decrypt_ctx cx[1]); +AES_RETURN aes_ni(decrypt_key192)(const unsigned char *key, aes_decrypt_ctx cx[1]); +AES_RETURN aes_ni(decrypt_key256)(const unsigned char *key, aes_decrypt_ctx cx[1]); + +AES_RETURN aes_ni(encrypt)(const unsigned char *in, unsigned char *out, const aes_encrypt_ctx cx[1]); +AES_RETURN aes_ni(decrypt)(const unsigned char *in, unsigned char *out, const aes_decrypt_ctx cx[1]); + +AES_RETURN aes_xi(encrypt_key128)(const unsigned char *key, aes_encrypt_ctx cx[1]); +AES_RETURN aes_xi(encrypt_key192)(const unsigned char *key, aes_encrypt_ctx cx[1]); +AES_RETURN aes_xi(encrypt_key256)(const unsigned char *key, aes_encrypt_ctx cx[1]); + +AES_RETURN aes_xi(decrypt_key128)(const unsigned char *key, aes_decrypt_ctx cx[1]); +AES_RETURN aes_xi(decrypt_key192)(const unsigned char *key, aes_decrypt_ctx cx[1]); +AES_RETURN aes_xi(decrypt_key256)(const unsigned char *key, aes_decrypt_ctx cx[1]); + +AES_RETURN aes_xi(encrypt)(const unsigned char *in, unsigned char *out, const aes_encrypt_ctx cx[1]); +AES_RETURN aes_xi(decrypt)(const unsigned char *in, unsigned char *out, const aes_decrypt_ctx cx[1]); + +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/aescrypt.c b/SSZipArchive/minizip/aes/aescrypt.c new file mode 100644 index 0000000..bd647e4 --- /dev/null +++ b/SSZipArchive/minizip/aes/aescrypt.c @@ -0,0 +1,301 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2013, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 +*/ + +#include "aesopt.h" +#include "aestab.h" + +#if defined( USE_INTEL_AES_IF_PRESENT ) +# include "aes_ni.h" +#else +/* map names here to provide the external API ('name' -> 'aes_name') */ +# define aes_xi(x) aes_ ## x +#endif + +#if defined(__cplusplus) +extern "C" +{ +#endif + +#define si(y,x,k,c) (s(y,c) = word_in(x, c) ^ (k)[c]) +#define so(y,x,c) word_out(y, c, s(x,c)) + +#if defined(ARRAYS) +#define locals(y,x) x[4],y[4] +#else +#define locals(y,x) x##0,x##1,x##2,x##3,y##0,y##1,y##2,y##3 +#endif + +#define l_copy(y, x) s(y,0) = s(x,0); s(y,1) = s(x,1); \ + s(y,2) = s(x,2); s(y,3) = s(x,3); +#define state_in(y,x,k) si(y,x,k,0); si(y,x,k,1); si(y,x,k,2); si(y,x,k,3) +#define state_out(y,x) so(y,x,0); so(y,x,1); so(y,x,2); so(y,x,3) +#define round(rm,y,x,k) rm(y,x,k,0); rm(y,x,k,1); rm(y,x,k,2); rm(y,x,k,3) + +#if ( FUNCS_IN_C & ENCRYPTION_IN_C ) + +/* Visual C++ .Net v7.1 provides the fastest encryption code when using + Pentium optimiation with small code but this is poor for decryption + so we need to control this with the following VC++ pragmas +*/ + +#if defined( _MSC_VER ) && !defined( _WIN64 ) +#pragma optimize( "s", on ) +#endif + +/* Given the column (c) of the output state variable, the following + macros give the input state variables which are needed in its + computation for each row (r) of the state. All the alternative + macros give the same end values but expand into different ways + of calculating these values. In particular the complex macro + used for dynamically variable block sizes is designed to expand + to a compile time constant whenever possible but will expand to + conditional clauses on some branches (I am grateful to Frank + Yellin for this construction) +*/ + +#define fwd_var(x,r,c)\ + ( r == 0 ? ( c == 0 ? s(x,0) : c == 1 ? s(x,1) : c == 2 ? s(x,2) : s(x,3))\ + : r == 1 ? ( c == 0 ? s(x,1) : c == 1 ? s(x,2) : c == 2 ? s(x,3) : s(x,0))\ + : r == 2 ? ( c == 0 ? s(x,2) : c == 1 ? s(x,3) : c == 2 ? s(x,0) : s(x,1))\ + : ( c == 0 ? s(x,3) : c == 1 ? s(x,0) : c == 2 ? s(x,1) : s(x,2))) + +#if defined(FT4_SET) +#undef dec_fmvars +#define fwd_rnd(y,x,k,c) (s(y,c) = (k)[c] ^ four_tables(x,t_use(f,n),fwd_var,rf1,c)) +#elif defined(FT1_SET) +#undef dec_fmvars +#define fwd_rnd(y,x,k,c) (s(y,c) = (k)[c] ^ one_table(x,upr,t_use(f,n),fwd_var,rf1,c)) +#else +#define fwd_rnd(y,x,k,c) (s(y,c) = (k)[c] ^ fwd_mcol(no_table(x,t_use(s,box),fwd_var,rf1,c))) +#endif + +#if defined(FL4_SET) +#define fwd_lrnd(y,x,k,c) (s(y,c) = (k)[c] ^ four_tables(x,t_use(f,l),fwd_var,rf1,c)) +#elif defined(FL1_SET) +#define fwd_lrnd(y,x,k,c) (s(y,c) = (k)[c] ^ one_table(x,ups,t_use(f,l),fwd_var,rf1,c)) +#else +#define fwd_lrnd(y,x,k,c) (s(y,c) = (k)[c] ^ no_table(x,t_use(s,box),fwd_var,rf1,c)) +#endif + +AES_RETURN aes_xi(encrypt)(const unsigned char *in, unsigned char *out, const aes_encrypt_ctx cx[1]) +{ uint32_t locals(b0, b1); + const uint32_t *kp; +#if defined( dec_fmvars ) + dec_fmvars; /* declare variables for fwd_mcol() if needed */ +#endif + + if(cx->inf.b[0] != 10 * 16 && cx->inf.b[0] != 12 * 16 && cx->inf.b[0] != 14 * 16) + return EXIT_FAILURE; + + kp = cx->ks; + state_in(b0, in, kp); + +#if (ENC_UNROLL == FULL) + + switch(cx->inf.b[0]) + { + case 14 * 16: + round(fwd_rnd, b1, b0, kp + 1 * N_COLS); + round(fwd_rnd, b0, b1, kp + 2 * N_COLS); + kp += 2 * N_COLS; + case 12 * 16: + round(fwd_rnd, b1, b0, kp + 1 * N_COLS); + round(fwd_rnd, b0, b1, kp + 2 * N_COLS); + kp += 2 * N_COLS; + case 10 * 16: + round(fwd_rnd, b1, b0, kp + 1 * N_COLS); + round(fwd_rnd, b0, b1, kp + 2 * N_COLS); + round(fwd_rnd, b1, b0, kp + 3 * N_COLS); + round(fwd_rnd, b0, b1, kp + 4 * N_COLS); + round(fwd_rnd, b1, b0, kp + 5 * N_COLS); + round(fwd_rnd, b0, b1, kp + 6 * N_COLS); + round(fwd_rnd, b1, b0, kp + 7 * N_COLS); + round(fwd_rnd, b0, b1, kp + 8 * N_COLS); + round(fwd_rnd, b1, b0, kp + 9 * N_COLS); + round(fwd_lrnd, b0, b1, kp +10 * N_COLS); + } + +#else + +#if (ENC_UNROLL == PARTIAL) + { uint32_t rnd; + for(rnd = 0; rnd < (cx->inf.b[0] >> 5) - 1; ++rnd) + { + kp += N_COLS; + round(fwd_rnd, b1, b0, kp); + kp += N_COLS; + round(fwd_rnd, b0, b1, kp); + } + kp += N_COLS; + round(fwd_rnd, b1, b0, kp); +#else + { uint32_t rnd; + for(rnd = 0; rnd < (cx->inf.b[0] >> 4) - 1; ++rnd) + { + kp += N_COLS; + round(fwd_rnd, b1, b0, kp); + l_copy(b0, b1); + } +#endif + kp += N_COLS; + round(fwd_lrnd, b0, b1, kp); + } +#endif + + state_out(out, b0); + return EXIT_SUCCESS; +} + +#endif + +#if ( FUNCS_IN_C & DECRYPTION_IN_C) + +/* Visual C++ .Net v7.1 provides the fastest encryption code when using + Pentium optimiation with small code but this is poor for decryption + so we need to control this with the following VC++ pragmas +*/ + +#if defined( _MSC_VER ) && !defined( _WIN64 ) +#pragma optimize( "t", on ) +#endif + +/* Given the column (c) of the output state variable, the following + macros give the input state variables which are needed in its + computation for each row (r) of the state. All the alternative + macros give the same end values but expand into different ways + of calculating these values. In particular the complex macro + used for dynamically variable block sizes is designed to expand + to a compile time constant whenever possible but will expand to + conditional clauses on some branches (I am grateful to Frank + Yellin for this construction) +*/ + +#define inv_var(x,r,c)\ + ( r == 0 ? ( c == 0 ? s(x,0) : c == 1 ? s(x,1) : c == 2 ? s(x,2) : s(x,3))\ + : r == 1 ? ( c == 0 ? s(x,3) : c == 1 ? s(x,0) : c == 2 ? s(x,1) : s(x,2))\ + : r == 2 ? ( c == 0 ? s(x,2) : c == 1 ? s(x,3) : c == 2 ? s(x,0) : s(x,1))\ + : ( c == 0 ? s(x,1) : c == 1 ? s(x,2) : c == 2 ? s(x,3) : s(x,0))) + +#if defined(IT4_SET) +#undef dec_imvars +#define inv_rnd(y,x,k,c) (s(y,c) = (k)[c] ^ four_tables(x,t_use(i,n),inv_var,rf1,c)) +#elif defined(IT1_SET) +#undef dec_imvars +#define inv_rnd(y,x,k,c) (s(y,c) = (k)[c] ^ one_table(x,upr,t_use(i,n),inv_var,rf1,c)) +#else +#define inv_rnd(y,x,k,c) (s(y,c) = inv_mcol((k)[c] ^ no_table(x,t_use(i,box),inv_var,rf1,c))) +#endif + +#if defined(IL4_SET) +#define inv_lrnd(y,x,k,c) (s(y,c) = (k)[c] ^ four_tables(x,t_use(i,l),inv_var,rf1,c)) +#elif defined(IL1_SET) +#define inv_lrnd(y,x,k,c) (s(y,c) = (k)[c] ^ one_table(x,ups,t_use(i,l),inv_var,rf1,c)) +#else +#define inv_lrnd(y,x,k,c) (s(y,c) = (k)[c] ^ no_table(x,t_use(i,box),inv_var,rf1,c)) +#endif + +/* This code can work with the decryption key schedule in the */ +/* order that is used for encrytpion (where the 1st decryption */ +/* round key is at the high end ot the schedule) or with a key */ +/* schedule that has been reversed to put the 1st decryption */ +/* round key at the low end of the schedule in memory (when */ +/* AES_REV_DKS is defined) */ + +#ifdef AES_REV_DKS +#define key_ofs 0 +#define rnd_key(n) (kp + n * N_COLS) +#else +#define key_ofs 1 +#define rnd_key(n) (kp - n * N_COLS) +#endif + +AES_RETURN aes_xi(decrypt)(const unsigned char *in, unsigned char *out, const aes_decrypt_ctx cx[1]) +{ uint32_t locals(b0, b1); +#if defined( dec_imvars ) + dec_imvars; /* declare variables for inv_mcol() if needed */ +#endif + const uint32_t *kp; + + if(cx->inf.b[0] != 10 * 16 && cx->inf.b[0] != 12 * 16 && cx->inf.b[0] != 14 * 16) + return EXIT_FAILURE; + + kp = cx->ks + (key_ofs ? (cx->inf.b[0] >> 2) : 0); + state_in(b0, in, kp); + +#if (DEC_UNROLL == FULL) + + kp = cx->ks + (key_ofs ? 0 : (cx->inf.b[0] >> 2)); + switch(cx->inf.b[0]) + { + case 14 * 16: + round(inv_rnd, b1, b0, rnd_key(-13)); + round(inv_rnd, b0, b1, rnd_key(-12)); + case 12 * 16: + round(inv_rnd, b1, b0, rnd_key(-11)); + round(inv_rnd, b0, b1, rnd_key(-10)); + case 10 * 16: + round(inv_rnd, b1, b0, rnd_key(-9)); + round(inv_rnd, b0, b1, rnd_key(-8)); + round(inv_rnd, b1, b0, rnd_key(-7)); + round(inv_rnd, b0, b1, rnd_key(-6)); + round(inv_rnd, b1, b0, rnd_key(-5)); + round(inv_rnd, b0, b1, rnd_key(-4)); + round(inv_rnd, b1, b0, rnd_key(-3)); + round(inv_rnd, b0, b1, rnd_key(-2)); + round(inv_rnd, b1, b0, rnd_key(-1)); + round(inv_lrnd, b0, b1, rnd_key( 0)); + } + +#else + +#if (DEC_UNROLL == PARTIAL) + { uint32_t rnd; + for(rnd = 0; rnd < (cx->inf.b[0] >> 5) - 1; ++rnd) + { + kp = rnd_key(1); + round(inv_rnd, b1, b0, kp); + kp = rnd_key(1); + round(inv_rnd, b0, b1, kp); + } + kp = rnd_key(1); + round(inv_rnd, b1, b0, kp); +#else + { uint32_t rnd; + for(rnd = 0; rnd < (cx->inf.b[0] >> 4) - 1; ++rnd) + { + kp = rnd_key(1); + round(inv_rnd, b1, b0, kp); + l_copy(b0, b1); + } +#endif + kp = rnd_key(1); + round(inv_lrnd, b0, b1, kp); + } +#endif + + state_out(out, b0); + return EXIT_SUCCESS; +} + +#endif + +#if defined(__cplusplus) +} +#endif diff --git a/SSZipArchive/minizip/aes/aeskey.c b/SSZipArchive/minizip/aes/aeskey.c new file mode 100644 index 0000000..16e9607 --- /dev/null +++ b/SSZipArchive/minizip/aes/aeskey.c @@ -0,0 +1,554 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2013, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 +*/ + +#include "aesopt.h" +#include "aestab.h" + +#if defined( USE_INTEL_AES_IF_PRESENT ) +# include "aes_ni.h" +#else +/* map names here to provide the external API ('name' -> 'aes_name') */ +# define aes_xi(x) aes_ ## x +#endif + +#ifdef USE_VIA_ACE_IF_PRESENT +# include "aes_via_ace.h" +#endif + +#if defined(__cplusplus) +extern "C" +{ +#endif + +/* Initialise the key schedule from the user supplied key. The key + length can be specified in bytes, with legal values of 16, 24 + and 32, or in bits, with legal values of 128, 192 and 256. These + values correspond with Nk values of 4, 6 and 8 respectively. + + The following macros implement a single cycle in the key + schedule generation process. The number of cycles needed + for each cx->n_col and nk value is: + + nk = 4 5 6 7 8 + ------------------------------ + cx->n_col = 4 10 9 8 7 7 + cx->n_col = 5 14 11 10 9 9 + cx->n_col = 6 19 15 12 11 11 + cx->n_col = 7 21 19 16 13 14 + cx->n_col = 8 29 23 19 17 14 +*/ + +#if defined( REDUCE_CODE_SIZE ) +# define ls_box ls_sub + uint32_t ls_sub(const uint32_t t, const uint32_t n); +# define inv_mcol im_sub + uint32_t im_sub(const uint32_t x); +# ifdef ENC_KS_UNROLL +# undef ENC_KS_UNROLL +# endif +# ifdef DEC_KS_UNROLL +# undef DEC_KS_UNROLL +# endif +#endif + +#if (FUNCS_IN_C & ENC_KEYING_IN_C) + +#if defined(AES_128) || defined( AES_VAR ) + +#define ke4(k,i) \ +{ k[4*(i)+4] = ss[0] ^= ls_box(ss[3],3) ^ t_use(r,c)[i]; \ + k[4*(i)+5] = ss[1] ^= ss[0]; \ + k[4*(i)+6] = ss[2] ^= ss[1]; \ + k[4*(i)+7] = ss[3] ^= ss[2]; \ +} + +AES_RETURN aes_xi(encrypt_key128)(const unsigned char *key, aes_encrypt_ctx cx[1]) +{ uint32_t ss[4]; + + cx->ks[0] = ss[0] = word_in(key, 0); + cx->ks[1] = ss[1] = word_in(key, 1); + cx->ks[2] = ss[2] = word_in(key, 2); + cx->ks[3] = ss[3] = word_in(key, 3); + +#ifdef ENC_KS_UNROLL + ke4(cx->ks, 0); ke4(cx->ks, 1); + ke4(cx->ks, 2); ke4(cx->ks, 3); + ke4(cx->ks, 4); ke4(cx->ks, 5); + ke4(cx->ks, 6); ke4(cx->ks, 7); + ke4(cx->ks, 8); +#else + { uint32_t i; + for(i = 0; i < 9; ++i) + ke4(cx->ks, i); + } +#endif + ke4(cx->ks, 9); + cx->inf.l = 0; + cx->inf.b[0] = 10 * 16; + +#ifdef USE_VIA_ACE_IF_PRESENT + if(VIA_ACE_AVAILABLE) + cx->inf.b[1] = 0xff; +#endif + return EXIT_SUCCESS; +} + +#endif + +#if defined(AES_192) || defined( AES_VAR ) + +#define kef6(k,i) \ +{ k[6*(i)+ 6] = ss[0] ^= ls_box(ss[5],3) ^ t_use(r,c)[i]; \ + k[6*(i)+ 7] = ss[1] ^= ss[0]; \ + k[6*(i)+ 8] = ss[2] ^= ss[1]; \ + k[6*(i)+ 9] = ss[3] ^= ss[2]; \ +} + +#define ke6(k,i) \ +{ kef6(k,i); \ + k[6*(i)+10] = ss[4] ^= ss[3]; \ + k[6*(i)+11] = ss[5] ^= ss[4]; \ +} + +AES_RETURN aes_xi(encrypt_key192)(const unsigned char *key, aes_encrypt_ctx cx[1]) +{ uint32_t ss[6]; + + cx->ks[0] = ss[0] = word_in(key, 0); + cx->ks[1] = ss[1] = word_in(key, 1); + cx->ks[2] = ss[2] = word_in(key, 2); + cx->ks[3] = ss[3] = word_in(key, 3); + cx->ks[4] = ss[4] = word_in(key, 4); + cx->ks[5] = ss[5] = word_in(key, 5); + +#ifdef ENC_KS_UNROLL + ke6(cx->ks, 0); ke6(cx->ks, 1); + ke6(cx->ks, 2); ke6(cx->ks, 3); + ke6(cx->ks, 4); ke6(cx->ks, 5); + ke6(cx->ks, 6); +#else + { uint32_t i; + for(i = 0; i < 7; ++i) + ke6(cx->ks, i); + } +#endif + kef6(cx->ks, 7); + cx->inf.l = 0; + cx->inf.b[0] = 12 * 16; + +#ifdef USE_VIA_ACE_IF_PRESENT + if(VIA_ACE_AVAILABLE) + cx->inf.b[1] = 0xff; +#endif + return EXIT_SUCCESS; +} + +#endif + +#if defined(AES_256) || defined( AES_VAR ) + +#define kef8(k,i) \ +{ k[8*(i)+ 8] = ss[0] ^= ls_box(ss[7],3) ^ t_use(r,c)[i]; \ + k[8*(i)+ 9] = ss[1] ^= ss[0]; \ + k[8*(i)+10] = ss[2] ^= ss[1]; \ + k[8*(i)+11] = ss[3] ^= ss[2]; \ +} + +#define ke8(k,i) \ +{ kef8(k,i); \ + k[8*(i)+12] = ss[4] ^= ls_box(ss[3],0); \ + k[8*(i)+13] = ss[5] ^= ss[4]; \ + k[8*(i)+14] = ss[6] ^= ss[5]; \ + k[8*(i)+15] = ss[7] ^= ss[6]; \ +} + +AES_RETURN aes_xi(encrypt_key256)(const unsigned char *key, aes_encrypt_ctx cx[1]) +{ uint32_t ss[8]; + + cx->ks[0] = ss[0] = word_in(key, 0); + cx->ks[1] = ss[1] = word_in(key, 1); + cx->ks[2] = ss[2] = word_in(key, 2); + cx->ks[3] = ss[3] = word_in(key, 3); + cx->ks[4] = ss[4] = word_in(key, 4); + cx->ks[5] = ss[5] = word_in(key, 5); + cx->ks[6] = ss[6] = word_in(key, 6); + cx->ks[7] = ss[7] = word_in(key, 7); + +#ifdef ENC_KS_UNROLL + ke8(cx->ks, 0); ke8(cx->ks, 1); + ke8(cx->ks, 2); ke8(cx->ks, 3); + ke8(cx->ks, 4); ke8(cx->ks, 5); +#else + { uint32_t i; + for(i = 0; i < 6; ++i) + ke8(cx->ks, i); + } +#endif + kef8(cx->ks, 6); + cx->inf.l = 0; + cx->inf.b[0] = 14 * 16; + +#ifdef USE_VIA_ACE_IF_PRESENT + if(VIA_ACE_AVAILABLE) + cx->inf.b[1] = 0xff; +#endif + return EXIT_SUCCESS; +} + +#endif + +#endif + +#if (FUNCS_IN_C & DEC_KEYING_IN_C) + +/* this is used to store the decryption round keys */ +/* in forward or reverse order */ + +#ifdef AES_REV_DKS +#define v(n,i) ((n) - (i) + 2 * ((i) & 3)) +#else +#define v(n,i) (i) +#endif + +#if DEC_ROUND == NO_TABLES +#define ff(x) (x) +#else +#define ff(x) inv_mcol(x) +#if defined( dec_imvars ) +#define d_vars dec_imvars +#endif +#endif + +#if defined(AES_128) || defined( AES_VAR ) + +#define k4e(k,i) \ +{ k[v(40,(4*(i))+4)] = ss[0] ^= ls_box(ss[3],3) ^ t_use(r,c)[i]; \ + k[v(40,(4*(i))+5)] = ss[1] ^= ss[0]; \ + k[v(40,(4*(i))+6)] = ss[2] ^= ss[1]; \ + k[v(40,(4*(i))+7)] = ss[3] ^= ss[2]; \ +} + +#if 1 + +#define kdf4(k,i) \ +{ ss[0] = ss[0] ^ ss[2] ^ ss[1] ^ ss[3]; \ + ss[1] = ss[1] ^ ss[3]; \ + ss[2] = ss[2] ^ ss[3]; \ + ss[4] = ls_box(ss[(i+3) % 4], 3) ^ t_use(r,c)[i]; \ + ss[i % 4] ^= ss[4]; \ + ss[4] ^= k[v(40,(4*(i)))]; k[v(40,(4*(i))+4)] = ff(ss[4]); \ + ss[4] ^= k[v(40,(4*(i))+1)]; k[v(40,(4*(i))+5)] = ff(ss[4]); \ + ss[4] ^= k[v(40,(4*(i))+2)]; k[v(40,(4*(i))+6)] = ff(ss[4]); \ + ss[4] ^= k[v(40,(4*(i))+3)]; k[v(40,(4*(i))+7)] = ff(ss[4]); \ +} + +#define kd4(k,i) \ +{ ss[4] = ls_box(ss[(i+3) % 4], 3) ^ t_use(r,c)[i]; \ + ss[i % 4] ^= ss[4]; ss[4] = ff(ss[4]); \ + k[v(40,(4*(i))+4)] = ss[4] ^= k[v(40,(4*(i)))]; \ + k[v(40,(4*(i))+5)] = ss[4] ^= k[v(40,(4*(i))+1)]; \ + k[v(40,(4*(i))+6)] = ss[4] ^= k[v(40,(4*(i))+2)]; \ + k[v(40,(4*(i))+7)] = ss[4] ^= k[v(40,(4*(i))+3)]; \ +} + +#define kdl4(k,i) \ +{ ss[4] = ls_box(ss[(i+3) % 4], 3) ^ t_use(r,c)[i]; ss[i % 4] ^= ss[4]; \ + k[v(40,(4*(i))+4)] = (ss[0] ^= ss[1]) ^ ss[2] ^ ss[3]; \ + k[v(40,(4*(i))+5)] = ss[1] ^ ss[3]; \ + k[v(40,(4*(i))+6)] = ss[0]; \ + k[v(40,(4*(i))+7)] = ss[1]; \ +} + +#else + +#define kdf4(k,i) \ +{ ss[0] ^= ls_box(ss[3],3) ^ t_use(r,c)[i]; k[v(40,(4*(i))+ 4)] = ff(ss[0]); \ + ss[1] ^= ss[0]; k[v(40,(4*(i))+ 5)] = ff(ss[1]); \ + ss[2] ^= ss[1]; k[v(40,(4*(i))+ 6)] = ff(ss[2]); \ + ss[3] ^= ss[2]; k[v(40,(4*(i))+ 7)] = ff(ss[3]); \ +} + +#define kd4(k,i) \ +{ ss[4] = ls_box(ss[3],3) ^ t_use(r,c)[i]; \ + ss[0] ^= ss[4]; ss[4] = ff(ss[4]); k[v(40,(4*(i))+ 4)] = ss[4] ^= k[v(40,(4*(i)))]; \ + ss[1] ^= ss[0]; k[v(40,(4*(i))+ 5)] = ss[4] ^= k[v(40,(4*(i))+ 1)]; \ + ss[2] ^= ss[1]; k[v(40,(4*(i))+ 6)] = ss[4] ^= k[v(40,(4*(i))+ 2)]; \ + ss[3] ^= ss[2]; k[v(40,(4*(i))+ 7)] = ss[4] ^= k[v(40,(4*(i))+ 3)]; \ +} + +#define kdl4(k,i) \ +{ ss[0] ^= ls_box(ss[3],3) ^ t_use(r,c)[i]; k[v(40,(4*(i))+ 4)] = ss[0]; \ + ss[1] ^= ss[0]; k[v(40,(4*(i))+ 5)] = ss[1]; \ + ss[2] ^= ss[1]; k[v(40,(4*(i))+ 6)] = ss[2]; \ + ss[3] ^= ss[2]; k[v(40,(4*(i))+ 7)] = ss[3]; \ +} + +#endif + +AES_RETURN aes_xi(decrypt_key128)(const unsigned char *key, aes_decrypt_ctx cx[1]) +{ uint32_t ss[5]; +#if defined( d_vars ) + d_vars; +#endif + + cx->ks[v(40,(0))] = ss[0] = word_in(key, 0); + cx->ks[v(40,(1))] = ss[1] = word_in(key, 1); + cx->ks[v(40,(2))] = ss[2] = word_in(key, 2); + cx->ks[v(40,(3))] = ss[3] = word_in(key, 3); + +#ifdef DEC_KS_UNROLL + kdf4(cx->ks, 0); kd4(cx->ks, 1); + kd4(cx->ks, 2); kd4(cx->ks, 3); + kd4(cx->ks, 4); kd4(cx->ks, 5); + kd4(cx->ks, 6); kd4(cx->ks, 7); + kd4(cx->ks, 8); kdl4(cx->ks, 9); +#else + { uint32_t i; + for(i = 0; i < 10; ++i) + k4e(cx->ks, i); +#if !(DEC_ROUND == NO_TABLES) + for(i = N_COLS; i < 10 * N_COLS; ++i) + cx->ks[i] = inv_mcol(cx->ks[i]); +#endif + } +#endif + cx->inf.l = 0; + cx->inf.b[0] = 10 * 16; + +#ifdef USE_VIA_ACE_IF_PRESENT + if(VIA_ACE_AVAILABLE) + cx->inf.b[1] = 0xff; +#endif + return EXIT_SUCCESS; +} + +#endif + +#if defined(AES_192) || defined( AES_VAR ) + +#define k6ef(k,i) \ +{ k[v(48,(6*(i))+ 6)] = ss[0] ^= ls_box(ss[5],3) ^ t_use(r,c)[i]; \ + k[v(48,(6*(i))+ 7)] = ss[1] ^= ss[0]; \ + k[v(48,(6*(i))+ 8)] = ss[2] ^= ss[1]; \ + k[v(48,(6*(i))+ 9)] = ss[3] ^= ss[2]; \ +} + +#define k6e(k,i) \ +{ k6ef(k,i); \ + k[v(48,(6*(i))+10)] = ss[4] ^= ss[3]; \ + k[v(48,(6*(i))+11)] = ss[5] ^= ss[4]; \ +} + +#define kdf6(k,i) \ +{ ss[0] ^= ls_box(ss[5],3) ^ t_use(r,c)[i]; k[v(48,(6*(i))+ 6)] = ff(ss[0]); \ + ss[1] ^= ss[0]; k[v(48,(6*(i))+ 7)] = ff(ss[1]); \ + ss[2] ^= ss[1]; k[v(48,(6*(i))+ 8)] = ff(ss[2]); \ + ss[3] ^= ss[2]; k[v(48,(6*(i))+ 9)] = ff(ss[3]); \ + ss[4] ^= ss[3]; k[v(48,(6*(i))+10)] = ff(ss[4]); \ + ss[5] ^= ss[4]; k[v(48,(6*(i))+11)] = ff(ss[5]); \ +} + +#define kd6(k,i) \ +{ ss[6] = ls_box(ss[5],3) ^ t_use(r,c)[i]; \ + ss[0] ^= ss[6]; ss[6] = ff(ss[6]); k[v(48,(6*(i))+ 6)] = ss[6] ^= k[v(48,(6*(i)))]; \ + ss[1] ^= ss[0]; k[v(48,(6*(i))+ 7)] = ss[6] ^= k[v(48,(6*(i))+ 1)]; \ + ss[2] ^= ss[1]; k[v(48,(6*(i))+ 8)] = ss[6] ^= k[v(48,(6*(i))+ 2)]; \ + ss[3] ^= ss[2]; k[v(48,(6*(i))+ 9)] = ss[6] ^= k[v(48,(6*(i))+ 3)]; \ + ss[4] ^= ss[3]; k[v(48,(6*(i))+10)] = ss[6] ^= k[v(48,(6*(i))+ 4)]; \ + ss[5] ^= ss[4]; k[v(48,(6*(i))+11)] = ss[6] ^= k[v(48,(6*(i))+ 5)]; \ +} + +#define kdl6(k,i) \ +{ ss[0] ^= ls_box(ss[5],3) ^ t_use(r,c)[i]; k[v(48,(6*(i))+ 6)] = ss[0]; \ + ss[1] ^= ss[0]; k[v(48,(6*(i))+ 7)] = ss[1]; \ + ss[2] ^= ss[1]; k[v(48,(6*(i))+ 8)] = ss[2]; \ + ss[3] ^= ss[2]; k[v(48,(6*(i))+ 9)] = ss[3]; \ +} + +AES_RETURN aes_xi(decrypt_key192)(const unsigned char *key, aes_decrypt_ctx cx[1]) +{ uint32_t ss[7]; +#if defined( d_vars ) + d_vars; +#endif + + cx->ks[v(48,(0))] = ss[0] = word_in(key, 0); + cx->ks[v(48,(1))] = ss[1] = word_in(key, 1); + cx->ks[v(48,(2))] = ss[2] = word_in(key, 2); + cx->ks[v(48,(3))] = ss[3] = word_in(key, 3); + +#ifdef DEC_KS_UNROLL + cx->ks[v(48,(4))] = ff(ss[4] = word_in(key, 4)); + cx->ks[v(48,(5))] = ff(ss[5] = word_in(key, 5)); + kdf6(cx->ks, 0); kd6(cx->ks, 1); + kd6(cx->ks, 2); kd6(cx->ks, 3); + kd6(cx->ks, 4); kd6(cx->ks, 5); + kd6(cx->ks, 6); kdl6(cx->ks, 7); +#else + cx->ks[v(48,(4))] = ss[4] = word_in(key, 4); + cx->ks[v(48,(5))] = ss[5] = word_in(key, 5); + { uint32_t i; + + for(i = 0; i < 7; ++i) + k6e(cx->ks, i); + k6ef(cx->ks, 7); +#if !(DEC_ROUND == NO_TABLES) + for(i = N_COLS; i < 12 * N_COLS; ++i) + cx->ks[i] = inv_mcol(cx->ks[i]); +#endif + } +#endif + cx->inf.l = 0; + cx->inf.b[0] = 12 * 16; + +#ifdef USE_VIA_ACE_IF_PRESENT + if(VIA_ACE_AVAILABLE) + cx->inf.b[1] = 0xff; +#endif + return EXIT_SUCCESS; +} + +#endif + +#if defined(AES_256) || defined( AES_VAR ) + +#define k8ef(k,i) \ +{ k[v(56,(8*(i))+ 8)] = ss[0] ^= ls_box(ss[7],3) ^ t_use(r,c)[i]; \ + k[v(56,(8*(i))+ 9)] = ss[1] ^= ss[0]; \ + k[v(56,(8*(i))+10)] = ss[2] ^= ss[1]; \ + k[v(56,(8*(i))+11)] = ss[3] ^= ss[2]; \ +} + +#define k8e(k,i) \ +{ k8ef(k,i); \ + k[v(56,(8*(i))+12)] = ss[4] ^= ls_box(ss[3],0); \ + k[v(56,(8*(i))+13)] = ss[5] ^= ss[4]; \ + k[v(56,(8*(i))+14)] = ss[6] ^= ss[5]; \ + k[v(56,(8*(i))+15)] = ss[7] ^= ss[6]; \ +} + +#define kdf8(k,i) \ +{ ss[0] ^= ls_box(ss[7],3) ^ t_use(r,c)[i]; k[v(56,(8*(i))+ 8)] = ff(ss[0]); \ + ss[1] ^= ss[0]; k[v(56,(8*(i))+ 9)] = ff(ss[1]); \ + ss[2] ^= ss[1]; k[v(56,(8*(i))+10)] = ff(ss[2]); \ + ss[3] ^= ss[2]; k[v(56,(8*(i))+11)] = ff(ss[3]); \ + ss[4] ^= ls_box(ss[3],0); k[v(56,(8*(i))+12)] = ff(ss[4]); \ + ss[5] ^= ss[4]; k[v(56,(8*(i))+13)] = ff(ss[5]); \ + ss[6] ^= ss[5]; k[v(56,(8*(i))+14)] = ff(ss[6]); \ + ss[7] ^= ss[6]; k[v(56,(8*(i))+15)] = ff(ss[7]); \ +} + +#define kd8(k,i) \ +{ ss[8] = ls_box(ss[7],3) ^ t_use(r,c)[i]; \ + ss[0] ^= ss[8]; ss[8] = ff(ss[8]); k[v(56,(8*(i))+ 8)] = ss[8] ^= k[v(56,(8*(i)))]; \ + ss[1] ^= ss[0]; k[v(56,(8*(i))+ 9)] = ss[8] ^= k[v(56,(8*(i))+ 1)]; \ + ss[2] ^= ss[1]; k[v(56,(8*(i))+10)] = ss[8] ^= k[v(56,(8*(i))+ 2)]; \ + ss[3] ^= ss[2]; k[v(56,(8*(i))+11)] = ss[8] ^= k[v(56,(8*(i))+ 3)]; \ + ss[8] = ls_box(ss[3],0); \ + ss[4] ^= ss[8]; ss[8] = ff(ss[8]); k[v(56,(8*(i))+12)] = ss[8] ^= k[v(56,(8*(i))+ 4)]; \ + ss[5] ^= ss[4]; k[v(56,(8*(i))+13)] = ss[8] ^= k[v(56,(8*(i))+ 5)]; \ + ss[6] ^= ss[5]; k[v(56,(8*(i))+14)] = ss[8] ^= k[v(56,(8*(i))+ 6)]; \ + ss[7] ^= ss[6]; k[v(56,(8*(i))+15)] = ss[8] ^= k[v(56,(8*(i))+ 7)]; \ +} + +#define kdl8(k,i) \ +{ ss[0] ^= ls_box(ss[7],3) ^ t_use(r,c)[i]; k[v(56,(8*(i))+ 8)] = ss[0]; \ + ss[1] ^= ss[0]; k[v(56,(8*(i))+ 9)] = ss[1]; \ + ss[2] ^= ss[1]; k[v(56,(8*(i))+10)] = ss[2]; \ + ss[3] ^= ss[2]; k[v(56,(8*(i))+11)] = ss[3]; \ +} + +AES_RETURN aes_xi(decrypt_key256)(const unsigned char *key, aes_decrypt_ctx cx[1]) +{ uint32_t ss[9]; +#if defined( d_vars ) + d_vars; +#endif + + cx->ks[v(56,(0))] = ss[0] = word_in(key, 0); + cx->ks[v(56,(1))] = ss[1] = word_in(key, 1); + cx->ks[v(56,(2))] = ss[2] = word_in(key, 2); + cx->ks[v(56,(3))] = ss[3] = word_in(key, 3); + +#ifdef DEC_KS_UNROLL + cx->ks[v(56,(4))] = ff(ss[4] = word_in(key, 4)); + cx->ks[v(56,(5))] = ff(ss[5] = word_in(key, 5)); + cx->ks[v(56,(6))] = ff(ss[6] = word_in(key, 6)); + cx->ks[v(56,(7))] = ff(ss[7] = word_in(key, 7)); + kdf8(cx->ks, 0); kd8(cx->ks, 1); + kd8(cx->ks, 2); kd8(cx->ks, 3); + kd8(cx->ks, 4); kd8(cx->ks, 5); + kdl8(cx->ks, 6); +#else + cx->ks[v(56,(4))] = ss[4] = word_in(key, 4); + cx->ks[v(56,(5))] = ss[5] = word_in(key, 5); + cx->ks[v(56,(6))] = ss[6] = word_in(key, 6); + cx->ks[v(56,(7))] = ss[7] = word_in(key, 7); + { uint32_t i; + + for(i = 0; i < 6; ++i) + k8e(cx->ks, i); + k8ef(cx->ks, 6); +#if !(DEC_ROUND == NO_TABLES) + for(i = N_COLS; i < 14 * N_COLS; ++i) + cx->ks[i] = inv_mcol(cx->ks[i]); +#endif + } +#endif + cx->inf.l = 0; + cx->inf.b[0] = 14 * 16; + +#ifdef USE_VIA_ACE_IF_PRESENT + if(VIA_ACE_AVAILABLE) + cx->inf.b[1] = 0xff; +#endif + return EXIT_SUCCESS; +} + +#endif + +#endif + +#if defined( AES_VAR ) + +AES_RETURN aes_encrypt_key(const unsigned char *key, int key_len, aes_encrypt_ctx cx[1]) +{ + switch(key_len) + { + case 16: case 128: return aes_encrypt_key128(key, cx); + case 24: case 192: return aes_encrypt_key192(key, cx); + case 32: case 256: return aes_encrypt_key256(key, cx); + default: return EXIT_FAILURE; + } +} + +AES_RETURN aes_decrypt_key(const unsigned char *key, int key_len, aes_decrypt_ctx cx[1]) +{ + switch(key_len) + { + case 16: case 128: return aes_decrypt_key128(key, cx); + case 24: case 192: return aes_decrypt_key192(key, cx); + case 32: case 256: return aes_decrypt_key256(key, cx); + default: return EXIT_FAILURE; + } +} + +#endif + +#if defined(__cplusplus) +} +#endif diff --git a/SSZipArchive/minizip/aes/aesopt.h b/SSZipArchive/minizip/aes/aesopt.h new file mode 100644 index 0000000..3678e74 --- /dev/null +++ b/SSZipArchive/minizip/aes/aesopt.h @@ -0,0 +1,776 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2013, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 + + This file contains the compilation options for AES (Rijndael) and code + that is common across encryption, key scheduling and table generation. + + OPERATION + + These source code files implement the AES algorithm Rijndael designed by + Joan Daemen and Vincent Rijmen. This version is designed for the standard + block size of 16 bytes and for key sizes of 128, 192 and 256 bits (16, 24 + and 32 bytes). + + This version is designed for flexibility and speed using operations on + 32-bit words rather than operations on bytes. It can be compiled with + either big or little endian internal byte order but is faster when the + native byte order for the processor is used. + + THE CIPHER INTERFACE + + The cipher interface is implemented as an array of bytes in which lower + AES bit sequence indexes map to higher numeric significance within bytes. + + uint8_t (an unsigned 8-bit type) + uint32_t (an unsigned 32-bit type) + struct aes_encrypt_ctx (structure for the cipher encryption context) + struct aes_decrypt_ctx (structure for the cipher decryption context) + AES_RETURN the function return type + + C subroutine calls: + + AES_RETURN aes_encrypt_key128(const unsigned char *key, aes_encrypt_ctx cx[1]); + AES_RETURN aes_encrypt_key192(const unsigned char *key, aes_encrypt_ctx cx[1]); + AES_RETURN aes_encrypt_key256(const unsigned char *key, aes_encrypt_ctx cx[1]); + AES_RETURN aes_encrypt(const unsigned char *in, unsigned char *out, + const aes_encrypt_ctx cx[1]); + + AES_RETURN aes_decrypt_key128(const unsigned char *key, aes_decrypt_ctx cx[1]); + AES_RETURN aes_decrypt_key192(const unsigned char *key, aes_decrypt_ctx cx[1]); + AES_RETURN aes_decrypt_key256(const unsigned char *key, aes_decrypt_ctx cx[1]); + AES_RETURN aes_decrypt(const unsigned char *in, unsigned char *out, + const aes_decrypt_ctx cx[1]); + + IMPORTANT NOTE: If you are using this C interface with dynamic tables make sure that + you call aes_init() before AES is used so that the tables are initialised. + + C++ aes class subroutines: + + Class AESencrypt for encryption + + Construtors: + AESencrypt(void) + AESencrypt(const unsigned char *key) - 128 bit key + Members: + AES_RETURN key128(const unsigned char *key) + AES_RETURN key192(const unsigned char *key) + AES_RETURN key256(const unsigned char *key) + AES_RETURN encrypt(const unsigned char *in, unsigned char *out) const + + Class AESdecrypt for encryption + Construtors: + AESdecrypt(void) + AESdecrypt(const unsigned char *key) - 128 bit key + Members: + AES_RETURN key128(const unsigned char *key) + AES_RETURN key192(const unsigned char *key) + AES_RETURN key256(const unsigned char *key) + AES_RETURN decrypt(const unsigned char *in, unsigned char *out) const +*/ + +#if !defined( _AESOPT_H ) +#define _AESOPT_H + +#if defined( __cplusplus ) +#include "aescpp.h" +#else +#include "aes.h" +#endif + +/* PLATFORM SPECIFIC INCLUDES */ + +#include "brg_endian.h" + +/* CONFIGURATION - THE USE OF DEFINES + + Later in this section there are a number of defines that control the + operation of the code. In each section, the purpose of each define is + explained so that the relevant form can be included or excluded by + setting either 1's or 0's respectively on the branches of the related + #if clauses. The following local defines should not be changed. +*/ + +#define ENCRYPTION_IN_C 1 +#define DECRYPTION_IN_C 2 +#define ENC_KEYING_IN_C 4 +#define DEC_KEYING_IN_C 8 + +#define NO_TABLES 0 +#define ONE_TABLE 1 +#define FOUR_TABLES 4 +#define NONE 0 +#define PARTIAL 1 +#define FULL 2 + +/* --- START OF USER CONFIGURED OPTIONS --- */ + +/* 1. BYTE ORDER WITHIN 32 BIT WORDS + + The fundamental data processing units in Rijndael are 8-bit bytes. The + input, output and key input are all enumerated arrays of bytes in which + bytes are numbered starting at zero and increasing to one less than the + number of bytes in the array in question. This enumeration is only used + for naming bytes and does not imply any adjacency or order relationship + from one byte to another. When these inputs and outputs are considered + as bit sequences, bits 8*n to 8*n+7 of the bit sequence are mapped to + byte[n] with bit 8n+i in the sequence mapped to bit 7-i within the byte. + In this implementation bits are numbered from 0 to 7 starting at the + numerically least significant end of each byte (bit n represents 2^n). + + However, Rijndael can be implemented more efficiently using 32-bit + words by packing bytes into words so that bytes 4*n to 4*n+3 are placed + into word[n]. While in principle these bytes can be assembled into words + in any positions, this implementation only supports the two formats in + which bytes in adjacent positions within words also have adjacent byte + numbers. This order is called big-endian if the lowest numbered bytes + in words have the highest numeric significance and little-endian if the + opposite applies. + + This code can work in either order irrespective of the order used by the + machine on which it runs. Normally the internal byte order will be set + to the order of the processor on which the code is to be run but this + define can be used to reverse this in special situations + + WARNING: Assembler code versions rely on PLATFORM_BYTE_ORDER being set. + This define will hence be redefined later (in section 4) if necessary +*/ + +#if 1 +# define ALGORITHM_BYTE_ORDER PLATFORM_BYTE_ORDER +#elif 0 +# define ALGORITHM_BYTE_ORDER IS_LITTLE_ENDIAN +#elif 0 +# define ALGORITHM_BYTE_ORDER IS_BIG_ENDIAN +#else +# error The algorithm byte order is not defined +#endif + +/* 2. Intel AES AND VIA ACE SUPPORT */ + +#if defined( __GNUC__ ) && defined( __i386__ ) \ + || defined( _WIN32 ) && defined( _M_IX86 ) && !(defined( _WIN64 ) \ + || defined( _WIN32_WCE ) || defined( _MSC_VER ) && ( _MSC_VER <= 800 )) +# define VIA_ACE_POSSIBLE +#endif + +#if (defined( _WIN64 ) && defined( _MSC_VER )) \ + || (defined( __GNUC__ ) && defined( __x86_64__ )) && !(defined( __APPLE__ ))\ + && !(defined( INTEL_AES_POSSIBLE )) +# define INTEL_AES_POSSIBLE +#endif + +/* Define this option if support for the Intel AESNI is required + If USE_INTEL_AES_IF_PRESENT is defined then AESNI will be used + if it is detected (both present and enabled). + + AESNI uses a decryption key schedule with the first decryption + round key at the high end of the key scedule with the following + round keys at lower positions in memory. So AES_REV_DKS must NOT + be defined when AESNI will be used. ALthough it is unlikely that + assembler code will be used with an AESNI build, if it is then + AES_REV_DKS must NOT be defined when the assembler files are + built +*/ + +#if 1 && defined( INTEL_AES_POSSIBLE ) && !defined( USE_INTEL_AES_IF_PRESENT ) +# define USE_INTEL_AES_IF_PRESENT +#endif + +/* Define this option if support for the VIA ACE is required. This uses + inline assembler instructions and is only implemented for the Microsoft, + Intel and GCC compilers. If VIA ACE is known to be present, then defining + ASSUME_VIA_ACE_PRESENT will remove the ordinary encryption/decryption + code. If USE_VIA_ACE_IF_PRESENT is defined then VIA ACE will be used if + it is detected (both present and enabled) but the normal AES code will + also be present. + + When VIA ACE is to be used, all AES encryption contexts MUST be 16 byte + aligned; other input/output buffers do not need to be 16 byte aligned + but there are very large performance gains if this can be arranged. + VIA ACE also requires the decryption key schedule to be in reverse + order (which later checks below ensure). + + AES_REV_DKS must be set for assembler code used with a VIA ACE build +*/ + +#if 0 && defined( VIA_ACE_POSSIBLE ) && !defined( USE_VIA_ACE_IF_PRESENT ) +# define USE_VIA_ACE_IF_PRESENT +#endif + +#if 0 && defined( VIA_ACE_POSSIBLE ) && !defined( ASSUME_VIA_ACE_PRESENT ) +# define ASSUME_VIA_ACE_PRESENT +# endif + +/* 3. ASSEMBLER SUPPORT + + This define (which can be on the command line) enables the use of the + assembler code routines for encryption, decryption and key scheduling + as follows: + + ASM_X86_V1C uses the assembler (aes_x86_v1.asm) with large tables for + encryption and decryption and but with key scheduling in C + ASM_X86_V2 uses assembler (aes_x86_v2.asm) with compressed tables for + encryption, decryption and key scheduling + ASM_X86_V2C uses assembler (aes_x86_v2.asm) with compressed tables for + encryption and decryption and but with key scheduling in C + ASM_AMD64_C uses assembler (aes_amd64.asm) with compressed tables for + encryption and decryption and but with key scheduling in C + + Change one 'if 0' below to 'if 1' to select the version or define + as a compilation option. +*/ + +#if 0 && !defined( ASM_X86_V1C ) +# define ASM_X86_V1C +#elif 0 && !defined( ASM_X86_V2 ) +# define ASM_X86_V2 +#elif 0 && !defined( ASM_X86_V2C ) +# define ASM_X86_V2C +#elif 0 && !defined( ASM_AMD64_C ) +# define ASM_AMD64_C +#endif + +#if defined( __i386 ) || defined( _M_IX86 ) +# define A32_ +#elif defined( __x86_64__ ) || defined( _M_X64 ) +# define A64_ +#endif + +#if (defined ( ASM_X86_V1C ) || defined( ASM_X86_V2 ) || defined( ASM_X86_V2C )) \ + && !defined( A32_ ) || defined( ASM_AMD64_C ) && !defined( A64_ ) +# error Assembler code is only available for x86 and AMD64 systems +#endif + +/* 4. FAST INPUT/OUTPUT OPERATIONS. + + On some machines it is possible to improve speed by transferring the + bytes in the input and output arrays to and from the internal 32-bit + variables by addressing these arrays as if they are arrays of 32-bit + words. On some machines this will always be possible but there may + be a large performance penalty if the byte arrays are not aligned on + the normal word boundaries. On other machines this technique will + lead to memory access errors when such 32-bit word accesses are not + properly aligned. The option SAFE_IO avoids such problems but will + often be slower on those machines that support misaligned access + (especially so if care is taken to align the input and output byte + arrays on 32-bit word boundaries). If SAFE_IO is not defined it is + assumed that access to byte arrays as if they are arrays of 32-bit + words will not cause problems when such accesses are misaligned. +*/ +#if 1 && !defined( _MSC_VER ) +# define SAFE_IO +#endif + +/* 5. LOOP UNROLLING + + The code for encryption and decrytpion cycles through a number of rounds + that can be implemented either in a loop or by expanding the code into a + long sequence of instructions, the latter producing a larger program but + one that will often be much faster. The latter is called loop unrolling. + There are also potential speed advantages in expanding two iterations in + a loop with half the number of iterations, which is called partial loop + unrolling. The following options allow partial or full loop unrolling + to be set independently for encryption and decryption +*/ +#if 1 +# define ENC_UNROLL FULL +#elif 0 +# define ENC_UNROLL PARTIAL +#else +# define ENC_UNROLL NONE +#endif + +#if 1 +# define DEC_UNROLL FULL +#elif 0 +# define DEC_UNROLL PARTIAL +#else +# define DEC_UNROLL NONE +#endif + +#if 1 +# define ENC_KS_UNROLL +#endif + +#if 1 +# define DEC_KS_UNROLL +#endif + +/* 6. FAST FINITE FIELD OPERATIONS + + If this section is included, tables are used to provide faster finite + field arithmetic (this has no effect if STATIC_TABLES is defined). +*/ +#if 1 +# define FF_TABLES +#endif + +/* 7. INTERNAL STATE VARIABLE FORMAT + + The internal state of Rijndael is stored in a number of local 32-bit + word varaibles which can be defined either as an array or as individual + names variables. Include this section if you want to store these local + varaibles in arrays. Otherwise individual local variables will be used. +*/ +#if 1 +# define ARRAYS +#endif + +/* 8. FIXED OR DYNAMIC TABLES + + When this section is included the tables used by the code are compiled + statically into the binary file. Otherwise the subroutine aes_init() + must be called to compute them before the code is first used. +*/ +#if 1 && !(defined( _MSC_VER ) && ( _MSC_VER <= 800 )) +# define STATIC_TABLES +#endif + +/* 9. MASKING OR CASTING FROM LONGER VALUES TO BYTES + + In some systems it is better to mask longer values to extract bytes + rather than using a cast. This option allows this choice. +*/ +#if 0 +# define to_byte(x) ((uint8_t)(x)) +#else +# define to_byte(x) ((x) & 0xff) +#endif + +/* 10. TABLE ALIGNMENT + + On some sytsems speed will be improved by aligning the AES large lookup + tables on particular boundaries. This define should be set to a power of + two giving the desired alignment. It can be left undefined if alignment + is not needed. This option is specific to the Microsft VC++ compiler - + it seems to sometimes cause trouble for the VC++ version 6 compiler. +*/ + +#if 1 && defined( _MSC_VER ) && ( _MSC_VER >= 1300 ) +# define TABLE_ALIGN 32 +#endif + +/* 11. REDUCE CODE AND TABLE SIZE + + This replaces some expanded macros with function calls if AES_ASM_V2 or + AES_ASM_V2C are defined +*/ + +#if 1 && (defined( ASM_X86_V2 ) || defined( ASM_X86_V2C )) +# define REDUCE_CODE_SIZE +#endif + +/* 12. TABLE OPTIONS + + This cipher proceeds by repeating in a number of cycles known as 'rounds' + which are implemented by a round function which can optionally be speeded + up using tables. The basic tables are each 256 32-bit words, with either + one or four tables being required for each round function depending on + how much speed is required. The encryption and decryption round functions + are different and the last encryption and decrytpion round functions are + different again making four different round functions in all. + + This means that: + 1. Normal encryption and decryption rounds can each use either 0, 1 + or 4 tables and table spaces of 0, 1024 or 4096 bytes each. + 2. The last encryption and decryption rounds can also use either 0, 1 + or 4 tables and table spaces of 0, 1024 or 4096 bytes each. + + Include or exclude the appropriate definitions below to set the number + of tables used by this implementation. +*/ + +#if 1 /* set tables for the normal encryption round */ +# define ENC_ROUND FOUR_TABLES +#elif 0 +# define ENC_ROUND ONE_TABLE +#else +# define ENC_ROUND NO_TABLES +#endif + +#if 1 /* set tables for the last encryption round */ +# define LAST_ENC_ROUND FOUR_TABLES +#elif 0 +# define LAST_ENC_ROUND ONE_TABLE +#else +# define LAST_ENC_ROUND NO_TABLES +#endif + +#if 1 /* set tables for the normal decryption round */ +# define DEC_ROUND FOUR_TABLES +#elif 0 +# define DEC_ROUND ONE_TABLE +#else +# define DEC_ROUND NO_TABLES +#endif + +#if 1 /* set tables for the last decryption round */ +# define LAST_DEC_ROUND FOUR_TABLES +#elif 0 +# define LAST_DEC_ROUND ONE_TABLE +#else +# define LAST_DEC_ROUND NO_TABLES +#endif + +/* The decryption key schedule can be speeded up with tables in the same + way that the round functions can. Include or exclude the following + defines to set this requirement. +*/ +#if 1 +# define KEY_SCHED FOUR_TABLES +#elif 0 +# define KEY_SCHED ONE_TABLE +#else +# define KEY_SCHED NO_TABLES +#endif + +/* ---- END OF USER CONFIGURED OPTIONS ---- */ + +/* VIA ACE support is only available for VC++ and GCC */ + +#if !defined( _MSC_VER ) && !defined( __GNUC__ ) +# if defined( ASSUME_VIA_ACE_PRESENT ) +# undef ASSUME_VIA_ACE_PRESENT +# endif +# if defined( USE_VIA_ACE_IF_PRESENT ) +# undef USE_VIA_ACE_IF_PRESENT +# endif +#endif + +#if defined( ASSUME_VIA_ACE_PRESENT ) && !defined( USE_VIA_ACE_IF_PRESENT ) +# define USE_VIA_ACE_IF_PRESENT +#endif + +/* define to reverse decryption key schedule */ +#if 1 || defined( USE_VIA_ACE_IF_PRESENT ) && !defined ( AES_REV_DKS ) +# define AES_REV_DKS +#endif + +/* Intel AESNI uses a decryption key schedule in the encryption order */ +#if defined( USE_INTEL_AES_IF_PRESENT ) && defined ( AES_REV_DKS ) +# undef AES_REV_DKS +#endif + +/* Assembler support requires the use of platform byte order */ + +#if ( defined( ASM_X86_V1C ) || defined( ASM_X86_V2C ) || defined( ASM_AMD64_C ) ) \ + && (ALGORITHM_BYTE_ORDER != PLATFORM_BYTE_ORDER) +# undef ALGORITHM_BYTE_ORDER +# define ALGORITHM_BYTE_ORDER PLATFORM_BYTE_ORDER +#endif + +/* In this implementation the columns of the state array are each held in + 32-bit words. The state array can be held in various ways: in an array + of words, in a number of individual word variables or in a number of + processor registers. The following define maps a variable name x and + a column number c to the way the state array variable is to be held. + The first define below maps the state into an array x[c] whereas the + second form maps the state into a number of individual variables x0, + x1, etc. Another form could map individual state colums to machine + register names. +*/ + +#if defined( ARRAYS ) +# define s(x,c) x[c] +#else +# define s(x,c) x##c +#endif + +/* This implementation provides subroutines for encryption, decryption + and for setting the three key lengths (separately) for encryption + and decryption. Since not all functions are needed, masks are set + up here to determine which will be implemented in C +*/ + +#if !defined( AES_ENCRYPT ) +# define EFUNCS_IN_C 0 +#elif defined( ASSUME_VIA_ACE_PRESENT ) || defined( ASM_X86_V1C ) \ + || defined( ASM_X86_V2C ) || defined( ASM_AMD64_C ) +# define EFUNCS_IN_C ENC_KEYING_IN_C +#elif !defined( ASM_X86_V2 ) +# define EFUNCS_IN_C ( ENCRYPTION_IN_C | ENC_KEYING_IN_C ) +#else +# define EFUNCS_IN_C 0 +#endif + +#if !defined( AES_DECRYPT ) +# define DFUNCS_IN_C 0 +#elif defined( ASSUME_VIA_ACE_PRESENT ) || defined( ASM_X86_V1C ) \ + || defined( ASM_X86_V2C ) || defined( ASM_AMD64_C ) +# define DFUNCS_IN_C DEC_KEYING_IN_C +#elif !defined( ASM_X86_V2 ) +# define DFUNCS_IN_C ( DECRYPTION_IN_C | DEC_KEYING_IN_C ) +#else +# define DFUNCS_IN_C 0 +#endif + +#define FUNCS_IN_C ( EFUNCS_IN_C | DFUNCS_IN_C ) + +/* END OF CONFIGURATION OPTIONS */ + +#define RC_LENGTH (5 * (AES_BLOCK_SIZE / 4 - 2)) + +/* Disable or report errors on some combinations of options */ + +#if ENC_ROUND == NO_TABLES && LAST_ENC_ROUND != NO_TABLES +# undef LAST_ENC_ROUND +# define LAST_ENC_ROUND NO_TABLES +#elif ENC_ROUND == ONE_TABLE && LAST_ENC_ROUND == FOUR_TABLES +# undef LAST_ENC_ROUND +# define LAST_ENC_ROUND ONE_TABLE +#endif + +#if ENC_ROUND == NO_TABLES && ENC_UNROLL != NONE +# undef ENC_UNROLL +# define ENC_UNROLL NONE +#endif + +#if DEC_ROUND == NO_TABLES && LAST_DEC_ROUND != NO_TABLES +# undef LAST_DEC_ROUND +# define LAST_DEC_ROUND NO_TABLES +#elif DEC_ROUND == ONE_TABLE && LAST_DEC_ROUND == FOUR_TABLES +# undef LAST_DEC_ROUND +# define LAST_DEC_ROUND ONE_TABLE +#endif + +#if DEC_ROUND == NO_TABLES && DEC_UNROLL != NONE +# undef DEC_UNROLL +# define DEC_UNROLL NONE +#endif + +#if defined( bswap32 ) +# define aes_sw32 bswap32 +#elif defined( bswap_32 ) +# define aes_sw32 bswap_32 +#else +# define brot(x,n) (((uint32_t)(x) << n) | ((uint32_t)(x) >> (32 - n))) +# define aes_sw32(x) ((brot((x),8) & 0x00ff00ff) | (brot((x),24) & 0xff00ff00)) +#endif + +/* upr(x,n): rotates bytes within words by n positions, moving bytes to + higher index positions with wrap around into low positions + ups(x,n): moves bytes by n positions to higher index positions in + words but without wrap around + bval(x,n): extracts a byte from a word + + WARNING: The definitions given here are intended only for use with + unsigned variables and with shift counts that are compile + time constants +*/ + +#if ( ALGORITHM_BYTE_ORDER == IS_LITTLE_ENDIAN ) +# define upr(x,n) (((uint32_t)(x) << (8 * (n))) | ((uint32_t)(x) >> (32 - 8 * (n)))) +# define ups(x,n) ((uint32_t) (x) << (8 * (n))) +# define bval(x,n) to_byte((x) >> (8 * (n))) +# define bytes2word(b0, b1, b2, b3) \ + (((uint32_t)(b3) << 24) | ((uint32_t)(b2) << 16) | ((uint32_t)(b1) << 8) | (b0)) +#endif + +#if ( ALGORITHM_BYTE_ORDER == IS_BIG_ENDIAN ) +# define upr(x,n) (((uint32_t)(x) >> (8 * (n))) | ((uint32_t)(x) << (32 - 8 * (n)))) +# define ups(x,n) ((uint32_t) (x) >> (8 * (n))) +# define bval(x,n) to_byte((x) >> (24 - 8 * (n))) +# define bytes2word(b0, b1, b2, b3) \ + (((uint32_t)(b0) << 24) | ((uint32_t)(b1) << 16) | ((uint32_t)(b2) << 8) | (b3)) +#endif + +#if defined( SAFE_IO ) +# define word_in(x,c) bytes2word(((const uint8_t*)(x)+4*c)[0], ((const uint8_t*)(x)+4*c)[1], \ + ((const uint8_t*)(x)+4*c)[2], ((const uint8_t*)(x)+4*c)[3]) +# define word_out(x,c,v) { ((uint8_t*)(x)+4*c)[0] = bval(v,0); ((uint8_t*)(x)+4*c)[1] = bval(v,1); \ + ((uint8_t*)(x)+4*c)[2] = bval(v,2); ((uint8_t*)(x)+4*c)[3] = bval(v,3); } +#elif ( ALGORITHM_BYTE_ORDER == PLATFORM_BYTE_ORDER ) +# define word_in(x,c) (*((uint32_t*)(x)+(c))) +# define word_out(x,c,v) (*((uint32_t*)(x)+(c)) = (v)) +#else +# define word_in(x,c) aes_sw32(*((uint32_t*)(x)+(c))) +# define word_out(x,c,v) (*((uint32_t*)(x)+(c)) = aes_sw32(v)) +#endif + +/* the finite field modular polynomial and elements */ + +#define WPOLY 0x011b +#define BPOLY 0x1b + +/* multiply four bytes in GF(2^8) by 'x' {02} in parallel */ + +#define gf_c1 0x80808080 +#define gf_c2 0x7f7f7f7f +#define gf_mulx(x) ((((x) & gf_c2) << 1) ^ ((((x) & gf_c1) >> 7) * BPOLY)) + +/* The following defines provide alternative definitions of gf_mulx that might + give improved performance if a fast 32-bit multiply is not available. Note + that a temporary variable u needs to be defined where gf_mulx is used. + +#define gf_mulx(x) (u = (x) & gf_c1, u |= (u >> 1), ((x) & gf_c2) << 1) ^ ((u >> 3) | (u >> 6)) +#define gf_c4 (0x01010101 * BPOLY) +#define gf_mulx(x) (u = (x) & gf_c1, ((x) & gf_c2) << 1) ^ ((u - (u >> 7)) & gf_c4) +*/ + +/* Work out which tables are needed for the different options */ + +#if defined( ASM_X86_V1C ) +# if defined( ENC_ROUND ) +# undef ENC_ROUND +# endif +# define ENC_ROUND FOUR_TABLES +# if defined( LAST_ENC_ROUND ) +# undef LAST_ENC_ROUND +# endif +# define LAST_ENC_ROUND FOUR_TABLES +# if defined( DEC_ROUND ) +# undef DEC_ROUND +# endif +# define DEC_ROUND FOUR_TABLES +# if defined( LAST_DEC_ROUND ) +# undef LAST_DEC_ROUND +# endif +# define LAST_DEC_ROUND FOUR_TABLES +# if defined( KEY_SCHED ) +# undef KEY_SCHED +# define KEY_SCHED FOUR_TABLES +# endif +#endif + +#if ( FUNCS_IN_C & ENCRYPTION_IN_C ) || defined( ASM_X86_V1C ) +# if ENC_ROUND == ONE_TABLE +# define FT1_SET +# elif ENC_ROUND == FOUR_TABLES +# define FT4_SET +# else +# define SBX_SET +# endif +# if LAST_ENC_ROUND == ONE_TABLE +# define FL1_SET +# elif LAST_ENC_ROUND == FOUR_TABLES +# define FL4_SET +# elif !defined( SBX_SET ) +# define SBX_SET +# endif +#endif + +#if ( FUNCS_IN_C & DECRYPTION_IN_C ) || defined( ASM_X86_V1C ) +# if DEC_ROUND == ONE_TABLE +# define IT1_SET +# elif DEC_ROUND == FOUR_TABLES +# define IT4_SET +# else +# define ISB_SET +# endif +# if LAST_DEC_ROUND == ONE_TABLE +# define IL1_SET +# elif LAST_DEC_ROUND == FOUR_TABLES +# define IL4_SET +# elif !defined(ISB_SET) +# define ISB_SET +# endif +#endif + +#if !(defined( REDUCE_CODE_SIZE ) && (defined( ASM_X86_V2 ) || defined( ASM_X86_V2C ))) +# if ((FUNCS_IN_C & ENC_KEYING_IN_C) || (FUNCS_IN_C & DEC_KEYING_IN_C)) +# if KEY_SCHED == ONE_TABLE +# if !defined( FL1_SET ) && !defined( FL4_SET ) +# define LS1_SET +# endif +# elif KEY_SCHED == FOUR_TABLES +# if !defined( FL4_SET ) +# define LS4_SET +# endif +# elif !defined( SBX_SET ) +# define SBX_SET +# endif +# endif +# if (FUNCS_IN_C & DEC_KEYING_IN_C) +# if KEY_SCHED == ONE_TABLE +# define IM1_SET +# elif KEY_SCHED == FOUR_TABLES +# define IM4_SET +# elif !defined( SBX_SET ) +# define SBX_SET +# endif +# endif +#endif + +/* generic definitions of Rijndael macros that use tables */ + +#define no_table(x,box,vf,rf,c) bytes2word( \ + box[bval(vf(x,0,c),rf(0,c))], \ + box[bval(vf(x,1,c),rf(1,c))], \ + box[bval(vf(x,2,c),rf(2,c))], \ + box[bval(vf(x,3,c),rf(3,c))]) + +#define one_table(x,op,tab,vf,rf,c) \ + ( tab[bval(vf(x,0,c),rf(0,c))] \ + ^ op(tab[bval(vf(x,1,c),rf(1,c))],1) \ + ^ op(tab[bval(vf(x,2,c),rf(2,c))],2) \ + ^ op(tab[bval(vf(x,3,c),rf(3,c))],3)) + +#define four_tables(x,tab,vf,rf,c) \ + ( tab[0][bval(vf(x,0,c),rf(0,c))] \ + ^ tab[1][bval(vf(x,1,c),rf(1,c))] \ + ^ tab[2][bval(vf(x,2,c),rf(2,c))] \ + ^ tab[3][bval(vf(x,3,c),rf(3,c))]) + +#define vf1(x,r,c) (x) +#define rf1(r,c) (r) +#define rf2(r,c) ((8+r-c)&3) + +/* perform forward and inverse column mix operation on four bytes in long word x in */ +/* parallel. NOTE: x must be a simple variable, NOT an expression in these macros. */ + +#if !(defined( REDUCE_CODE_SIZE ) && (defined( ASM_X86_V2 ) || defined( ASM_X86_V2C ))) + +#if defined( FM4_SET ) /* not currently used */ +# define fwd_mcol(x) four_tables(x,t_use(f,m),vf1,rf1,0) +#elif defined( FM1_SET ) /* not currently used */ +# define fwd_mcol(x) one_table(x,upr,t_use(f,m),vf1,rf1,0) +#else +# define dec_fmvars uint32_t g2 +# define fwd_mcol(x) (g2 = gf_mulx(x), g2 ^ upr((x) ^ g2, 3) ^ upr((x), 2) ^ upr((x), 1)) +#endif + +#if defined( IM4_SET ) +# define inv_mcol(x) four_tables(x,t_use(i,m),vf1,rf1,0) +#elif defined( IM1_SET ) +# define inv_mcol(x) one_table(x,upr,t_use(i,m),vf1,rf1,0) +#else +# define dec_imvars uint32_t g2, g4, g9 +# define inv_mcol(x) (g2 = gf_mulx(x), g4 = gf_mulx(g2), g9 = (x) ^ gf_mulx(g4), g4 ^= g9, \ + (x) ^ g2 ^ g4 ^ upr(g2 ^ g9, 3) ^ upr(g4, 2) ^ upr(g9, 1)) +#endif + +#if defined( FL4_SET ) +# define ls_box(x,c) four_tables(x,t_use(f,l),vf1,rf2,c) +#elif defined( LS4_SET ) +# define ls_box(x,c) four_tables(x,t_use(l,s),vf1,rf2,c) +#elif defined( FL1_SET ) +# define ls_box(x,c) one_table(x,upr,t_use(f,l),vf1,rf2,c) +#elif defined( LS1_SET ) +# define ls_box(x,c) one_table(x,upr,t_use(l,s),vf1,rf2,c) +#else +# define ls_box(x,c) no_table(x,t_use(s,box),vf1,rf2,c) +#endif + +#endif + +#if defined( ASM_X86_V1C ) && defined( AES_DECRYPT ) && !defined( ISB_SET ) +# define ISB_SET +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/aestab.c b/SSZipArchive/minizip/aes/aestab.c new file mode 100644 index 0000000..3d48edf --- /dev/null +++ b/SSZipArchive/minizip/aes/aestab.c @@ -0,0 +1,418 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2013, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 +*/ + +#define DO_TABLES + +#include "aes.h" +#include "aesopt.h" + +#if defined(STATIC_TABLES) + +#define sb_data(w) {\ + w(0x63), w(0x7c), w(0x77), w(0x7b), w(0xf2), w(0x6b), w(0x6f), w(0xc5),\ + w(0x30), w(0x01), w(0x67), w(0x2b), w(0xfe), w(0xd7), w(0xab), w(0x76),\ + w(0xca), w(0x82), w(0xc9), w(0x7d), w(0xfa), w(0x59), w(0x47), w(0xf0),\ + w(0xad), w(0xd4), w(0xa2), w(0xaf), w(0x9c), w(0xa4), w(0x72), w(0xc0),\ + w(0xb7), w(0xfd), w(0x93), w(0x26), w(0x36), w(0x3f), w(0xf7), w(0xcc),\ + w(0x34), w(0xa5), w(0xe5), w(0xf1), w(0x71), w(0xd8), w(0x31), w(0x15),\ + w(0x04), w(0xc7), w(0x23), w(0xc3), w(0x18), w(0x96), w(0x05), w(0x9a),\ + w(0x07), w(0x12), w(0x80), w(0xe2), w(0xeb), w(0x27), w(0xb2), w(0x75),\ + w(0x09), w(0x83), w(0x2c), w(0x1a), w(0x1b), w(0x6e), w(0x5a), w(0xa0),\ + w(0x52), w(0x3b), w(0xd6), w(0xb3), w(0x29), w(0xe3), w(0x2f), w(0x84),\ + w(0x53), w(0xd1), w(0x00), w(0xed), w(0x20), w(0xfc), w(0xb1), w(0x5b),\ + w(0x6a), w(0xcb), w(0xbe), w(0x39), w(0x4a), w(0x4c), w(0x58), w(0xcf),\ + w(0xd0), w(0xef), w(0xaa), w(0xfb), w(0x43), w(0x4d), w(0x33), w(0x85),\ + w(0x45), w(0xf9), w(0x02), w(0x7f), w(0x50), w(0x3c), w(0x9f), w(0xa8),\ + w(0x51), w(0xa3), w(0x40), w(0x8f), w(0x92), w(0x9d), w(0x38), w(0xf5),\ + w(0xbc), w(0xb6), w(0xda), w(0x21), w(0x10), w(0xff), w(0xf3), w(0xd2),\ + w(0xcd), w(0x0c), w(0x13), w(0xec), w(0x5f), w(0x97), w(0x44), w(0x17),\ + w(0xc4), w(0xa7), w(0x7e), w(0x3d), w(0x64), w(0x5d), w(0x19), w(0x73),\ + w(0x60), w(0x81), w(0x4f), w(0xdc), w(0x22), w(0x2a), w(0x90), w(0x88),\ + w(0x46), w(0xee), w(0xb8), w(0x14), w(0xde), w(0x5e), w(0x0b), w(0xdb),\ + w(0xe0), w(0x32), w(0x3a), w(0x0a), w(0x49), w(0x06), w(0x24), w(0x5c),\ + w(0xc2), w(0xd3), w(0xac), w(0x62), w(0x91), w(0x95), w(0xe4), w(0x79),\ + w(0xe7), w(0xc8), w(0x37), w(0x6d), w(0x8d), w(0xd5), w(0x4e), w(0xa9),\ + w(0x6c), w(0x56), w(0xf4), w(0xea), w(0x65), w(0x7a), w(0xae), w(0x08),\ + w(0xba), w(0x78), w(0x25), w(0x2e), w(0x1c), w(0xa6), w(0xb4), w(0xc6),\ + w(0xe8), w(0xdd), w(0x74), w(0x1f), w(0x4b), w(0xbd), w(0x8b), w(0x8a),\ + w(0x70), w(0x3e), w(0xb5), w(0x66), w(0x48), w(0x03), w(0xf6), w(0x0e),\ + w(0x61), w(0x35), w(0x57), w(0xb9), w(0x86), w(0xc1), w(0x1d), w(0x9e),\ + w(0xe1), w(0xf8), w(0x98), w(0x11), w(0x69), w(0xd9), w(0x8e), w(0x94),\ + w(0x9b), w(0x1e), w(0x87), w(0xe9), w(0xce), w(0x55), w(0x28), w(0xdf),\ + w(0x8c), w(0xa1), w(0x89), w(0x0d), w(0xbf), w(0xe6), w(0x42), w(0x68),\ + w(0x41), w(0x99), w(0x2d), w(0x0f), w(0xb0), w(0x54), w(0xbb), w(0x16) } + +#define isb_data(w) {\ + w(0x52), w(0x09), w(0x6a), w(0xd5), w(0x30), w(0x36), w(0xa5), w(0x38),\ + w(0xbf), w(0x40), w(0xa3), w(0x9e), w(0x81), w(0xf3), w(0xd7), w(0xfb),\ + w(0x7c), w(0xe3), w(0x39), w(0x82), w(0x9b), w(0x2f), w(0xff), w(0x87),\ + w(0x34), w(0x8e), w(0x43), w(0x44), w(0xc4), w(0xde), w(0xe9), w(0xcb),\ + w(0x54), w(0x7b), w(0x94), w(0x32), w(0xa6), w(0xc2), w(0x23), w(0x3d),\ + w(0xee), w(0x4c), w(0x95), w(0x0b), w(0x42), w(0xfa), w(0xc3), w(0x4e),\ + w(0x08), w(0x2e), w(0xa1), w(0x66), w(0x28), w(0xd9), w(0x24), w(0xb2),\ + w(0x76), w(0x5b), w(0xa2), w(0x49), w(0x6d), w(0x8b), w(0xd1), w(0x25),\ + w(0x72), w(0xf8), w(0xf6), w(0x64), w(0x86), w(0x68), w(0x98), w(0x16),\ + w(0xd4), w(0xa4), w(0x5c), w(0xcc), w(0x5d), w(0x65), w(0xb6), w(0x92),\ + w(0x6c), w(0x70), w(0x48), w(0x50), w(0xfd), w(0xed), w(0xb9), w(0xda),\ + w(0x5e), w(0x15), w(0x46), w(0x57), w(0xa7), w(0x8d), w(0x9d), w(0x84),\ + w(0x90), w(0xd8), w(0xab), w(0x00), w(0x8c), w(0xbc), w(0xd3), w(0x0a),\ + w(0xf7), w(0xe4), w(0x58), w(0x05), w(0xb8), w(0xb3), w(0x45), w(0x06),\ + w(0xd0), w(0x2c), w(0x1e), w(0x8f), w(0xca), w(0x3f), w(0x0f), w(0x02),\ + w(0xc1), w(0xaf), w(0xbd), w(0x03), w(0x01), w(0x13), w(0x8a), w(0x6b),\ + w(0x3a), w(0x91), w(0x11), w(0x41), w(0x4f), w(0x67), w(0xdc), w(0xea),\ + w(0x97), w(0xf2), w(0xcf), w(0xce), w(0xf0), w(0xb4), w(0xe6), w(0x73),\ + w(0x96), w(0xac), w(0x74), w(0x22), w(0xe7), w(0xad), w(0x35), w(0x85),\ + w(0xe2), w(0xf9), w(0x37), w(0xe8), w(0x1c), w(0x75), w(0xdf), w(0x6e),\ + w(0x47), w(0xf1), w(0x1a), w(0x71), w(0x1d), w(0x29), w(0xc5), w(0x89),\ + w(0x6f), w(0xb7), w(0x62), w(0x0e), w(0xaa), w(0x18), w(0xbe), w(0x1b),\ + w(0xfc), w(0x56), w(0x3e), w(0x4b), w(0xc6), w(0xd2), w(0x79), w(0x20),\ + w(0x9a), w(0xdb), w(0xc0), w(0xfe), w(0x78), w(0xcd), w(0x5a), w(0xf4),\ + w(0x1f), w(0xdd), w(0xa8), w(0x33), w(0x88), w(0x07), w(0xc7), w(0x31),\ + w(0xb1), w(0x12), w(0x10), w(0x59), w(0x27), w(0x80), w(0xec), w(0x5f),\ + w(0x60), w(0x51), w(0x7f), w(0xa9), w(0x19), w(0xb5), w(0x4a), w(0x0d),\ + w(0x2d), w(0xe5), w(0x7a), w(0x9f), w(0x93), w(0xc9), w(0x9c), w(0xef),\ + w(0xa0), w(0xe0), w(0x3b), w(0x4d), w(0xae), w(0x2a), w(0xf5), w(0xb0),\ + w(0xc8), w(0xeb), w(0xbb), w(0x3c), w(0x83), w(0x53), w(0x99), w(0x61),\ + w(0x17), w(0x2b), w(0x04), w(0x7e), w(0xba), w(0x77), w(0xd6), w(0x26),\ + w(0xe1), w(0x69), w(0x14), w(0x63), w(0x55), w(0x21), w(0x0c), w(0x7d) } + +#define mm_data(w) {\ + w(0x00), w(0x01), w(0x02), w(0x03), w(0x04), w(0x05), w(0x06), w(0x07),\ + w(0x08), w(0x09), w(0x0a), w(0x0b), w(0x0c), w(0x0d), w(0x0e), w(0x0f),\ + w(0x10), w(0x11), w(0x12), w(0x13), w(0x14), w(0x15), w(0x16), w(0x17),\ + w(0x18), w(0x19), w(0x1a), w(0x1b), w(0x1c), w(0x1d), w(0x1e), w(0x1f),\ + w(0x20), w(0x21), w(0x22), w(0x23), w(0x24), w(0x25), w(0x26), w(0x27),\ + w(0x28), w(0x29), w(0x2a), w(0x2b), w(0x2c), w(0x2d), w(0x2e), w(0x2f),\ + w(0x30), w(0x31), w(0x32), w(0x33), w(0x34), w(0x35), w(0x36), w(0x37),\ + w(0x38), w(0x39), w(0x3a), w(0x3b), w(0x3c), w(0x3d), w(0x3e), w(0x3f),\ + w(0x40), w(0x41), w(0x42), w(0x43), w(0x44), w(0x45), w(0x46), w(0x47),\ + w(0x48), w(0x49), w(0x4a), w(0x4b), w(0x4c), w(0x4d), w(0x4e), w(0x4f),\ + w(0x50), w(0x51), w(0x52), w(0x53), w(0x54), w(0x55), w(0x56), w(0x57),\ + w(0x58), w(0x59), w(0x5a), w(0x5b), w(0x5c), w(0x5d), w(0x5e), w(0x5f),\ + w(0x60), w(0x61), w(0x62), w(0x63), w(0x64), w(0x65), w(0x66), w(0x67),\ + w(0x68), w(0x69), w(0x6a), w(0x6b), w(0x6c), w(0x6d), w(0x6e), w(0x6f),\ + w(0x70), w(0x71), w(0x72), w(0x73), w(0x74), w(0x75), w(0x76), w(0x77),\ + w(0x78), w(0x79), w(0x7a), w(0x7b), w(0x7c), w(0x7d), w(0x7e), w(0x7f),\ + w(0x80), w(0x81), w(0x82), w(0x83), w(0x84), w(0x85), w(0x86), w(0x87),\ + w(0x88), w(0x89), w(0x8a), w(0x8b), w(0x8c), w(0x8d), w(0x8e), w(0x8f),\ + w(0x90), w(0x91), w(0x92), w(0x93), w(0x94), w(0x95), w(0x96), w(0x97),\ + w(0x98), w(0x99), w(0x9a), w(0x9b), w(0x9c), w(0x9d), w(0x9e), w(0x9f),\ + w(0xa0), w(0xa1), w(0xa2), w(0xa3), w(0xa4), w(0xa5), w(0xa6), w(0xa7),\ + w(0xa8), w(0xa9), w(0xaa), w(0xab), w(0xac), w(0xad), w(0xae), w(0xaf),\ + w(0xb0), w(0xb1), w(0xb2), w(0xb3), w(0xb4), w(0xb5), w(0xb6), w(0xb7),\ + w(0xb8), w(0xb9), w(0xba), w(0xbb), w(0xbc), w(0xbd), w(0xbe), w(0xbf),\ + w(0xc0), w(0xc1), w(0xc2), w(0xc3), w(0xc4), w(0xc5), w(0xc6), w(0xc7),\ + w(0xc8), w(0xc9), w(0xca), w(0xcb), w(0xcc), w(0xcd), w(0xce), w(0xcf),\ + w(0xd0), w(0xd1), w(0xd2), w(0xd3), w(0xd4), w(0xd5), w(0xd6), w(0xd7),\ + w(0xd8), w(0xd9), w(0xda), w(0xdb), w(0xdc), w(0xdd), w(0xde), w(0xdf),\ + w(0xe0), w(0xe1), w(0xe2), w(0xe3), w(0xe4), w(0xe5), w(0xe6), w(0xe7),\ + w(0xe8), w(0xe9), w(0xea), w(0xeb), w(0xec), w(0xed), w(0xee), w(0xef),\ + w(0xf0), w(0xf1), w(0xf2), w(0xf3), w(0xf4), w(0xf5), w(0xf6), w(0xf7),\ + w(0xf8), w(0xf9), w(0xfa), w(0xfb), w(0xfc), w(0xfd), w(0xfe), w(0xff) } + +#define rc_data(w) {\ + w(0x01), w(0x02), w(0x04), w(0x08), w(0x10),w(0x20), w(0x40), w(0x80),\ + w(0x1b), w(0x36) } + +#define h0(x) (x) + +#define w0(p) bytes2word(p, 0, 0, 0) +#define w1(p) bytes2word(0, p, 0, 0) +#define w2(p) bytes2word(0, 0, p, 0) +#define w3(p) bytes2word(0, 0, 0, p) + +#define u0(p) bytes2word(f2(p), p, p, f3(p)) +#define u1(p) bytes2word(f3(p), f2(p), p, p) +#define u2(p) bytes2word(p, f3(p), f2(p), p) +#define u3(p) bytes2word(p, p, f3(p), f2(p)) + +#define v0(p) bytes2word(fe(p), f9(p), fd(p), fb(p)) +#define v1(p) bytes2word(fb(p), fe(p), f9(p), fd(p)) +#define v2(p) bytes2word(fd(p), fb(p), fe(p), f9(p)) +#define v3(p) bytes2word(f9(p), fd(p), fb(p), fe(p)) + +#endif + +#if defined(STATIC_TABLES) || !defined(FF_TABLES) + +#define f2(x) ((x<<1) ^ (((x>>7) & 1) * WPOLY)) +#define f4(x) ((x<<2) ^ (((x>>6) & 1) * WPOLY) ^ (((x>>6) & 2) * WPOLY)) +#define f8(x) ((x<<3) ^ (((x>>5) & 1) * WPOLY) ^ (((x>>5) & 2) * WPOLY) \ + ^ (((x>>5) & 4) * WPOLY)) +#define f3(x) (f2(x) ^ x) +#define f9(x) (f8(x) ^ x) +#define fb(x) (f8(x) ^ f2(x) ^ x) +#define fd(x) (f8(x) ^ f4(x) ^ x) +#define fe(x) (f8(x) ^ f4(x) ^ f2(x)) + +#else + +#define f2(x) ((x) ? pow[log[x] + 0x19] : 0) +#define f3(x) ((x) ? pow[log[x] + 0x01] : 0) +#define f9(x) ((x) ? pow[log[x] + 0xc7] : 0) +#define fb(x) ((x) ? pow[log[x] + 0x68] : 0) +#define fd(x) ((x) ? pow[log[x] + 0xee] : 0) +#define fe(x) ((x) ? pow[log[x] + 0xdf] : 0) + +#endif + +#include "aestab.h" + +#if defined(__cplusplus) +extern "C" +{ +#endif + +#if defined(STATIC_TABLES) + +/* implemented in case of wrong call for fixed tables */ + +AES_RETURN aes_init(void) +{ + return EXIT_SUCCESS; +} + +#else /* Generate the tables for the dynamic table option */ + +#if defined(FF_TABLES) + +#define gf_inv(x) ((x) ? pow[ 255 - log[x]] : 0) + +#else + +/* It will generally be sensible to use tables to compute finite + field multiplies and inverses but where memory is scarse this + code might sometimes be better. But it only has effect during + initialisation so its pretty unimportant in overall terms. +*/ + +/* return 2 ^ (n - 1) where n is the bit number of the highest bit + set in x with x in the range 1 < x < 0x00000200. This form is + used so that locals within fi can be bytes rather than words +*/ + +static uint8_t hibit(const uint32_t x) +{ uint8_t r = (uint8_t)((x >> 1) | (x >> 2)); + + r |= (r >> 2); + r |= (r >> 4); + return (r + 1) >> 1; +} + +/* return the inverse of the finite field element x */ + +static uint8_t gf_inv(const uint8_t x) +{ uint8_t p1 = x, p2 = BPOLY, n1 = hibit(x), n2 = 0x80, v1 = 1, v2 = 0; + + if(x < 2) + return x; + + for( ; ; ) + { + if(n1) + while(n2 >= n1) /* divide polynomial p2 by p1 */ + { + n2 /= n1; /* shift smaller polynomial left */ + p2 ^= (p1 * n2) & 0xff; /* and remove from larger one */ + v2 ^= v1 * n2; /* shift accumulated value and */ + n2 = hibit(p2); /* add into result */ + } + else + return v1; + + if(n2) /* repeat with values swapped */ + while(n1 >= n2) + { + n1 /= n2; + p1 ^= p2 * n1; + v1 ^= v2 * n1; + n1 = hibit(p1); + } + else + return v2; + } +} + +#endif + +/* The forward and inverse affine transformations used in the S-box */ +uint8_t fwd_affine(const uint8_t x) +{ uint32_t w = x; + w ^= (w << 1) ^ (w << 2) ^ (w << 3) ^ (w << 4); + return 0x63 ^ ((w ^ (w >> 8)) & 0xff); +} + +uint8_t inv_affine(const uint8_t x) +{ uint32_t w = x; + w = (w << 1) ^ (w << 3) ^ (w << 6); + return 0x05 ^ ((w ^ (w >> 8)) & 0xff); +} + +static int init = 0; + +AES_RETURN aes_init(void) +{ uint32_t i, w; + +#if defined(FF_TABLES) + + uint8_t pow[512], log[256]; + + if(init) + return EXIT_SUCCESS; + /* log and power tables for GF(2^8) finite field with + WPOLY as modular polynomial - the simplest primitive + root is 0x03, used here to generate the tables + */ + + i = 0; w = 1; + do + { + pow[i] = (uint8_t)w; + pow[i + 255] = (uint8_t)w; + log[w] = (uint8_t)i++; + w ^= (w << 1) ^ (w & 0x80 ? WPOLY : 0); + } + while (w != 1); + +#else + if(init) + return EXIT_SUCCESS; +#endif + + for(i = 0, w = 1; i < RC_LENGTH; ++i) + { + t_set(r,c)[i] = bytes2word(w, 0, 0, 0); + w = f2(w); + } + + for(i = 0; i < 256; ++i) + { uint8_t b; + + b = fwd_affine(gf_inv((uint8_t)i)); + w = bytes2word(f2(b), b, b, f3(b)); + +#if defined( SBX_SET ) + t_set(s,box)[i] = b; +#endif + +#if defined( FT1_SET ) /* tables for a normal encryption round */ + t_set(f,n)[i] = w; +#endif +#if defined( FT4_SET ) + t_set(f,n)[0][i] = w; + t_set(f,n)[1][i] = upr(w,1); + t_set(f,n)[2][i] = upr(w,2); + t_set(f,n)[3][i] = upr(w,3); +#endif + w = bytes2word(b, 0, 0, 0); + +#if defined( FL1_SET ) /* tables for last encryption round (may also */ + t_set(f,l)[i] = w; /* be used in the key schedule) */ +#endif +#if defined( FL4_SET ) + t_set(f,l)[0][i] = w; + t_set(f,l)[1][i] = upr(w,1); + t_set(f,l)[2][i] = upr(w,2); + t_set(f,l)[3][i] = upr(w,3); +#endif + +#if defined( LS1_SET ) /* table for key schedule if t_set(f,l) above is*/ + t_set(l,s)[i] = w; /* not of the required form */ +#endif +#if defined( LS4_SET ) + t_set(l,s)[0][i] = w; + t_set(l,s)[1][i] = upr(w,1); + t_set(l,s)[2][i] = upr(w,2); + t_set(l,s)[3][i] = upr(w,3); +#endif + + b = gf_inv(inv_affine((uint8_t)i)); + w = bytes2word(fe(b), f9(b), fd(b), fb(b)); + +#if defined( IM1_SET ) /* tables for the inverse mix column operation */ + t_set(i,m)[b] = w; +#endif +#if defined( IM4_SET ) + t_set(i,m)[0][b] = w; + t_set(i,m)[1][b] = upr(w,1); + t_set(i,m)[2][b] = upr(w,2); + t_set(i,m)[3][b] = upr(w,3); +#endif + +#if defined( ISB_SET ) + t_set(i,box)[i] = b; +#endif +#if defined( IT1_SET ) /* tables for a normal decryption round */ + t_set(i,n)[i] = w; +#endif +#if defined( IT4_SET ) + t_set(i,n)[0][i] = w; + t_set(i,n)[1][i] = upr(w,1); + t_set(i,n)[2][i] = upr(w,2); + t_set(i,n)[3][i] = upr(w,3); +#endif + w = bytes2word(b, 0, 0, 0); +#if defined( IL1_SET ) /* tables for last decryption round */ + t_set(i,l)[i] = w; +#endif +#if defined( IL4_SET ) + t_set(i,l)[0][i] = w; + t_set(i,l)[1][i] = upr(w,1); + t_set(i,l)[2][i] = upr(w,2); + t_set(i,l)[3][i] = upr(w,3); +#endif + } + init = 1; + return EXIT_SUCCESS; +} + +/* + Automatic code initialisation (suggested by by Henrik S. Gaßmann) + based on code provided by Joe Lowe and placed in the public domain at: + http://stackoverflow.com/questions/1113409/attribute-constructor-equivalent-in-vc +*/ + +#ifdef _MSC_VER + +#pragma section(".CRT$XCU", read) + +__declspec(allocate(".CRT$XCU")) void (__cdecl *aes_startup)(void) = aes_init; + +#elif defined(__GNUC__) + +static void aes_startup(void) __attribute__((constructor)); + +static void aes_startup(void) +{ + aes_init(); +} + +#else + +#pragma message( "dynamic tables must be initialised manually on your system" ) + +#endif + +#endif + +#if defined(__cplusplus) +} +#endif + diff --git a/SSZipArchive/minizip/aes/aestab.h b/SSZipArchive/minizip/aes/aestab.h new file mode 100644 index 0000000..8fe32d1 --- /dev/null +++ b/SSZipArchive/minizip/aes/aestab.h @@ -0,0 +1,173 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2013, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 + + This file contains the code for declaring the tables needed to implement + AES. The file aesopt.h is assumed to be included before this header file. + If there are no global variables, the definitions here can be used to put + the AES tables in a structure so that a pointer can then be added to the + AES context to pass them to the AES routines that need them. If this + facility is used, the calling program has to ensure that this pointer is + managed appropriately. In particular, the value of the t_dec(in,it) item + in the table structure must be set to zero in order to ensure that the + tables are initialised. In practice the three code sequences in aeskey.c + that control the calls to aes_init() and the aes_init() routine itself will + have to be changed for a specific implementation. If global variables are + available it will generally be preferable to use them with the precomputed + STATIC_TABLES option that uses static global tables. + + The following defines can be used to control the way the tables + are defined, initialised and used in embedded environments that + require special features for these purposes + + the 't_dec' construction is used to declare fixed table arrays + the 't_set' construction is used to set fixed table values + the 't_use' construction is used to access fixed table values + + 256 byte tables: + + t_xxx(s,box) => forward S box + t_xxx(i,box) => inverse S box + + 256 32-bit word OR 4 x 256 32-bit word tables: + + t_xxx(f,n) => forward normal round + t_xxx(f,l) => forward last round + t_xxx(i,n) => inverse normal round + t_xxx(i,l) => inverse last round + t_xxx(l,s) => key schedule table + t_xxx(i,m) => key schedule table + + Other variables and tables: + + t_xxx(r,c) => the rcon table +*/ + +#if !defined( _AESTAB_H ) +#define _AESTAB_H + +#if defined(__cplusplus) +extern "C" { +#endif + +#define t_dec(m,n) t_##m##n +#define t_set(m,n) t_##m##n +#define t_use(m,n) t_##m##n + +#if defined(STATIC_TABLES) +# if !defined( __GNUC__ ) && (defined( __MSDOS__ ) || defined( __WIN16__ )) +/* make tables far data to avoid using too much DGROUP space (PG) */ +# define CONST const far +# else +# define CONST const +# endif +#else +# define CONST +#endif + +#if defined(DO_TABLES) +# define EXTERN +#else +# define EXTERN extern +#endif + +#if defined(_MSC_VER) && defined(TABLE_ALIGN) +#define ALIGN __declspec(align(TABLE_ALIGN)) +#else +#define ALIGN +#endif + +#if defined( __WATCOMC__ ) && ( __WATCOMC__ >= 1100 ) +# define XP_DIR __cdecl +#else +# define XP_DIR +#endif + +#if defined(DO_TABLES) && defined(STATIC_TABLES) +#define d_1(t,n,b,e) EXTERN ALIGN CONST XP_DIR t n[256] = b(e) +#define d_4(t,n,b,e,f,g,h) EXTERN ALIGN CONST XP_DIR t n[4][256] = { b(e), b(f), b(g), b(h) } +EXTERN ALIGN CONST uint32_t t_dec(r,c)[RC_LENGTH] = rc_data(w0); +#else +#define d_1(t,n,b,e) EXTERN ALIGN CONST XP_DIR t n[256] +#define d_4(t,n,b,e,f,g,h) EXTERN ALIGN CONST XP_DIR t n[4][256] +EXTERN ALIGN CONST uint32_t t_dec(r,c)[RC_LENGTH]; +#endif + +#if defined( SBX_SET ) + d_1(uint8_t, t_dec(s,box), sb_data, h0); +#endif +#if defined( ISB_SET ) + d_1(uint8_t, t_dec(i,box), isb_data, h0); +#endif + +#if defined( FT1_SET ) + d_1(uint32_t, t_dec(f,n), sb_data, u0); +#endif +#if defined( FT4_SET ) + d_4(uint32_t, t_dec(f,n), sb_data, u0, u1, u2, u3); +#endif + +#if defined( FL1_SET ) + d_1(uint32_t, t_dec(f,l), sb_data, w0); +#endif +#if defined( FL4_SET ) + d_4(uint32_t, t_dec(f,l), sb_data, w0, w1, w2, w3); +#endif + +#if defined( IT1_SET ) + d_1(uint32_t, t_dec(i,n), isb_data, v0); +#endif +#if defined( IT4_SET ) + d_4(uint32_t, t_dec(i,n), isb_data, v0, v1, v2, v3); +#endif + +#if defined( IL1_SET ) + d_1(uint32_t, t_dec(i,l), isb_data, w0); +#endif +#if defined( IL4_SET ) + d_4(uint32_t, t_dec(i,l), isb_data, w0, w1, w2, w3); +#endif + +#if defined( LS1_SET ) +#if defined( FL1_SET ) +#undef LS1_SET +#else + d_1(uint32_t, t_dec(l,s), sb_data, w0); +#endif +#endif + +#if defined( LS4_SET ) +#if defined( FL4_SET ) +#undef LS4_SET +#else + d_4(uint32_t, t_dec(l,s), sb_data, w0, w1, w2, w3); +#endif +#endif + +#if defined( IM1_SET ) + d_1(uint32_t, t_dec(i,m), mm_data, v0); +#endif +#if defined( IM4_SET ) + d_4(uint32_t, t_dec(i,m), mm_data, v0, v1, v2, v3); +#endif + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/brg_endian.h b/SSZipArchive/minizip/aes/brg_endian.h new file mode 100644 index 0000000..9ef4af5 --- /dev/null +++ b/SSZipArchive/minizip/aes/brg_endian.h @@ -0,0 +1,127 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2013, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 +*/ + +#ifndef _BRG_ENDIAN_H +#define _BRG_ENDIAN_H + +#define IS_BIG_ENDIAN 4321 /* byte 0 is most significant (mc68k) */ +#define IS_LITTLE_ENDIAN 1234 /* byte 0 is least significant (i386) */ + +/* Include files where endian defines and byteswap functions may reside */ +#if defined( __sun ) +# include +#elif defined( __FreeBSD__ ) || defined( __OpenBSD__ ) || defined( __NetBSD__ ) +# include +#elif defined( BSD ) && ( BSD >= 199103 ) || defined( __APPLE__ ) || \ + defined( __CYGWIN32__ ) || defined( __DJGPP__ ) || defined( __osf__ ) || \ + defined(__pnacl__) +# include +#elif defined( __linux__ ) || defined( __GNUC__ ) || defined( __GNU_LIBRARY__ ) +# if !defined( __MINGW32__ ) && !defined( _AIX ) +# include +# if !defined( __BEOS__ ) +# include +# endif +# endif +#endif + +/* Now attempt to set the define for platform byte order using any */ +/* of the four forms SYMBOL, _SYMBOL, __SYMBOL & __SYMBOL__, which */ +/* seem to encompass most endian symbol definitions */ + +#if defined( BIG_ENDIAN ) && defined( LITTLE_ENDIAN ) +# if defined( BYTE_ORDER ) && BYTE_ORDER == BIG_ENDIAN +# define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN +# elif defined( BYTE_ORDER ) && BYTE_ORDER == LITTLE_ENDIAN +# define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN +# endif +#elif defined( BIG_ENDIAN ) +# define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN +#elif defined( LITTLE_ENDIAN ) +# define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN +#endif + +#if defined( _BIG_ENDIAN ) && defined( _LITTLE_ENDIAN ) +# if defined( _BYTE_ORDER ) && _BYTE_ORDER == _BIG_ENDIAN +# define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN +# elif defined( _BYTE_ORDER ) && _BYTE_ORDER == _LITTLE_ENDIAN +# define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN +# endif +#elif defined( _BIG_ENDIAN ) +# define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN +#elif defined( _LITTLE_ENDIAN ) +# define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN +#endif + +#if defined( __BIG_ENDIAN ) && defined( __LITTLE_ENDIAN ) +# if defined( __BYTE_ORDER ) && __BYTE_ORDER == __BIG_ENDIAN +# define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN +# elif defined( __BYTE_ORDER ) && __BYTE_ORDER == __LITTLE_ENDIAN +# define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN +# endif +#elif defined( __BIG_ENDIAN ) +# define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN +#elif defined( __LITTLE_ENDIAN ) +# define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN +#endif + +#if defined( __BIG_ENDIAN__ ) && defined( __LITTLE_ENDIAN__ ) +# if defined( __BYTE_ORDER__ ) && __BYTE_ORDER__ == __BIG_ENDIAN__ +# define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN +# elif defined( __BYTE_ORDER__ ) && __BYTE_ORDER__ == __LITTLE_ENDIAN__ +# define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN +# endif +#elif defined( __BIG_ENDIAN__ ) +# define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN +#elif defined( __LITTLE_ENDIAN__ ) +# define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN +#endif + +/* if the platform byte order could not be determined, then try to */ +/* set this define using common machine defines */ +#if !defined(PLATFORM_BYTE_ORDER) + +#if defined( __alpha__ ) || defined( __alpha ) || defined( i386 ) || \ + defined( __i386__ ) || defined( _M_I86 ) || defined( _M_IX86 ) || \ + defined( __OS2__ ) || defined( sun386 ) || defined( __TURBOC__ ) || \ + defined( vax ) || defined( vms ) || defined( VMS ) || \ + defined( __VMS ) || defined( _M_X64 ) +# define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN + +#elif defined( AMIGA ) || defined( applec ) || defined( __AS400__ ) || \ + defined( _CRAY ) || defined( __hppa ) || defined( __hp9000 ) || \ + defined( ibm370 ) || defined( mc68000 ) || defined( m68k ) || \ + defined( __MRC__ ) || defined( __MVS__ ) || defined( __MWERKS__ ) || \ + defined( sparc ) || defined( __sparc) || defined( SYMANTEC_C ) || \ + defined( __VOS__ ) || defined( __TIGCC__ ) || defined( __TANDEM ) || \ + defined( THINK_C ) || defined( __VMCMS__ ) || defined( _AIX ) +# define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN + +#elif 0 /* **** EDIT HERE IF NECESSARY **** */ +# define PLATFORM_BYTE_ORDER IS_LITTLE_ENDIAN +#elif 0 /* **** EDIT HERE IF NECESSARY **** */ +# define PLATFORM_BYTE_ORDER IS_BIG_ENDIAN +#else +# error Please edit lines 126 or 128 in brg_endian.h to set the platform byte order +#endif + +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/brg_types.h b/SSZipArchive/minizip/aes/brg_types.h new file mode 100644 index 0000000..307319b --- /dev/null +++ b/SSZipArchive/minizip/aes/brg_types.h @@ -0,0 +1,191 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2013, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 + + The unsigned integer types defined here are of the form uint_t where + is the length of the type; for example, the unsigned 32-bit type is + 'uint32_t'. These are NOT the same as the 'C99 integer types' that are + defined in the inttypes.h and stdint.h headers since attempts to use these + types have shown that support for them is still highly variable. However, + since the latter are of the form uint_t, a regular expression search + and replace (in VC++ search on 'uint_{:z}t' and replace with 'uint\1_t') + can be used to convert the types used here to the C99 standard types. +*/ + +#ifndef _BRG_TYPES_H +#define _BRG_TYPES_H + +#if defined(__cplusplus) +extern "C" { +#endif + +#include +#include + +#if defined( _MSC_VER ) && ( _MSC_VER >= 1300 ) +# include +# define ptrint_t intptr_t +#elif defined( __ECOS__ ) +# define intptr_t unsigned int +# define ptrint_t intptr_t +#elif defined( __GNUC__ ) && ( __GNUC__ >= 3 ) +# define ptrint_t intptr_t +#else +# define ptrint_t int +#endif + +#ifndef BRG_UI32 +# define BRG_UI32 +# if UINT_MAX == 4294967295u +# define li_32(h) 0x##h##u +# elif ULONG_MAX == 4294967295u +# define li_32(h) 0x##h##ul +# elif defined( _CRAY ) +# error This code needs 32-bit data types, which Cray machines do not provide +# else +# error Please define uint32_t as a 32-bit unsigned integer type in brg_types.h +# endif +#endif + +#ifndef BRG_UI64 +# if defined( __BORLANDC__ ) && !defined( __MSDOS__ ) +# define BRG_UI64 +# define li_64(h) 0x##h##ui64 +# elif defined( _MSC_VER ) && ( _MSC_VER < 1300 ) /* 1300 == VC++ 7.0 */ +# define BRG_UI64 +# define li_64(h) 0x##h##ui64 +# elif defined( __sun ) && defined( ULONG_MAX ) && ULONG_MAX == 0xfffffffful +# define BRG_UI64 +# define li_64(h) 0x##h##ull +# elif defined( __MVS__ ) +# define BRG_UI64 +# define li_64(h) 0x##h##ull +# elif defined( UINT_MAX ) && UINT_MAX > 4294967295u +# if UINT_MAX == 18446744073709551615u +# define BRG_UI64 +# define li_64(h) 0x##h##u +# endif +# elif defined( ULONG_MAX ) && ULONG_MAX > 4294967295u +# if ULONG_MAX == 18446744073709551615ul +# define BRG_UI64 +# define li_64(h) 0x##h##ul +# endif +# elif defined( ULLONG_MAX ) && ULLONG_MAX > 4294967295u +# if ULLONG_MAX == 18446744073709551615ull +# define BRG_UI64 +# define li_64(h) 0x##h##ull +# endif +# elif defined( ULONG_LONG_MAX ) && ULONG_LONG_MAX > 4294967295u +# if ULONG_LONG_MAX == 18446744073709551615ull +# define BRG_UI64 +# define li_64(h) 0x##h##ull +# endif +# endif +#endif + +#if !defined( BRG_UI64 ) +# if defined( NEED_UINT_64T ) +# error Please define uint64_t as an unsigned 64 bit type in brg_types.h +# endif +#endif + +#ifndef RETURN_VALUES +# define RETURN_VALUES +# if defined( DLL_EXPORT ) +# if defined( _MSC_VER ) || defined ( __INTEL_COMPILER ) +# define VOID_RETURN __declspec( dllexport ) void __stdcall +# define INT_RETURN __declspec( dllexport ) int __stdcall +# elif defined( __GNUC__ ) +# define VOID_RETURN __declspec( __dllexport__ ) void +# define INT_RETURN __declspec( __dllexport__ ) int +# else +# error Use of the DLL is only available on the Microsoft, Intel and GCC compilers +# endif +# elif defined( DLL_IMPORT ) +# if defined( _MSC_VER ) || defined ( __INTEL_COMPILER ) +# define VOID_RETURN __declspec( dllimport ) void __stdcall +# define INT_RETURN __declspec( dllimport ) int __stdcall +# elif defined( __GNUC__ ) +# define VOID_RETURN __declspec( __dllimport__ ) void +# define INT_RETURN __declspec( __dllimport__ ) int +# else +# error Use of the DLL is only available on the Microsoft, Intel and GCC compilers +# endif +# elif defined( __WATCOMC__ ) +# define VOID_RETURN void __cdecl +# define INT_RETURN int __cdecl +# else +# define VOID_RETURN void +# define INT_RETURN int +# endif +#endif + +/* These defines are used to detect and set the memory alignment of pointers. + Note that offsets are in bytes. + + ALIGN_OFFSET(x,n) return the positive or zero offset of + the memory addressed by the pointer 'x' + from an address that is aligned on an + 'n' byte boundary ('n' is a power of 2) + + ALIGN_FLOOR(x,n) return a pointer that points to memory + that is aligned on an 'n' byte boundary + and is not higher than the memory address + pointed to by 'x' ('n' is a power of 2) + + ALIGN_CEIL(x,n) return a pointer that points to memory + that is aligned on an 'n' byte boundary + and is not lower than the memory address + pointed to by 'x' ('n' is a power of 2) +*/ + +#define ALIGN_OFFSET(x,n) (((ptrint_t)(x)) & ((n) - 1)) +#define ALIGN_FLOOR(x,n) ((uint8_t*)(x) - ( ((ptrint_t)(x)) & ((n) - 1))) +#define ALIGN_CEIL(x,n) ((uint8_t*)(x) + (-((ptrint_t)(x)) & ((n) - 1))) + +/* These defines are used to declare buffers in a way that allows + faster operations on longer variables to be used. In all these + defines 'size' must be a power of 2 and >= 8. NOTE that the + buffer size is in bytes but the type length is in bits + + UNIT_TYPEDEF(x,size) declares a variable 'x' of length + 'size' bits + + BUFR_TYPEDEF(x,size,bsize) declares a buffer 'x' of length 'bsize' + bytes defined as an array of variables + each of 'size' bits (bsize must be a + multiple of size / 8) + + UNIT_CAST(x,size) casts a variable to a type of + length 'size' bits + + UPTR_CAST(x,size) casts a pointer to a pointer to a + varaiable of length 'size' bits +*/ + +#define UI_TYPE(size) uint##size##_t +#define UNIT_TYPEDEF(x,size) typedef UI_TYPE(size) x +#define BUFR_TYPEDEF(x,size,bsize) typedef UI_TYPE(size) x[bsize / (size >> 3)] +#define UNIT_CAST(x,size) ((UI_TYPE(size) )(x)) +#define UPTR_CAST(x,size) ((UI_TYPE(size)*)(x)) + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/fileenc.c b/SSZipArchive/minizip/aes/fileenc.c new file mode 100644 index 0000000..31a8994 --- /dev/null +++ b/SSZipArchive/minizip/aes/fileenc.c @@ -0,0 +1,145 @@ +/* + --------------------------------------------------------------------------- + Copyright (c) 2002, Dr Brian Gladman < >, Worcester, UK. + All rights reserved. + + LICENSE TERMS + + The free distribution and use of this software in both source and binary + form is allowed (with or without changes) provided that: + + 1. distributions of this source code include the above copyright + notice, this list of conditions and the following disclaimer; + + 2. distributions in binary form include the above copyright + notice, this list of conditions and the following disclaimer + in the documentation and/or other associated materials; + + 3. the copyright holder's name is not used to endorse products + built using this software without specific written permission. + + ALTERNATIVELY, provided that this notice is retained in full, this product + may be distributed under the terms of the GNU General Public License (GPL), + in which case the provisions of the GPL apply INSTEAD OF those given above. + + DISCLAIMER + + This software is provided 'as is' with no explicit or implied warranties + in respect of its properties, including, but not limited to, correctness + and/or fitness for purpose. + ------------------------------------------------------------------------- + Issue Date: 24/01/2003 + + This file implements password based file encryption and authentication + using AES in CTR mode, HMAC-SHA1 authentication and RFC2898 password + based key derivation. + +*/ + +#include + +#include "fileenc.h" + +#if defined(__cplusplus) +extern "C" +{ +#endif + +/* subroutine for data encryption/decryption */ +/* this could be speeded up a lot by aligning */ +/* buffers and using 32 bit operations */ + +static void encr_data(unsigned char data[], unsigned long d_len, fcrypt_ctx cx[1]) +{ + unsigned int i = 0, pos = cx->encr_pos; + + while (i < d_len) + { + if (pos == AES_BLOCK_SIZE) + { + unsigned int j = 0; + /* increment encryption nonce */ + while (j < 8 && !++cx->nonce[j]) + ++j; + /* encrypt the nonce to form next xor buffer */ + aes_encrypt(cx->nonce, cx->encr_bfr, cx->encr_ctx); + pos = 0; + } + + data[i++] ^= cx->encr_bfr[pos++]; + } + + cx->encr_pos = pos; +} + +int fcrypt_init( + int mode, /* the mode to be used (input) */ + const unsigned char pwd[], /* the user specified password (input) */ + unsigned int pwd_len, /* the length of the password (input) */ + const unsigned char salt[], /* the salt (input) */ +#ifdef PASSWORD_VERIFIER + unsigned char pwd_ver[PWD_VER_LENGTH], /* 2 byte password verifier (output) */ +#endif + fcrypt_ctx cx[1]) /* the file encryption context (output) */ +{ unsigned char kbuf[2 * MAX_KEY_LENGTH + PWD_VER_LENGTH]; + + if (pwd_len > MAX_PWD_LENGTH) + return PASSWORD_TOO_LONG; + + if (mode < 1 || mode > 3) + return BAD_MODE; + + cx->mode = mode; + cx->pwd_len = pwd_len; + + /* derive the encryption and authentication keys and the password verifier */ + derive_key(pwd, pwd_len, salt, SALT_LENGTH(mode), KEYING_ITERATIONS, + kbuf, 2 * KEY_LENGTH(mode) + PWD_VER_LENGTH); + + /* initialise the encryption nonce and buffer pos */ + cx->encr_pos = AES_BLOCK_SIZE; + /* if we need a random component in the encryption */ + /* nonce, this is where it would have to be set */ + memset(cx->nonce, 0, AES_BLOCK_SIZE * sizeof(unsigned char)); + + /* initialise for encryption using key 1 */ + aes_encrypt_key(kbuf, KEY_LENGTH(mode), cx->encr_ctx); + + /* initialise for authentication using key 2 */ + hmac_sha_begin(HMAC_SHA1, cx->auth_ctx); + hmac_sha_key(kbuf + KEY_LENGTH(mode), KEY_LENGTH(mode), cx->auth_ctx); + +#ifdef PASSWORD_VERIFIER + memcpy(pwd_ver, kbuf + 2 * KEY_LENGTH(mode), PWD_VER_LENGTH); +#endif + + return GOOD_RETURN; +} + +/* perform 'in place' encryption and authentication */ + +void fcrypt_encrypt(unsigned char data[], unsigned int data_len, fcrypt_ctx cx[1]) +{ + encr_data(data, data_len, cx); + hmac_sha_data(data, data_len, cx->auth_ctx); +} + +/* perform 'in place' authentication and decryption */ + +void fcrypt_decrypt(unsigned char data[], unsigned int data_len, fcrypt_ctx cx[1]) +{ + hmac_sha_data(data, data_len, cx->auth_ctx); + encr_data(data, data_len, cx); +} + +/* close encryption/decryption and return the MAC value */ + +int fcrypt_end(unsigned char mac[], fcrypt_ctx cx[1]) +{ + hmac_sha_end(mac, MAC_LENGTH(cx->mode), cx->auth_ctx); + return MAC_LENGTH(cx->mode); /* return MAC length in bytes */ +} + +#if defined(__cplusplus) +} +#endif diff --git a/SSZipArchive/minizip/aes/fileenc.h b/SSZipArchive/minizip/aes/fileenc.h new file mode 100644 index 0000000..9c0250e --- /dev/null +++ b/SSZipArchive/minizip/aes/fileenc.h @@ -0,0 +1,121 @@ +/* + --------------------------------------------------------------------------- + Copyright (c) 2002, Dr Brian Gladman < >, Worcester, UK. + All rights reserved. + + LICENSE TERMS + + The free distribution and use of this software in both source and binary + form is allowed (with or without changes) provided that: + + 1. distributions of this source code include the above copyright + notice, this list of conditions and the following disclaimer; + + 2. distributions in binary form include the above copyright + notice, this list of conditions and the following disclaimer + in the documentation and/or other associated materials; + + 3. the copyright holder's name is not used to endorse products + built using this software without specific written permission. + + ALTERNATIVELY, provided that this notice is retained in full, this product + may be distributed under the terms of the GNU General Public License (GPL), + in which case the provisions of the GPL apply INSTEAD OF those given above. + + DISCLAIMER + + This software is provided 'as is' with no explicit or implied warranties + in respect of its properties, including, but not limited to, correctness + and/or fitness for purpose. + --------------------------------------------------------------------------- + Issue Date: 24/01/2003 + + This file contains the header file for fileenc.c, which implements password + based file encryption and authentication using AES in CTR mode, HMAC-SHA1 + authentication and RFC2898 password based key derivation. +*/ + +#ifndef _FENC_H +#define _FENC_H + +#include "aes.h" +#include "hmac.h" +#include "pwd2key.h" + +#define PASSWORD_VERIFIER + +#define MAX_KEY_LENGTH 32 +#define MAX_PWD_LENGTH 128 +#define MAX_SALT_LENGTH 16 +#define KEYING_ITERATIONS 1000 + +#ifdef PASSWORD_VERIFIER +#define PWD_VER_LENGTH 2 +#else +#define PWD_VER_LENGTH 0 +#endif + +#define GOOD_RETURN 0 +#define PASSWORD_TOO_LONG -100 +#define BAD_MODE -101 + +/* + Field lengths (in bytes) versus File Encryption Mode (0 < mode < 4) + + Mode Key Salt MAC Overhead + 1 16 8 10 18 + 2 24 12 10 22 + 3 32 16 10 26 + + The following macros assume that the mode value is correct. +*/ + +#define KEY_LENGTH(mode) (8 * (mode & 3) + 8) +#define SALT_LENGTH(mode) (4 * (mode & 3) + 4) +#define MAC_LENGTH(mode) (10) + +/* the context for file encryption */ + +#if defined(__cplusplus) +extern "C" +{ +#endif + +typedef struct +{ unsigned char nonce[AES_BLOCK_SIZE]; /* the CTR nonce */ + unsigned char encr_bfr[AES_BLOCK_SIZE]; /* encrypt buffer */ + aes_encrypt_ctx encr_ctx[1]; /* encryption context */ + hmac_ctx auth_ctx[1]; /* authentication context */ + unsigned int encr_pos; /* block position (enc) */ + unsigned int pwd_len; /* password length */ + unsigned int mode; /* File encryption mode */ +} fcrypt_ctx; + +/* initialise file encryption or decryption */ + +int fcrypt_init( + int mode, /* the mode to be used (input) */ + const unsigned char pwd[], /* the user specified password (input) */ + unsigned int pwd_len, /* the length of the password (input) */ + const unsigned char salt[], /* the salt (input) */ +#ifdef PASSWORD_VERIFIER + unsigned char pwd_ver[PWD_VER_LENGTH], /* 2 byte password verifier (output) */ +#endif + fcrypt_ctx cx[1]); /* the file encryption context (output) */ + +/* perform 'in place' encryption or decryption and authentication */ + +void fcrypt_encrypt(unsigned char data[], unsigned int data_len, fcrypt_ctx cx[1]); +void fcrypt_decrypt(unsigned char data[], unsigned int data_len, fcrypt_ctx cx[1]); + +/* close encryption/decryption and return the MAC value */ +/* the return value is the length of the MAC */ + +int fcrypt_end(unsigned char mac[], /* the MAC value (output) */ + fcrypt_ctx cx[1]); /* the context (input) */ + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/hmac.c b/SSZipArchive/minizip/aes/hmac.c new file mode 100644 index 0000000..face1fb --- /dev/null +++ b/SSZipArchive/minizip/aes/hmac.c @@ -0,0 +1,209 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2010, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 + +This is an implementation of HMAC, the FIPS standard keyed hash function +*/ + +#include "hmac.h" + +#if defined(__cplusplus) +extern "C" +{ +#endif + +/* initialise the HMAC context to zero */ +int hmac_sha_begin(enum hmac_hash hash, hmac_ctx cx[1]) +{ + memset(cx, 0, sizeof(hmac_ctx)); + switch(hash) + { +#ifdef SHA_1 + case HMAC_SHA1: + cx->f_begin = (hf_begin *)sha1_begin; + cx->f_hash = (hf_hash *)sha1_hash; + cx->f_end = (hf_end *)sha1_end; + cx->input_len = SHA1_BLOCK_SIZE; + cx->output_len = SHA1_DIGEST_SIZE; + break; +#endif +#ifdef SHA_224 + case HMAC_SHA224: + cx->f_begin = (hf_begin *)sha224_begin; + cx->f_hash = (hf_hash *)sha224_hash; + cx->f_end = (hf_end *)sha224_end; + cx->input_len = SHA224_BLOCK_SIZE; + cx->output_len = SHA224_DIGEST_SIZE; + break; +#endif +#ifdef SHA_256 + case HMAC_SHA256: + cx->f_begin = (hf_begin *)sha256_begin; + cx->f_hash = (hf_hash *)sha256_hash; + cx->f_end = (hf_end *)sha256_end; + cx->input_len = SHA256_BLOCK_SIZE; + cx->output_len = SHA256_DIGEST_SIZE; + break; +#endif +#ifdef SHA_384 + case HMAC_SHA384: + cx->f_begin = (hf_begin *)sha384_begin; + cx->f_hash = (hf_hash *)sha384_hash; + cx->f_end = (hf_end *)sha384_end; + cx->input_len = SHA384_BLOCK_SIZE; + cx->output_len = SHA384_DIGEST_SIZE; + break; +#endif +#ifdef SHA_512 + case HMAC_SHA512: + cx->f_begin = (hf_begin *)sha512_begin; + cx->f_hash = (hf_hash *)sha512_hash; + cx->f_end = (hf_end *)sha512_end; + cx->input_len = SHA512_BLOCK_SIZE; + cx->output_len = SHA512_DIGEST_SIZE; + break; + case HMAC_SHA512_256: + cx->f_begin = (hf_begin *)sha512_256_begin; + cx->f_hash = (hf_hash *)sha512_256_hash; + cx->f_end = (hf_end *)sha512_256_end; + cx->input_len = SHA512_256_BLOCK_SIZE; + cx->output_len = SHA512_256_DIGEST_SIZE; + break; + case HMAC_SHA512_224: + cx->f_begin = (hf_begin *)sha512_224_begin; + cx->f_hash = (hf_hash *)sha512_224_hash; + cx->f_end = (hf_end *)sha512_224_end; + cx->input_len = SHA512_224_BLOCK_SIZE; + cx->output_len = SHA512_224_DIGEST_SIZE; + break; + case HMAC_SHA512_192: + cx->f_begin = (hf_begin *)sha512_192_begin; + cx->f_hash = (hf_hash *)sha512_192_hash; + cx->f_end = (hf_end *)sha512_192_end; + cx->input_len = SHA512_192_BLOCK_SIZE; + cx->output_len = SHA512_192_DIGEST_SIZE; + break; + case HMAC_SHA512_128: + cx->f_begin = (hf_begin *)sha512_128_begin; + cx->f_hash = (hf_hash *)sha512_128_hash; + cx->f_end = (hf_begin *)sha512_128_end; + cx->input_len = SHA512_128_BLOCK_SIZE; + cx->output_len = SHA512_128_DIGEST_SIZE; + break; +#endif + } + return (int)cx->output_len; +} + +/* input the HMAC key (can be called multiple times) */ +int hmac_sha_key(const unsigned char key[], unsigned long key_len, hmac_ctx cx[1]) +{ + if(cx->klen == HMAC_IN_DATA) /* error if further key input */ + return EXIT_FAILURE; /* is attempted in data mode */ + + if(cx->klen + key_len > cx->input_len) /* if the key has to be hashed */ + { + if(cx->klen <= cx->input_len) /* if the hash has not yet been */ + { /* started, initialise it and */ + cx->f_begin(cx->sha_ctx); /* hash stored key characters */ + cx->f_hash(cx->key, cx->klen, cx->sha_ctx); + } + + cx->f_hash(key, key_len, cx->sha_ctx); /* hash long key data into hash */ + } + else /* otherwise store key data */ + memcpy(cx->key + cx->klen, key, key_len); + + cx->klen += key_len; /* update the key length count */ + return EXIT_SUCCESS; +} + +/* input the HMAC data (can be called multiple times) - */ +/* note that this call terminates the key input phase */ +void hmac_sha_data(const unsigned char data[], unsigned long data_len, hmac_ctx cx[1]) +{ unsigned int i; + + if(cx->klen != HMAC_IN_DATA) /* if not yet in data phase */ + { + if(cx->klen > cx->input_len) /* if key is being hashed */ + { /* complete the hash and */ + cx->f_end(cx->key, cx->sha_ctx); /* store the result as the */ + cx->klen = cx->output_len; /* key and set new length */ + } + + /* pad the key if necessary */ + memset(cx->key + cx->klen, 0, cx->input_len - cx->klen); + + /* xor ipad into key value */ + for(i = 0; i < (cx->input_len >> 2); ++i) + ((uint32_t*)cx->key)[i] ^= 0x36363636; + + /* and start hash operation */ + cx->f_begin(cx->sha_ctx); + cx->f_hash(cx->key, cx->input_len, cx->sha_ctx); + + /* mark as now in data mode */ + cx->klen = HMAC_IN_DATA; + } + + /* hash the data (if any) */ + if(data_len) + cx->f_hash(data, data_len, cx->sha_ctx); +} + +/* compute and output the MAC value */ +void hmac_sha_end(unsigned char mac[], unsigned long mac_len, hmac_ctx cx[1]) +{ unsigned char dig[HMAC_MAX_OUTPUT_SIZE]; + unsigned int i; + + /* if no data has been entered perform a null data phase */ + if(cx->klen != HMAC_IN_DATA) + hmac_sha_data((const unsigned char*)0, 0, cx); + + cx->f_end(dig, cx->sha_ctx); /* complete the inner hash */ + + /* set outer key value using opad and removing ipad */ + for(i = 0; i < (cx->input_len >> 2); ++i) + ((uint32_t*)cx->key)[i] ^= 0x36363636 ^ 0x5c5c5c5c; + + /* perform the outer hash operation */ + cx->f_begin(cx->sha_ctx); + cx->f_hash(cx->key, cx->input_len, cx->sha_ctx); + cx->f_hash(dig, cx->output_len, cx->sha_ctx); + cx->f_end(dig, cx->sha_ctx); + + /* output the hash value */ + for(i = 0; i < mac_len; ++i) + mac[i] = dig[i]; +} + +/* 'do it all in one go' subroutine */ +void hmac_sha(enum hmac_hash hash, const unsigned char key[], unsigned long key_len, + const unsigned char data[], unsigned long data_len, + unsigned char mac[], unsigned long mac_len) +{ hmac_ctx cx[1]; + + hmac_sha_begin(hash, cx); + hmac_sha_key(key, key_len, cx); + hmac_sha_data(data, data_len, cx); + hmac_sha_end(mac, mac_len, cx); +} + +#if defined(__cplusplus) +} +#endif diff --git a/SSZipArchive/minizip/aes/hmac.h b/SSZipArchive/minizip/aes/hmac.h new file mode 100644 index 0000000..46956c4 --- /dev/null +++ b/SSZipArchive/minizip/aes/hmac.h @@ -0,0 +1,119 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2010, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 + +This is an implementation of HMAC, the FIPS standard keyed hash function +*/ + +#ifndef _HMAC2_H +#define _HMAC2_H + +#include +#include + +#if defined(__cplusplus) +extern "C" +{ +#endif + +#include "sha1.h" + +#if defined(SHA_224) || defined(SHA_256) || defined(SHA_384) || defined(SHA_512) +#define HMAC_MAX_OUTPUT_SIZE SHA2_MAX_DIGEST_SIZE +#define HMAC_MAX_BLOCK_SIZE SHA2_MAX_BLOCK_SIZE +#else +#define HMAC_MAX_OUTPUT_SIZE SHA1_DIGEST_SIZE +#define HMAC_MAX_BLOCK_SIZE SHA1_BLOCK_SIZE +#endif + +#define HMAC_IN_DATA 0xffffffff + +enum hmac_hash +{ +#ifdef SHA_1 + HMAC_SHA1, +#endif +#ifdef SHA_224 + HMAC_SHA224, +#endif +#ifdef SHA_256 + HMAC_SHA256, +#endif +#ifdef SHA_384 + HMAC_SHA384, +#endif +#ifdef SHA_512 + HMAC_SHA512, + HMAC_SHA512_256, + HMAC_SHA512_224, + HMAC_SHA512_192, + HMAC_SHA512_128 +#endif +}; + +typedef VOID_RETURN hf_begin(void*); +typedef VOID_RETURN hf_hash(const void*, unsigned long len, void*); +typedef VOID_RETURN hf_end(void*, void*); + +typedef struct +{ hf_begin *f_begin; + hf_hash *f_hash; + hf_end *f_end; + unsigned char key[HMAC_MAX_BLOCK_SIZE]; + union + { +#ifdef SHA_1 + sha1_ctx u_sha1; +#endif +#ifdef SHA_224 + sha224_ctx u_sha224; +#endif +#ifdef SHA_256 + sha256_ctx u_sha256; +#endif +#ifdef SHA_384 + sha384_ctx u_sha384; +#endif +#ifdef SHA_512 + sha512_ctx u_sha512; +#endif + } sha_ctx[1]; + unsigned long input_len; + unsigned long output_len; + unsigned long klen; +} hmac_ctx; + +/* returns the length of hash digest for the hash used */ +/* mac_len must not be greater than this */ +int hmac_sha_begin(enum hmac_hash hash, hmac_ctx cx[1]); + +int hmac_sha_key(const unsigned char key[], unsigned long key_len, hmac_ctx cx[1]); + +void hmac_sha_data(const unsigned char data[], unsigned long data_len, hmac_ctx cx[1]); + +void hmac_sha_end(unsigned char mac[], unsigned long mac_len, hmac_ctx cx[1]); + +void hmac_sha(enum hmac_hash hash, const unsigned char key[], unsigned long key_len, + const unsigned char data[], unsigned long data_len, + unsigned char mac[], unsigned long mac_len); + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/prng.c b/SSZipArchive/minizip/aes/prng.c new file mode 100644 index 0000000..b90fcae --- /dev/null +++ b/SSZipArchive/minizip/aes/prng.c @@ -0,0 +1,155 @@ +/* + --------------------------------------------------------------------------- + Copyright (c) 2002, Dr Brian Gladman < >, Worcester, UK. + All rights reserved. + + LICENSE TERMS + + The free distribution and use of this software in both source and binary + form is allowed (with or without changes) provided that: + + 1. distributions of this source code include the above copyright + notice, this list of conditions and the following disclaimer; + + 2. distributions in binary form include the above copyright + notice, this list of conditions and the following disclaimer + in the documentation and/or other associated materials; + + 3. the copyright holder's name is not used to endorse products + built using this software without specific written permission. + + ALTERNATIVELY, provided that this notice is retained in full, this product + may be distributed under the terms of the GNU General Public License (GPL), + in which case the provisions of the GPL apply INSTEAD OF those given above. + + DISCLAIMER + + This software is provided 'as is' with no explicit or implied warranties + in respect of its properties, including, but not limited to, correctness + and/or fitness for purpose. + --------------------------------------------------------------------------- + Issue Date: 24/01/2003 + + This file implements a random data pool based on the use of an external + entropy function. It is based on the ideas advocated by Peter Gutmann in + his work on pseudo random sequence generators. It is not a 'paranoid' + random sequence generator and no attempt is made to protect the pool + from prying eyes either by memory locking or by techniques to obscure + its location in memory. +*/ + +#include +#include "prng.h" + +#if defined(__cplusplus) +extern "C" +{ +#endif + +/* mix a random data pool using the SHA1 compression function (as */ +/* suggested by Peter Gutmann in his paper on random pools) */ + +static void prng_mix(unsigned char buf[]) +{ unsigned int i, len; + sha1_ctx ctx[1]; + + /*lint -e{663} unusual array to pointer conversion */ + for(i = 0; i < PRNG_POOL_SIZE; i += SHA1_DIGEST_SIZE) + { + /* copy digest size pool block into SHA1 hash block */ + memcpy(ctx->hash, buf + (i ? i : PRNG_POOL_SIZE) + - SHA1_DIGEST_SIZE, SHA1_DIGEST_SIZE); + + /* copy data from pool into the SHA1 data buffer */ + len = PRNG_POOL_SIZE - i; + memcpy(ctx->wbuf, buf + i, (len > SHA1_BLOCK_SIZE ? SHA1_BLOCK_SIZE : len)); + + if(len < SHA1_BLOCK_SIZE) + memcpy(((char*)ctx->wbuf) + len, buf, SHA1_BLOCK_SIZE - len); + + /* compress using the SHA1 compression function */ + sha1_compile(ctx); + + /* put digest size block back into the random pool */ + memcpy(buf + i, ctx->hash, SHA1_DIGEST_SIZE); + } +} + +/* refresh the output buffer and update the random pool by adding */ +/* entropy and remixing */ + +static void update_pool(prng_ctx ctx[1]) +{ unsigned int i = 0; + + /* transfer random pool data to the output buffer */ + memcpy(ctx->obuf, ctx->rbuf, PRNG_POOL_SIZE); + + /* enter entropy data into the pool */ + while(i < PRNG_POOL_SIZE) + i += ctx->entropy(ctx->rbuf + i, PRNG_POOL_SIZE - i); + + /* invert and xor the original pool data into the pool */ + for(i = 0; i < PRNG_POOL_SIZE; ++i) + ctx->rbuf[i] ^= ~ctx->obuf[i]; + + /* mix the pool and the output buffer */ + prng_mix(ctx->rbuf); + prng_mix(ctx->obuf); +} + +void prng_init(prng_entropy_fn fun, prng_ctx ctx[1]) +{ int i; + + /* clear the buffers and the counter in the context */ + memset(ctx, 0, sizeof(prng_ctx)); + + /* set the pointer to the entropy collection function */ + ctx->entropy = fun; + + /* initialise the random data pool */ + update_pool(ctx); + + /* mix the pool a minimum number of times */ + for(i = 0; i < PRNG_MIN_MIX; ++i) + prng_mix(ctx->rbuf); + + /* update the pool to prime the pool output buffer */ + update_pool(ctx); +} + +/* provide random bytes from the random data pool */ + +void prng_rand(unsigned char data[], unsigned int data_len, prng_ctx ctx[1]) +{ unsigned char *rp = data; + unsigned int len, pos = ctx->pos; + + while(data_len) + { + /* transfer 'data_len' bytes (or the number of bytes remaining */ + /* the pool output buffer if less) into the output */ + len = (data_len < PRNG_POOL_SIZE - pos ? data_len : PRNG_POOL_SIZE - pos); + memcpy(rp, ctx->obuf + pos, len); + rp += len; /* update ouput buffer position pointer */ + pos += len; /* update pool output buffer pointer */ + data_len -= len; /* update the remaining data count */ + + /* refresh the random pool if necessary */ + if(pos == PRNG_POOL_SIZE) + { + update_pool(ctx); pos = 0; + } + } + + ctx->pos = pos; +} + +void prng_end(prng_ctx ctx[1]) +{ + /* ensure the data in the context is destroyed */ + memset(ctx, 0, sizeof(prng_ctx)); +} + +#if defined(__cplusplus) +} +#endif + diff --git a/SSZipArchive/minizip/aes/prng.h b/SSZipArchive/minizip/aes/prng.h new file mode 100644 index 0000000..9a77426 --- /dev/null +++ b/SSZipArchive/minizip/aes/prng.h @@ -0,0 +1,82 @@ +/* + --------------------------------------------------------------------------- + Copyright (c) 2002, Dr Brian Gladman < >, Worcester, UK. + All rights reserved. + + LICENSE TERMS + + The free distribution and use of this software in both source and binary + form is allowed (with or without changes) provided that: + + 1. distributions of this source code include the above copyright + notice, this list of conditions and the following disclaimer; + + 2. distributions in binary form include the above copyright + notice, this list of conditions and the following disclaimer + in the documentation and/or other associated materials; + + 3. the copyright holder's name is not used to endorse products + built using this software without specific written permission. + + ALTERNATIVELY, provided that this notice is retained in full, this product + may be distributed under the terms of the GNU General Public License (GPL), + in which case the provisions of the GPL apply INSTEAD OF those given above. + + DISCLAIMER + + This software is provided 'as is' with no explicit or implied warranties + in respect of its properties, including, but not limited to, correctness + and/or fitness for purpose. + --------------------------------------------------------------------------- + Issue Date: 24/01/2003 + + This is the header file for an implementation of a random data pool based on + the use of an external entropy function (inspired by Peter Gutmann's work). +*/ + +#ifndef _PRNG_H +#define _PRNG_H + +#include "sha1.h" + +#define PRNG_POOL_LEN 256 /* minimum random pool size */ +#define PRNG_MIN_MIX 20 /* min initial pool mixing iterations */ + +/* ensure that pool length is a multiple of the SHA1 digest size */ + +#define PRNG_POOL_SIZE (SHA1_DIGEST_SIZE * (1 + (PRNG_POOL_LEN - 1) / SHA1_DIGEST_SIZE)) + +#if defined(__cplusplus) +extern "C" +{ +#endif + +/* A function for providing entropy is a parameter in the prng_init() */ +/* call. This function has the following form and returns a maximum */ +/* of 'len' bytes of pseudo random data in the buffer 'buf'. It can */ +/* return less than 'len' bytes but will be repeatedly called for more */ +/* data in this case. */ + +typedef int (*prng_entropy_fn)(unsigned char buf[], unsigned int len); + +typedef struct +{ unsigned char rbuf[PRNG_POOL_SIZE]; /* the random pool */ + unsigned char obuf[PRNG_POOL_SIZE]; /* pool output buffer */ + unsigned int pos; /* output buffer position */ + prng_entropy_fn entropy; /* entropy function pointer */ +} prng_ctx; + +/* initialise the random stream generator */ +void prng_init(prng_entropy_fn fun, prng_ctx ctx[1]); + +/* obtain random bytes from the generator */ +void prng_rand(unsigned char data[], unsigned int data_len, prng_ctx ctx[1]); + +/* close the random stream generator */ +void prng_end(prng_ctx ctx[1]); + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/pwd2key.c b/SSZipArchive/minizip/aes/pwd2key.c new file mode 100644 index 0000000..86c97c4 --- /dev/null +++ b/SSZipArchive/minizip/aes/pwd2key.c @@ -0,0 +1,181 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2010, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 + +This is an implementation of RFC2898, which specifies key derivation from +a password and a salt value. +*/ + +#include +#include "hmac.h" + +#if defined(__cplusplus) +extern "C" +{ +#endif + +void derive_key(const unsigned char pwd[], /* the PASSWORD */ + unsigned int pwd_len, /* and its length */ + const unsigned char salt[], /* the SALT and its */ + unsigned int salt_len, /* length */ + unsigned int iter, /* the number of iterations */ + unsigned char key[], /* space for the output key */ + unsigned int key_len)/* and its required length */ +{ + unsigned int i, j, k, n_blk, h_size; + unsigned char uu[HMAC_MAX_OUTPUT_SIZE], ux[HMAC_MAX_OUTPUT_SIZE]; + hmac_ctx c1[1], c2[1], c3[1]; + + /* set HMAC context (c1) for password */ + h_size = hmac_sha_begin(HMAC_SHA1, c1); + hmac_sha_key(pwd, pwd_len, c1); + + /* set HMAC context (c2) for password and salt */ + memcpy(c2, c1, sizeof(hmac_ctx)); + hmac_sha_data(salt, salt_len, c2); + + /* find the number of SHA blocks in the key */ + n_blk = 1 + (key_len - 1) / h_size; + + for(i = 0; i < n_blk; ++i) /* for each block in key */ + { + /* ux[] holds the running xor value */ + memset(ux, 0, h_size); + + /* set HMAC context (c3) for password and salt */ + memcpy(c3, c2, sizeof(hmac_ctx)); + + /* enter additional data for 1st block into uu */ + uu[0] = (unsigned char)((i + 1) >> 24); + uu[1] = (unsigned char)((i + 1) >> 16); + uu[2] = (unsigned char)((i + 1) >> 8); + uu[3] = (unsigned char)(i + 1); + + /* this is the key mixing iteration */ + for(j = 0, k = 4; j < iter; ++j) + { + /* add previous round data to HMAC */ + hmac_sha_data(uu, k, c3); + + /* obtain HMAC for uu[] */ + hmac_sha_end(uu, h_size, c3); + + /* xor into the running xor block */ + for(k = 0; k < h_size; ++k) + ux[k] ^= uu[k]; + + /* set HMAC context (c3) for password */ + memcpy(c3, c1, sizeof(hmac_ctx)); + } + + /* compile key blocks into the key output */ + j = 0; k = i * h_size; + while(j < h_size && k < key_len) + key[k++] = ux[j++]; + } +} + +#ifdef TEST + +#include + +struct +{ unsigned int pwd_len; + unsigned int salt_len; + unsigned int it_count; + unsigned char *pwd; + unsigned char salt[32]; + unsigned char key[32]; +} tests[] = +{ + { 8, 4, 5, (unsigned char*)"password", + { + 0x12, 0x34, 0x56, 0x78 + }, + { + 0x5c, 0x75, 0xce, 0xf0, 0x1a, 0x96, 0x0d, 0xf7, + 0x4c, 0xb6, 0xb4, 0x9b, 0x9e, 0x38, 0xe6, 0xb5 + } + }, + { 8, 8, 5, (unsigned char*)"password", + { + 0x12, 0x34, 0x56, 0x78, 0x78, 0x56, 0x34, 0x12 + }, + { + 0xd1, 0xda, 0xa7, 0x86, 0x15, 0xf2, 0x87, 0xe6, + 0xa1, 0xc8, 0xb1, 0x20, 0xd7, 0x06, 0x2a, 0x49 + } + }, + { 8, 21, 1, (unsigned char*)"password", + { + "ATHENA.MIT.EDUraeburn" + }, + { + 0xcd, 0xed, 0xb5, 0x28, 0x1b, 0xb2, 0xf8, 0x01, + 0x56, 0x5a, 0x11, 0x22, 0xb2, 0x56, 0x35, 0x15 + } + }, + { 8, 21, 2, (unsigned char*)"password", + { + "ATHENA.MIT.EDUraeburn" + }, + { + 0x01, 0xdb, 0xee, 0x7f, 0x4a, 0x9e, 0x24, 0x3e, + 0x98, 0x8b, 0x62, 0xc7, 0x3c, 0xda, 0x93, 0x5d + } + }, + { 8, 21, 1200, (unsigned char*)"password", + { + "ATHENA.MIT.EDUraeburn" + }, + { + 0x5c, 0x08, 0xeb, 0x61, 0xfd, 0xf7, 0x1e, 0x4e, + 0x4e, 0xc3, 0xcf, 0x6b, 0xa1, 0xf5, 0x51, 0x2b + } + } +}; + +int main() +{ unsigned int i, j, key_len = 256; + unsigned char key[256]; + + printf("\nTest of RFC2898 Password Based Key Derivation"); + for(i = 0; i < 5; ++i) + { + derive_key(tests[i].pwd, tests[i].pwd_len, tests[i].salt, + tests[i].salt_len, tests[i].it_count, key, key_len); + + printf("\ntest %i: ", i + 1); + printf("key %s", memcmp(tests[i].key, key, 16) ? "is bad" : "is good"); + for(j = 0; j < key_len && j < 64; j += 4) + { + if(j % 16 == 0) + printf("\n"); + printf("0x%02x%02x%02x%02x ", key[j], key[j + 1], key[j + 2], key[j + 3]); + } + printf(j < key_len ? " ... \n" : "\n"); + } + printf("\n"); + return 0; +} + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/pwd2key.h b/SSZipArchive/minizip/aes/pwd2key.h new file mode 100644 index 0000000..b9ba421 --- /dev/null +++ b/SSZipArchive/minizip/aes/pwd2key.h @@ -0,0 +1,45 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2010, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 + +This is an implementation of RFC2898, which specifies key derivation from +a password and a salt value. +*/ + +#ifndef PWD2KEY_H +#define PWD2KEY_H + +#if defined(__cplusplus) +extern "C" +{ +#endif + +void derive_key( + const unsigned char pwd[], /* the PASSWORD, and */ + unsigned int pwd_len, /* its length */ + const unsigned char salt[], /* the SALT and its */ + unsigned int salt_len, /* length */ + unsigned int iter, /* the number of iterations */ + unsigned char key[], /* space for the output key */ + unsigned int key_len); /* and its required length */ + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/SSZipArchive/minizip/aes/sha1.c b/SSZipArchive/minizip/aes/sha1.c new file mode 100644 index 0000000..3300363 --- /dev/null +++ b/SSZipArchive/minizip/aes/sha1.c @@ -0,0 +1,283 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2010, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 +*/ + +#include /* for memcpy() etc. */ + +#include "sha1.h" +#include "brg_endian.h" + +#if defined(__cplusplus) +extern "C" +{ +#endif + +#if defined( _MSC_VER ) && ( _MSC_VER > 800 ) +#pragma intrinsic(memcpy) +#pragma intrinsic(memset) +#endif + +#if 0 && defined(_MSC_VER) +#define rotl32 _lrotl +#define rotr32 _lrotr +#else +#define rotl32(x,n) (((x) << n) | ((x) >> (32 - n))) +#define rotr32(x,n) (((x) >> n) | ((x) << (32 - n))) +#endif + +#if !defined(bswap_32) +#define bswap_32(x) ((rotr32((x), 24) & 0x00ff00ff) | (rotr32((x), 8) & 0xff00ff00)) +#endif + +#if (PLATFORM_BYTE_ORDER == IS_LITTLE_ENDIAN) +#define SWAP_BYTES +#else +#undef SWAP_BYTES +#endif + +#if defined(SWAP_BYTES) +#define bsw_32(p,n) \ + { int _i = (n); while(_i--) ((uint32_t*)p)[_i] = bswap_32(((uint32_t*)p)[_i]); } +#else +#define bsw_32(p,n) +#endif + +#define SHA1_MASK (SHA1_BLOCK_SIZE - 1) + +#if 0 + +#define ch(x,y,z) (((x) & (y)) ^ (~(x) & (z))) +#define parity(x,y,z) ((x) ^ (y) ^ (z)) +#define maj(x,y,z) (((x) & (y)) ^ ((x) & (z)) ^ ((y) & (z))) + +#else /* Discovered by Rich Schroeppel and Colin Plumb */ + +#define ch(x,y,z) ((z) ^ ((x) & ((y) ^ (z)))) +#define parity(x,y,z) ((x) ^ (y) ^ (z)) +#define maj(x,y,z) (((x) & (y)) | ((z) & ((x) ^ (y)))) + +#endif + +/* Compile 64 bytes of hash data into SHA1 context. Note */ +/* that this routine assumes that the byte order in the */ +/* ctx->wbuf[] at this point is in such an order that low */ +/* address bytes in the ORIGINAL byte stream will go in */ +/* this buffer to the high end of 32-bit words on BOTH big */ +/* and little endian systems */ + +#ifdef ARRAY +#define q(v,n) v[n] +#else +#define q(v,n) v##n +#endif + +#ifdef SHA_1 + +#define one_cycle(v,a,b,c,d,e,f,k,h) \ + q(v,e) += rotr32(q(v,a),27) + \ + f(q(v,b),q(v,c),q(v,d)) + k + h; \ + q(v,b) = rotr32(q(v,b), 2) + +#define five_cycle(v,f,k,i) \ + one_cycle(v, 0,1,2,3,4, f,k,hf(i )); \ + one_cycle(v, 4,0,1,2,3, f,k,hf(i+1)); \ + one_cycle(v, 3,4,0,1,2, f,k,hf(i+2)); \ + one_cycle(v, 2,3,4,0,1, f,k,hf(i+3)); \ + one_cycle(v, 1,2,3,4,0, f,k,hf(i+4)) + +VOID_RETURN sha1_compile(sha1_ctx ctx[1]) +{ uint32_t *w = ctx->wbuf; + +#ifdef ARRAY + uint32_t v[5]; + memcpy(v, ctx->hash, sizeof(ctx->hash)); +#else + uint32_t v0, v1, v2, v3, v4; + v0 = ctx->hash[0]; v1 = ctx->hash[1]; + v2 = ctx->hash[2]; v3 = ctx->hash[3]; + v4 = ctx->hash[4]; +#endif + +#define hf(i) w[i] + + five_cycle(v, ch, 0x5a827999, 0); + five_cycle(v, ch, 0x5a827999, 5); + five_cycle(v, ch, 0x5a827999, 10); + one_cycle(v,0,1,2,3,4, ch, 0x5a827999, hf(15)); \ + +#undef hf +#define hf(i) (w[(i) & 15] = rotl32( \ + w[((i) + 13) & 15] ^ w[((i) + 8) & 15] \ + ^ w[((i) + 2) & 15] ^ w[(i) & 15], 1)) + + one_cycle(v,4,0,1,2,3, ch, 0x5a827999, hf(16)); + one_cycle(v,3,4,0,1,2, ch, 0x5a827999, hf(17)); + one_cycle(v,2,3,4,0,1, ch, 0x5a827999, hf(18)); + one_cycle(v,1,2,3,4,0, ch, 0x5a827999, hf(19)); + + five_cycle(v, parity, 0x6ed9eba1, 20); + five_cycle(v, parity, 0x6ed9eba1, 25); + five_cycle(v, parity, 0x6ed9eba1, 30); + five_cycle(v, parity, 0x6ed9eba1, 35); + + five_cycle(v, maj, 0x8f1bbcdc, 40); + five_cycle(v, maj, 0x8f1bbcdc, 45); + five_cycle(v, maj, 0x8f1bbcdc, 50); + five_cycle(v, maj, 0x8f1bbcdc, 55); + + five_cycle(v, parity, 0xca62c1d6, 60); + five_cycle(v, parity, 0xca62c1d6, 65); + five_cycle(v, parity, 0xca62c1d6, 70); + five_cycle(v, parity, 0xca62c1d6, 75); + +#ifdef ARRAY + ctx->hash[0] += v[0]; ctx->hash[1] += v[1]; + ctx->hash[2] += v[2]; ctx->hash[3] += v[3]; + ctx->hash[4] += v[4]; +#else + ctx->hash[0] += v0; ctx->hash[1] += v1; + ctx->hash[2] += v2; ctx->hash[3] += v3; + ctx->hash[4] += v4; +#endif +} + +VOID_RETURN sha1_begin(sha1_ctx ctx[1]) +{ + memset(ctx, 0, sizeof(sha1_ctx)); + ctx->hash[0] = 0x67452301; + ctx->hash[1] = 0xefcdab89; + ctx->hash[2] = 0x98badcfe; + ctx->hash[3] = 0x10325476; + ctx->hash[4] = 0xc3d2e1f0; +} + +/* SHA1 hash data in an array of bytes into hash buffer and */ +/* call the hash_compile function as required. For both the */ +/* bit and byte orientated versions, the block length 'len' */ +/* must not be greater than 2^32 - 1 bits (2^29 - 1 bytes) */ + +VOID_RETURN sha1_hash(const unsigned char data[], unsigned long len, sha1_ctx ctx[1]) +{ uint32_t pos = (uint32_t)((ctx->count[0] >> 3) & SHA1_MASK); + const unsigned char *sp = data; + unsigned char *w = (unsigned char*)ctx->wbuf; +#if SHA1_BITS == 1 + uint32_t ofs = (ctx->count[0] & 7); +#else + len <<= 3; +#endif + if((ctx->count[0] += len) < len) + ++(ctx->count[1]); +#if SHA1_BITS == 1 + if(ofs) /* if not on a byte boundary */ + { + if(ofs + len < 8) /* if no added bytes are needed */ + { + w[pos] |= (*sp >> ofs); + } + else /* otherwise and add bytes */ + { unsigned char part = w[pos]; + + while((int)(ofs + (len -= 8)) >= 0) + { + w[pos++] = part | (*sp >> ofs); + part = *sp++ << (8 - ofs); + if(pos == SHA1_BLOCK_SIZE) + { + bsw_32(w, SHA1_BLOCK_SIZE >> 2); + sha1_compile(ctx); pos = 0; + } + } + + w[pos] = part; + } + } + else /* data is byte aligned */ +#endif + { uint32_t space = SHA1_BLOCK_SIZE - pos; + + while(len >= (space << 3)) + { + memcpy(w + pos, sp, space); + bsw_32(w, SHA1_BLOCK_SIZE >> 2); + sha1_compile(ctx); + sp += space; len -= (space << 3); + space = SHA1_BLOCK_SIZE; pos = 0; + } + memcpy(w + pos, sp, (len + 7 * SHA1_BITS) >> 3); + } +} + +/* SHA1 final padding and digest calculation */ + +VOID_RETURN sha1_end(unsigned char hval[], sha1_ctx ctx[1]) +{ uint32_t i = (uint32_t)((ctx->count[0] >> 3) & SHA1_MASK), m1; + + /* put bytes in the buffer in an order in which references to */ + /* 32-bit words will put bytes with lower addresses into the */ + /* top of 32 bit words on BOTH big and little endian machines */ + bsw_32(ctx->wbuf, (i + 3 + SHA1_BITS) >> 2); + + /* we now need to mask valid bytes and add the padding which is */ + /* a single 1 bit and as many zero bits as necessary. Note that */ + /* we can always add the first padding byte here because the */ + /* buffer always has at least one empty slot */ + m1 = (unsigned char)0x80 >> (ctx->count[0] & 7); + ctx->wbuf[i >> 2] &= ((0xffffff00 | (~m1 + 1)) << 8 * (~i & 3)); + ctx->wbuf[i >> 2] |= (m1 << 8 * (~i & 3)); + + /* we need 9 or more empty positions, one for the padding byte */ + /* (above) and eight for the length count. If there is not */ + /* enough space, pad and empty the buffer */ + if(i > SHA1_BLOCK_SIZE - 9) + { + if(i < 60) ctx->wbuf[15] = 0; + sha1_compile(ctx); + i = 0; + } + else /* compute a word index for the empty buffer positions */ + i = (i >> 2) + 1; + + while(i < 14) /* and zero pad all but last two positions */ + ctx->wbuf[i++] = 0; + + /* the following 32-bit length fields are assembled in the */ + /* wrong byte order on little endian machines but this is */ + /* corrected later since they are only ever used as 32-bit */ + /* word values. */ + ctx->wbuf[14] = ctx->count[1]; + ctx->wbuf[15] = ctx->count[0]; + sha1_compile(ctx); + + /* extract the hash value as bytes in case the hash buffer is */ + /* misaligned for 32-bit words */ + for(i = 0; i < SHA1_DIGEST_SIZE; ++i) + hval[i] = ((ctx->hash[i >> 2] >> (8 * (~i & 3))) & 0xff); +} + +VOID_RETURN sha1(unsigned char hval[], const unsigned char data[], unsigned long len) +{ sha1_ctx cx[1]; + + sha1_begin(cx); sha1_hash(data, len, cx); sha1_end(hval, cx); +} + +#endif + +#if defined(__cplusplus) +} +#endif diff --git a/SSZipArchive/minizip/aes/sha1.h b/SSZipArchive/minizip/aes/sha1.h new file mode 100644 index 0000000..e805ad9 --- /dev/null +++ b/SSZipArchive/minizip/aes/sha1.h @@ -0,0 +1,72 @@ +/* +--------------------------------------------------------------------------- +Copyright (c) 1998-2010, Brian Gladman, Worcester, UK. All rights reserved. + +The redistribution and use of this software (with or without changes) +is allowed without the payment of fees or royalties provided that: + + source code distributions include the above copyright notice, this + list of conditions and the following disclaimer; + + binary distributions include the above copyright notice, this list + of conditions and the following disclaimer in their documentation. + +This software is provided 'as is' with no explicit or implied warranties +in respect of its operation, including, but not limited to, correctness +and fitness for purpose. +--------------------------------------------------------------------------- +Issue Date: 20/12/2007 +*/ + +#ifndef _SHA1_H +#define _SHA1_H + +#define SHA_1 + +/* define for bit or byte oriented SHA */ +#if 1 +# define SHA1_BITS 0 /* byte oriented */ +#else +# define SHA1_BITS 1 /* bit oriented */ +#endif + +#include +#include "brg_types.h" + +#define SHA1_BLOCK_SIZE 64 +#define SHA1_DIGEST_SIZE 20 + +#if defined(__cplusplus) +extern "C" +{ +#endif + +/* type to hold the SHA256 context */ + +typedef struct +{ uint32_t count[2]; + uint32_t hash[SHA1_DIGEST_SIZE >> 2]; + uint32_t wbuf[SHA1_BLOCK_SIZE >> 2]; +} sha1_ctx; + +/* Note that these prototypes are the same for both bit and */ +/* byte oriented implementations. However the length fields */ +/* are in bytes or bits as appropriate for the version used */ +/* and bit sequences are input as arrays of bytes in which */ +/* bit sequences run from the most to the least significant */ +/* end of each byte. The value 'len' in sha1_hash for the */ +/* byte oriented version of SHA1 is limited to 2^29 bytes, */ +/* but multiple calls will handle longer data blocks. */ + +VOID_RETURN sha1_compile(sha1_ctx ctx[1]); + +VOID_RETURN sha1_begin(sha1_ctx ctx[1]); +VOID_RETURN sha1_hash(const unsigned char data[], unsigned long len, sha1_ctx ctx[1]); +VOID_RETURN sha1_end(unsigned char hval[], sha1_ctx ctx[1]); +VOID_RETURN sha1(unsigned char hval[], const unsigned char data[], unsigned long len); + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/SSZipArchive/minizip/crypt.c b/SSZipArchive/minizip/crypt.c new file mode 100644 index 0000000..9c1203b --- /dev/null +++ b/SSZipArchive/minizip/crypt.c @@ -0,0 +1,144 @@ +/* crypt.c -- base code for traditional PKWARE encryption + Version 1.2.0, September 16th, 2017 + + Copyright (C) 2012-2017 Nathan Moinvaziri + https://github.com/nmoinvaz/minizip + Copyright (C) 1998-2005 Gilles Vollant + Modifications for Info-ZIP crypting + http://www.winimage.com/zLibDll/minizip.html + Copyright (C) 2003 Terry Thorsen + + This code is a modified version of crypting code in Info-ZIP distribution + + Copyright (C) 1990-2000 Info-ZIP. All rights reserved. + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. + + This encryption code is a direct transcription of the algorithm from + Roger Schlafly, described by Phil Katz in the file appnote.txt. This + file (appnote.txt) is distributed with the PKZIP program (even in the + version without encryption capabilities). + + If you don't need crypting in your application, just define symbols + NOCRYPT and NOUNCRYPT. +*/ + +#include +#include +#include +#include + +#ifdef _WIN32 +# include +# include +#else +# include +# include +# include +#endif + +#include "zlib.h" + +#include "crypt.h" + +/***************************************************************************/ + +#define CRC32(c, b) ((*(pcrc_32_tab+(((uint32_t)(c) ^ (b)) & 0xff))) ^ ((c) >> 8)) + +/***************************************************************************/ + +uint8_t decrypt_byte(uint32_t *pkeys) +{ + unsigned temp; /* POTENTIAL BUG: temp*(temp^1) may overflow in an + * unpredictable manner on 16-bit systems; not a problem + * with any known compiler so far, though */ + + temp = ((uint32_t)(*(pkeys+2)) & 0xffff) | 2; + return (uint8_t)(((temp * (temp ^ 1)) >> 8) & 0xff); +} + +uint8_t update_keys(uint32_t *pkeys, const z_crc_t *pcrc_32_tab, int32_t c) +{ + (*(pkeys+0)) = (uint32_t)CRC32((*(pkeys+0)), c); + (*(pkeys+1)) += (*(pkeys+0)) & 0xff; + (*(pkeys+1)) = (*(pkeys+1)) * 134775813L + 1; + { + register int32_t keyshift = (int32_t)((*(pkeys + 1)) >> 24); + (*(pkeys+2)) = (uint32_t)CRC32((*(pkeys+2)), keyshift); + } + return c; +} + +void init_keys(const char *passwd, uint32_t *pkeys, const z_crc_t *pcrc_32_tab) +{ + *(pkeys+0) = 305419896L; + *(pkeys+1) = 591751049L; + *(pkeys+2) = 878082192L; + while (*passwd != 0) + { + update_keys(pkeys, pcrc_32_tab, *passwd); + passwd += 1; + } +} + +/***************************************************************************/ + +int cryptrand(unsigned char *buf, unsigned int len) +{ +#ifdef _WIN32 + HCRYPTPROV provider; + unsigned __int64 pentium_tsc[1]; + int rlen = 0; + int result = 0; + + + if (CryptAcquireContext(&provider, NULL, NULL, PROV_RSA_FULL, CRYPT_VERIFYCONTEXT | CRYPT_SILENT)) + { + result = CryptGenRandom(provider, len, buf); + CryptReleaseContext(provider, 0); + if (result) + return len; + } + + for (rlen = 0; rlen < (int)len; ++rlen) + { + if (rlen % 8 == 0) + QueryPerformanceCounter((LARGE_INTEGER *)pentium_tsc); + buf[rlen] = ((unsigned char*)pentium_tsc)[rlen % 8]; + } + + return rlen; +#else + arc4random_buf(buf, len); + return len; +#endif +} + +int crypthead(const char *passwd, uint8_t *buf, int buf_size, uint32_t *pkeys, + const z_crc_t *pcrc_32_tab, uint8_t verify1, uint8_t verify2) +{ + uint8_t n = 0; /* index in random header */ + uint8_t header[RAND_HEAD_LEN-2]; /* random header */ + uint16_t t = 0; /* temporary */ + + if (buf_size < RAND_HEAD_LEN) + return 0; + + init_keys(passwd, pkeys, pcrc_32_tab); + + /* First generate RAND_HEAD_LEN-2 random bytes. */ + cryptrand(header, RAND_HEAD_LEN-2); + + /* Encrypt random header (last two bytes is high word of crc) */ + init_keys(passwd, pkeys, pcrc_32_tab); + + for (n = 0; n < RAND_HEAD_LEN-2; n++) + buf[n] = (uint8_t)zencode(pkeys, pcrc_32_tab, header[n], t); + + buf[n++] = (uint8_t)zencode(pkeys, pcrc_32_tab, verify1, t); + buf[n++] = (uint8_t)zencode(pkeys, pcrc_32_tab, verify2, t); + return n; +} + +/***************************************************************************/ diff --git a/SSZipArchive/minizip/crypt.h b/SSZipArchive/minizip/crypt.h new file mode 100644 index 0000000..0ba8260 --- /dev/null +++ b/SSZipArchive/minizip/crypt.h @@ -0,0 +1,64 @@ +/* crypt.h -- base code for traditional PKWARE encryption + Version 1.2.0, September 16th, 2017 + + Copyright (C) 2012-2017 Nathan Moinvaziri + https://github.com/nmoinvaz/minizip + Copyright (C) 1998-2005 Gilles Vollant + Modifications for Info-ZIP crypting + http://www.winimage.com/zLibDll/minizip.html + Copyright (C) 2003 Terry Thorsen + + This code is a modified version of crypting code in Info-ZIP distribution + + Copyright (C) 1990-2000 Info-ZIP. All rights reserved. + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. +*/ + +#ifndef _MINICRYPT_H +#define _MINICRYPT_H + +#if ZLIB_VERNUM < 0x1270 +typedef unsigned long z_crc_t; +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +#define RAND_HEAD_LEN 12 + +/***************************************************************************/ + +#define zdecode(pkeys,pcrc_32_tab,c) \ + (update_keys(pkeys,pcrc_32_tab, c ^= decrypt_byte(pkeys))) + +#define zencode(pkeys,pcrc_32_tab,c,t) \ + (t = decrypt_byte(pkeys), update_keys(pkeys,pcrc_32_tab,c), t^(c)) + +/***************************************************************************/ + +/* Return the next byte in the pseudo-random sequence */ +uint8_t decrypt_byte(uint32_t *pkeys); + +/* Update the encryption keys with the next byte of plain text */ +uint8_t update_keys(uint32_t *pkeys, const z_crc_t *pcrc_32_tab, int32_t c); + +/* Initialize the encryption keys and the random header according to the given password. */ +void init_keys(const char *passwd, uint32_t *pkeys, const z_crc_t *pcrc_32_tab); + +/* Generate cryptographically secure random numbers */ +int cryptrand(unsigned char *buf, unsigned int len); + +/* Create encryption header */ +int crypthead(const char *passwd, uint8_t *buf, int buf_size, uint32_t *pkeys, + const z_crc_t *pcrc_32_tab, uint8_t verify1, uint8_t verify2); + +/***************************************************************************/ + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/SSZipArchive/minizip/ioapi.c b/SSZipArchive/minizip/ioapi.c new file mode 100644 index 0000000..239bb05 --- /dev/null +++ b/SSZipArchive/minizip/ioapi.c @@ -0,0 +1,353 @@ +/* ioapi.c -- IO base function header for compress/uncompress .zip + part of the MiniZip project + + Copyright (C) 2012-2017 Nathan Moinvaziri + https://github.com/nmoinvaz/minizip + Modifications for Zip64 support + Copyright (C) 2009-2010 Mathias Svensson + http://result42.com + Copyright (C) 1998-2010 Gilles Vollant + http://www.winimage.com/zLibDll/minizip.html + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. +*/ + +#include +#include + +#if defined unix || defined __APPLE__ +#include +#include +#endif + +#include "ioapi.h" + +#if defined(_WIN32) +# define snprintf _snprintf +#endif + +voidpf call_zopen64(const zlib_filefunc64_32_def *pfilefunc, const void *filename, int mode) +{ + if (pfilefunc->zfile_func64.zopen64_file != NULL) + return (*(pfilefunc->zfile_func64.zopen64_file)) (pfilefunc->zfile_func64.opaque, filename, mode); + return (*(pfilefunc->zopen32_file))(pfilefunc->zfile_func64.opaque, (const char*)filename, mode); +} + +voidpf call_zopendisk64(const zlib_filefunc64_32_def *pfilefunc, voidpf filestream, uint32_t number_disk, int mode) +{ + if (pfilefunc->zfile_func64.zopendisk64_file != NULL) + return (*(pfilefunc->zfile_func64.zopendisk64_file)) (pfilefunc->zfile_func64.opaque, filestream, number_disk, mode); + return (*(pfilefunc->zopendisk32_file))(pfilefunc->zfile_func64.opaque, filestream, number_disk, mode); +} + +long call_zseek64(const zlib_filefunc64_32_def *pfilefunc, voidpf filestream, uint64_t offset, int origin) +{ + uint32_t offset_truncated = 0; + if (pfilefunc->zfile_func64.zseek64_file != NULL) + return (*(pfilefunc->zfile_func64.zseek64_file)) (pfilefunc->zfile_func64.opaque,filestream,offset,origin); + offset_truncated = (uint32_t)offset; + if (offset_truncated != offset) + return -1; + return (*(pfilefunc->zseek32_file))(pfilefunc->zfile_func64.opaque,filestream, offset_truncated, origin); +} + +uint64_t call_ztell64(const zlib_filefunc64_32_def *pfilefunc, voidpf filestream) +{ + uint64_t position; + if (pfilefunc->zfile_func64.zseek64_file != NULL) + return (*(pfilefunc->zfile_func64.ztell64_file)) (pfilefunc->zfile_func64.opaque, filestream); + position = (*(pfilefunc->ztell32_file))(pfilefunc->zfile_func64.opaque, filestream); + if ((position) == UINT32_MAX) + return (uint64_t)-1; + return position; +} + +void fill_zlib_filefunc64_32_def_from_filefunc32(zlib_filefunc64_32_def *p_filefunc64_32, const zlib_filefunc_def *p_filefunc32) +{ + p_filefunc64_32->zfile_func64.zopen64_file = NULL; + p_filefunc64_32->zfile_func64.zopendisk64_file = NULL; + p_filefunc64_32->zopen32_file = p_filefunc32->zopen_file; + p_filefunc64_32->zopendisk32_file = p_filefunc32->zopendisk_file; + p_filefunc64_32->zfile_func64.zerror_file = p_filefunc32->zerror_file; + p_filefunc64_32->zfile_func64.zread_file = p_filefunc32->zread_file; + p_filefunc64_32->zfile_func64.zwrite_file = p_filefunc32->zwrite_file; + p_filefunc64_32->zfile_func64.ztell64_file = NULL; + p_filefunc64_32->zfile_func64.zseek64_file = NULL; + p_filefunc64_32->zfile_func64.zclose_file = p_filefunc32->zclose_file; + p_filefunc64_32->zfile_func64.zerror_file = p_filefunc32->zerror_file; + p_filefunc64_32->zfile_func64.opaque = p_filefunc32->opaque; + p_filefunc64_32->zseek32_file = p_filefunc32->zseek_file; + p_filefunc64_32->ztell32_file = p_filefunc32->ztell_file; +} + +static voidpf ZCALLBACK fopen_file_func(ZIP_UNUSED voidpf opaque, const char *filename, int mode); +static uint32_t ZCALLBACK fread_file_func(voidpf opaque, voidpf stream, void* buf, uint32_t size); +static uint32_t ZCALLBACK fwrite_file_func(voidpf opaque, voidpf stream, const void *buf, uint32_t size); +static uint64_t ZCALLBACK ftell64_file_func(voidpf opaque, voidpf stream); +static long ZCALLBACK fseek64_file_func(voidpf opaque, voidpf stream, uint64_t offset, int origin); +static int ZCALLBACK fclose_file_func(voidpf opaque, voidpf stream); +static int ZCALLBACK ferror_file_func(voidpf opaque, voidpf stream); + +typedef struct +{ + FILE *file; + int filenameLength; + void *filename; +} FILE_IOPOSIX; + +static voidpf file_build_ioposix(FILE *file, const char *filename) +{ + FILE_IOPOSIX *ioposix = NULL; + if (file == NULL) + return NULL; + ioposix = (FILE_IOPOSIX*)malloc(sizeof(FILE_IOPOSIX)); + ioposix->file = file; + ioposix->filenameLength = (int)strlen(filename) + 1; + ioposix->filename = (char*)malloc(ioposix->filenameLength * sizeof(char)); + strncpy((char*)ioposix->filename, filename, ioposix->filenameLength); + return (voidpf)ioposix; +} + +static voidpf ZCALLBACK fopen_file_func(ZIP_UNUSED voidpf opaque, const char *filename, int mode) +{ + FILE* file = NULL; + const char *mode_fopen = NULL; + if ((mode & ZLIB_FILEFUNC_MODE_READWRITEFILTER) == ZLIB_FILEFUNC_MODE_READ) + mode_fopen = "rb"; + else if (mode & ZLIB_FILEFUNC_MODE_EXISTING) + mode_fopen = "r+b"; + else if (mode & ZLIB_FILEFUNC_MODE_CREATE) + mode_fopen = "wb"; + + if ((filename != NULL) && (mode_fopen != NULL)) + { + file = fopen(filename, mode_fopen); + return file_build_ioposix(file, filename); + } + return file; +} + +static voidpf ZCALLBACK fopen64_file_func(ZIP_UNUSED voidpf opaque, const void *filename, int mode) +{ + FILE* file = NULL; + const char *mode_fopen = NULL; + if ((mode & ZLIB_FILEFUNC_MODE_READWRITEFILTER) == ZLIB_FILEFUNC_MODE_READ) + mode_fopen = "rb"; + else if (mode & ZLIB_FILEFUNC_MODE_EXISTING) + mode_fopen = "r+b"; + else if (mode & ZLIB_FILEFUNC_MODE_CREATE) + mode_fopen = "wb"; + + if ((filename != NULL) && (mode_fopen != NULL)) + { + file = fopen64((const char*)filename, mode_fopen); + return file_build_ioposix(file, (const char*)filename); + } + return file; +} + +static voidpf ZCALLBACK fopendisk64_file_func(voidpf opaque, voidpf stream, uint32_t number_disk, int mode) +{ + FILE_IOPOSIX *ioposix = NULL; + char *diskFilename = NULL; + voidpf ret = NULL; + int i = 0; + + if (stream == NULL) + return NULL; + ioposix = (FILE_IOPOSIX*)stream; + diskFilename = (char*)malloc(ioposix->filenameLength * sizeof(char)); + strncpy(diskFilename, (const char*)ioposix->filename, ioposix->filenameLength); + for (i = ioposix->filenameLength - 1; i >= 0; i -= 1) + { + if (diskFilename[i] != '.') + continue; + snprintf(&diskFilename[i], ioposix->filenameLength - i, ".z%02u", number_disk + 1); + break; + } + if (i >= 0) + ret = fopen64_file_func(opaque, diskFilename, mode); + free(diskFilename); + return ret; +} + +static voidpf ZCALLBACK fopendisk_file_func(voidpf opaque, voidpf stream, uint32_t number_disk, int mode) +{ + FILE_IOPOSIX *ioposix = NULL; + char *diskFilename = NULL; + voidpf ret = NULL; + int i = 0; + + if (stream == NULL) + return NULL; + ioposix = (FILE_IOPOSIX*)stream; + diskFilename = (char*)malloc(ioposix->filenameLength * sizeof(char)); + strncpy(diskFilename, (const char*)ioposix->filename, ioposix->filenameLength); + for (i = ioposix->filenameLength - 1; i >= 0; i -= 1) + { + if (diskFilename[i] != '.') + continue; + snprintf(&diskFilename[i], ioposix->filenameLength - i, ".z%02u", number_disk + 1); + break; + } + if (i >= 0) + ret = fopen_file_func(opaque, diskFilename, mode); + free(diskFilename); + return ret; +} + +static uint32_t ZCALLBACK fread_file_func(ZIP_UNUSED voidpf opaque, voidpf stream, void* buf, uint32_t size) +{ + FILE_IOPOSIX *ioposix = NULL; + uint32_t read = (uint32_t)-1; + if (stream == NULL) + return read; + ioposix = (FILE_IOPOSIX*)stream; + read = (uint32_t)fread(buf, 1, (size_t)size, ioposix->file); + return read; +} + +static uint32_t ZCALLBACK fwrite_file_func(ZIP_UNUSED voidpf opaque, voidpf stream, const void *buf, uint32_t size) +{ + FILE_IOPOSIX *ioposix = NULL; + uint32_t written = (uint32_t)-1; + if (stream == NULL) + return written; + ioposix = (FILE_IOPOSIX*)stream; + written = (uint32_t)fwrite(buf, 1, (size_t)size, ioposix->file); + return written; +} + +static long ZCALLBACK ftell_file_func(ZIP_UNUSED voidpf opaque, voidpf stream) +{ + FILE_IOPOSIX *ioposix = NULL; + long ret = -1; + if (stream == NULL) + return ret; + ioposix = (FILE_IOPOSIX*)stream; + ret = ftell(ioposix->file); + return ret; +} + +static uint64_t ZCALLBACK ftell64_file_func(ZIP_UNUSED voidpf opaque, voidpf stream) +{ + FILE_IOPOSIX *ioposix = NULL; + uint64_t ret = (uint64_t)-1; + if (stream == NULL) + return ret; + ioposix = (FILE_IOPOSIX*)stream; + ret = ftello64(ioposix->file); + return ret; +} + +static long ZCALLBACK fseek_file_func(ZIP_UNUSED voidpf opaque, voidpf stream, uint32_t offset, int origin) +{ + FILE_IOPOSIX *ioposix = NULL; + int fseek_origin = 0; + long ret = 0; + + if (stream == NULL) + return -1; + ioposix = (FILE_IOPOSIX*)stream; + + switch (origin) + { + case ZLIB_FILEFUNC_SEEK_CUR: + fseek_origin = SEEK_CUR; + break; + case ZLIB_FILEFUNC_SEEK_END: + fseek_origin = SEEK_END; + break; + case ZLIB_FILEFUNC_SEEK_SET: + fseek_origin = SEEK_SET; + break; + default: + return -1; + } + if (fseek(ioposix->file, offset, fseek_origin) != 0) + ret = -1; + return ret; +} + +static long ZCALLBACK fseek64_file_func(ZIP_UNUSED voidpf opaque, voidpf stream, uint64_t offset, int origin) +{ + FILE_IOPOSIX *ioposix = NULL; + int fseek_origin = 0; + long ret = 0; + + if (stream == NULL) + return -1; + ioposix = (FILE_IOPOSIX*)stream; + + switch (origin) + { + case ZLIB_FILEFUNC_SEEK_CUR: + fseek_origin = SEEK_CUR; + break; + case ZLIB_FILEFUNC_SEEK_END: + fseek_origin = SEEK_END; + break; + case ZLIB_FILEFUNC_SEEK_SET: + fseek_origin = SEEK_SET; + break; + default: + return -1; + } + + if (fseeko64(ioposix->file, offset, fseek_origin) != 0) + ret = -1; + + return ret; +} + +static int ZCALLBACK fclose_file_func(ZIP_UNUSED voidpf opaque, voidpf stream) +{ + FILE_IOPOSIX *ioposix = NULL; + int ret = -1; + if (stream == NULL) + return ret; + ioposix = (FILE_IOPOSIX*)stream; + if (ioposix->filename != NULL) + free(ioposix->filename); + ret = fclose(ioposix->file); + free(ioposix); + return ret; +} + +static int ZCALLBACK ferror_file_func(ZIP_UNUSED voidpf opaque, voidpf stream) +{ + FILE_IOPOSIX *ioposix = NULL; + int ret = -1; + if (stream == NULL) + return ret; + ioposix = (FILE_IOPOSIX*)stream; + ret = ferror(ioposix->file); + return ret; +} + +void fill_fopen_filefunc(zlib_filefunc_def *pzlib_filefunc_def) +{ + pzlib_filefunc_def->zopen_file = fopen_file_func; + pzlib_filefunc_def->zopendisk_file = fopendisk_file_func; + pzlib_filefunc_def->zread_file = fread_file_func; + pzlib_filefunc_def->zwrite_file = fwrite_file_func; + pzlib_filefunc_def->ztell_file = ftell_file_func; + pzlib_filefunc_def->zseek_file = fseek_file_func; + pzlib_filefunc_def->zclose_file = fclose_file_func; + pzlib_filefunc_def->zerror_file = ferror_file_func; + pzlib_filefunc_def->opaque = NULL; +} + +void fill_fopen64_filefunc(zlib_filefunc64_def *pzlib_filefunc_def) +{ + pzlib_filefunc_def->zopen64_file = fopen64_file_func; + pzlib_filefunc_def->zopendisk64_file = fopendisk64_file_func; + pzlib_filefunc_def->zread_file = fread_file_func; + pzlib_filefunc_def->zwrite_file = fwrite_file_func; + pzlib_filefunc_def->ztell64_file = ftell64_file_func; + pzlib_filefunc_def->zseek64_file = fseek64_file_func; + pzlib_filefunc_def->zclose_file = fclose_file_func; + pzlib_filefunc_def->zerror_file = ferror_file_func; + pzlib_filefunc_def->opaque = NULL; +} diff --git a/SSZipArchive/minizip/ioapi.h b/SSZipArchive/minizip/ioapi.h new file mode 100644 index 0000000..c5698ad --- /dev/null +++ b/SSZipArchive/minizip/ioapi.h @@ -0,0 +1,154 @@ +/* ioapi.h -- IO base function header for compress/uncompress .zip + part of the MiniZip project + + Copyright (C) 2012-2017 Nathan Moinvaziri + https://github.com/nmoinvaz/minizip + Copyright (C) 2009-2010 Mathias Svensson + Modifications for Zip64 support + http://result42.com + Copyright (C) 1998-2010 Gilles Vollant + http://www.winimage.com/zLibDll/minizip.html + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. +*/ + +#ifndef _ZLIBIOAPI64_H +#define _ZLIBIOAPI64_H + +#include +#include +#include + +#include "zlib.h" + +#ifdef __GNUC__ +# define ZIP_UNUSED __attribute__((__unused__)) +#else +# define ZIP_UNUSED +#endif + +#if defined(USE_FILE32API) +# define fopen64 fopen +# define ftello64 ftell +# define fseeko64 fseek +#else +# if defined(__FreeBSD__) || defined(__NetBSD__) || defined(__DragonFly__) || defined(__OpenBSD__) || defined(__APPLE__) || defined(__ANDROID__) +# define fopen64 fopen +# define ftello64 ftello +# define fseeko64 fseeko +# endif +# ifdef _MSC_VER +# define fopen64 fopen +# if (_MSC_VER >= 1400) && (!(defined(NO_MSCVER_FILE64_FUNC))) +# define ftello64 _ftelli64 +# define fseeko64 _fseeki64 +# else /* old MSC */ +# define ftello64 ftell +# define fseeko64 fseek +# endif +# endif +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +#define ZLIB_FILEFUNC_SEEK_CUR (1) +#define ZLIB_FILEFUNC_SEEK_END (2) +#define ZLIB_FILEFUNC_SEEK_SET (0) + +#define ZLIB_FILEFUNC_MODE_READ (1) +#define ZLIB_FILEFUNC_MODE_WRITE (2) +#define ZLIB_FILEFUNC_MODE_READWRITEFILTER (3) +#define ZLIB_FILEFUNC_MODE_EXISTING (4) +#define ZLIB_FILEFUNC_MODE_CREATE (8) + +#ifndef ZCALLBACK +# if (defined(WIN32) || defined(_WIN32) || defined (WINDOWS) || \ + defined (_WINDOWS)) && defined(CALLBACK) && defined (USEWINDOWS_CALLBACK) +# define ZCALLBACK CALLBACK +# else +# define ZCALLBACK +# endif +#endif + +typedef voidpf (ZCALLBACK *open_file_func) (voidpf opaque, const char *filename, int mode); +typedef voidpf (ZCALLBACK *opendisk_file_func) (voidpf opaque, voidpf stream, uint32_t number_disk, int mode); +typedef uint32_t (ZCALLBACK *read_file_func) (voidpf opaque, voidpf stream, void* buf, uint32_t size); +typedef uint32_t (ZCALLBACK *write_file_func) (voidpf opaque, voidpf stream, const void *buf, uint32_t size); +typedef int (ZCALLBACK *close_file_func) (voidpf opaque, voidpf stream); +typedef int (ZCALLBACK *error_file_func) (voidpf opaque, voidpf stream); + +typedef long (ZCALLBACK *tell_file_func) (voidpf opaque, voidpf stream); +typedef long (ZCALLBACK *seek_file_func) (voidpf opaque, voidpf stream, uint32_t offset, int origin); + +/* here is the "old" 32 bits structure structure */ +typedef struct zlib_filefunc_def_s +{ + open_file_func zopen_file; + opendisk_file_func zopendisk_file; + read_file_func zread_file; + write_file_func zwrite_file; + tell_file_func ztell_file; + seek_file_func zseek_file; + close_file_func zclose_file; + error_file_func zerror_file; + voidpf opaque; +} zlib_filefunc_def; + +typedef uint64_t (ZCALLBACK *tell64_file_func) (voidpf opaque, voidpf stream); +typedef long (ZCALLBACK *seek64_file_func) (voidpf opaque, voidpf stream, uint64_t offset, int origin); +typedef voidpf (ZCALLBACK *open64_file_func) (voidpf opaque, const void *filename, int mode); +typedef voidpf (ZCALLBACK *opendisk64_file_func)(voidpf opaque, voidpf stream, uint32_t number_disk, int mode); + +typedef struct zlib_filefunc64_def_s +{ + open64_file_func zopen64_file; + opendisk64_file_func zopendisk64_file; + read_file_func zread_file; + write_file_func zwrite_file; + tell64_file_func ztell64_file; + seek64_file_func zseek64_file; + close_file_func zclose_file; + error_file_func zerror_file; + voidpf opaque; +} zlib_filefunc64_def; + +void fill_fopen_filefunc(zlib_filefunc_def *pzlib_filefunc_def); +void fill_fopen64_filefunc(zlib_filefunc64_def *pzlib_filefunc_def); + +/* now internal definition, only for zip.c and unzip.h */ +typedef struct zlib_filefunc64_32_def_s +{ + zlib_filefunc64_def zfile_func64; + open_file_func zopen32_file; + opendisk_file_func zopendisk32_file; + tell_file_func ztell32_file; + seek_file_func zseek32_file; +} zlib_filefunc64_32_def; + +#define ZREAD64(filefunc,filestream,buf,size) ((*((filefunc).zfile_func64.zread_file)) ((filefunc).zfile_func64.opaque,filestream,buf,size)) +#define ZWRITE64(filefunc,filestream,buf,size) ((*((filefunc).zfile_func64.zwrite_file)) ((filefunc).zfile_func64.opaque,filestream,buf,size)) +/*#define ZTELL64(filefunc,filestream) ((*((filefunc).ztell64_file)) ((filefunc).opaque,filestream))*/ +/*#define ZSEEK64(filefunc,filestream,pos,mode) ((*((filefunc).zseek64_file)) ((filefunc).opaque,filestream,pos,mode))*/ +#define ZCLOSE64(filefunc,filestream) ((*((filefunc).zfile_func64.zclose_file)) ((filefunc).zfile_func64.opaque,filestream)) +#define ZERROR64(filefunc,filestream) ((*((filefunc).zfile_func64.zerror_file)) ((filefunc).zfile_func64.opaque,filestream)) + +voidpf call_zopen64(const zlib_filefunc64_32_def *pfilefunc,const void*filename, int mode); +voidpf call_zopendisk64(const zlib_filefunc64_32_def *pfilefunc, voidpf filestream, uint32_t number_disk, int mode); +long call_zseek64(const zlib_filefunc64_32_def *pfilefunc, voidpf filestream, uint64_t offset, int origin); +uint64_t call_ztell64(const zlib_filefunc64_32_def *pfilefunc, voidpf filestream); + +void fill_zlib_filefunc64_32_def_from_filefunc32(zlib_filefunc64_32_def *p_filefunc64_32, const zlib_filefunc_def *p_filefunc32); + +#define ZOPEN64(filefunc,filename,mode) (call_zopen64((&(filefunc)),(filename),(mode))) +#define ZOPENDISK64(filefunc,filestream,diskn,mode) (call_zopendisk64((&(filefunc)),(filestream),(diskn),(mode))) +#define ZTELL64(filefunc,filestream) (call_ztell64((&(filefunc)),(filestream))) +#define ZSEEK64(filefunc,filestream,pos,mode) (call_zseek64((&(filefunc)),(filestream),(pos),(mode))) + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/SSZipArchive/minizip/ioapi_buf.c b/SSZipArchive/minizip/ioapi_buf.c new file mode 100644 index 0000000..074a930 --- /dev/null +++ b/SSZipArchive/minizip/ioapi_buf.c @@ -0,0 +1,461 @@ +/* ioapi_buf.c -- IO base function header for compress/uncompress .zip + files using zlib + zip or unzip API + + This version of ioapi is designed to buffer IO. + + Copyright (C) 2012-2017 Nathan Moinvaziri + https://github.com/nmoinvaz/minizip + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. +*/ + + +#include +#include +#include +#include + +#include "zlib.h" +#include "ioapi.h" + +#include "ioapi_buf.h" + +#ifndef IOBUF_BUFFERSIZE +# define IOBUF_BUFFERSIZE (UINT16_MAX) +#endif + +#if defined(_WIN32) +# include +# define PRINTF _cprintf +# define VPRINTF _vcprintf +#else +# define PRINTF printf +# define VPRINTF vprintf +#endif + +//#define IOBUF_VERBOSE + +#ifdef __GNUC__ +#ifndef max +#define max(x,y) ({ \ +const __typeof__(x) _x = (x); \ +const __typeof__(y) _y = (y); \ +(void) (&_x == &_y); \ +_x > _y ? _x : _y; }) +#endif /* __GNUC__ */ + +#ifndef min +#define min(x,y) ({ \ +const __typeof__(x) _x = (x); \ +const __typeof__(y) _y = (y); \ +(void) (&_x == &_y); \ +_x < _y ? _x : _y; }) +#endif +#endif + +typedef struct ourstream_s { + char readbuf[IOBUF_BUFFERSIZE]; + uint32_t readbuf_len; + uint32_t readbuf_pos; + uint32_t readbuf_hits; + uint32_t readbuf_misses; + char writebuf[IOBUF_BUFFERSIZE]; + uint32_t writebuf_len; + uint32_t writebuf_pos; + uint32_t writebuf_hits; + uint32_t writebuf_misses; + uint64_t position; + voidpf stream; +} ourstream_t; + +#if defined(IOBUF_VERBOSE) +# define print_buf(o,s,f,...) print_buf_internal(o,s,f,__VA_ARGS__); +#else +# define print_buf(o,s,f,...) +#endif + +void print_buf_internal(ZIP_UNUSED voidpf opaque, voidpf stream, char *format, ...) +{ + ourstream_t *streamio = (ourstream_t *)stream; + va_list arglist; + PRINTF("Buf stream %p - ", streamio); + va_start(arglist, format); + VPRINTF(format, arglist); + va_end(arglist); +} + +voidpf fopen_buf_internal_func(ZIP_UNUSED voidpf opaque, voidpf stream, ZIP_UNUSED uint32_t number_disk, ZIP_UNUSED int mode) +{ + ourstream_t *streamio = NULL; + if (stream == NULL) + return NULL; + streamio = (ourstream_t *)malloc(sizeof(ourstream_t)); + if (streamio == NULL) + return NULL; + memset(streamio, 0, sizeof(ourstream_t)); + streamio->stream = stream; + print_buf(opaque, streamio, "open [num %d mode %d]\n", number_disk, mode); + return streamio; +} + +voidpf ZCALLBACK fopen_buf_func(voidpf opaque, const char *filename, int mode) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + voidpf stream = bufio->filefunc.zopen_file(bufio->filefunc.opaque, filename, mode); + return fopen_buf_internal_func(opaque, stream, 0, mode); +} + +voidpf ZCALLBACK fopen64_buf_func(voidpf opaque, const void *filename, int mode) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + voidpf stream = bufio->filefunc64.zopen64_file(bufio->filefunc64.opaque, filename, mode); + return fopen_buf_internal_func(opaque, stream, 0, mode); +} + +voidpf ZCALLBACK fopendisk_buf_func(voidpf opaque, voidpf stream_cd, uint32_t number_disk, int mode) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream_cd; + voidpf *stream = bufio->filefunc.zopendisk_file(bufio->filefunc.opaque, streamio->stream, number_disk, mode); + return fopen_buf_internal_func(opaque, stream, number_disk, mode); +} + +voidpf ZCALLBACK fopendisk64_buf_func(voidpf opaque, voidpf stream_cd, uint32_t number_disk, int mode) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream_cd; + voidpf stream = bufio->filefunc64.zopendisk64_file(bufio->filefunc64.opaque, streamio->stream, number_disk, mode); + return fopen_buf_internal_func(opaque, stream, number_disk, mode); +} + +long fflush_buf(voidpf opaque, voidpf stream) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream; + uint32_t total_bytes_to_write = 0; + uint32_t bytes_to_write = streamio->writebuf_len; + uint32_t bytes_left_to_write = streamio->writebuf_len; + long bytes_written = 0; + + while (bytes_left_to_write > 0) + { + if (bufio->filefunc64.zwrite_file != NULL) + bytes_written = bufio->filefunc64.zwrite_file(bufio->filefunc64.opaque, streamio->stream, streamio->writebuf + (bytes_to_write - bytes_left_to_write), bytes_left_to_write); + else + bytes_written = bufio->filefunc.zwrite_file(bufio->filefunc.opaque, streamio->stream, streamio->writebuf + (bytes_to_write - bytes_left_to_write), bytes_left_to_write); + + streamio->writebuf_misses += 1; + + print_buf(opaque, stream, "write flush [%d:%d len %d]\n", bytes_to_write, bytes_left_to_write, streamio->writebuf_len); + + if (bytes_written < 0) + return bytes_written; + + total_bytes_to_write += bytes_written; + bytes_left_to_write -= bytes_written; + streamio->position += bytes_written; + } + streamio->writebuf_len = 0; + streamio->writebuf_pos = 0; + return total_bytes_to_write; +} + +uint32_t ZCALLBACK fread_buf_func(voidpf opaque, voidpf stream, void *buf, uint32_t size) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream; + uint32_t buf_len = 0; + uint32_t bytes_to_read = 0; + uint32_t bytes_to_copy = 0; + uint32_t bytes_left_to_read = size; + uint32_t bytes_read = 0; + + print_buf(opaque, stream, "read [size %ld pos %lld]\n", size, streamio->position); + + if (streamio->writebuf_len > 0) + { + print_buf(opaque, stream, "switch from write to read, not yet supported [%lld]\n", streamio->position); + } + + while (bytes_left_to_read > 0) + { + if ((streamio->readbuf_len == 0) || (streamio->readbuf_pos == streamio->readbuf_len)) + { + if (streamio->readbuf_len == IOBUF_BUFFERSIZE) + { + streamio->readbuf_pos = 0; + streamio->readbuf_len = 0; + } + + bytes_to_read = IOBUF_BUFFERSIZE - (streamio->readbuf_len - streamio->readbuf_pos); + + if (bufio->filefunc64.zread_file != NULL) + bytes_read = bufio->filefunc64.zread_file(bufio->filefunc64.opaque, streamio->stream, streamio->readbuf + streamio->readbuf_pos, bytes_to_read); + else + bytes_read = bufio->filefunc.zread_file(bufio->filefunc.opaque, streamio->stream, streamio->readbuf + streamio->readbuf_pos, bytes_to_read); + + streamio->readbuf_misses += 1; + streamio->readbuf_len += bytes_read; + streamio->position += bytes_read; + + print_buf(opaque, stream, "filled [read %d/%d buf %d:%d pos %lld]\n", bytes_read, bytes_to_read, streamio->readbuf_pos, streamio->readbuf_len, streamio->position); + + if (bytes_read == 0) + break; + } + + if ((streamio->readbuf_len - streamio->readbuf_pos) > 0) + { + bytes_to_copy = min(bytes_left_to_read, (uint32_t)(streamio->readbuf_len - streamio->readbuf_pos)); + memcpy((char *)buf + buf_len, streamio->readbuf + streamio->readbuf_pos, bytes_to_copy); + + buf_len += bytes_to_copy; + bytes_left_to_read -= bytes_to_copy; + + streamio->readbuf_hits += 1; + streamio->readbuf_pos += bytes_to_copy; + + print_buf(opaque, stream, "emptied [copied %d remaining %d buf %d:%d pos %lld]\n", bytes_to_copy, bytes_left_to_read, streamio->readbuf_pos, streamio->readbuf_len, streamio->position); + } + } + + return size - bytes_left_to_read; +} + +uint32_t ZCALLBACK fwrite_buf_func(voidpf opaque, voidpf stream, const void *buf, uint32_t size) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream; + uint32_t bytes_to_write = size; + uint32_t bytes_left_to_write = size; + uint32_t bytes_to_copy = 0; + int64_t ret = 0; + + print_buf(opaque, stream, "write [size %ld len %d pos %lld]\n", size, streamio->writebuf_len, streamio->position); + + if (streamio->readbuf_len > 0) + { + streamio->position -= streamio->readbuf_len; + streamio->position += streamio->readbuf_pos; + + streamio->readbuf_len = 0; + streamio->readbuf_pos = 0; + + print_buf(opaque, stream, "switch from read to write [%lld]\n", streamio->position); + + if (bufio->filefunc64.zseek64_file != NULL) + ret = bufio->filefunc64.zseek64_file(bufio->filefunc64.opaque, streamio->stream, streamio->position, ZLIB_FILEFUNC_SEEK_SET); + else + ret = bufio->filefunc.zseek_file(bufio->filefunc.opaque, streamio->stream, (uint32_t)streamio->position, ZLIB_FILEFUNC_SEEK_SET); + + if (ret != 0) + return (uint32_t)-1; + } + + while (bytes_left_to_write > 0) + { + bytes_to_copy = min(bytes_left_to_write, (uint32_t)(IOBUF_BUFFERSIZE - min(streamio->writebuf_len, streamio->writebuf_pos))); + + if (bytes_to_copy == 0) + { + if (fflush_buf(opaque, stream) <= 0) + return 0; + + continue; + } + + memcpy(streamio->writebuf + streamio->writebuf_pos, (char *)buf + (bytes_to_write - bytes_left_to_write), bytes_to_copy); + + print_buf(opaque, stream, "write copy [remaining %d write %d:%d len %d]\n", bytes_to_copy, bytes_to_write, bytes_left_to_write, streamio->writebuf_len); + + bytes_left_to_write -= bytes_to_copy; + + streamio->writebuf_pos += bytes_to_copy; + streamio->writebuf_hits += 1; + if (streamio->writebuf_pos > streamio->writebuf_len) + streamio->writebuf_len += streamio->writebuf_pos - streamio->writebuf_len; + } + + return size - bytes_left_to_write; +} + +uint64_t ftell_buf_internal_func(ZIP_UNUSED voidpf opaque, voidpf stream, uint64_t position) +{ + ourstream_t *streamio = (ourstream_t *)stream; + streamio->position = position; + print_buf(opaque, stream, "tell [pos %llu readpos %d writepos %d err %d]\n", streamio->position, streamio->readbuf_pos, streamio->writebuf_pos, errno); + if (streamio->readbuf_len > 0) + position -= (streamio->readbuf_len - streamio->readbuf_pos); + if (streamio->writebuf_len > 0) + position += streamio->writebuf_pos; + return position; +} + +long ZCALLBACK ftell_buf_func(voidpf opaque, voidpf stream) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream; + uint64_t position = bufio->filefunc.ztell_file(bufio->filefunc.opaque, streamio->stream); + return (long)ftell_buf_internal_func(opaque, stream, position); +} + +uint64_t ZCALLBACK ftell64_buf_func(voidpf opaque, voidpf stream) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream; + uint64_t position = bufio->filefunc64.ztell64_file(bufio->filefunc64.opaque, streamio->stream); + return ftell_buf_internal_func(opaque, stream, position); +} + +int fseek_buf_internal_func(voidpf opaque, voidpf stream, uint64_t offset, int origin) +{ + ourstream_t *streamio = (ourstream_t *)stream; + + print_buf(opaque, stream, "seek [origin %d offset %llu pos %lld]\n", origin, offset, streamio->position); + + switch (origin) + { + case ZLIB_FILEFUNC_SEEK_SET: + + if (streamio->writebuf_len > 0) + { + if ((offset >= streamio->position) && (offset <= streamio->position + streamio->writebuf_len)) + { + streamio->writebuf_pos = (uint32_t)(offset - streamio->position); + return 0; + } + } + if ((streamio->readbuf_len > 0) && (offset < streamio->position) && (offset >= streamio->position - streamio->readbuf_len)) + { + streamio->readbuf_pos = (uint32_t)(offset - (streamio->position - streamio->readbuf_len)); + return 0; + } + if (fflush_buf(opaque, stream) < 0) + return -1; + streamio->position = offset; + break; + + case ZLIB_FILEFUNC_SEEK_CUR: + + if (streamio->readbuf_len > 0) + { + if (offset <= (streamio->readbuf_len - streamio->readbuf_pos)) + { + streamio->readbuf_pos += (uint32_t)offset; + return 0; + } + offset -= (streamio->readbuf_len - streamio->readbuf_pos); + streamio->position += offset; + } + if (streamio->writebuf_len > 0) + { + if (offset <= (streamio->writebuf_len - streamio->writebuf_pos)) + { + streamio->writebuf_pos += (uint32_t)offset; + return 0; + } + //offset -= (streamio->writebuf_len - streamio->writebuf_pos); + } + + if (fflush_buf(opaque, stream) < 0) + return -1; + + break; + + case ZLIB_FILEFUNC_SEEK_END: + + if (streamio->writebuf_len > 0) + { + streamio->writebuf_pos = streamio->writebuf_len; + return 0; + } + break; + } + + streamio->readbuf_len = 0; + streamio->readbuf_pos = 0; + streamio->writebuf_len = 0; + streamio->writebuf_pos = 0; + return 1; +} + +long ZCALLBACK fseek_buf_func(voidpf opaque, voidpf stream, uint32_t offset, int origin) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream; + long ret = -1; + if (bufio->filefunc.zseek_file == NULL) + return ret; + ret = fseek_buf_internal_func(opaque, stream, offset, origin); + if (ret == 1) + ret = bufio->filefunc.zseek_file(bufio->filefunc.opaque, streamio->stream, offset, origin); + return ret; +} + +long ZCALLBACK fseek64_buf_func(voidpf opaque, voidpf stream, uint64_t offset, int origin) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream; + long ret = -1; + if (bufio->filefunc64.zseek64_file == NULL) + return ret; + ret = fseek_buf_internal_func(opaque, stream, offset, origin); + if (ret == 1) + ret = bufio->filefunc64.zseek64_file(bufio->filefunc64.opaque, streamio->stream, offset, origin); + return ret; +} + +int ZCALLBACK fclose_buf_func(voidpf opaque, voidpf stream) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream; + int ret = 0; + fflush_buf(opaque, stream); + print_buf(opaque, stream, "close\n"); + if (streamio->readbuf_hits + streamio->readbuf_misses > 0) + print_buf(opaque, stream, "read efficency %.02f%%\n", (streamio->readbuf_hits / ((float)streamio->readbuf_hits + streamio->readbuf_misses)) * 100); + if (streamio->writebuf_hits + streamio->writebuf_misses > 0) + print_buf(opaque, stream, "write efficency %.02f%%\n", (streamio->writebuf_hits / ((float)streamio->writebuf_hits + streamio->writebuf_misses)) * 100); + if (bufio->filefunc64.zclose_file != NULL) + ret = bufio->filefunc64.zclose_file(bufio->filefunc64.opaque, streamio->stream); + else + ret = bufio->filefunc.zclose_file(bufio->filefunc.opaque, streamio->stream); + free(streamio); + return ret; +} + +int ZCALLBACK ferror_buf_func(voidpf opaque, voidpf stream) +{ + ourbuffer_t *bufio = (ourbuffer_t *)opaque; + ourstream_t *streamio = (ourstream_t *)stream; + if (bufio->filefunc64.zerror_file != NULL) + return bufio->filefunc64.zerror_file(bufio->filefunc64.opaque, streamio->stream); + return bufio->filefunc.zerror_file(bufio->filefunc.opaque, streamio->stream); +} + +void fill_buffer_filefunc(zlib_filefunc_def *pzlib_filefunc_def, ourbuffer_t *ourbuf) +{ + pzlib_filefunc_def->zopen_file = fopen_buf_func; + pzlib_filefunc_def->zopendisk_file = fopendisk_buf_func; + pzlib_filefunc_def->zread_file = fread_buf_func; + pzlib_filefunc_def->zwrite_file = fwrite_buf_func; + pzlib_filefunc_def->ztell_file = ftell_buf_func; + pzlib_filefunc_def->zseek_file = fseek_buf_func; + pzlib_filefunc_def->zclose_file = fclose_buf_func; + pzlib_filefunc_def->zerror_file = ferror_buf_func; + pzlib_filefunc_def->opaque = ourbuf; +} + +void fill_buffer_filefunc64(zlib_filefunc64_def *pzlib_filefunc_def, ourbuffer_t *ourbuf) +{ + pzlib_filefunc_def->zopen64_file = fopen64_buf_func; + pzlib_filefunc_def->zopendisk64_file = fopendisk64_buf_func; + pzlib_filefunc_def->zread_file = fread_buf_func; + pzlib_filefunc_def->zwrite_file = fwrite_buf_func; + pzlib_filefunc_def->ztell64_file = ftell64_buf_func; + pzlib_filefunc_def->zseek64_file = fseek64_buf_func; + pzlib_filefunc_def->zclose_file = fclose_buf_func; + pzlib_filefunc_def->zerror_file = ferror_buf_func; + pzlib_filefunc_def->opaque = ourbuf; +} diff --git a/SSZipArchive/minizip/ioapi_buf.h b/SSZipArchive/minizip/ioapi_buf.h new file mode 100644 index 0000000..b0e7698 --- /dev/null +++ b/SSZipArchive/minizip/ioapi_buf.h @@ -0,0 +1,52 @@ +/* ioapi_buf.h -- IO base function header for compress/uncompress .zip + files using zlib + zip or unzip API + + This version of ioapi is designed to buffer IO. + + Copyright (C) 2012-2017 Nathan Moinvaziri + https://github.com/nmoinvaz/minizip + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. +*/ + +#ifndef _IOAPI_BUF_H +#define _IOAPI_BUF_H + +#include +#include +#include + +#include "zlib.h" +#include "ioapi.h" + +#ifdef __cplusplus +extern "C" { +#endif + +voidpf ZCALLBACK fopen_buf_func(voidpf opaque, const char* filename, int mode); +voidpf ZCALLBACK fopen64_buf_func(voidpf opaque, const void* filename, int mode); +voidpf ZCALLBACK fopendisk_buf_func(voidpf opaque, voidpf stream_cd, uint32_t number_disk, int mode); +voidpf ZCALLBACK fopendisk64_buf_func(voidpf opaque, voidpf stream_cd, uint32_t number_disk, int mode); +uint32_t ZCALLBACK fread_buf_func(voidpf opaque, voidpf stream, void* buf, uint32_t size); +uint32_t ZCALLBACK fwrite_buf_func(voidpf opaque, voidpf stream, const void* buf, uint32_t size); +long ZCALLBACK ftell_buf_func(voidpf opaque, voidpf stream); +uint64_t ZCALLBACK ftell64_buf_func(voidpf opaque, voidpf stream); +long ZCALLBACK fseek_buf_func(voidpf opaque, voidpf stream, uint32_t offset, int origin); +long ZCALLBACK fseek64_buf_func(voidpf opaque, voidpf stream, uint64_t offset, int origin); +int ZCALLBACK fclose_buf_func(voidpf opaque,voidpf stream); +int ZCALLBACK ferror_buf_func(voidpf opaque,voidpf stream); + +typedef struct ourbuffer_s { + zlib_filefunc_def filefunc; + zlib_filefunc64_def filefunc64; +} ourbuffer_t; + +void fill_buffer_filefunc(zlib_filefunc_def* pzlib_filefunc_def, ourbuffer_t *ourbuf); +void fill_buffer_filefunc64(zlib_filefunc64_def* pzlib_filefunc_def, ourbuffer_t *ourbuf); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/SSZipArchive/minizip/ioapi_mem.c b/SSZipArchive/minizip/ioapi_mem.c new file mode 100644 index 0000000..ed53345 --- /dev/null +++ b/SSZipArchive/minizip/ioapi_mem.c @@ -0,0 +1,167 @@ +/* ioapi_mem.c -- IO base function header for compress/uncompress .zip + files using zlib + zip or unzip API + + This version of ioapi is designed to access memory rather than files. + We do use a region of memory to put data in to and take it out of. We do + not have auto-extending buffers and do not inform anyone else that the + data has been written. It is really intended for accessing a zip archive + embedded in an application such that I can write an installer with no + external files. Creation of archives has not been attempted, although + parts of the framework are present. + + Based on Unzip ioapi.c version 0.22, May 19th, 2003 + + Copyright (C) 2012-2017 Nathan Moinvaziri + https://github.com/nmoinvaz/minizip + Copyright (C) 2003 Justin Fletcher + Copyright (C) 1998-2003 Gilles Vollant + http://www.winimage.com/zLibDll/minizip.html + + This file is under the same license as the Unzip tool it is distributed + with. +*/ + + +#include +#include +#include + +#include "zlib.h" +#include "ioapi.h" + +#include "ioapi_mem.h" + +#ifndef IOMEM_BUFFERSIZE +# define IOMEM_BUFFERSIZE (UINT16_MAX) +#endif + +voidpf ZCALLBACK fopen_mem_func(voidpf opaque, ZIP_UNUSED const char *filename, int mode) +{ + ourmemory_t *mem = (ourmemory_t *)opaque; + if (mem == NULL) + return NULL; /* Mem structure passed in was null */ + + if (mode & ZLIB_FILEFUNC_MODE_CREATE) + { + if (mem->grow) + { + mem->size = IOMEM_BUFFERSIZE; + mem->base = (char *)malloc(mem->size); + } + + mem->limit = 0; /* When writing we start with 0 bytes written */ + } + else + mem->limit = mem->size; + + mem->cur_offset = 0; + + return mem; +} + +voidpf ZCALLBACK fopendisk_mem_func(ZIP_UNUSED voidpf opaque, ZIP_UNUSED voidpf stream, ZIP_UNUSED uint32_t number_disk, ZIP_UNUSED int mode) +{ + /* Not used */ + return NULL; +} + +uint32_t ZCALLBACK fread_mem_func(ZIP_UNUSED voidpf opaque, voidpf stream, void *buf, uint32_t size) +{ + ourmemory_t *mem = (ourmemory_t *)stream; + + if (size > mem->size - mem->cur_offset) + size = mem->size - mem->cur_offset; + + memcpy(buf, mem->base + mem->cur_offset, size); + mem->cur_offset += size; + + return size; +} + +uint32_t ZCALLBACK fwrite_mem_func(ZIP_UNUSED voidpf opaque, voidpf stream, const void *buf, uint32_t size) +{ + ourmemory_t *mem = (ourmemory_t *)stream; + uint32_t newmemsize = 0; + char *newbase = NULL; + + if (size > mem->size - mem->cur_offset) + { + if (mem->grow) + { + newmemsize = mem->size; + if (size < IOMEM_BUFFERSIZE) + newmemsize += IOMEM_BUFFERSIZE; + else + newmemsize += size; + newbase = (char *)malloc(newmemsize); + memcpy(newbase, mem->base, mem->size); + free(mem->base); + mem->base = newbase; + mem->size = newmemsize; + } + else + size = mem->size - mem->cur_offset; + } + memcpy(mem->base + mem->cur_offset, buf, size); + mem->cur_offset += size; + if (mem->cur_offset > mem->limit) + mem->limit = mem->cur_offset; + + return size; +} + +long ZCALLBACK ftell_mem_func(ZIP_UNUSED voidpf opaque, voidpf stream) +{ + ourmemory_t *mem = (ourmemory_t *)stream; + return mem->cur_offset; +} + +long ZCALLBACK fseek_mem_func(ZIP_UNUSED voidpf opaque, voidpf stream, uint32_t offset, int origin) +{ + ourmemory_t *mem = (ourmemory_t *)stream; + uint32_t new_pos = 0; + switch (origin) + { + case ZLIB_FILEFUNC_SEEK_CUR: + new_pos = mem->cur_offset + offset; + break; + case ZLIB_FILEFUNC_SEEK_END: + new_pos = mem->limit + offset; + break; + case ZLIB_FILEFUNC_SEEK_SET: + new_pos = offset; + break; + default: + return -1; + } + + if (new_pos > mem->size) + return 1; /* Failed to seek that far */ + mem->cur_offset = new_pos; + return 0; +} + +int ZCALLBACK fclose_mem_func(ZIP_UNUSED voidpf opaque, ZIP_UNUSED voidpf stream) +{ + /* Even with grow = 1, caller must always free() memory */ + return 0; +} + +int ZCALLBACK ferror_mem_func(ZIP_UNUSED voidpf opaque, ZIP_UNUSED voidpf stream) +{ + /* We never return errors */ + return 0; +} + +void fill_memory_filefunc(zlib_filefunc_def *pzlib_filefunc_def, ourmemory_t *ourmem) +{ + pzlib_filefunc_def->zopen_file = fopen_mem_func; + pzlib_filefunc_def->zopendisk_file = fopendisk_mem_func; + pzlib_filefunc_def->zread_file = fread_mem_func; + pzlib_filefunc_def->zwrite_file = fwrite_mem_func; + pzlib_filefunc_def->ztell_file = ftell_mem_func; + pzlib_filefunc_def->zseek_file = fseek_mem_func; + pzlib_filefunc_def->zclose_file = fclose_mem_func; + pzlib_filefunc_def->zerror_file = ferror_mem_func; + pzlib_filefunc_def->opaque = ourmem; +} diff --git a/SSZipArchive/minizip/ioapi_mem.h b/SSZipArchive/minizip/ioapi_mem.h new file mode 100644 index 0000000..7061d6f --- /dev/null +++ b/SSZipArchive/minizip/ioapi_mem.h @@ -0,0 +1,52 @@ +/* ioapi_mem.h -- IO base function header for compress/uncompress .zip + files using zlib + zip or unzip API + + This version of ioapi is designed to access memory rather than files. + We do use a region of memory to put data in to and take it out of. + + Copyright (C) 2012-2017 Nathan Moinvaziri (https://github.com/nmoinvaz/minizip) + (C) 2003 Justin Fletcher + (C) 1998-2003 Gilles Vollant + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. +*/ + +#ifndef _IOAPI_MEM_H +#define _IOAPI_MEM_H + +#include +#include +#include + +#include "zlib.h" +#include "ioapi.h" + +#ifdef __cplusplus +extern "C" { +#endif + +voidpf ZCALLBACK fopen_mem_func(voidpf opaque, const char* filename, int mode); +voidpf ZCALLBACK fopendisk_mem_func(voidpf opaque, voidpf stream, uint32_t number_disk, int mode); +uint32_t ZCALLBACK fread_mem_func(voidpf opaque, voidpf stream, void* buf, uint32_t size); +uint32_t ZCALLBACK fwrite_mem_func(voidpf opaque, voidpf stream, const void* buf, uint32_t size); +long ZCALLBACK ftell_mem_func(voidpf opaque, voidpf stream); +long ZCALLBACK fseek_mem_func(voidpf opaque, voidpf stream, uint32_t offset, int origin); +int ZCALLBACK fclose_mem_func(voidpf opaque, voidpf stream); +int ZCALLBACK ferror_mem_func(voidpf opaque, voidpf stream); + +typedef struct ourmemory_s { + char *base; /* Base of the region of memory we're using */ + uint32_t size; /* Size of the region of memory we're using */ + uint32_t limit; /* Furthest we've written */ + uint32_t cur_offset; /* Current offset in the area */ + int grow; /* Growable memory buffer */ +} ourmemory_t; + +void fill_memory_filefunc(zlib_filefunc_def* pzlib_filefunc_def, ourmemory_t *ourmem); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/SSZipArchive/minizip/minishared.c b/SSZipArchive/minizip/minishared.c new file mode 100644 index 0000000..beabddc --- /dev/null +++ b/SSZipArchive/minizip/minishared.c @@ -0,0 +1,292 @@ +#include +#include +#include +#include +#include +#include +#include + +#include "zlib.h" +#include "ioapi.h" + +#ifdef _WIN32 +# include +# include +#else +# include +# include +# include +# include +#endif + +#include "minishared.h" + +#ifdef _WIN32 +# define USEWIN32IOAPI +# include "iowin32.h" +#endif + +uint32_t get_file_date(const char *path, uint32_t *dos_date) +{ + int ret = 0; +#ifdef _WIN32 + FILETIME ftm_local; + HANDLE find = NULL; + WIN32_FIND_DATAA ff32; + + find = FindFirstFileA(path, &ff32); + if (find != INVALID_HANDLE_VALUE) + { + FileTimeToLocalFileTime(&(ff32.ftLastWriteTime), &ftm_local); + FileTimeToDosDateTime(&ftm_local, ((LPWORD)dos_date) + 1, ((LPWORD)dos_date) + 0); + FindClose(find); + ret = 1; + } +#else + struct stat s; + struct tm *filedate = NULL; + time_t tm_t = 0; + + memset(&s, 0, sizeof(s)); + + if (strcmp(path, "-") != 0) + { + size_t len = strlen(path); + char *name = (char *)malloc(len + 1); + strncpy(name, path, len + 1); + name[len] = 0; + if (name[len - 1] == '/') + name[len - 1] = 0; + + /* Not all systems allow stat'ing a file with / appended */ + if (stat(name, &s) == 0) + { + tm_t = s.st_mtime; + ret = 1; + } + free(name); + } + + filedate = localtime(&tm_t); + *dos_date = tm_to_dosdate(filedate); +#endif + return ret; +} + +void change_file_date(const char *path, uint32_t dos_date) +{ +#ifdef _WIN32 + HANDLE handle = NULL; + FILETIME ftm, ftm_local, ftm_create, ftm_access, ftm_modified; + + handle = CreateFileA(path, GENERIC_READ | GENERIC_WRITE, 0, NULL, OPEN_EXISTING, 0, NULL); + if (handle != INVALID_HANDLE_VALUE) + { + GetFileTime(handle, &ftm_create, &ftm_access, &ftm_modified); + DosDateTimeToFileTime((WORD)(dos_date >> 16), (WORD)dos_date, &ftm_local); + LocalFileTimeToFileTime(&ftm_local, &ftm); + SetFileTime(handle, &ftm, &ftm_access, &ftm); + CloseHandle(handle); + } +#else + struct utimbuf ut; + ut.actime = ut.modtime = dosdate_to_time_t(dos_date); + utime(path, &ut); +#endif +} + +int invalid_date(const struct tm *ptm) +{ +#define datevalue_in_range(min, max, value) ((min) <= (value) && (value) <= (max)) + return (!datevalue_in_range(0, 207, ptm->tm_year) || + !datevalue_in_range(0, 11, ptm->tm_mon) || + !datevalue_in_range(1, 31, ptm->tm_mday) || + !datevalue_in_range(0, 23, ptm->tm_hour) || + !datevalue_in_range(0, 59, ptm->tm_min) || + !datevalue_in_range(0, 59, ptm->tm_sec)); +#undef datevalue_in_range +} + +// Conversion without validation +void dosdate_to_raw_tm(uint64_t dos_date, struct tm *ptm) +{ + uint64_t date = (uint64_t)(dos_date >> 16); + + ptm->tm_mday = (uint16_t)(date & 0x1f); + ptm->tm_mon = (uint16_t)(((date & 0x1E0) / 0x20) - 1); + ptm->tm_year = (uint16_t)(((date & 0x0FE00) / 0x0200) + 80); + ptm->tm_hour = (uint16_t)((dos_date & 0xF800) / 0x800); + ptm->tm_min = (uint16_t)((dos_date & 0x7E0) / 0x20); + ptm->tm_sec = (uint16_t)(2 * (dos_date & 0x1f)); + ptm->tm_isdst = -1; +} + +int dosdate_to_tm(uint64_t dos_date, struct tm *ptm) +{ + dosdate_to_raw_tm(dos_date, ptm); + + if (invalid_date(ptm)) + { + // Invalid date stored, so don't return it. + memset(ptm, 0, sizeof(struct tm)); + return -1; + } + return 0; +} + +time_t dosdate_to_time_t(uint64_t dos_date) +{ + struct tm ptm; + dosdate_to_raw_tm(dos_date, &ptm); + return mktime(&ptm); +} + +uint32_t tm_to_dosdate(const struct tm *ptm) +{ + struct tm fixed_tm; + + /* Years supported: + * [00, 79] (assumed to be between 2000 and 2079) + * [80, 207] (assumed to be between 1980 and 2107, typical output of old + software that does 'year-1900' to get a double digit year) + * [1980, 2107] (due to the date format limitations, only years between 1980 and 2107 can be stored.) + */ + + memcpy(&fixed_tm, ptm, sizeof(struct tm)); + if (fixed_tm.tm_year >= 1980) /* range [1980, 2107] */ + fixed_tm.tm_year -= 1980; + else if (fixed_tm.tm_year >= 80) /* range [80, 99] */ + fixed_tm.tm_year -= 80; + else /* range [00, 79] */ + fixed_tm.tm_year += 20; + + if (invalid_date(ptm)) + return 0; + + return (uint32_t)(((fixed_tm.tm_mday) + (32 * (fixed_tm.tm_mon + 1)) + (512 * fixed_tm.tm_year)) << 16) | + ((fixed_tm.tm_sec / 2) + (32 * fixed_tm.tm_min) + (2048 * (uint32_t)fixed_tm.tm_hour)); +} + +int makedir(const char *newdir) +{ + char *buffer = NULL; + char *p = NULL; + int len = (int)strlen(newdir); + + if (len <= 0) + return 0; + + buffer = (char*)malloc(len + 1); + if (buffer == NULL) + { + printf("Error allocating memory\n"); + return -1; + } + + strcpy(buffer, newdir); + + if (buffer[len - 1] == '/') + buffer[len - 1] = 0; + + if (MKDIR(buffer) == 0) + { + free(buffer); + return 1; + } + + p = buffer + 1; + while (1) + { + char hold; + while (*p && *p != '\\' && *p != '/') + p++; + hold = *p; + *p = 0; + + if ((MKDIR(buffer) == -1) && (errno == ENOENT)) + { + printf("couldn't create directory %s (%d)\n", buffer, errno); + free(buffer); + return 0; + } + + if (hold == 0) + break; + + *p++ = hold; + } + + free(buffer); + return 1; +} + +FILE *get_file_handle(const char *path) +{ + FILE *handle = NULL; +#if defined(WIN32) + wchar_t *pathWide = NULL; + int pathLength = 0; + + pathLength = MultiByteToWideChar(CP_UTF8, 0, path, -1, NULL, 0) + 1; + pathWide = (wchar_t*)calloc(pathLength, sizeof(wchar_t)); + MultiByteToWideChar(CP_UTF8, 0, path, -1, pathWide, pathLength); + handle = _wfopen((const wchar_t*)pathWide, L"rb"); + free(pathWide); +#else + handle = fopen64(path, "rb"); +#endif + + return handle; +} + +int check_file_exists(const char *path) +{ + FILE *handle = get_file_handle(path); + if (handle == NULL) + return 0; + fclose(handle); + return 1; +} + +int is_large_file(const char *path) +{ + FILE* handle = NULL; + uint64_t pos = 0; + + handle = get_file_handle(path); + if (handle == NULL) + return 0; + + fseeko64(handle, 0, SEEK_END); + pos = ftello64(handle); + fclose(handle); + + printf("file : %s is %lld bytes\n", path, pos); + + return (pos >= UINT32_MAX); +} + +void display_zpos64(uint64_t n, int size_char) +{ + /* To avoid compatibility problem we do here the conversion */ + char number[21] = { 0 }; + int offset = 19; + int pos_string = 19; + int size_display_string = 19; + + while (1) + { + number[offset] = (char)((n % 10) + '0'); + if (number[offset] != '0') + pos_string = offset; + n /= 10; + if (offset == 0) + break; + offset--; + } + + size_display_string -= pos_string; + while (size_char-- > size_display_string) + printf(" "); + printf("%s", &number[pos_string]); +} diff --git a/SSZipArchive/minizip/minishared.h b/SSZipArchive/minizip/minishared.h new file mode 100644 index 0000000..32fccb6 --- /dev/null +++ b/SSZipArchive/minizip/minishared.h @@ -0,0 +1,51 @@ +#ifndef _MINISHARED_H +#define _MINISHARED_H + +#ifdef __cplusplus +extern "C" { +#endif + +#ifdef _WIN32 +# define MKDIR(d) _mkdir(d) +# define CHDIR(d) _chdir(d) +#else +# define MKDIR(d) mkdir(d, 0775) +# define CHDIR(d) chdir(d) +#endif + +/***************************************************************************/ + +/* Get a file's date and time in dos format */ +uint32_t get_file_date(const char *path, uint32_t *dos_date); + +/* Sets a file's date and time in dos format */ +void change_file_date(const char *path, uint32_t dos_date); + +/* Convert dos date/time format to struct tm */ +int dosdate_to_tm(uint64_t dos_date, struct tm *ptm); + +/* Convert dos date/time format to time_t */ +time_t dosdate_to_time_t(uint64_t dos_date); + +/* Convert struct tm to dos date/time format */ +uint32_t tm_to_dosdate(const struct tm *ptm); + +/* Create a directory and all subdirectories */ +int makedir(const char *newdir); + +/* Check to see if a file exists */ +int check_file_exists(const char *path); + +/* Check to see if a file is over 4GB and needs ZIP64 extension */ +int is_large_file(const char *path); + +/* Print a 64-bit number for compatibility */ +void display_zpos64(uint64_t n, int size_char); + +/***************************************************************************/ + +#ifdef __cplusplus +} +#endif + +#endif /* _MINISHARED_H */ \ No newline at end of file diff --git a/SSZipArchive/minizip/unzip.c b/SSZipArchive/minizip/unzip.c new file mode 100644 index 0000000..90a7310 --- /dev/null +++ b/SSZipArchive/minizip/unzip.c @@ -0,0 +1,1999 @@ +/* unzip.c -- IO for uncompress .zip files using zlib + Version 1.2.0, September 16th, 2017 + part of the MiniZip project + + Copyright (C) 2010-2017 Nathan Moinvaziri + Modifications for AES, PKWARE disk spanning + https://github.com/nmoinvaz/minizip + Copyright (C) 2009-2010 Mathias Svensson + Modifications for Zip64 support on both zip and unzip + http://result42.com + Copyright (C) 2007-2008 Even Rouault + Modifications of Unzip for Zip64 + Copyright (C) 1998-2010 Gilles Vollant + http://www.winimage.com/zLibDll/minizip.html + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. +*/ + +#include +#include +#include +#include +#include +#include + +#include "zlib.h" +#include "unzip.h" + +#ifdef HAVE_AES +# define AES_METHOD (99) +# define AES_PWVERIFYSIZE (2) +# define AES_MAXSALTLENGTH (16) +# define AES_AUTHCODESIZE (10) +# define AES_HEADERSIZE (11) +# define AES_KEYSIZE(mode) (64 + (mode * 64)) + +# include "aes/aes.h" +# include "aes/fileenc.h" +#endif +#ifdef HAVE_APPLE_COMPRESSION +# include +#endif + +#ifndef NOUNCRYPT +# include "crypt.h" +#endif + +#define DISKHEADERMAGIC (0x08074b50) +#define LOCALHEADERMAGIC (0x04034b50) +#define CENTRALHEADERMAGIC (0x02014b50) +#define ENDHEADERMAGIC (0x06054b50) +#define ZIP64ENDHEADERMAGIC (0x06064b50) +#define ZIP64ENDLOCHEADERMAGIC (0x07064b50) + +#define SIZECENTRALDIRITEM (0x2e) +#define SIZECENTRALHEADERLOCATOR (0x14) +#define SIZEZIPLOCALHEADER (0x1e) + +#ifndef BUFREADCOMMENT +# define BUFREADCOMMENT (0x400) +#endif + +#ifndef UNZ_BUFSIZE +# define UNZ_BUFSIZE (UINT16_MAX) +#endif +#ifndef UNZ_MAXFILENAMEINZIP +# define UNZ_MAXFILENAMEINZIP (256) +#endif + +#ifndef ALLOC +# define ALLOC(size) (malloc(size)) +#endif +#ifndef TRYFREE +# define TRYFREE(p) {if (p) free(p);} +#endif + +const char unz_copyright[] = " unzip 1.2.0 Copyright 1998-2017 - https://github.com/nmoinvaz/minizip"; + +/* unz_file_info_internal contain internal info about a file in zipfile*/ +typedef struct unz_file_info64_internal_s +{ + uint64_t offset_curfile; /* relative offset of local header 8 bytes */ + uint64_t byte_before_the_zipfile; /* byte before the zipfile, (>0 for sfx) */ +#ifdef HAVE_AES + uint8_t aes_encryption_mode; + uint16_t aes_compression_method; + uint16_t aes_version; +#endif +} unz_file_info64_internal; + +/* file_in_zip_read_info_s contain internal information about a file in zipfile */ +typedef struct +{ + uint8_t *read_buffer; /* internal buffer for compressed data */ + z_stream stream; /* zLib stream structure for inflate */ +#ifdef HAVE_BZIP2 + bz_stream bstream; /* bzLib stream structure for bziped */ +#endif +#ifdef HAVE_APPLE_COMPRESSION + compression_stream astream; /* libcompression stream structure */ +#endif +#ifdef HAVE_AES + fcrypt_ctx aes_ctx; +#endif + uint64_t pos_in_zipfile; /* position in byte on the zipfile, for fseek */ + uint8_t stream_initialised; /* flag set if stream structure is initialised */ + + uint64_t offset_local_extrafield; /* offset of the local extra field */ + uint16_t size_local_extrafield; /* size of the local extra field */ + uint64_t pos_local_extrafield; /* position in the local extra field in read */ + uint64_t total_out_64; + + uint32_t crc32; /* crc32 of all data uncompressed */ + uint32_t crc32_expected; /* crc32 we must obtain after decompress all */ + uint64_t rest_read_compressed; /* number of byte to be decompressed */ + uint64_t rest_read_uncompressed; /* number of byte to be obtained after decomp */ + + zlib_filefunc64_32_def z_filefunc; + + voidpf filestream; /* io structore of the zipfile */ + uint16_t compression_method; /* compression method (0==store) */ + uint64_t byte_before_the_zipfile; /* byte before the zipfile, (>0 for sfx) */ + int raw; +} file_in_zip64_read_info_s; + +/* unz64_s contain internal information about the zipfile */ +typedef struct +{ + zlib_filefunc64_32_def z_filefunc; + + voidpf filestream; /* io structure of the current zipfile */ + voidpf filestream_with_CD; /* io structure of the disk with the central directory */ + + unz_global_info64 gi; /* public global information */ + + uint64_t byte_before_the_zipfile; /* byte before the zipfile, (>0 for sfx) */ + uint64_t num_file; /* number of the current file in the zipfile */ + uint64_t pos_in_central_dir; /* pos of the current file in the central dir */ + uint64_t current_file_ok; /* flag about the usability of the current file */ + uint64_t central_pos; /* position of the beginning of the central dir */ + uint32_t number_disk; /* number of the current disk, used for spanning ZIP */ + uint64_t size_central_dir; /* size of the central directory */ + uint64_t offset_central_dir; /* offset of start of central directory with + respect to the starting disk number */ + + unz_file_info64 cur_file_info; /* public info about the current file in zip*/ + unz_file_info64_internal cur_file_info_internal; + /* private info about it*/ + file_in_zip64_read_info_s *pfile_in_zip_read; + /* structure about the current file if we are decompressing it */ + int is_zip64; /* is the current file zip64 */ +#ifndef NOUNCRYPT + uint32_t keys[3]; /* keys defining the pseudo-random sequence */ + const z_crc_t *pcrc_32_tab; +#endif +} unz64_internal; + +/* Read a byte from a gz_stream; Return EOF for end of file. */ +static int unzReadUInt8(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream, uint8_t *value) +{ + uint8_t c = 0; + if (ZREAD64(*pzlib_filefunc_def, filestream, &c, 1) == 1) + { + *value = (uint8_t)c; + return UNZ_OK; + } + *value = 0; + if (ZERROR64(*pzlib_filefunc_def, filestream)) + return UNZ_ERRNO; + return UNZ_EOF; +} + +static int unzReadUInt16(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream, uint16_t *value) +{ + uint16_t x; + uint8_t c = 0; + int err = UNZ_OK; + + err = unzReadUInt8(pzlib_filefunc_def, filestream, &c); + x = (uint16_t)c; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &c); + x |= ((uint16_t)c) << 8; + + if (err == UNZ_OK) + *value = x; + else + *value = 0; + return err; +} + +static int unzReadUInt32(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream, uint32_t *value) +{ + uint32_t x = 0; + uint8_t c = 0; + int err = UNZ_OK; + + err = unzReadUInt8(pzlib_filefunc_def, filestream, &c); + x = (uint32_t)c; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &c); + x |= ((uint32_t)c) << 8; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &c); + x |= ((uint32_t)c) << 16; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint32_t)c) << 24; + + if (err == UNZ_OK) + *value = x; + else + *value = 0; + return err; +} + +static int unzReadUInt64(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream, uint64_t *value) +{ + uint64_t x = 0; + uint8_t i = 0; + int err = UNZ_OK; + + err = unzReadUInt8(pzlib_filefunc_def, filestream, &i); + x = (uint64_t)i; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &i); + x |= ((uint64_t)i) << 8; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &i); + x |= ((uint64_t)i) << 16; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &i); + x |= ((uint64_t)i) << 24; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &i); + x |= ((uint64_t)i) << 32; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &i); + x |= ((uint64_t)i) << 40; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &i); + x |= ((uint64_t)i) << 48; + if (err == UNZ_OK) + err = unzReadUInt8(pzlib_filefunc_def, filestream, &i); + x |= ((uint64_t)i) << 56; + + if (err == UNZ_OK) + *value = x; + else + *value = 0; + return err; +} + +/* Locate the Central directory of a zip file (at the end, just before the global comment) */ +static int unzSearchCentralDir(const zlib_filefunc64_32_def *pzlib_filefunc_def, uint64_t *pos_found, voidpf filestream) +{ + uint8_t buf[BUFREADCOMMENT + 4]; + uint64_t file_size = 0; + uint64_t back_read = 4; + uint64_t max_back = UINT16_MAX; /* maximum size of global comment */ + uint32_t read_size = 0; + uint64_t read_pos = 0; + uint32_t i = 0; + *pos_found = 0; + + if (ZSEEK64(*pzlib_filefunc_def, filestream, 0, ZLIB_FILEFUNC_SEEK_END) != 0) + return UNZ_ERRNO; + + file_size = ZTELL64(*pzlib_filefunc_def, filestream); + + if (max_back > file_size) + max_back = file_size; + + while (back_read < max_back) + { + if (back_read + BUFREADCOMMENT > max_back) + back_read = max_back; + else + back_read += BUFREADCOMMENT; + + read_pos = file_size - back_read; + read_size = ((BUFREADCOMMENT + 4) < (file_size - read_pos)) ? + (BUFREADCOMMENT + 4) : (uint32_t)(file_size - read_pos); + + if (ZSEEK64(*pzlib_filefunc_def, filestream, read_pos, ZLIB_FILEFUNC_SEEK_SET) != 0) + break; + if (ZREAD64(*pzlib_filefunc_def, filestream, buf, read_size) != read_size) + break; + + for (i = read_size - 3; (i--) > 0;) + if (((*(buf+i)) == (ENDHEADERMAGIC & 0xff)) && + ((*(buf+i+1)) == (ENDHEADERMAGIC >> 8 & 0xff)) && + ((*(buf+i+2)) == (ENDHEADERMAGIC >> 16 & 0xff)) && + ((*(buf+i+3)) == (ENDHEADERMAGIC >> 24 & 0xff))) + { + *pos_found = read_pos+i; + return UNZ_OK; + } + } + + return UNZ_ERRNO; +} + +/* Locate the Central directory 64 of a zipfile (at the end, just before the global comment) */ +static int unzSearchCentralDir64(const zlib_filefunc64_32_def *pzlib_filefunc_def, uint64_t *offset, voidpf filestream, + const uint64_t endcentraloffset) +{ + uint32_t value32 = 0; + *offset = 0; + + /* Zip64 end of central directory locator */ + if (ZSEEK64(*pzlib_filefunc_def, filestream, endcentraloffset - SIZECENTRALHEADERLOCATOR, ZLIB_FILEFUNC_SEEK_SET) != 0) + return UNZ_ERRNO; + + /* Read locator signature */ + if (unzReadUInt32(pzlib_filefunc_def, filestream, &value32) != UNZ_OK) + return UNZ_ERRNO; + if (value32 != ZIP64ENDLOCHEADERMAGIC) + return UNZ_ERRNO; + /* Number of the disk with the start of the zip64 end of central directory */ + if (unzReadUInt32(pzlib_filefunc_def, filestream, &value32) != UNZ_OK) + return UNZ_ERRNO; + /* Relative offset of the zip64 end of central directory record */ + if (unzReadUInt64(pzlib_filefunc_def, filestream, offset) != UNZ_OK) + return UNZ_ERRNO; + /* Total number of disks */ + if (unzReadUInt32(pzlib_filefunc_def, filestream, &value32) != UNZ_OK) + return UNZ_ERRNO; + /* Goto end of central directory record */ + if (ZSEEK64(*pzlib_filefunc_def, filestream, *offset, ZLIB_FILEFUNC_SEEK_SET) != 0) + return UNZ_ERRNO; + /* The signature */ + if (unzReadUInt32(pzlib_filefunc_def, filestream, &value32) != UNZ_OK) + return UNZ_ERRNO; + if (value32 != ZIP64ENDHEADERMAGIC) + return UNZ_ERRNO; + + return UNZ_OK; +} + +static unzFile unzOpenInternal(const void *path, zlib_filefunc64_32_def *pzlib_filefunc64_32_def) +{ + unz64_internal us = { 0 }; + unz64_internal *s = NULL; + uint64_t central_pos = 0; + uint64_t central_pos64 = 0; + uint64_t number_entry_CD = 0; + uint16_t value16 = 0; + uint32_t value32 = 0; + uint64_t value64 = 0; + voidpf filestream = NULL; + int err = UNZ_OK; + int err64 = UNZ_OK; + + if (pzlib_filefunc64_32_def == NULL) + fill_fopen64_filefunc(&us.z_filefunc.zfile_func64); + else + { + assert((pzlib_filefunc64_32_def->zopen32_file || pzlib_filefunc64_32_def->zfile_func64.zopen64_file) && + (pzlib_filefunc64_32_def->zopendisk32_file || pzlib_filefunc64_32_def->zfile_func64.zopendisk64_file) && + (pzlib_filefunc64_32_def->ztell32_file || pzlib_filefunc64_32_def->zfile_func64.ztell64_file) && + (pzlib_filefunc64_32_def->zseek32_file || pzlib_filefunc64_32_def->zfile_func64.zseek64_file)); + us.z_filefunc = *pzlib_filefunc64_32_def; + } + + us.filestream = ZOPEN64(us.z_filefunc, path, ZLIB_FILEFUNC_MODE_READ | ZLIB_FILEFUNC_MODE_EXISTING); + + if (us.filestream == NULL) + return NULL; + + us.filestream_with_CD = us.filestream; + + /* Search for end of central directory header */ + err = unzSearchCentralDir(&us.z_filefunc, ¢ral_pos, us.filestream); + if (err == UNZ_OK) + { + if (ZSEEK64(us.z_filefunc, us.filestream, central_pos, ZLIB_FILEFUNC_SEEK_SET) != 0) + err = UNZ_ERRNO; + + /* The signature, already checked */ + if (unzReadUInt32(&us.z_filefunc, us.filestream, &value32) != UNZ_OK) + err = UNZ_ERRNO; + /* Number of this disk */ + if (unzReadUInt16(&us.z_filefunc, us.filestream, &value16) != UNZ_OK) + err = UNZ_ERRNO; + us.number_disk = value16; + /* Number of the disk with the start of the central directory */ + if (unzReadUInt16(&us.z_filefunc, us.filestream, &value16) != UNZ_OK) + err = UNZ_ERRNO; + us.gi.number_disk_with_CD = value16; + /* Total number of entries in the central directory on this disk */ + if (unzReadUInt16(&us.z_filefunc, us.filestream, &value16) != UNZ_OK) + err = UNZ_ERRNO; + us.gi.number_entry = value16; + /* Total number of entries in the central directory */ + if (unzReadUInt16(&us.z_filefunc, us.filestream, &value16) != UNZ_OK) + err = UNZ_ERRNO; + number_entry_CD = value16; + if (number_entry_CD != us.gi.number_entry) + err = UNZ_BADZIPFILE; + /* Size of the central directory */ + if (unzReadUInt32(&us.z_filefunc, us.filestream, &value32) != UNZ_OK) + err = UNZ_ERRNO; + us.size_central_dir = value32; + /* Offset of start of central directory with respect to the starting disk number */ + if (unzReadUInt32(&us.z_filefunc, us.filestream, &value32) != UNZ_OK) + err = UNZ_ERRNO; + us.offset_central_dir = value32; + /* Zipfile comment length */ + if (unzReadUInt16(&us.z_filefunc, us.filestream, &us.gi.size_comment) != UNZ_OK) + err = UNZ_ERRNO; + + if (err == UNZ_OK) + { + /* Search for Zip64 end of central directory header */ + err64 = unzSearchCentralDir64(&us.z_filefunc, ¢ral_pos64, us.filestream, central_pos); + if (err64 == UNZ_OK) + { + central_pos = central_pos64; + us.is_zip64 = 1; + + if (ZSEEK64(us.z_filefunc, us.filestream, central_pos, ZLIB_FILEFUNC_SEEK_SET) != 0) + err = UNZ_ERRNO; + + /* the signature, already checked */ + if (unzReadUInt32(&us.z_filefunc, us.filestream, &value32) != UNZ_OK) + err = UNZ_ERRNO; + /* size of zip64 end of central directory record */ + if (unzReadUInt64(&us.z_filefunc, us.filestream, &value64) != UNZ_OK) + err = UNZ_ERRNO; + /* version made by */ + if (unzReadUInt16(&us.z_filefunc, us.filestream, &value16) != UNZ_OK) + err = UNZ_ERRNO; + /* version needed to extract */ + if (unzReadUInt16(&us.z_filefunc, us.filestream, &value16) != UNZ_OK) + err = UNZ_ERRNO; + /* number of this disk */ + if (unzReadUInt32(&us.z_filefunc, us.filestream, &us.number_disk) != UNZ_OK) + err = UNZ_ERRNO; + /* number of the disk with the start of the central directory */ + if (unzReadUInt32(&us.z_filefunc, us.filestream, &us.gi.number_disk_with_CD) != UNZ_OK) + err = UNZ_ERRNO; + /* total number of entries in the central directory on this disk */ + if (unzReadUInt64(&us.z_filefunc, us.filestream, &us.gi.number_entry) != UNZ_OK) + err = UNZ_ERRNO; + /* total number of entries in the central directory */ + if (unzReadUInt64(&us.z_filefunc, us.filestream, &number_entry_CD) != UNZ_OK) + err = UNZ_ERRNO; + if (number_entry_CD != us.gi.number_entry) + err = UNZ_BADZIPFILE; + /* size of the central directory */ + if (unzReadUInt64(&us.z_filefunc, us.filestream, &us.size_central_dir) != UNZ_OK) + err = UNZ_ERRNO; + /* offset of start of central directory with respect to the starting disk number */ + if (unzReadUInt64(&us.z_filefunc, us.filestream, &us.offset_central_dir) != UNZ_OK) + err = UNZ_ERRNO; + } + else if ((us.size_central_dir == UINT16_MAX) || (us.offset_central_dir == UINT32_MAX)) + err = UNZ_BADZIPFILE; + } + } + else + err = UNZ_ERRNO; + + if ((err == UNZ_OK) && (central_pos < us.offset_central_dir + us.size_central_dir)) + err = UNZ_BADZIPFILE; + + if (err != UNZ_OK) + { + ZCLOSE64(us.z_filefunc, us.filestream); + return NULL; + } + + if (us.gi.number_disk_with_CD == 0) + { + /* If there is only one disk open another stream so we don't have to seek between the CD + and the file headers constantly */ + filestream = ZOPEN64(us.z_filefunc, path, ZLIB_FILEFUNC_MODE_READ | ZLIB_FILEFUNC_MODE_EXISTING); + if (filestream != NULL) + us.filestream = filestream; + } + + /* Hack for zip files that have no respect for zip64 + if ((central_pos > 0xffffffff) && (us.offset_central_dir < 0xffffffff)) + us.offset_central_dir = central_pos - us.size_central_dir;*/ + + us.byte_before_the_zipfile = central_pos - (us.offset_central_dir + us.size_central_dir); + us.central_pos = central_pos; + + s = (unz64_internal*)ALLOC(sizeof(unz64_internal)); + if (s != NULL) + { + *s = us; + if (err64 != UNZ_OK) + // workaround incorrect count #184 + s->gi.number_entry = unzCountEntries(s); + + unzGoToFirstFile((unzFile)s); + } + return (unzFile)s; +} + +extern unzFile ZEXPORT unzOpen2(const char *path, zlib_filefunc_def *pzlib_filefunc32_def) +{ + if (pzlib_filefunc32_def != NULL) + { + zlib_filefunc64_32_def zlib_filefunc64_32_def_fill = { 0 }; + fill_zlib_filefunc64_32_def_from_filefunc32(&zlib_filefunc64_32_def_fill, pzlib_filefunc32_def); + return unzOpenInternal(path, &zlib_filefunc64_32_def_fill); + } + return unzOpenInternal(path, NULL); +} + +extern unzFile ZEXPORT unzOpen2_64(const void *path, zlib_filefunc64_def *pzlib_filefunc_def) +{ + if (pzlib_filefunc_def != NULL) + { + zlib_filefunc64_32_def zlib_filefunc64_32_def_fill = { 0 }; + zlib_filefunc64_32_def_fill.zfile_func64 = *pzlib_filefunc_def; + return unzOpenInternal(path, &zlib_filefunc64_32_def_fill); + } + return unzOpenInternal(path, NULL); +} + +extern unzFile ZEXPORT unzOpen(const char *path) +{ + return unzOpenInternal(path, NULL); +} + +extern unzFile ZEXPORT unzOpen64(const void *path) +{ + return unzOpenInternal(path, NULL); +} + +extern int ZEXPORT unzClose(unzFile file) +{ + unz64_internal *s; + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + + if (s->pfile_in_zip_read != NULL) + unzCloseCurrentFile(file); + + if ((s->filestream != NULL) && (s->filestream != s->filestream_with_CD)) + ZCLOSE64(s->z_filefunc, s->filestream); + if (s->filestream_with_CD != NULL) + ZCLOSE64(s->z_filefunc, s->filestream_with_CD); + + s->filestream = NULL; + s->filestream_with_CD = NULL; + TRYFREE(s); + return UNZ_OK; +} + +/* Goto to the next available disk for spanned archives */ +static int unzGoToNextDisk(unzFile file) +{ + unz64_internal *s; + uint32_t number_disk_next = 0; + + s = (unz64_internal*)file; + if (s == NULL) + return UNZ_PARAMERROR; + number_disk_next = s->number_disk; + + if ((s->pfile_in_zip_read != NULL) && (s->pfile_in_zip_read->rest_read_uncompressed > 0)) + /* We are currently reading a file and we need the next sequential disk */ + number_disk_next += 1; + else + /* Goto the disk for the current file */ + number_disk_next = s->cur_file_info.disk_num_start; + + if (number_disk_next != s->number_disk) + { + /* Switch disks */ + if ((s->filestream != NULL) && (s->filestream != s->filestream_with_CD)) + ZCLOSE64(s->z_filefunc, s->filestream); + + if (number_disk_next == s->gi.number_disk_with_CD) + { + s->filestream = s->filestream_with_CD; + } + else + { + s->filestream = ZOPENDISK64(s->z_filefunc, s->filestream_with_CD, number_disk_next, + ZLIB_FILEFUNC_MODE_READ | ZLIB_FILEFUNC_MODE_EXISTING); + } + + if (s->filestream == NULL) + return UNZ_ERRNO; + + s->number_disk = number_disk_next; + } + + return UNZ_OK; +} + +extern int ZEXPORT unzGetGlobalInfo(unzFile file, unz_global_info* pglobal_info32) +{ + unz64_internal *s = NULL; + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + + pglobal_info32->number_entry = (uint32_t)s->gi.number_entry; + pglobal_info32->size_comment = s->gi.size_comment; + pglobal_info32->number_disk_with_CD = s->gi.number_disk_with_CD; + return UNZ_OK; +} + +extern int ZEXPORT unzGetGlobalInfo64(unzFile file, unz_global_info64 *pglobal_info) +{ + unz64_internal *s = NULL; + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + *pglobal_info = s->gi; + return UNZ_OK; +} + +extern int ZEXPORT unzGetGlobalComment(unzFile file, char *comment, uint16_t comment_size) +{ + unz64_internal *s = NULL; + uint16_t bytes_to_read = comment_size; + if (file == NULL) + return (int)UNZ_PARAMERROR; + s = (unz64_internal*)file; + + if (bytes_to_read > s->gi.size_comment) + bytes_to_read = s->gi.size_comment; + + if (ZSEEK64(s->z_filefunc, s->filestream_with_CD, s->central_pos + 22, ZLIB_FILEFUNC_SEEK_SET) != 0) + return UNZ_ERRNO; + + if (bytes_to_read > 0) + { + *comment = 0; + if (ZREAD64(s->z_filefunc, s->filestream_with_CD, comment, bytes_to_read) != bytes_to_read) + return UNZ_ERRNO; + } + + if ((comment != NULL) && (comment_size > s->gi.size_comment)) + *(comment + s->gi.size_comment) = 0; + + return (int)bytes_to_read; +} + +static int unzGetCurrentFileInfoField(unzFile file, uint32_t *seek, void *field, uint16_t field_size, uint16_t size_file_field, int null_terminated_field) +{ + unz64_internal *s = NULL; + uint32_t bytes_to_read = 0; + int err = UNZ_OK; + + if (file == NULL) + return (int)UNZ_PARAMERROR; + s = (unz64_internal*)file; + + /* Read field */ + if (field != NULL) + { + if (size_file_field < field_size) + { + if (null_terminated_field) + *((char *)field+size_file_field) = 0; + + bytes_to_read = size_file_field; + } + else + bytes_to_read = field_size; + + if (*seek != 0) + { + if (ZSEEK64(s->z_filefunc, s->filestream_with_CD, *seek, ZLIB_FILEFUNC_SEEK_CUR) == 0) + *seek = 0; + else + err = UNZ_ERRNO; + } + + if ((size_file_field > 0) && (field_size > 0)) + { + if (ZREAD64(s->z_filefunc, s->filestream_with_CD, field, bytes_to_read) != bytes_to_read) + err = UNZ_ERRNO; + } + *seek += size_file_field - bytes_to_read; + } + else + { + *seek += size_file_field; + } + + return err; +} + +/* Get info about the current file in the zipfile, with internal only info */ +static int unzGetCurrentFileInfoInternal(unzFile file, unz_file_info64 *pfile_info, + unz_file_info64_internal *pfile_info_internal, char *filename, uint16_t filename_size, void *extrafield, + uint16_t extrafield_size, char *comment, uint16_t comment_size) +{ + unz64_internal *s = NULL; + unz_file_info64 file_info; + unz_file_info64_internal file_info_internal; + uint32_t magic = 0; + uint64_t current_pos = 0; + uint32_t seek = 0; + uint32_t extra_pos = 0; + uint16_t extra_header_id = 0; + uint16_t extra_data_size = 0; + uint16_t value16 = 0; + uint32_t value32 = 0; + uint64_t value64 = 0; + int err = UNZ_OK; + + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + + if (ZSEEK64(s->z_filefunc, s->filestream_with_CD, + s->pos_in_central_dir + s->byte_before_the_zipfile, ZLIB_FILEFUNC_SEEK_SET) != 0) + err = UNZ_ERRNO; + + /* Check the magic */ + if (err == UNZ_OK) + { + if (unzReadUInt32(&s->z_filefunc, s->filestream_with_CD, &magic) != UNZ_OK) + err = UNZ_ERRNO; + else if (magic != CENTRALHEADERMAGIC) + err = UNZ_BADZIPFILE; + } + + /* Read central directory header */ + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &file_info.version) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &file_info.version_needed) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &file_info.flag) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &file_info.compression_method) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt32(&s->z_filefunc, s->filestream_with_CD, &file_info.dos_date) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt32(&s->z_filefunc, s->filestream_with_CD, &file_info.crc) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt32(&s->z_filefunc, s->filestream_with_CD, &value32) != UNZ_OK) + err = UNZ_ERRNO; + file_info.compressed_size = value32; + if (unzReadUInt32(&s->z_filefunc, s->filestream_with_CD, &value32) != UNZ_OK) + err = UNZ_ERRNO; + file_info.uncompressed_size = value32; + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &file_info.size_filename) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &file_info.size_file_extra) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &file_info.size_file_comment) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &value16) != UNZ_OK) + err = UNZ_ERRNO; + file_info.disk_num_start = value16; + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &file_info.internal_fa) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt32(&s->z_filefunc, s->filestream_with_CD, &file_info.external_fa) != UNZ_OK) + err = UNZ_ERRNO; + /* Relative offset of local header */ + if (unzReadUInt32(&s->z_filefunc, s->filestream_with_CD, &value32) != UNZ_OK) + err = UNZ_ERRNO; + + file_info.size_file_extra_internal = 0; + file_info.disk_offset = value32; + file_info_internal.offset_curfile = value32; +#ifdef HAVE_AES + file_info_internal.aes_compression_method = 0; + file_info_internal.aes_encryption_mode = 0; + file_info_internal.aes_version = 0; +#endif + + if (err == UNZ_OK) + err = unzGetCurrentFileInfoField(file, &seek, filename, filename_size, file_info.size_filename, 1); + + /* Read extrafield */ + if (err == UNZ_OK) + err = unzGetCurrentFileInfoField(file, &seek, extrafield, extrafield_size, file_info.size_file_extra, 0); + + if ((err == UNZ_OK) && (file_info.size_file_extra != 0)) + { + if (seek != 0) + { + if (ZSEEK64(s->z_filefunc, s->filestream_with_CD, seek, ZLIB_FILEFUNC_SEEK_CUR) == 0) + seek = 0; + else + err = UNZ_ERRNO; + } + + /* We are going to parse the extra field so we need to move back */ + current_pos = ZTELL64(s->z_filefunc, s->filestream_with_CD); + if (current_pos < file_info.size_file_extra) + err = UNZ_ERRNO; + current_pos -= file_info.size_file_extra; + if (ZSEEK64(s->z_filefunc, s->filestream_with_CD, current_pos, ZLIB_FILEFUNC_SEEK_SET) != 0) + err = UNZ_ERRNO; + + while ((err != UNZ_ERRNO) && (extra_pos < file_info.size_file_extra)) + { + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &extra_header_id) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &extra_data_size) != UNZ_OK) + err = UNZ_ERRNO; + + /* ZIP64 extra fields */ + if (extra_header_id == 0x0001) + { + /* Subtract size of ZIP64 field, since ZIP64 is handled internally */ + file_info.size_file_extra_internal += 2 + 2 + extra_data_size; + + if (file_info.uncompressed_size == UINT32_MAX) + { + if (unzReadUInt64(&s->z_filefunc, s->filestream_with_CD, &file_info.uncompressed_size) != UNZ_OK) + err = UNZ_ERRNO; + } + if (file_info.compressed_size == UINT32_MAX) + { + if (unzReadUInt64(&s->z_filefunc, s->filestream_with_CD, &file_info.compressed_size) != UNZ_OK) + err = UNZ_ERRNO; + } + if (file_info_internal.offset_curfile == UINT32_MAX) + { + /* Relative Header offset */ + if (unzReadUInt64(&s->z_filefunc, s->filestream_with_CD, &value64) != UNZ_OK) + err = UNZ_ERRNO; + file_info_internal.offset_curfile = value64; + file_info.disk_offset = value64; + } + if (file_info.disk_num_start == UINT32_MAX) + { + /* Disk Start Number */ + if (unzReadUInt32(&s->z_filefunc, s->filestream_with_CD, &file_info.disk_num_start) != UNZ_OK) + err = UNZ_ERRNO; + } + } +#ifdef HAVE_AES + /* AES header */ + else if (extra_header_id == 0x9901) + { + uint8_t value8 = 0; + + /* Subtract size of AES field, since AES is handled internally */ + file_info.size_file_extra_internal += 2 + 2 + extra_data_size; + + /* Verify version info */ + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &value16) != UNZ_OK) + err = UNZ_ERRNO; + /* Support AE-1 and AE-2 */ + if (value16 != 1 && value16 != 2) + err = UNZ_ERRNO; + file_info_internal.aes_version = value16; + if (unzReadUInt8(&s->z_filefunc, s->filestream_with_CD, &value8) != UNZ_OK) + err = UNZ_ERRNO; + if ((char)value8 != 'A') + err = UNZ_ERRNO; + if (unzReadUInt8(&s->z_filefunc, s->filestream_with_CD, &value8) != UNZ_OK) + err = UNZ_ERRNO; + if ((char)value8 != 'E') + err = UNZ_ERRNO; + /* Get AES encryption strength and actual compression method */ + if (unzReadUInt8(&s->z_filefunc, s->filestream_with_CD, &value8) != UNZ_OK) + err = UNZ_ERRNO; + file_info_internal.aes_encryption_mode = value8; + if (unzReadUInt16(&s->z_filefunc, s->filestream_with_CD, &value16) != UNZ_OK) + err = UNZ_ERRNO; + file_info_internal.aes_compression_method = value16; + } +#endif + else + { + if (ZSEEK64(s->z_filefunc, s->filestream_with_CD, extra_data_size, ZLIB_FILEFUNC_SEEK_CUR) != 0) + err = UNZ_ERRNO; + } + + extra_pos += 2 + 2 + extra_data_size; + } + } + + if (file_info.disk_num_start == s->gi.number_disk_with_CD) + file_info_internal.byte_before_the_zipfile = s->byte_before_the_zipfile; + else + file_info_internal.byte_before_the_zipfile = 0; + + if (err == UNZ_OK) + err = unzGetCurrentFileInfoField(file, &seek, comment, comment_size, file_info.size_file_comment, 1); + + if ((err == UNZ_OK) && (pfile_info != NULL)) + *pfile_info = file_info; + if ((err == UNZ_OK) && (pfile_info_internal != NULL)) + *pfile_info_internal = file_info_internal; + + return err; +} + +extern int ZEXPORT unzGetCurrentFileInfo(unzFile file, unz_file_info *pfile_info, char *filename, + uint16_t filename_size, void *extrafield, uint16_t extrafield_size, char *comment, uint16_t comment_size) +{ + unz_file_info64 file_info64; + int err = UNZ_OK; + + err = unzGetCurrentFileInfoInternal(file, &file_info64, NULL, filename, filename_size, + extrafield, extrafield_size, comment, comment_size); + + if ((err == UNZ_OK) && (pfile_info != NULL)) + { + pfile_info->version = file_info64.version; + pfile_info->version_needed = file_info64.version_needed; + pfile_info->flag = file_info64.flag; + pfile_info->compression_method = file_info64.compression_method; + pfile_info->dos_date = file_info64.dos_date; + pfile_info->crc = file_info64.crc; + + pfile_info->size_filename = file_info64.size_filename; + pfile_info->size_file_extra = file_info64.size_file_extra - file_info64.size_file_extra_internal; + pfile_info->size_file_comment = file_info64.size_file_comment; + + pfile_info->disk_num_start = (uint16_t)file_info64.disk_num_start; + pfile_info->internal_fa = file_info64.internal_fa; + pfile_info->external_fa = file_info64.external_fa; + + pfile_info->compressed_size = (uint32_t)file_info64.compressed_size; + pfile_info->uncompressed_size = (uint32_t)file_info64.uncompressed_size; + } + return err; +} + +extern int ZEXPORT unzGetCurrentFileInfo64(unzFile file, unz_file_info64 * pfile_info, char *filename, + uint16_t filename_size, void *extrafield, uint16_t extrafield_size, char *comment, uint16_t comment_size) +{ + return unzGetCurrentFileInfoInternal(file, pfile_info, NULL, filename, filename_size, + extrafield, extrafield_size, comment, comment_size); +} + +/* Read the local header of the current zipfile. Check the coherency of the local header and info in the + end of central directory about this file store in *piSizeVar the size of extra info in local header + (filename and size of extra field data) */ +static int unzCheckCurrentFileCoherencyHeader(unz64_internal *s, uint32_t *psize_variable, uint64_t *poffset_local_extrafield, + uint16_t *psize_local_extrafield) +{ + uint32_t magic = 0; + uint16_t value16 = 0; + uint32_t value32 = 0; + uint32_t flags = 0; + uint16_t size_filename = 0; + uint16_t size_extra_field = 0; + uint16_t compression_method = 0; + int err = UNZ_OK; + + if (psize_variable == NULL) + return UNZ_PARAMERROR; + *psize_variable = 0; + if (poffset_local_extrafield == NULL) + return UNZ_PARAMERROR; + *poffset_local_extrafield = 0; + if (psize_local_extrafield == NULL) + return UNZ_PARAMERROR; + *psize_local_extrafield = 0; + + err = unzGoToNextDisk((unzFile)s); + if (err != UNZ_OK) + return err; + + if (ZSEEK64(s->z_filefunc, s->filestream, s->cur_file_info_internal.offset_curfile + + s->cur_file_info_internal.byte_before_the_zipfile, ZLIB_FILEFUNC_SEEK_SET) != 0) + return UNZ_ERRNO; + + if (err == UNZ_OK) + { + if (unzReadUInt32(&s->z_filefunc, s->filestream, &magic) != UNZ_OK) + err = UNZ_ERRNO; + else if (magic != LOCALHEADERMAGIC) + err = UNZ_BADZIPFILE; + } + + if (unzReadUInt16(&s->z_filefunc, s->filestream, &value16) != UNZ_OK) + err = UNZ_ERRNO; + if (unzReadUInt16(&s->z_filefunc, s->filestream, &value16) != UNZ_OK) + err = UNZ_ERRNO; + flags = value16; + if (unzReadUInt16(&s->z_filefunc, s->filestream, &value16) != UNZ_OK) + err = UNZ_ERRNO; + else if ((err == UNZ_OK) && (value16 != s->cur_file_info.compression_method)) + err = UNZ_BADZIPFILE; + + compression_method = s->cur_file_info.compression_method; +#ifdef HAVE_AES + if (compression_method == AES_METHOD) + compression_method = s->cur_file_info_internal.aes_compression_method; +#endif + + if ((err == UNZ_OK) && (compression_method != 0) && (compression_method != Z_DEFLATED)) + { +#ifdef HAVE_BZIP2 + if (compression_method != Z_BZIP2ED) +#endif + err = UNZ_BADZIPFILE; + } + + if (unzReadUInt32(&s->z_filefunc, s->filestream, &value32) != UNZ_OK) /* date/time */ + err = UNZ_ERRNO; + if (unzReadUInt32(&s->z_filefunc, s->filestream, &value32) != UNZ_OK) /* crc */ + err = UNZ_ERRNO; + else if ((err == UNZ_OK) && (value32 != s->cur_file_info.crc) && ((flags & 8) == 0)) + err = UNZ_BADZIPFILE; + if (unzReadUInt32(&s->z_filefunc, s->filestream, &value32) != UNZ_OK) /* size compr */ + err = UNZ_ERRNO; + else if ((value32 != UINT32_MAX) && (err == UNZ_OK) && (value32 != s->cur_file_info.compressed_size) && ((flags & 8) == 0)) + err = UNZ_BADZIPFILE; + if (unzReadUInt32(&s->z_filefunc, s->filestream, &value32) != UNZ_OK) /* size uncompr */ + err = UNZ_ERRNO; + else if ((value32 != UINT32_MAX) && (err == UNZ_OK) && (value32 != s->cur_file_info.uncompressed_size) && ((flags & 8) == 0)) + err = UNZ_BADZIPFILE; + if (unzReadUInt16(&s->z_filefunc, s->filestream, &size_filename) != UNZ_OK) + err = UNZ_ERRNO; + + *psize_variable += size_filename; + + if (unzReadUInt16(&s->z_filefunc, s->filestream, &size_extra_field) != UNZ_OK) + err = UNZ_ERRNO; + + *poffset_local_extrafield = s->cur_file_info_internal.offset_curfile + SIZEZIPLOCALHEADER + size_filename; + *psize_local_extrafield = size_extra_field; + *psize_variable += size_extra_field; + + return err; +} + +extern uint64_t ZEXPORT unzCountEntries(const unzFile file) +{ + if (file == NULL) + return 0; + + unz64_internal s = *(unz64_internal*)file; + + s.pos_in_central_dir = s.offset_central_dir; + s.num_file = 0; + while (UNZ_OK == unzGetCurrentFileInfoInternal(&s, + &s.cur_file_info, + &s.cur_file_info_internal, + NULL, 0, NULL, 0, NULL, 0)) + { + s.pos_in_central_dir += SIZECENTRALDIRITEM + + s.cur_file_info.size_filename + + s.cur_file_info.size_file_extra + + s.cur_file_info.size_file_comment; + s.num_file += 1; + } + return s.num_file; +} + +/* + Open for reading data the current file in the zipfile. + If there is no error and the file is opened, the return value is UNZ_OK. +*/ +extern int ZEXPORT unzOpenCurrentFile3(unzFile file, int *method, int *level, int raw, const char *password) +{ + unz64_internal *s = NULL; + file_in_zip64_read_info_s *pfile_in_zip_read_info = NULL; + uint16_t compression_method = 0; + uint64_t offset_local_extrafield = 0; + uint16_t size_local_extrafield = 0; + uint32_t size_variable = 0; + int err = UNZ_OK; +#ifndef NOUNCRYPT + char source[12]; +#else + if (password != NULL) + return UNZ_PARAMERROR; +#endif + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + if (!s->current_file_ok) + return UNZ_PARAMERROR; + + if (s->pfile_in_zip_read != NULL) + unzCloseCurrentFile(file); + + if (unzCheckCurrentFileCoherencyHeader(s, &size_variable, &offset_local_extrafield, &size_local_extrafield) != UNZ_OK) + return UNZ_BADZIPFILE; + + compression_method = s->cur_file_info.compression_method; +#ifdef HAVE_AES + if (compression_method == AES_METHOD) + { + compression_method = s->cur_file_info_internal.aes_compression_method; + if (password == NULL) + { + return UNZ_PARAMERROR; + } + } +#endif + + if (method != NULL) + *method = compression_method; + + if (level != NULL) + { + *level = 6; + switch (s->cur_file_info.flag & 0x06) + { + case 6 : *level = 1; break; + case 4 : *level = 2; break; + case 2 : *level = 9; break; + } + } + + if ((compression_method != 0) && (compression_method != Z_DEFLATED)) + { +#ifdef HAVE_BZIP2 + if (compression_method != Z_BZIP2ED) +#endif + { + return UNZ_BADZIPFILE; + } + } + + pfile_in_zip_read_info = (file_in_zip64_read_info_s*)ALLOC(sizeof(file_in_zip64_read_info_s)); + if (pfile_in_zip_read_info == NULL) + return UNZ_INTERNALERROR; + + pfile_in_zip_read_info->read_buffer = (uint8_t*)ALLOC(UNZ_BUFSIZE); + if (pfile_in_zip_read_info->read_buffer == NULL) + { + TRYFREE(pfile_in_zip_read_info); + return UNZ_INTERNALERROR; + } + + pfile_in_zip_read_info->stream_initialised = 0; + + pfile_in_zip_read_info->filestream = s->filestream; + pfile_in_zip_read_info->z_filefunc = s->z_filefunc; + + pfile_in_zip_read_info->raw = raw; + pfile_in_zip_read_info->crc32 = 0; + pfile_in_zip_read_info->crc32_expected = s->cur_file_info.crc; + pfile_in_zip_read_info->total_out_64 = 0; + pfile_in_zip_read_info->compression_method = compression_method; + + pfile_in_zip_read_info->offset_local_extrafield = offset_local_extrafield; + pfile_in_zip_read_info->size_local_extrafield = size_local_extrafield; + pfile_in_zip_read_info->pos_local_extrafield = 0; + + pfile_in_zip_read_info->rest_read_compressed = s->cur_file_info.compressed_size; + pfile_in_zip_read_info->rest_read_uncompressed = s->cur_file_info.uncompressed_size; + pfile_in_zip_read_info->byte_before_the_zipfile = 0; + + if (s->number_disk == s->gi.number_disk_with_CD) + pfile_in_zip_read_info->byte_before_the_zipfile = s->byte_before_the_zipfile; + + pfile_in_zip_read_info->pos_in_zipfile = s->cur_file_info_internal.offset_curfile + SIZEZIPLOCALHEADER + size_variable; + + pfile_in_zip_read_info->stream.zalloc = (alloc_func)0; + pfile_in_zip_read_info->stream.zfree = (free_func)0; + pfile_in_zip_read_info->stream.opaque = (voidpf)s; + pfile_in_zip_read_info->stream.total_out = 0; + pfile_in_zip_read_info->stream.total_in = 0; + pfile_in_zip_read_info->stream.next_in = NULL; + pfile_in_zip_read_info->stream.avail_in = 0; + + if (!raw) + { + if (compression_method == Z_BZIP2ED) + { +#ifdef HAVE_BZIP2 + pfile_in_zip_read_info->bstream.bzalloc = (void *(*) (void *, int, int))0; + pfile_in_zip_read_info->bstream.bzfree = (free_func)0; + pfile_in_zip_read_info->bstream.opaque = (voidpf)0; + pfile_in_zip_read_info->bstream.state = (voidpf)0; + + err = BZ2_bzDecompressInit(&pfile_in_zip_read_info->bstream, 0, 0); + if (err == Z_OK) + { + pfile_in_zip_read_info->stream_initialised = Z_BZIP2ED; + } + else + { + TRYFREE(pfile_in_zip_read_info); + return err; + } +#else + pfile_in_zip_read_info->raw = 1; +#endif + } + else if (compression_method == Z_DEFLATED) + { +#ifdef HAVE_APPLE_COMPRESSION + err = compression_stream_init(&pfile_in_zip_read_info->astream, COMPRESSION_STREAM_DECODE, COMPRESSION_ZLIB); + if (err == COMPRESSION_STATUS_ERROR) + err = UNZ_INTERNALERROR; + else + err = Z_OK; +#else + err = inflateInit2(&pfile_in_zip_read_info->stream, -MAX_WBITS); +#endif + if (err == Z_OK) + { + pfile_in_zip_read_info->stream_initialised = Z_DEFLATED; + } + else + { + TRYFREE(pfile_in_zip_read_info); + return err; + } + /* windowBits is passed < 0 to tell that there is no zlib header. + * Note that in this case inflate *requires* an extra "dummy" byte + * after the compressed stream in order to complete decompression and + * return Z_STREAM_END. + * In unzip, i don't wait absolutely Z_STREAM_END because I known the + * size of both compressed and uncompressed data + */ + } + } + + s->pfile_in_zip_read = pfile_in_zip_read_info; + +#ifndef NOUNCRYPT + s->pcrc_32_tab = NULL; + + if ((password != NULL) && ((s->cur_file_info.flag & 1) != 0)) + { + if (ZSEEK64(s->z_filefunc, s->filestream, + s->pfile_in_zip_read->pos_in_zipfile + s->pfile_in_zip_read->byte_before_the_zipfile, + ZLIB_FILEFUNC_SEEK_SET) != 0) + return UNZ_INTERNALERROR; +#ifdef HAVE_AES + if (s->cur_file_info.compression_method == AES_METHOD) + { + unsigned char passverify_archive[AES_PWVERIFYSIZE]; + unsigned char passverify_password[AES_PWVERIFYSIZE]; + unsigned char salt_value[AES_MAXSALTLENGTH]; + uint32_t salt_length = 0; + + if ((s->cur_file_info_internal.aes_encryption_mode < 1) || + (s->cur_file_info_internal.aes_encryption_mode > 3)) + return UNZ_INTERNALERROR; + + salt_length = SALT_LENGTH(s->cur_file_info_internal.aes_encryption_mode); + + if (ZREAD64(s->z_filefunc, s->filestream, salt_value, salt_length) != salt_length) + return UNZ_INTERNALERROR; + if (ZREAD64(s->z_filefunc, s->filestream, passverify_archive, AES_PWVERIFYSIZE) != AES_PWVERIFYSIZE) + return UNZ_INTERNALERROR; + + fcrypt_init(s->cur_file_info_internal.aes_encryption_mode, (uint8_t *)password, + (uint32_t)strlen(password), salt_value, passverify_password, &s->pfile_in_zip_read->aes_ctx); + + if (memcmp(passverify_archive, passverify_password, AES_PWVERIFYSIZE) != 0) + return UNZ_BADPASSWORD; + + s->pfile_in_zip_read->rest_read_compressed -= salt_length + AES_PWVERIFYSIZE; + s->pfile_in_zip_read->rest_read_compressed -= AES_AUTHCODESIZE; + + s->pfile_in_zip_read->pos_in_zipfile += salt_length + AES_PWVERIFYSIZE; + } + else +#endif + { + int i; + s->pcrc_32_tab = (const z_crc_t*)get_crc_table(); + init_keys(password, s->keys, s->pcrc_32_tab); + + if (ZREAD64(s->z_filefunc, s->filestream, source, 12) < 12) + return UNZ_INTERNALERROR; + + for (i = 0; i < 12; i++) + zdecode(s->keys, s->pcrc_32_tab, source[i]); + + s->pfile_in_zip_read->rest_read_compressed -= 12; + s->pfile_in_zip_read->pos_in_zipfile += 12; + } + } +#endif + + return UNZ_OK; +} + +extern int ZEXPORT unzOpenCurrentFile(unzFile file) +{ + return unzOpenCurrentFile3(file, NULL, NULL, 0, NULL); +} + +extern int ZEXPORT unzOpenCurrentFilePassword(unzFile file, const char *password) +{ + return unzOpenCurrentFile3(file, NULL, NULL, 0, password); +} + +extern int ZEXPORT unzOpenCurrentFile2(unzFile file, int *method, int *level, int raw) +{ + return unzOpenCurrentFile3(file, method, level, raw, NULL); +} + +/* Read bytes from the current file. + buf contain buffer where data must be copied + len the size of buf. + + return the number of byte copied if some bytes are copied + return 0 if the end of file was reached + return <0 with error code if there is an error (UNZ_ERRNO for IO error, or zLib error for uncompress error) */ +extern int ZEXPORT unzReadCurrentFile(unzFile file, voidp buf, uint32_t len) +{ + unz64_internal *s = NULL; + uint32_t read = 0; + int err = UNZ_OK; + + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + + if (s->pfile_in_zip_read == NULL) + return UNZ_PARAMERROR; + if (s->pfile_in_zip_read->read_buffer == NULL) + return UNZ_END_OF_LIST_OF_FILE; + if (len == 0) + return 0; + if (len > UINT16_MAX) + return UNZ_PARAMERROR; + + s->pfile_in_zip_read->stream.next_out = (uint8_t*)buf; + s->pfile_in_zip_read->stream.avail_out = (uint16_t)len; + + if ((s->pfile_in_zip_read->compression_method == 0) || (s->pfile_in_zip_read->raw)) + { + if (len > s->pfile_in_zip_read->rest_read_compressed + s->pfile_in_zip_read->stream.avail_in) + s->pfile_in_zip_read->stream.avail_out = (uint16_t)s->pfile_in_zip_read->rest_read_compressed + + s->pfile_in_zip_read->stream.avail_in; + } + + do + { + if (s->pfile_in_zip_read->stream.avail_in == 0) + { + uint32_t bytes_to_read = UNZ_BUFSIZE; + uint32_t bytes_not_read = 0; + uint32_t bytes_read = 0; + uint32_t total_bytes_read = 0; + + if (s->pfile_in_zip_read->stream.next_in != NULL) + bytes_not_read = (uint32_t)(s->pfile_in_zip_read->read_buffer + UNZ_BUFSIZE - + s->pfile_in_zip_read->stream.next_in); + bytes_to_read -= bytes_not_read; + if (bytes_not_read > 0) + memcpy(s->pfile_in_zip_read->read_buffer, s->pfile_in_zip_read->stream.next_in, bytes_not_read); + if (s->pfile_in_zip_read->rest_read_compressed < bytes_to_read) + bytes_to_read = (uint16_t)s->pfile_in_zip_read->rest_read_compressed; + + while (total_bytes_read != bytes_to_read) + { + if (ZSEEK64(s->pfile_in_zip_read->z_filefunc, s->pfile_in_zip_read->filestream, + s->pfile_in_zip_read->pos_in_zipfile + s->pfile_in_zip_read->byte_before_the_zipfile, + ZLIB_FILEFUNC_SEEK_SET) != 0) + return UNZ_ERRNO; + + bytes_read = ZREAD64(s->pfile_in_zip_read->z_filefunc, s->pfile_in_zip_read->filestream, + s->pfile_in_zip_read->read_buffer + bytes_not_read + total_bytes_read, + bytes_to_read - total_bytes_read); + + total_bytes_read += bytes_read; + s->pfile_in_zip_read->pos_in_zipfile += bytes_read; + + if (bytes_read == 0) + { + if (ZERROR64(s->pfile_in_zip_read->z_filefunc, s->pfile_in_zip_read->filestream)) + return UNZ_ERRNO; + + err = unzGoToNextDisk(file); + if (err != UNZ_OK) + return err; + + s->pfile_in_zip_read->pos_in_zipfile = 0; + s->pfile_in_zip_read->filestream = s->filestream; + } + } + +#ifndef NOUNCRYPT + if ((s->cur_file_info.flag & 1) != 0) + { +#ifdef HAVE_AES + if (s->cur_file_info.compression_method == AES_METHOD) + { + fcrypt_decrypt(s->pfile_in_zip_read->read_buffer, bytes_to_read, &s->pfile_in_zip_read->aes_ctx); + } + else +#endif + if (s->pcrc_32_tab != NULL) + { + uint32_t i = 0; + + for (i = 0; i < total_bytes_read; i++) + s->pfile_in_zip_read->read_buffer[i] = + zdecode(s->keys, s->pcrc_32_tab, s->pfile_in_zip_read->read_buffer[i]); + } + } +#endif + + s->pfile_in_zip_read->rest_read_compressed -= total_bytes_read; + s->pfile_in_zip_read->stream.next_in = (uint8_t*)s->pfile_in_zip_read->read_buffer; + s->pfile_in_zip_read->stream.avail_in = (uint16_t)(bytes_not_read + total_bytes_read); + } + + if ((s->pfile_in_zip_read->compression_method == 0) || (s->pfile_in_zip_read->raw)) + { + uint32_t i = 0; + uint32_t copy = 0; + + if ((s->pfile_in_zip_read->stream.avail_in == 0) && + (s->pfile_in_zip_read->rest_read_compressed == 0)) + return (read == 0) ? UNZ_EOF : read; + + if (s->pfile_in_zip_read->stream.avail_out < s->pfile_in_zip_read->stream.avail_in) + copy = s->pfile_in_zip_read->stream.avail_out; + else + copy = s->pfile_in_zip_read->stream.avail_in; + + for (i = 0; i < copy; i++) + *(s->pfile_in_zip_read->stream.next_out + i) = + *(s->pfile_in_zip_read->stream.next_in + i); + + s->pfile_in_zip_read->total_out_64 = s->pfile_in_zip_read->total_out_64 + copy; + s->pfile_in_zip_read->rest_read_uncompressed -= copy; + s->pfile_in_zip_read->crc32 = (uint32_t)crc32(s->pfile_in_zip_read->crc32, + s->pfile_in_zip_read->stream.next_out, copy); + + s->pfile_in_zip_read->stream.avail_in -= copy; + s->pfile_in_zip_read->stream.avail_out -= copy; + s->pfile_in_zip_read->stream.next_out += copy; + s->pfile_in_zip_read->stream.next_in += copy; + s->pfile_in_zip_read->stream.total_out += copy; + + read += copy; + } + else if (s->pfile_in_zip_read->compression_method == Z_BZIP2ED) + { +#ifdef HAVE_BZIP2 + uint64_t total_out_before = 0; + uint64_t total_out_after = 0; + uint64_t out_bytes = 0; + const uint8_t *buf_before = NULL; + + s->pfile_in_zip_read->bstream.next_in = (char*)s->pfile_in_zip_read->stream.next_in; + s->pfile_in_zip_read->bstream.avail_in = s->pfile_in_zip_read->stream.avail_in; + s->pfile_in_zip_read->bstream.total_in_lo32 = (uint32_t)s->pfile_in_zip_read->stream.total_in; + s->pfile_in_zip_read->bstream.total_in_hi32 = s->pfile_in_zip_read->stream.total_in >> 32; + + s->pfile_in_zip_read->bstream.next_out = (char*)s->pfile_in_zip_read->stream.next_out; + s->pfile_in_zip_read->bstream.avail_out = s->pfile_in_zip_read->stream.avail_out; + s->pfile_in_zip_read->bstream.total_out_lo32 = (uint32_t)s->pfile_in_zip_read->stream.total_out; + s->pfile_in_zip_read->bstream.total_out_hi32 = s->pfile_in_zip_read->stream.total_out >> 32; + + total_out_before = s->pfile_in_zip_read->bstream.total_out_lo32 + + (((uint32_t)s->pfile_in_zip_read->bstream.total_out_hi32) << 32); + buf_before = (const uint8_t*)s->pfile_in_zip_read->bstream.next_out; + + err = BZ2_bzDecompress(&s->pfile_in_zip_read->bstream); + + total_out_after = s->pfile_in_zip_read->bstream.total_out_lo32 + + (((uint32_t)s->pfile_in_zip_read->bstream.total_out_hi32) << 32); + + out_bytes = total_out_after - total_out_before; + + s->pfile_in_zip_read->total_out_64 = s->pfile_in_zip_read->total_out_64 + out_bytes; + s->pfile_in_zip_read->rest_read_uncompressed -= out_bytes; + s->pfile_in_zip_read->crc32 = crc32(s->pfile_in_zip_read->crc32, buf_before, (uint32_t)out_bytes); + + read += (uint32_t)out_bytes; + + s->pfile_in_zip_read->stream.next_in = (uint8_t*)s->pfile_in_zip_read->bstream.next_in; + s->pfile_in_zip_read->stream.avail_in = s->pfile_in_zip_read->bstream.avail_in; + s->pfile_in_zip_read->stream.total_in = s->pfile_in_zip_read->bstream.total_in_lo32; + s->pfile_in_zip_read->stream.next_out = (uint8_t*)s->pfile_in_zip_read->bstream.next_out; + s->pfile_in_zip_read->stream.avail_out = s->pfile_in_zip_read->bstream.avail_out; + s->pfile_in_zip_read->stream.total_out = s->pfile_in_zip_read->bstream.total_out_lo32; + + if (err == BZ_STREAM_END) + return (read == 0) ? UNZ_EOF : read; + if (err != BZ_OK) + break; +#endif + } +#ifdef HAVE_APPLE_COMPRESSION + else + { + uint64_t total_out_before = 0; + uint64_t total_out_after = 0; + uint64_t out_bytes = 0; + const uint8_t *buf_before = NULL; + + s->pfile_in_zip_read->astream.src_ptr = s->pfile_in_zip_read->stream.next_in; + s->pfile_in_zip_read->astream.src_size = s->pfile_in_zip_read->stream.avail_in; + s->pfile_in_zip_read->astream.dst_ptr = s->pfile_in_zip_read->stream.next_out; + s->pfile_in_zip_read->astream.dst_size = len; + + total_out_before = s->pfile_in_zip_read->stream.total_out; + buf_before = s->pfile_in_zip_read->stream.next_out; + + compression_status status; + compression_stream_flags flags; + + if (s->pfile_in_zip_read->stream.avail_in == 0) + { + flags = COMPRESSION_STREAM_FINALIZE; + } + + status = compression_stream_process(&s->pfile_in_zip_read->astream, flags); + + total_out_after = len - s->pfile_in_zip_read->astream.dst_size; + out_bytes = total_out_after - total_out_before; + + s->pfile_in_zip_read->total_out_64 += out_bytes; + s->pfile_in_zip_read->rest_read_uncompressed -= out_bytes; + s->pfile_in_zip_read->crc32 = + crc32(s->pfile_in_zip_read->crc32, buf_before, (uint32_t)out_bytes); + + read += (uint32_t)out_bytes; + + s->pfile_in_zip_read->stream.next_in = s->pfile_in_zip_read->astream.src_ptr; + s->pfile_in_zip_read->stream.avail_in = s->pfile_in_zip_read->astream.src_size; + s->pfile_in_zip_read->stream.next_out = s->pfile_in_zip_read->astream.dst_ptr; + s->pfile_in_zip_read->stream.avail_out = s->pfile_in_zip_read->astream.dst_size; + + if (status == COMPRESSION_STATUS_END) + return (read == 0) ? UNZ_EOF : read; + if (status == COMPRESSION_STATUS_ERROR) + return Z_DATA_ERROR; + return read; + } +#else + else + { + uint64_t total_out_before = 0; + uint64_t total_out_after = 0; + uint64_t out_bytes = 0; + const uint8_t *buf_before = NULL; + int flush = Z_SYNC_FLUSH; + + total_out_before = s->pfile_in_zip_read->stream.total_out; + buf_before = s->pfile_in_zip_read->stream.next_out; + + /* + if ((pfile_in_zip_read_info->rest_read_uncompressed == + pfile_in_zip_read_info->stream.avail_out) && + (pfile_in_zip_read_info->rest_read_compressed == 0)) + flush = Z_FINISH; + */ + err = inflate(&s->pfile_in_zip_read->stream, flush); + + if ((err >= 0) && (s->pfile_in_zip_read->stream.msg != NULL)) + err = Z_DATA_ERROR; + + total_out_after = s->pfile_in_zip_read->stream.total_out; + out_bytes = total_out_after - total_out_before; + + s->pfile_in_zip_read->total_out_64 += out_bytes; + s->pfile_in_zip_read->rest_read_uncompressed -= out_bytes; + s->pfile_in_zip_read->crc32 = + (uint32_t)crc32(s->pfile_in_zip_read->crc32, buf_before, (uint32_t)out_bytes); + + read += (uint32_t)out_bytes; + + if (err == Z_STREAM_END) + return (read == 0) ? UNZ_EOF : read; + if (err != Z_OK) + break; + } +#endif + } + while (s->pfile_in_zip_read->stream.avail_out > 0); + + if (err == Z_OK) + return read; + return err; +} + +extern int ZEXPORT unzGetLocalExtrafield(unzFile file, voidp buf, uint32_t len) +{ + unz64_internal *s = NULL; + uint64_t size_to_read = 0; + uint32_t read_now = 0; + + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + if (s->pfile_in_zip_read == NULL) + return UNZ_PARAMERROR; + + size_to_read = s->pfile_in_zip_read->size_local_extrafield - s->pfile_in_zip_read->pos_local_extrafield; + + if (buf == NULL) + return (int)size_to_read; + + if (len > size_to_read) + read_now = (uint32_t)size_to_read; + else + read_now = len; + + if (read_now == 0) + return 0; + + if (ZSEEK64(s->pfile_in_zip_read->z_filefunc, s->pfile_in_zip_read->filestream, + s->pfile_in_zip_read->offset_local_extrafield + s->pfile_in_zip_read->pos_local_extrafield, + ZLIB_FILEFUNC_SEEK_SET) != 0) + return UNZ_ERRNO; + + if (ZREAD64(s->pfile_in_zip_read->z_filefunc, s->pfile_in_zip_read->filestream, buf, read_now) != read_now) + return UNZ_ERRNO; + + return (int)read_now; +} + +extern int ZEXPORT unzCloseCurrentFile(unzFile file) +{ + unz64_internal *s = NULL; + file_in_zip64_read_info_s *pfile_in_zip_read_info = NULL; + int err = UNZ_OK; + + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + pfile_in_zip_read_info = s->pfile_in_zip_read; + if (pfile_in_zip_read_info == NULL) + return UNZ_PARAMERROR; + +#ifdef HAVE_AES + if (s->cur_file_info.compression_method == AES_METHOD) + { + unsigned char authcode[AES_AUTHCODESIZE]; + unsigned char rauthcode[AES_AUTHCODESIZE]; + + if (ZREAD64(s->z_filefunc, s->filestream, authcode, AES_AUTHCODESIZE) != AES_AUTHCODESIZE) + return UNZ_ERRNO; + + if (fcrypt_end(rauthcode, &s->pfile_in_zip_read->aes_ctx) != AES_AUTHCODESIZE) + err = UNZ_CRCERROR; + if (memcmp(authcode, rauthcode, AES_AUTHCODESIZE) != 0) + err = UNZ_CRCERROR; + } + /* AES zip version AE-1 will expect a valid crc as well */ + if ((s->cur_file_info.compression_method != AES_METHOD) || + (s->cur_file_info_internal.aes_version == 0x0001)) +#endif + { + if ((pfile_in_zip_read_info->rest_read_uncompressed == 0) && + (!pfile_in_zip_read_info->raw)) + { + if (pfile_in_zip_read_info->crc32 != pfile_in_zip_read_info->crc32_expected) + err = UNZ_CRCERROR; + } + } + + TRYFREE(pfile_in_zip_read_info->read_buffer); + pfile_in_zip_read_info->read_buffer = NULL; + if (pfile_in_zip_read_info->stream_initialised == Z_DEFLATED) + { +#ifdef HAVE_APPLE_COMPRESSION + if (compression_stream_destroy) + compression_stream_destroy(&pfile_in_zip_read_info->astream); +#else + inflateEnd(&pfile_in_zip_read_info->stream); +#endif + + } +#ifdef HAVE_BZIP2 + else if (pfile_in_zip_read_info->stream_initialised == Z_BZIP2ED) + BZ2_bzDecompressEnd(&pfile_in_zip_read_info->bstream); +#endif + + pfile_in_zip_read_info->stream_initialised = 0; + TRYFREE(pfile_in_zip_read_info); + + s->pfile_in_zip_read = NULL; + + return err; +} + +extern int ZEXPORT unzGoToFirstFile2(unzFile file, unz_file_info64 *pfile_info, char *filename, + uint16_t filename_size, void *extrafield, uint16_t extrafield_size, char *comment, uint16_t comment_size) +{ + unz64_internal *s = NULL; + int err = UNZ_OK; + + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + + if (s->gi.number_entry == 0) + return UNZ_END_OF_LIST_OF_FILE; + + s->pos_in_central_dir = s->offset_central_dir; + s->num_file = 0; + + err = unzGetCurrentFileInfoInternal(file, &s->cur_file_info, &s->cur_file_info_internal, + filename, filename_size, extrafield, extrafield_size, comment, comment_size); + + s->current_file_ok = (err == UNZ_OK); + if ((err == UNZ_OK) && (pfile_info != NULL)) + memcpy(pfile_info, &s->cur_file_info, sizeof(unz_file_info64)); + + return err; +} + +extern int ZEXPORT unzGoToFirstFile(unzFile file) +{ + return unzGoToFirstFile2(file, NULL, NULL, 0, NULL, 0, NULL, 0); +} + +extern int ZEXPORT unzGoToNextFile2(unzFile file, unz_file_info64 *pfile_info, char *filename, + uint16_t filename_size, void *extrafield, uint16_t extrafield_size, char *comment, uint16_t comment_size) +{ + unz64_internal *s = NULL; + int err = UNZ_OK; + + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + + if (!s->current_file_ok) + return UNZ_END_OF_LIST_OF_FILE; + if (s->gi.number_entry != UINT16_MAX) /* 2^16 files overflow hack */ + { + if (s->num_file+1 == s->gi.number_entry) + return UNZ_END_OF_LIST_OF_FILE; + } + + s->pos_in_central_dir += SIZECENTRALDIRITEM + s->cur_file_info.size_filename + + s->cur_file_info.size_file_extra + s->cur_file_info.size_file_comment; + s->num_file += 1; + + err = unzGetCurrentFileInfoInternal(file, &s->cur_file_info, &s->cur_file_info_internal, + filename, filename_size, extrafield, extrafield_size, comment, comment_size); + + s->current_file_ok = (err == UNZ_OK); + if ((err == UNZ_OK) && (pfile_info != NULL)) + memcpy(pfile_info, &s->cur_file_info, sizeof(unz_file_info64)); + + return err; +} + +extern int ZEXPORT unzGoToNextFile(unzFile file) +{ + return unzGoToNextFile2(file, NULL, NULL, 0, NULL, 0, NULL, 0); +} + +extern int ZEXPORT unzLocateFile(unzFile file, const char *filename, unzFileNameComparer filename_compare_func) +{ + unz64_internal *s = NULL; + unz_file_info64 cur_file_info_saved; + unz_file_info64_internal cur_file_info_internal_saved; + uint64_t num_file_saved = 0; + uint64_t pos_in_central_dir_saved = 0; + char current_filename[UNZ_MAXFILENAMEINZIP+1]; + int err = UNZ_OK; + + if (file == NULL) + return UNZ_PARAMERROR; + if (strlen(filename) >= UNZ_MAXFILENAMEINZIP) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + if (!s->current_file_ok) + return UNZ_END_OF_LIST_OF_FILE; + + /* Save the current state */ + num_file_saved = s->num_file; + pos_in_central_dir_saved = s->pos_in_central_dir; + cur_file_info_saved = s->cur_file_info; + cur_file_info_internal_saved = s->cur_file_info_internal; + + err = unzGoToFirstFile2(file, NULL, current_filename, sizeof(current_filename)-1, NULL, 0, NULL, 0); + + while (err == UNZ_OK) + { + if (filename_compare_func != NULL) + err = filename_compare_func(file, current_filename, filename); + else + err = strcmp(current_filename, filename); + if (err == 0) + return UNZ_OK; + err = unzGoToNextFile2(file, NULL, current_filename, sizeof(current_filename)-1, NULL, 0, NULL, 0); + } + + /* We failed, so restore the state of the 'current file' to where we were. */ + s->num_file = num_file_saved; + s->pos_in_central_dir = pos_in_central_dir_saved; + s->cur_file_info = cur_file_info_saved; + s->cur_file_info_internal = cur_file_info_internal_saved; + return err; +} + +extern int ZEXPORT unzGetFilePos(unzFile file, unz_file_pos *file_pos) +{ + unz64_file_pos file_pos64; + int err = unzGetFilePos64(file, &file_pos64); + if (err == UNZ_OK) + { + file_pos->pos_in_zip_directory = (uint32_t)file_pos64.pos_in_zip_directory; + file_pos->num_of_file = (uint32_t)file_pos64.num_of_file; + } + return err; +} + +extern int ZEXPORT unzGoToFilePos(unzFile file, unz_file_pos *file_pos) +{ + unz64_file_pos file_pos64; + if (file_pos == NULL) + return UNZ_PARAMERROR; + file_pos64.pos_in_zip_directory = file_pos->pos_in_zip_directory; + file_pos64.num_of_file = file_pos->num_of_file; + return unzGoToFilePos64(file, &file_pos64); +} + +extern int ZEXPORT unzGetFilePos64(unzFile file, unz64_file_pos *file_pos) +{ + unz64_internal *s = NULL; + + if (file == NULL || file_pos == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + if (!s->current_file_ok) + return UNZ_END_OF_LIST_OF_FILE; + + file_pos->pos_in_zip_directory = s->pos_in_central_dir; + file_pos->num_of_file = s->num_file; + return UNZ_OK; +} + +extern int ZEXPORT unzGoToFilePos64(unzFile file, const unz64_file_pos *file_pos) +{ + unz64_internal *s = NULL; + int err = UNZ_OK; + + if (file == NULL || file_pos == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + + /* Jump to the right spot */ + s->pos_in_central_dir = file_pos->pos_in_zip_directory; + s->num_file = file_pos->num_of_file; + + /* Set the current file */ + err = unzGetCurrentFileInfoInternal(file, &s->cur_file_info, &s->cur_file_info_internal, NULL, 0, NULL, 0, NULL, 0); + /* Return results */ + s->current_file_ok = (err == UNZ_OK); + return err; +} + +extern int32_t ZEXPORT unzGetOffset(unzFile file) +{ + uint64_t offset64 = 0; + + if (file == NULL) + return UNZ_PARAMERROR; + offset64 = unzGetOffset64(file); + return (int32_t)offset64; +} + +extern int64_t ZEXPORT unzGetOffset64(unzFile file) +{ + unz64_internal *s = NULL; + + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + if (!s->current_file_ok) + return 0; + if (s->gi.number_entry != 0 && s->gi.number_entry != UINT16_MAX) + { + if (s->num_file == s->gi.number_entry) + return 0; + } + return s->pos_in_central_dir; +} + +extern int ZEXPORT unzSetOffset(unzFile file, uint32_t pos) +{ + return unzSetOffset64(file, pos); +} + +extern int ZEXPORT unzSetOffset64(unzFile file, uint64_t pos) +{ + unz64_internal *s = NULL; + int err = UNZ_OK; + + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + s->pos_in_central_dir = pos; + s->num_file = s->gi.number_entry; /* hack */ + + err = unzGetCurrentFileInfoInternal(file, &s->cur_file_info, &s->cur_file_info_internal, NULL, 0, NULL, 0, NULL, 0); + + s->current_file_ok = (err == UNZ_OK); + return err; +} + +extern int32_t ZEXPORT unzTell(unzFile file) +{ + unz64_internal *s = NULL; + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + if (s->pfile_in_zip_read == NULL) + return UNZ_PARAMERROR; + return (int32_t)s->pfile_in_zip_read->stream.total_out; +} + +extern int64_t ZEXPORT unzTell64(unzFile file) +{ + unz64_internal *s = NULL; + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + if (s->pfile_in_zip_read == NULL) + return UNZ_PARAMERROR; + return s->pfile_in_zip_read->total_out_64; +} + +extern int ZEXPORT unzSeek(unzFile file, uint32_t offset, int origin) +{ + return unzSeek64(file, offset, origin); +} + +extern int ZEXPORT unzSeek64(unzFile file, uint64_t offset, int origin) +{ + unz64_internal *s = NULL; + uint64_t stream_pos_begin = 0; + uint64_t stream_pos_end = 0; + uint64_t position = 0; + int is_within_buffer = 0; + + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + + if (s->pfile_in_zip_read == NULL) + return UNZ_ERRNO; + if (s->pfile_in_zip_read->compression_method != 0) + return UNZ_ERRNO; + + if (origin == SEEK_SET) + position = offset; + else if (origin == SEEK_CUR) + position = s->pfile_in_zip_read->total_out_64 + offset; + else if (origin == SEEK_END) + position = s->cur_file_info.compressed_size + offset; + else + return UNZ_PARAMERROR; + + if (position > s->cur_file_info.compressed_size) + return UNZ_PARAMERROR; + + stream_pos_end = s->pfile_in_zip_read->pos_in_zipfile; + stream_pos_begin = stream_pos_end; + + if (stream_pos_begin > UNZ_BUFSIZE) + stream_pos_begin -= UNZ_BUFSIZE; + else + stream_pos_begin = 0; + + is_within_buffer = + (s->pfile_in_zip_read->stream.avail_in != 0) && + (s->pfile_in_zip_read->rest_read_compressed != 0 || s->cur_file_info.compressed_size < UNZ_BUFSIZE) && + (position >= stream_pos_begin && position < stream_pos_end); + + if (is_within_buffer) + { + s->pfile_in_zip_read->stream.next_in += position - s->pfile_in_zip_read->total_out_64; + s->pfile_in_zip_read->stream.avail_in = (uInt)(stream_pos_end - position); + } + else + { + s->pfile_in_zip_read->stream.avail_in = 0; + s->pfile_in_zip_read->stream.next_in = 0; + + s->pfile_in_zip_read->pos_in_zipfile = s->pfile_in_zip_read->offset_local_extrafield + position; + s->pfile_in_zip_read->rest_read_compressed = s->cur_file_info.compressed_size - position; + } + + s->pfile_in_zip_read->rest_read_uncompressed -= (position - s->pfile_in_zip_read->total_out_64); + s->pfile_in_zip_read->stream.total_out = (uint32_t)position; + s->pfile_in_zip_read->total_out_64 = position; + + return UNZ_OK; +} + +extern int ZEXPORT unzEndOfFile(unzFile file) +{ + unz64_internal *s = NULL; + if (file == NULL) + return UNZ_PARAMERROR; + s = (unz64_internal*)file; + if (s->pfile_in_zip_read == NULL) + return UNZ_PARAMERROR; + if (s->pfile_in_zip_read->rest_read_uncompressed == 0) + return 1; + return 0; +} diff --git a/SSZipArchive/minizip/unzip.h b/SSZipArchive/minizip/unzip.h new file mode 100644 index 0000000..059a026 --- /dev/null +++ b/SSZipArchive/minizip/unzip.h @@ -0,0 +1,254 @@ +/* unzip.h -- IO for uncompress .zip files using zlib + Version 1.2.0, September 16th, 2017 + part of the MiniZip project + + Copyright (C) 2012-2017 Nathan Moinvaziri + https://github.com/nmoinvaz/minizip + Copyright (C) 2009-2010 Mathias Svensson + Modifications for Zip64 support on both zip and unzip + http://result42.com + Copyright (C) 2007-2008 Even Rouault + Modifications of Unzip for Zip64 + Copyright (C) 1998-2010 Gilles Vollant + http://www.winimage.com/zLibDll/minizip.html + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. +*/ + +#ifndef _UNZ_H +#define _UNZ_H + +#include "../SSZipCommon.h" + +#define HAVE_AES + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef _ZLIB_H +#include "zlib.h" +#endif + +#ifndef _ZLIBIOAPI_H +#include "ioapi.h" +#endif + +#ifdef HAVE_BZIP2 +#include "bzlib.h" +#endif + +#define Z_BZIP2ED 12 + +#if defined(STRICTUNZIP) || defined(STRICTZIPUNZIP) +/* like the STRICT of WIN32, we define a pointer that cannot be converted + from (void*) without cast */ +typedef struct TagunzFile__ { int unused; } unz_file__; +typedef unz_file__ *unzFile; +#else +typedef voidp unzFile; +#endif + +#define UNZ_OK (0) +#define UNZ_END_OF_LIST_OF_FILE (-100) +#define UNZ_ERRNO (Z_ERRNO) +#define UNZ_EOF (0) +#define UNZ_PARAMERROR (-102) +#define UNZ_BADZIPFILE (-103) +#define UNZ_INTERNALERROR (-104) +#define UNZ_CRCERROR (-105) +#define UNZ_BADPASSWORD (-106) + + +/***************************************************************************/ +/* Opening and close a zip file */ + +extern unzFile ZEXPORT unzOpen(const char *path); +extern unzFile ZEXPORT unzOpen64(const void *path); +/* Open a Zip file. + + path should contain the full path (by example, on a Windows XP computer + "c:\\zlib\\zlib113.zip" or on an Unix computer "zlib/zlib113.zip". + return NULL if zipfile cannot be opened or doesn't exist + return unzFile handle if no error + + NOTE: The "64" function take a const void *pointer, because the path is just the value passed to the + open64_file_func callback. Under Windows, if UNICODE is defined, using fill_fopen64_filefunc, the path + is a pointer to a wide unicode string (LPCTSTR is LPCWSTR), so const char *does not describe the reality */ + +extern unzFile ZEXPORT unzOpen2(const char *path, zlib_filefunc_def *pzlib_filefunc_def); +/* Open a Zip file, like unzOpen, but provide a set of file low level API for read/write operations */ +extern unzFile ZEXPORT unzOpen2_64(const void *path, zlib_filefunc64_def *pzlib_filefunc_def); +/* Open a Zip file, like unz64Open, but provide a set of file low level API for read/write 64-bit operations */ + +extern int ZEXPORT unzClose(unzFile file); +/* Close a ZipFile opened with unzOpen. If there is files inside the .Zip opened with unzOpenCurrentFile, + these files MUST be closed with unzipCloseCurrentFile before call unzipClose. + + return UNZ_OK if there is no error */ + +extern int ZEXPORT unzGetGlobalInfo(unzFile file, unz_global_info *pglobal_info); +extern int ZEXPORT unzGetGlobalInfo64(unzFile file, unz_global_info64 *pglobal_info); +/* Write info about the ZipFile in the *pglobal_info structure. + + return UNZ_OK if no error */ + +extern int ZEXPORT unzGetGlobalComment(unzFile file, char *comment, uint16_t comment_size); +/* Get the global comment string of the ZipFile, in the comment buffer. + + uSizeBuf is the size of the szComment buffer. + return the number of byte copied or an error code <0 */ + +extern uint64_t ZEXPORT unzCountEntries(const unzFile file); + +/***************************************************************************/ +/* Reading the content of the current zipfile, you can open it, read data from it, and close it + (you can close it before reading all the file) */ + +extern int ZEXPORT unzOpenCurrentFile(unzFile file); +/* Open for reading data the current file in the zipfile. + + return UNZ_OK if no error */ + +extern int ZEXPORT unzOpenCurrentFilePassword(unzFile file, const char *password); +/* Open for reading data the current file in the zipfile. + password is a crypting password + + return UNZ_OK if no error */ + +extern int ZEXPORT unzOpenCurrentFile2(unzFile file, int *method, int *level, int raw); +/* Same as unzOpenCurrentFile, but open for read raw the file (not uncompress) + if raw==1 *method will receive method of compression, *level will receive level of compression + + NOTE: you can set level parameter as NULL (if you did not want known level, + but you CANNOT set method parameter as NULL */ + +extern int ZEXPORT unzOpenCurrentFile3(unzFile file, int *method, int *level, int raw, const char *password); +/* Same as unzOpenCurrentFile, but takes extra parameter password for encrypted files */ + +extern int ZEXPORT unzReadCurrentFile(unzFile file, voidp buf, uint32_t len); +/* Read bytes from the current file (opened by unzOpenCurrentFile) + buf contain buffer where data must be copied + len the size of buf. + + return the number of byte copied if somes bytes are copied + return 0 if the end of file was reached + return <0 with error code if there is an error (UNZ_ERRNO for IO error, or zLib error for uncompress error) */ + +extern int ZEXPORT unzGetCurrentFileInfo(unzFile file, unz_file_info *pfile_info, char *filename, + uint16_t filename_size, void *extrafield, uint16_t extrafield_size, char *comment, uint16_t comment_size); +extern int ZEXPORT unzGetCurrentFileInfo64(unzFile file, unz_file_info64 *pfile_info, char *filename, + uint16_t filename_size, void *extrafield, uint16_t extrafield_size, char *comment, uint16_t comment_size); +/* Get Info about the current file + + pfile_info if != NULL, the *pfile_info structure will contain somes info about the current file + filename if != NULL, the file name string will be copied in filename + filename_size is the size of the filename buffer + extrafield if != NULL, the extra field information from the central header will be copied in to + extrafield_size is the size of the extraField buffer + comment if != NULL, the comment string of the file will be copied in to + comment_size is the size of the comment buffer */ + +extern int ZEXPORT unzGetLocalExtrafield(unzFile file, voidp buf, uint32_t len); +/* Read extra field from the current file (opened by unzOpenCurrentFile) + This is the local-header version of the extra field (sometimes, there is + more info in the local-header version than in the central-header) + + if buf == NULL, it return the size of the local extra field + if buf != NULL, len is the size of the buffer, the extra header is copied in buf. + + return number of bytes copied in buf, or (if <0) the error code */ + +extern int ZEXPORT unzCloseCurrentFile(unzFile file); +/* Close the file in zip opened with unzOpenCurrentFile + + return UNZ_CRCERROR if all the file was read but the CRC is not good */ + +/***************************************************************************/ +/* Browse the directory of the zipfile */ + +typedef int (*unzFileNameComparer)(unzFile file, const char *filename1, const char *filename2); +typedef int (*unzIteratorFunction)(unzFile file); +typedef int (*unzIteratorFunction2)(unzFile file, unz_file_info64 *pfile_info, char *filename, + uint16_t filename_size, void *extrafield, uint16_t extrafield_size, char *comment, uint16_t comment_size); + +extern int ZEXPORT unzGoToFirstFile(unzFile file); +/* Set the current file of the zipfile to the first file. + + return UNZ_OK if no error */ + +extern int ZEXPORT unzGoToFirstFile2(unzFile file, unz_file_info64 *pfile_info, char *filename, + uint16_t filename_size, void *extrafield, uint16_t extrafield_size, char *comment, uint16_t comment_size); +/* Set the current file of the zipfile to the first file and retrieves the current info on success. + Not as seek intensive as unzGoToFirstFile + unzGetCurrentFileInfo. + + return UNZ_OK if no error */ + +extern int ZEXPORT unzGoToNextFile(unzFile file); +/* Set the current file of the zipfile to the next file. + + return UNZ_OK if no error + return UNZ_END_OF_LIST_OF_FILE if the actual file was the latest */ + +extern int ZEXPORT unzGoToNextFile2(unzFile file, unz_file_info64 *pfile_info, char *filename, + uint16_t filename_size, void *extrafield, uint16_t extrafield_size, char *comment, uint16_t comment_size); +/* Set the current file of the zipfile to the next file and retrieves the current + info on success. Does less seeking around than unzGotoNextFile + unzGetCurrentFileInfo. + + return UNZ_OK if no error + return UNZ_END_OF_LIST_OF_FILE if the actual file was the latest */ + +extern int ZEXPORT unzLocateFile(unzFile file, const char *filename, unzFileNameComparer filename_compare_func); +/* Try locate the file szFileName in the zipfile. For custom filename comparison pass in comparison function. + + return UNZ_OK if the file is found (it becomes the current file) + return UNZ_END_OF_LIST_OF_FILE if the file is not found */ + +/***************************************************************************/ +/* Raw access to zip file */ + +typedef struct unz_file_pos_s +{ + uint32_t pos_in_zip_directory; /* offset in zip file directory */ + uint32_t num_of_file; /* # of file */ +} unz_file_pos; + +extern int ZEXPORT unzGetFilePos(unzFile file, unz_file_pos *file_pos); +extern int ZEXPORT unzGoToFilePos(unzFile file, unz_file_pos *file_pos); + +typedef struct unz64_file_pos_s +{ + uint64_t pos_in_zip_directory; /* offset in zip file directory */ + uint64_t num_of_file; /* # of file */ +} unz64_file_pos; + +extern int ZEXPORT unzGetFilePos64(unzFile file, unz64_file_pos *file_pos); +extern int ZEXPORT unzGoToFilePos64(unzFile file, const unz64_file_pos *file_pos); + +extern int32_t ZEXPORT unzGetOffset(unzFile file); +extern int64_t ZEXPORT unzGetOffset64(unzFile file); +/* Get the current file offset */ + +extern int ZEXPORT unzSetOffset(unzFile file, uint32_t pos); +extern int ZEXPORT unzSetOffset64(unzFile file, uint64_t pos); +/* Set the current file offset */ + +extern int32_t ZEXPORT unzTell(unzFile file); +extern int64_t ZEXPORT unzTell64(unzFile file); +/* return current position in uncompressed data */ + +extern int ZEXPORT unzSeek(unzFile file, uint32_t offset, int origin); +extern int ZEXPORT unzSeek64(unzFile file, uint64_t offset, int origin); +/* Seek within the uncompressed data if compression method is storage */ + +extern int ZEXPORT unzEndOfFile(unzFile file); +/* return 1 if the end of file was reached, 0 elsewhere */ + +/***************************************************************************/ + +#ifdef __cplusplus +} +#endif + +#endif /* _UNZ_H */ diff --git a/SSZipArchive/minizip/zip.c b/SSZipArchive/minizip/zip.c new file mode 100644 index 0000000..f4ff103 --- /dev/null +++ b/SSZipArchive/minizip/zip.c @@ -0,0 +1,2009 @@ +/* zip.c -- IO on .zip files using zlib + Version 1.2.0, September 16th, 2017 + part of the MiniZip project + + Copyright (C) 2010-2017 Nathan Moinvaziri + Modifications for AES, PKWARE disk spanning + https://github.com/nmoinvaz/minizip + Copyright (C) 2009-2010 Mathias Svensson + Modifications for Zip64 support + http://result42.com + Copyright (C) 1998-2010 Gilles Vollant + http://www.winimage.com/zLibDll/minizip.html + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. +*/ + +#include +#include +#include +#include +#include +#include + +#include "zlib.h" +#include "zip.h" + +#ifdef HAVE_AES +# define AES_METHOD (99) +# define AES_PWVERIFYSIZE (2) +# define AES_AUTHCODESIZE (10) +# define AES_MAXSALTLENGTH (16) +# define AES_VERSION (0x0001) +# define AES_ENCRYPTIONMODE (0x03) + +# include "aes/aes.h" +# include "aes/fileenc.h" +# include "aes/prng.h" +#endif +#ifdef HAVE_APPLE_COMPRESSION +# include +#endif + +#ifndef NOCRYPT +# include "crypt.h" +#endif + +#define SIZEDATA_INDATABLOCK (4096-(4*4)) + +#define DISKHEADERMAGIC (0x08074b50) +#define LOCALHEADERMAGIC (0x04034b50) +#define CENTRALHEADERMAGIC (0x02014b50) +#define ENDHEADERMAGIC (0x06054b50) +#define ZIP64ENDHEADERMAGIC (0x06064b50) +#define ZIP64ENDLOCHEADERMAGIC (0x07064b50) +#define DATADESCRIPTORMAGIC (0x08074b50) + +#define FLAG_LOCALHEADER_OFFSET (0x06) +#define CRC_LOCALHEADER_OFFSET (0x0e) + +#define SIZECENTRALHEADER (0x2e) /* 46 */ +#define SIZECENTRALHEADERLOCATOR (0x14) /* 20 */ +#define SIZECENTRALDIRITEM (0x2e) +#define SIZEZIPLOCALHEADER (0x1e) + +#ifndef BUFREADCOMMENT +# define BUFREADCOMMENT (0x400) +#endif +#ifndef VERSIONMADEBY +# define VERSIONMADEBY (0x0) /* platform dependent */ +#endif + +#ifndef Z_BUFSIZE +# define Z_BUFSIZE (UINT16_MAX) +#endif + +#ifndef ALLOC +# define ALLOC(size) (malloc(size)) +#endif +#ifndef TRYFREE +# define TRYFREE(p) {if (p) free(p);} +#endif + +/* NOT sure that this work on ALL platform */ +#define MAKEULONG64(a, b) ((uint64_t)(((unsigned long)(a)) | ((uint64_t)((unsigned long)(b))) << 32)) + +#ifndef DEF_MEM_LEVEL +# if MAX_MEM_LEVEL >= 8 +# define DEF_MEM_LEVEL 8 +# else +# define DEF_MEM_LEVEL MAX_MEM_LEVEL +# endif +#endif + +const char zip_copyright[] = " zip 1.01 Copyright 1998-2004 Gilles Vollant - http://www.winimage.com/zLibDll"; + +typedef struct linkedlist_datablock_internal_s +{ + struct linkedlist_datablock_internal_s *next_datablock; + uint32_t avail_in_this_block; + uint32_t filled_in_this_block; + uint32_t unused; /* for future use and alignment */ + uint8_t data[SIZEDATA_INDATABLOCK]; +} linkedlist_datablock_internal; + +typedef struct linkedlist_data_s +{ + linkedlist_datablock_internal *first_block; + linkedlist_datablock_internal *last_block; +} linkedlist_data; + +typedef struct +{ + z_stream stream; /* zLib stream structure for inflate */ +#ifdef HAVE_BZIP2 + bz_stream bstream; /* bzLib stream structure for bziped */ +#endif +#ifdef HAVE_APPLE_COMPRESSION + compression_stream astream; /* libcompression stream structure */ +#endif +#ifdef HAVE_AES + fcrypt_ctx aes_ctx; + prng_ctx aes_rng[1]; +#endif + int stream_initialised; /* 1 is stream is initialized */ + uint32_t pos_in_buffered_data; /* last written byte in buffered_data */ + + uint64_t pos_local_header; /* offset of the local header of the file currently writing */ + char *central_header; /* central header data for the current file */ + uint16_t size_centralextra; + uint16_t size_centralheader; /* size of the central header for cur file */ + uint16_t size_centralextrafree; /* Extra bytes allocated to the central header but that are not used */ + uint16_t size_comment; + uint16_t flag; /* flag of the file currently writing */ + + uint16_t method; /* compression method written to file.*/ + uint16_t compression_method; /* compression method to use */ + int raw; /* 1 for directly writing raw data */ + uint8_t buffered_data[Z_BUFSIZE]; /* buffer contain compressed data to be writ*/ + uint32_t dos_date; + uint32_t crc32; + int zip64; /* add ZIP64 extended information in the extra field */ + uint32_t number_disk; /* number of current disk used for spanning ZIP */ + uint64_t total_compressed; + uint64_t total_uncompressed; +#ifndef NOCRYPT + uint32_t keys[3]; /* keys defining the pseudo-random sequence */ + const z_crc_t *pcrc_32_tab; +#endif +} curfile64_info; + +typedef struct +{ + zlib_filefunc64_32_def z_filefunc; + voidpf filestream; /* io structure of the zipfile */ + voidpf filestream_with_CD; /* io structure of the zipfile with the central dir */ + linkedlist_data central_dir; /* datablock with central dir in construction*/ + int in_opened_file_inzip; /* 1 if a file in the zip is currently writ.*/ + int append; /* append mode */ + curfile64_info ci; /* info on the file currently writing */ + + uint64_t add_position_when_writting_offset; + uint64_t number_entry; + uint64_t disk_size; /* size of each disk */ + uint32_t number_disk; /* number of the current disk, used for spanning ZIP */ + uint32_t number_disk_with_CD; /* number the the disk with central dir, used for spanning ZIP */ +#ifndef NO_ADDFILEINEXISTINGZIP + char *globalcomment; +#endif +} zip64_internal; + +/* Allocate a new data block */ +static linkedlist_datablock_internal *allocate_new_datablock(void) +{ + linkedlist_datablock_internal *ldi = NULL; + + ldi = (linkedlist_datablock_internal*)ALLOC(sizeof(linkedlist_datablock_internal)); + + if (ldi != NULL) + { + ldi->next_datablock = NULL; + ldi->filled_in_this_block = 0; + ldi->avail_in_this_block = SIZEDATA_INDATABLOCK; + } + return ldi; +} + +/* Free data block in linked list */ +static void free_datablock(linkedlist_datablock_internal *ldi) +{ + while (ldi != NULL) + { + linkedlist_datablock_internal *ldinext = ldi->next_datablock; + TRYFREE(ldi); + ldi = ldinext; + } +} + +/* Initialize linked list */ +static void init_linkedlist(linkedlist_data *ll) +{ + ll->first_block = ll->last_block = NULL; +} + +/* Free entire linked list and all data blocks */ +static void free_linkedlist(linkedlist_data *ll) +{ + free_datablock(ll->first_block); + ll->first_block = ll->last_block = NULL; +} + +/* Add data to linked list data block */ +static int add_data_in_datablock(linkedlist_data *ll, const void *buf, uint32_t len) +{ + linkedlist_datablock_internal *ldi = NULL; + const unsigned char *from_copy = NULL; + + if (ll == NULL) + return ZIP_INTERNALERROR; + + if (ll->last_block == NULL) + { + ll->first_block = ll->last_block = allocate_new_datablock(); + if (ll->first_block == NULL) + return ZIP_INTERNALERROR; + } + + ldi = ll->last_block; + from_copy = (unsigned char*)buf; + + while (len > 0) + { + uint32_t copy_this = 0; + uint32_t i = 0; + unsigned char *to_copy = NULL; + + if (ldi->avail_in_this_block == 0) + { + ldi->next_datablock = allocate_new_datablock(); + if (ldi->next_datablock == NULL) + return ZIP_INTERNALERROR; + ldi = ldi->next_datablock ; + ll->last_block = ldi; + } + + if (ldi->avail_in_this_block < len) + copy_this = ldi->avail_in_this_block; + else + copy_this = len; + + to_copy = &(ldi->data[ldi->filled_in_this_block]); + + for (i = 0; i < copy_this; i++) + *(to_copy+i) = *(from_copy+i); + + ldi->filled_in_this_block += copy_this; + ldi->avail_in_this_block -= copy_this; + from_copy += copy_this; + len -= copy_this; + } + return ZIP_OK; +} + +/* Inputs a long in LSB order to the given file: nbByte == 1, 2, 4 or 8 (byte, short or long, uint64_t) */ +static int zipWriteValue(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream, + uint64_t x, uint32_t len) +{ + unsigned char buf[8]; + uint32_t n = 0; + + for (n = 0; n < len; n++) + { + buf[n] = (unsigned char)(x & 0xff); + x >>= 8; + } + + if (x != 0) + { + /* Data overflow - hack for ZIP64 (X Roche) */ + for (n = 0; n < len; n++) + { + buf[n] = 0xff; + } + } + + if (ZWRITE64(*pzlib_filefunc_def, filestream, buf, len) != len) + return ZIP_ERRNO; + + return ZIP_OK; +} + +static void zipWriteValueToMemory(void* dest, uint64_t x, uint32_t len) +{ + unsigned char *buf = (unsigned char*)dest; + uint32_t n = 0; + + for (n = 0; n < len; n++) + { + buf[n] = (unsigned char)(x & 0xff); + x >>= 8; + } + + if (x != 0) + { + /* data overflow - hack for ZIP64 */ + for (n = 0; n < len; n++) + { + buf[n] = 0xff; + } + } +} + +static void zipWriteValueToMemoryAndMove(unsigned char **dest_ptr, uint64_t x, uint32_t len) +{ + zipWriteValueToMemory(*dest_ptr, x, len); + *dest_ptr += len; +} + +static int zipReadUInt8(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream, uint8_t *value) +{ + uint8_t c = 0; + if (ZREAD64(*pzlib_filefunc_def, filestream, &c, 1) == 1) + { + *value = (uint8_t)c; + return ZIP_OK; + } + if (ZERROR64(*pzlib_filefunc_def, filestream)) + return ZIP_ERRNO; + return ZIP_EOF; +} + +static int zipReadUInt16(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream, uint16_t *value) +{ + uint16_t x = 0; + uint8_t c = 0; + int err = ZIP_OK; + + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x = (uint16_t)c; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint16_t)c) << 8; + + if (err == ZIP_OK) + *value = x; + else + *value = 0; + return err; +} + +static int zipReadUInt32(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream, uint32_t *value) +{ + uint32_t x = 0; + uint8_t c = 0; + int err = ZIP_OK; + + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x = (uint32_t)c; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint32_t)c) << 8; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint32_t)c) << 16; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint32_t)c) << 24; + + if (err == ZIP_OK) + *value = x; + else + *value = 0; + return err; +} + +static int zipReadUInt64(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream, uint64_t *value) +{ + uint64_t x = 0; + uint8_t c = 0; + int err = ZIP_OK; + + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x = (uint64_t)c; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint64_t)c) << 8; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint64_t)c) << 16; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint64_t)c) << 24; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint64_t)c) << 32; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint64_t)c) << 40; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint64_t)c) << 48; + if (err == ZIP_OK) + err = zipReadUInt8(pzlib_filefunc_def, filestream, &c); + x += ((uint64_t)c) << 56; + + if (err == ZIP_OK) + *value = x; + else + *value = 0; + + return err; +} + +/* Gets the amount of bytes left to write to the current disk for spanning archives */ +static void zipGetDiskSizeAvailable(zipFile file, uint64_t *size_available) +{ + zip64_internal *zi = NULL; + uint64_t current_disk_size = 0; + + zi = (zip64_internal*)file; + ZSEEK64(zi->z_filefunc, zi->filestream, 0, ZLIB_FILEFUNC_SEEK_END); + current_disk_size = ZTELL64(zi->z_filefunc, zi->filestream); + *size_available = zi->disk_size - current_disk_size; +} + +/* Goes to a specific disk number for spanning archives */ +static int zipGoToSpecificDisk(zipFile file, uint32_t number_disk, int open_existing) +{ + zip64_internal *zi = NULL; + int err = ZIP_OK; + + zi = (zip64_internal*)file; + if (zi->disk_size == 0) + return err; + + if ((zi->filestream != NULL) && (zi->filestream != zi->filestream_with_CD)) + ZCLOSE64(zi->z_filefunc, zi->filestream); + + zi->filestream = ZOPENDISK64(zi->z_filefunc, zi->filestream_with_CD, number_disk, (open_existing == 1) ? + (ZLIB_FILEFUNC_MODE_READ | ZLIB_FILEFUNC_MODE_WRITE | ZLIB_FILEFUNC_MODE_EXISTING) : + (ZLIB_FILEFUNC_MODE_READ | ZLIB_FILEFUNC_MODE_WRITE | ZLIB_FILEFUNC_MODE_CREATE)); + + if (zi->filestream == NULL) + err = ZIP_ERRNO; + + return err; +} + +/* Goes to the first disk in a spanned archive */ +static int zipGoToFirstDisk(zipFile file) +{ + zip64_internal *zi = NULL; + uint32_t number_disk_next = 0; + int err = ZIP_OK; + + zi = (zip64_internal*)file; + + if (zi->disk_size == 0) + return err; + number_disk_next = 0; + if (zi->number_disk_with_CD > 0) + number_disk_next = zi->number_disk_with_CD - 1; + err = zipGoToSpecificDisk(file, number_disk_next, (zi->append == APPEND_STATUS_ADDINZIP)); + if ((err == ZIP_ERRNO) && (zi->append == APPEND_STATUS_ADDINZIP)) + err = zipGoToSpecificDisk(file, number_disk_next, 0); + if (err == ZIP_OK) + zi->number_disk = number_disk_next; + ZSEEK64(zi->z_filefunc, zi->filestream, 0, ZLIB_FILEFUNC_SEEK_END); + return err; +} + +/* Goes to the next disk in a spanned archive */ +static int zipGoToNextDisk(zipFile file) +{ + zip64_internal *zi = NULL; + uint64_t size_available_in_disk = 0; + uint32_t number_disk_next = 0; + int err = ZIP_OK; + + zi = (zip64_internal*)file; + if (zi->disk_size == 0) + return err; + + number_disk_next = zi->number_disk + 1; + + do + { + err = zipGoToSpecificDisk(file, number_disk_next, (zi->append == APPEND_STATUS_ADDINZIP)); + if ((err == ZIP_ERRNO) && (zi->append == APPEND_STATUS_ADDINZIP)) + err = zipGoToSpecificDisk(file, number_disk_next, 0); + if (err != ZIP_OK) + break; + zipGetDiskSizeAvailable(file, &size_available_in_disk); + zi->number_disk = number_disk_next; + zi->number_disk_with_CD = zi->number_disk + 1; + + number_disk_next += 1; + } + while (size_available_in_disk <= 0); + + return err; +} + +/* Locate the Central directory of a zipfile (at the end, just before the global comment) */ +static uint64_t zipSearchCentralDir(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream) +{ + unsigned char *buf = NULL; + uint64_t file_size = 0; + uint64_t back_read = 4; + uint64_t max_back = UINT16_MAX; /* maximum size of global comment */ + uint64_t pos_found = 0; + uint32_t read_size = 0; + uint64_t read_pos = 0; + uint32_t i = 0; + + buf = (unsigned char*)ALLOC(BUFREADCOMMENT+4); + if (buf == NULL) + return 0; + + if (ZSEEK64(*pzlib_filefunc_def, filestream, 0, ZLIB_FILEFUNC_SEEK_END) != 0) + { + TRYFREE(buf); + return 0; + } + + file_size = ZTELL64(*pzlib_filefunc_def, filestream); + + if (max_back > file_size) + max_back = file_size; + + while (back_read < max_back) + { + if (back_read + BUFREADCOMMENT > max_back) + back_read = max_back; + else + back_read += BUFREADCOMMENT; + + read_pos = file_size-back_read; + read_size = ((BUFREADCOMMENT+4) < (file_size - read_pos)) ? + (BUFREADCOMMENT+4) : (uint32_t)(file_size - read_pos); + + if (ZSEEK64(*pzlib_filefunc_def, filestream, read_pos, ZLIB_FILEFUNC_SEEK_SET) != 0) + break; + if (ZREAD64(*pzlib_filefunc_def, filestream, buf, read_size) != read_size) + break; + + for (i = read_size-3; (i--) > 0;) + if ((*(buf+i)) == (ENDHEADERMAGIC & 0xff) && + (*(buf+i+1)) == (ENDHEADERMAGIC >> 8 & 0xff) && + (*(buf+i+2)) == (ENDHEADERMAGIC >> 16 & 0xff) && + (*(buf+i+3)) == (ENDHEADERMAGIC >> 24 & 0xff)) + { + pos_found = read_pos+i; + break; + } + + if (pos_found != 0) + break; + } + TRYFREE(buf); + return pos_found; +} + +/* Locate the Central directory 64 of a zipfile (at the end, just before the global comment) */ +static uint64_t zipSearchCentralDir64(const zlib_filefunc64_32_def *pzlib_filefunc_def, voidpf filestream, + const uint64_t endcentraloffset) +{ + uint64_t offset = 0; + uint32_t value32 = 0; + + /* Zip64 end of central directory locator */ + if (ZSEEK64(*pzlib_filefunc_def, filestream, endcentraloffset - SIZECENTRALHEADERLOCATOR, ZLIB_FILEFUNC_SEEK_SET) != 0) + return 0; + + /* Read locator signature */ + if (zipReadUInt32(pzlib_filefunc_def, filestream, &value32) != ZIP_OK) + return 0; + if (value32 != ZIP64ENDLOCHEADERMAGIC) + return 0; + /* Number of the disk with the start of the zip64 end of central directory */ + if (zipReadUInt32(pzlib_filefunc_def, filestream, &value32) != ZIP_OK) + return 0; + /* Relative offset of the zip64 end of central directory record */ + if (zipReadUInt64(pzlib_filefunc_def, filestream, &offset) != ZIP_OK) + return 0; + /* Total number of disks */ + if (zipReadUInt32(pzlib_filefunc_def, filestream, &value32) != ZIP_OK) + return 0; + /* Goto end of central directory record */ + if (ZSEEK64(*pzlib_filefunc_def, filestream, offset, ZLIB_FILEFUNC_SEEK_SET) != 0) + return 0; + /* The signature */ + if (zipReadUInt32(pzlib_filefunc_def, filestream, &value32) != ZIP_OK) + return 0; + if (value32 != ZIP64ENDHEADERMAGIC) + return 0; + + return offset; +} + +extern zipFile ZEXPORT zipOpen4(const void *path, int append, uint64_t disk_size, const char **globalcomment, + zlib_filefunc64_32_def *pzlib_filefunc64_32_def) +{ + zip64_internal ziinit = { 0 }; + zip64_internal *zi = NULL; +#ifndef NO_ADDFILEINEXISTINGZIP + uint64_t byte_before_the_zipfile = 0; /* byte before the zipfile, (>0 for sfx)*/ + uint64_t size_central_dir = 0; /* size of the central directory */ + uint64_t offset_central_dir = 0; /* offset of start of central directory */ + uint64_t number_entry_CD = 0; /* total number of entries in the central dir */ + uint64_t number_entry = 0; + uint64_t central_pos = 0; + uint64_t size_central_dir_to_read = 0; + uint16_t value16 = 0; + uint32_t value32 = 0; + uint16_t size_comment = 0; + size_t buf_size = SIZEDATA_INDATABLOCK; + void *buf_read = NULL; +#endif + int err = ZIP_OK; + int mode = 0; + + + if (pzlib_filefunc64_32_def == NULL) + fill_fopen64_filefunc(&ziinit.z_filefunc.zfile_func64); + else + { + assert((pzlib_filefunc64_32_def->zopen32_file || pzlib_filefunc64_32_def->zfile_func64.zopen64_file) && + (pzlib_filefunc64_32_def->zopendisk32_file || pzlib_filefunc64_32_def->zfile_func64.zopendisk64_file) && + (pzlib_filefunc64_32_def->ztell32_file || pzlib_filefunc64_32_def->zfile_func64.ztell64_file) && + (pzlib_filefunc64_32_def->zseek32_file || pzlib_filefunc64_32_def->zfile_func64.zseek64_file)); + ziinit.z_filefunc = *pzlib_filefunc64_32_def; + } + + if (append == APPEND_STATUS_CREATE) + mode = (ZLIB_FILEFUNC_MODE_READ | ZLIB_FILEFUNC_MODE_WRITE | ZLIB_FILEFUNC_MODE_CREATE); + else + mode = (ZLIB_FILEFUNC_MODE_READ | ZLIB_FILEFUNC_MODE_WRITE | ZLIB_FILEFUNC_MODE_EXISTING); + + ziinit.filestream = ZOPEN64(ziinit.z_filefunc, path, mode); + if (ziinit.filestream == NULL) + return NULL; + + if (append == APPEND_STATUS_CREATEAFTER) + { + /* Don't support spanning ZIP with APPEND_STATUS_CREATEAFTER */ + if (disk_size > 0) + return NULL; + + ZSEEK64(ziinit.z_filefunc, ziinit.filestream, 0, SEEK_END); + } + + + ziinit.filestream_with_CD = ziinit.filestream; + ziinit.append = append; + ziinit.disk_size = disk_size; + init_linkedlist(&(ziinit.central_dir)); + + zi = (zip64_internal*)ALLOC(sizeof(zip64_internal)); + if (zi == NULL) + { + ZCLOSE64(ziinit.z_filefunc, ziinit.filestream); + return NULL; + } + +#ifndef NO_ADDFILEINEXISTINGZIP + /* Add file in a zipfile */ + ziinit.globalcomment = NULL; + if (append == APPEND_STATUS_ADDINZIP) + { + /* Read and Cache Central Directory Records */ + central_pos = zipSearchCentralDir(&ziinit.z_filefunc, ziinit.filestream); + /* Disable to allow appending to empty ZIP archive (must be standard zip, not zip64) + if (central_pos == 0) + err = ZIP_ERRNO; + */ + + if (err == ZIP_OK) + { + /* Read end of central directory info */ + if (ZSEEK64(ziinit.z_filefunc, ziinit.filestream, central_pos, ZLIB_FILEFUNC_SEEK_SET) != 0) + err = ZIP_ERRNO; + + /* The signature, already checked */ + if (zipReadUInt32(&ziinit.z_filefunc, ziinit.filestream, &value32) != ZIP_OK) + err = ZIP_ERRNO; + /* Number of this disk */ + if (zipReadUInt16(&ziinit.z_filefunc, ziinit.filestream, &value16) != ZIP_OK) + err = ZIP_ERRNO; + ziinit.number_disk = value16; + /* Number of the disk with the start of the central directory */ + if (zipReadUInt16(&ziinit.z_filefunc, ziinit.filestream, &value16) != ZIP_OK) + err = ZIP_ERRNO; + ziinit.number_disk_with_CD = value16; + /* Total number of entries in the central dir on this disk */ + number_entry = 0; + if (zipReadUInt16(&ziinit.z_filefunc, ziinit.filestream, &value16) != ZIP_OK) + err = ZIP_ERRNO; + else + number_entry = value16; + /* Total number of entries in the central dir */ + number_entry_CD = 0; + if (zipReadUInt16(&ziinit.z_filefunc, ziinit.filestream, &value16) != ZIP_OK) + err = ZIP_ERRNO; + else + number_entry_CD = value16; + if (number_entry_CD!=number_entry) + err = ZIP_BADZIPFILE; + /* Size of the central directory */ + size_central_dir = 0; + if (zipReadUInt32(&ziinit.z_filefunc, ziinit.filestream, &value32) != ZIP_OK) + err = ZIP_ERRNO; + else + size_central_dir = value32; + /* Offset of start of central directory with respect to the starting disk number */ + offset_central_dir = 0; + if (zipReadUInt32(&ziinit.z_filefunc, ziinit.filestream, &value32) != ZIP_OK) + err = ZIP_ERRNO; + else + offset_central_dir = value32; + /* Zipfile global comment length */ + if (zipReadUInt16(&ziinit.z_filefunc, ziinit.filestream, &size_comment) != ZIP_OK) + err = ZIP_ERRNO; + + if ((err == ZIP_OK) && ((number_entry_CD == UINT16_MAX) || (offset_central_dir == UINT32_MAX))) + { + /* Format should be Zip64, as the central directory or file size is too large */ + central_pos = zipSearchCentralDir64(&ziinit.z_filefunc, ziinit.filestream, central_pos); + + if (central_pos) + { + uint64_t sizeEndOfCentralDirectory; + + if (ZSEEK64(ziinit.z_filefunc, ziinit.filestream, central_pos, ZLIB_FILEFUNC_SEEK_SET) != 0) + err = ZIP_ERRNO; + + /* The signature, already checked */ + if (zipReadUInt32(&ziinit.z_filefunc, ziinit.filestream, &value32) != ZIP_OK) + err = ZIP_ERRNO; + /* Size of zip64 end of central directory record */ + if (zipReadUInt64(&ziinit.z_filefunc, ziinit.filestream, &sizeEndOfCentralDirectory) != ZIP_OK) + err = ZIP_ERRNO; + /* Version made by */ + if (zipReadUInt16(&ziinit.z_filefunc, ziinit.filestream, &value16) != ZIP_OK) + err = ZIP_ERRNO; + /* Version needed to extract */ + if (zipReadUInt16(&ziinit.z_filefunc, ziinit.filestream, &value16) != ZIP_OK) + err = ZIP_ERRNO; + /* Number of this disk */ + if (zipReadUInt32(&ziinit.z_filefunc, ziinit.filestream, &ziinit.number_disk) != ZIP_OK) + err = ZIP_ERRNO; + /* Number of the disk with the start of the central directory */ + if (zipReadUInt32(&ziinit.z_filefunc, ziinit.filestream, &ziinit.number_disk_with_CD) != ZIP_OK) + err = ZIP_ERRNO; + /* Total number of entries in the central directory on this disk */ + if (zipReadUInt64(&ziinit.z_filefunc, ziinit.filestream, &number_entry) != ZIP_OK) + err = ZIP_ERRNO; + /* Total number of entries in the central directory */ + if (zipReadUInt64(&ziinit.z_filefunc, ziinit.filestream, &number_entry_CD) != ZIP_OK) + err = ZIP_ERRNO; + if (number_entry_CD!=number_entry) + err = ZIP_BADZIPFILE; + /* Size of the central directory */ + if (zipReadUInt64(&ziinit.z_filefunc, ziinit.filestream, &size_central_dir) != ZIP_OK) + err = ZIP_ERRNO; + /* Offset of start of central directory with respect to the starting disk number */ + if (zipReadUInt64(&ziinit.z_filefunc, ziinit.filestream, &offset_central_dir) != ZIP_OK) + err = ZIP_ERRNO; + } + else + err = ZIP_BADZIPFILE; + } + } + + if ((err == ZIP_OK) && (central_pos < offset_central_dir + size_central_dir)) + err = ZIP_BADZIPFILE; + + if ((err == ZIP_OK) && (size_comment > 0)) + { + ziinit.globalcomment = (char*)ALLOC(size_comment+1); + if (ziinit.globalcomment) + { + if (ZREAD64(ziinit.z_filefunc, ziinit.filestream, ziinit.globalcomment, size_comment) != size_comment) + err = ZIP_ERRNO; + else + ziinit.globalcomment[size_comment] = 0; + } + } + + if (err != ZIP_OK) + { + ZCLOSE64(ziinit.z_filefunc, ziinit.filestream); + TRYFREE(ziinit.globalcomment); + TRYFREE(zi); + return NULL; + } + + byte_before_the_zipfile = central_pos - (offset_central_dir+size_central_dir); + ziinit.add_position_when_writting_offset = byte_before_the_zipfile; + + /* Store central directory in memory */ + size_central_dir_to_read = size_central_dir; + buf_size = SIZEDATA_INDATABLOCK; + buf_read = (void*)ALLOC(buf_size); + + if (ZSEEK64(ziinit.z_filefunc, ziinit.filestream, + offset_central_dir + byte_before_the_zipfile, ZLIB_FILEFUNC_SEEK_SET) != 0) + err = ZIP_ERRNO; + + while ((size_central_dir_to_read > 0) && (err == ZIP_OK)) + { + uint64_t read_this = SIZEDATA_INDATABLOCK; + if (read_this > size_central_dir_to_read) + read_this = size_central_dir_to_read; + + if (ZREAD64(ziinit.z_filefunc, ziinit.filestream, buf_read, (uint32_t)read_this) != read_this) + err = ZIP_ERRNO; + + if (err == ZIP_OK) + err = add_data_in_datablock(&ziinit.central_dir, buf_read, (uint32_t)read_this); + + size_central_dir_to_read -= read_this; + } + TRYFREE(buf_read); + + ziinit.number_entry = number_entry_CD; + + if (ZSEEK64(ziinit.z_filefunc, ziinit.filestream, + offset_central_dir+byte_before_the_zipfile, ZLIB_FILEFUNC_SEEK_SET) != 0) + err = ZIP_ERRNO; + } + + if (globalcomment) + *globalcomment = ziinit.globalcomment; +#endif + + if (err != ZIP_OK) + { +#ifndef NO_ADDFILEINEXISTINGZIP + TRYFREE(ziinit.globalcomment); +#endif + TRYFREE(zi); + return NULL; + } + *zi = ziinit; + zipGoToFirstDisk((zipFile)zi); + + return(zipFile)zi; +} + +extern zipFile ZEXPORT zipOpen2(const char *path, int append, const char **globalcomment, + zlib_filefunc_def *pzlib_filefunc32_def) +{ + if (pzlib_filefunc32_def != NULL) + { + zlib_filefunc64_32_def zlib_filefunc64_32_def_fill = { 0 }; + fill_zlib_filefunc64_32_def_from_filefunc32(&zlib_filefunc64_32_def_fill, pzlib_filefunc32_def); + return zipOpen4(path, append, 0, globalcomment, &zlib_filefunc64_32_def_fill); + } + return zipOpen4(path, append, 0, globalcomment, NULL); +} + +extern zipFile ZEXPORT zipOpen2_64(const void *path, int append, const char **globalcomment, + zlib_filefunc64_def *pzlib_filefunc_def) +{ + if (pzlib_filefunc_def != NULL) + { + zlib_filefunc64_32_def zlib_filefunc64_32_def_fill = { 0 }; + zlib_filefunc64_32_def_fill.zfile_func64 = *pzlib_filefunc_def; + return zipOpen4(path, append, 0, globalcomment, &zlib_filefunc64_32_def_fill); + } + return zipOpen4(path, append, 0, globalcomment, NULL); +} + +extern zipFile ZEXPORT zipOpen3(const char *path, int append, uint64_t disk_size, const char **globalcomment, + zlib_filefunc_def *pzlib_filefunc32_def) +{ + if (pzlib_filefunc32_def != NULL) + { + zlib_filefunc64_32_def zlib_filefunc64_32_def_fill = { 0 }; + fill_zlib_filefunc64_32_def_from_filefunc32(&zlib_filefunc64_32_def_fill, pzlib_filefunc32_def); + return zipOpen4(path, append, disk_size, globalcomment, &zlib_filefunc64_32_def_fill); + } + return zipOpen4(path, append, disk_size, globalcomment, NULL); +} + +extern zipFile ZEXPORT zipOpen3_64(const void *path, int append, uint64_t disk_size, const char **globalcomment, + zlib_filefunc64_def *pzlib_filefunc_def) +{ + if (pzlib_filefunc_def != NULL) + { + zlib_filefunc64_32_def zlib_filefunc64_32_def_fill = { 0 }; + zlib_filefunc64_32_def_fill.zfile_func64 = *pzlib_filefunc_def; + return zipOpen4(path, append, disk_size, globalcomment, &zlib_filefunc64_32_def_fill); + } + return zipOpen4(path, append, disk_size, globalcomment, NULL); +} + +extern zipFile ZEXPORT zipOpen(const char *path, int append) +{ + return zipOpen3((const void*)path, append, 0, NULL, NULL); +} + +extern zipFile ZEXPORT zipOpen64(const void *path, int append) +{ + return zipOpen3(path, append, 0, NULL, NULL); +} + +extern int ZEXPORT zipOpenNewFileInZip5(zipFile file, + const char *filename, + const zip_fileinfo *zipfi, + const void *extrafield_local, + uint16_t size_extrafield_local, + const void *extrafield_global, + uint16_t size_extrafield_global, + const char *comment, + uint16_t flag_base, + int zip64, + uint16_t method, + int level, + int raw, + int windowBits, + int memLevel, + int strategy, + const char *password, + int aes, + uint16_t version_madeby) +{ + zip64_internal *zi = NULL; + uint64_t size_available = 0; + uint64_t size_needed = 0; + uint16_t size_filename = 0; + uint16_t size_comment = 0; + uint16_t i = 0; + unsigned char *central_dir = NULL; + int err = ZIP_OK; + +#ifdef NOCRYPT + if (password != NULL) + return ZIP_PARAMERROR; +#endif + + if (file == NULL) + return ZIP_PARAMERROR; + + if ((method != 0) && +#ifdef HAVE_BZIP2 + (method != Z_BZIP2ED) && +#endif + (method != Z_DEFLATED)) + return ZIP_PARAMERROR; + + zi = (zip64_internal*)file; + + if (zi->in_opened_file_inzip == 1) + { + err = zipCloseFileInZip (file); + if (err != ZIP_OK) + return err; + } + + if (filename == NULL) + filename = "-"; + if (comment != NULL) + size_comment = (uint16_t)strlen(comment); + + size_filename = (uint16_t)strlen(filename); + + if (zipfi == NULL) + zi->ci.dos_date = 0; + else + { + if (zipfi->dos_date != 0) + zi->ci.dos_date = zipfi->dos_date; + } + + zi->ci.method = method; + zi->ci.compression_method = method; + zi->ci.raw = raw; + zi->ci.flag = flag_base | 8; + if ((level == 8) || (level == 9)) + zi->ci.flag |= 2; + if (level == 2) + zi->ci.flag |= 4; + if (level == 1) + zi->ci.flag |= 6; + + if (password != NULL) + { + zi->ci.flag |= 1; +#ifdef HAVE_AES + if (aes) + zi->ci.method = AES_METHOD; +#endif + } + else + { + zi->ci.flag &= ~1; + } + + if (zi->disk_size > 0) + { + if ((zi->number_disk == 0) && (zi->number_entry == 0)) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)DISKHEADERMAGIC, 4); + + /* Make sure enough space available on current disk for local header */ + zipGetDiskSizeAvailable((zipFile)zi, &size_available); + size_needed = 30 + size_filename + size_extrafield_local; +#ifdef HAVE_AES + if (zi->ci.method == AES_METHOD) + size_needed += 11; +#endif + if (size_available < size_needed) + zipGoToNextDisk((zipFile)zi); + } + + zi->ci.zip64 = zip64; + + zi->ci.pos_local_header = ZTELL64(zi->z_filefunc, zi->filestream); + if (zi->ci.pos_local_header >= UINT32_MAX) + zi->ci.zip64 = 1; + + zi->ci.size_comment = size_comment; + zi->ci.size_centralheader = SIZECENTRALHEADER + size_filename + size_extrafield_global; + zi->ci.size_centralextra = size_extrafield_global; + zi->ci.size_centralextrafree = 32; /* Extra space reserved for ZIP64 extra info */ +#ifdef HAVE_AES + if (zi->ci.method == AES_METHOD) + zi->ci.size_centralextrafree += 11; /* Extra space reserved for AES extra info */ +#endif + zi->ci.central_header = (char*)ALLOC((uint32_t)zi->ci.size_centralheader + zi->ci.size_centralextrafree + size_comment); + zi->ci.number_disk = zi->number_disk; + + /* Write central directory header */ + /* https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT */ + central_dir = (unsigned char*)zi->ci.central_header; + zipWriteValueToMemoryAndMove(¢ral_dir, (uint32_t)CENTRALHEADERMAGIC, 4); + zipWriteValueToMemoryAndMove(¢ral_dir, version_madeby, 2); + if (zi->ci.zip64) + zipWriteValueToMemoryAndMove(¢ral_dir, (uint16_t)45, 2); + else + zipWriteValueToMemoryAndMove(¢ral_dir, (uint16_t)20, 2); + zipWriteValueToMemoryAndMove(¢ral_dir, zi->ci.flag, 2); + zipWriteValueToMemoryAndMove(¢ral_dir, zi->ci.method, 2); + zipWriteValueToMemoryAndMove(¢ral_dir, zi->ci.dos_date, 4); + zipWriteValueToMemoryAndMove(¢ral_dir, (uint32_t)0, 4); /*crc*/ + zipWriteValueToMemoryAndMove(¢ral_dir, (uint32_t)0, 4); /*compr size*/ + zipWriteValueToMemoryAndMove(¢ral_dir, (uint32_t)0, 4); /*uncompr size*/ + zipWriteValueToMemoryAndMove(¢ral_dir, size_filename, 2); + zipWriteValueToMemoryAndMove(¢ral_dir, size_extrafield_global, 2); + zipWriteValueToMemoryAndMove(¢ral_dir, size_comment, 2); + zipWriteValueToMemoryAndMove(¢ral_dir, (uint16_t)zi->ci.number_disk, 2); /*disk nm start*/ + + if (zipfi == NULL) + zipWriteValueToMemoryAndMove(¢ral_dir, (uint16_t)0, 2); + else + zipWriteValueToMemoryAndMove(¢ral_dir, zipfi->internal_fa, 2); + if (zipfi == NULL) + zipWriteValueToMemoryAndMove(¢ral_dir, (uint32_t)0, 4); + else + zipWriteValueToMemoryAndMove(¢ral_dir, zipfi->external_fa, 4); + if (zi->ci.pos_local_header >= UINT32_MAX) + zipWriteValueToMemoryAndMove(¢ral_dir, UINT32_MAX, 4); + else + zipWriteValueToMemoryAndMove(¢ral_dir, + (uint32_t)(zi->ci.pos_local_header - zi->add_position_when_writting_offset), 4); + + for (i = 0; i < size_filename; i++) + zi->ci.central_header[SIZECENTRALHEADER+i] = filename[i]; + for (i = 0; i < size_extrafield_global; i++) + zi->ci.central_header[SIZECENTRALHEADER+size_filename+i] = + ((const char*)extrafield_global)[i]; + + /* Store comment at the end for later repositioning */ + for (i = 0; i < size_comment; i++) + zi->ci.central_header[zi->ci.size_centralheader+ + zi->ci.size_centralextrafree+i] = comment[i]; + + if (zi->ci.central_header == NULL) + return ZIP_INTERNALERROR; + + /* Write the local header */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)LOCALHEADERMAGIC, 4); + + if (err == ZIP_OK) + { + if (zi->ci.zip64) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint16_t)45, 2); /* version needed to extract */ + else + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint16_t)20, 2); /* version needed to extract */ + } + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->ci.flag, 2); + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->ci.method, 2); + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->ci.dos_date, 4); + + /* CRC & compressed size & uncompressed size is in data descriptor */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)0, 4); /* crc 32, unknown */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)0, 4); /* compressed size, unknown */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)0, 4); /* uncompressed size, unknown */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, size_filename, 2); + if (err == ZIP_OK) + { + uint64_t size_extrafield = size_extrafield_local; +#ifdef HAVE_AES + if (zi->ci.method == AES_METHOD) + size_extrafield += 11; +#endif + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint16_t)size_extrafield, 2); + } + if ((err == ZIP_OK) && (size_filename > 0)) + { + if (ZWRITE64(zi->z_filefunc, zi->filestream, filename, size_filename) != size_filename) + err = ZIP_ERRNO; + } + if ((err == ZIP_OK) && (size_extrafield_local > 0)) + { + if (ZWRITE64(zi->z_filefunc, zi->filestream, extrafield_local, size_extrafield_local) != size_extrafield_local) + err = ZIP_ERRNO; + } + +#ifdef HAVE_AES + /* Write the AES extended info */ + if ((err == ZIP_OK) && (zi->ci.method == AES_METHOD)) + { + int headerid = 0x9901; + short datasize = 7; + + err = zipWriteValue(&zi->z_filefunc, zi->filestream, headerid, 2); + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, datasize, 2); + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, AES_VERSION, 2); + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, 'A', 1); + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, 'E', 1); + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, AES_ENCRYPTIONMODE, 1); + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->ci.compression_method, 2); + } +#endif + + zi->ci.crc32 = 0; + zi->ci.stream_initialised = 0; + zi->ci.pos_in_buffered_data = 0; + zi->ci.total_compressed = 0; + zi->ci.total_uncompressed = 0; + +#ifdef HAVE_BZIP2 + zi->ci.bstream.avail_in = (uint16_t)0; + zi->ci.bstream.avail_out = (uint16_t)Z_BUFSIZE; + zi->ci.bstream.next_out = (char*)zi->ci.buffered_data; + zi->ci.bstream.total_in_hi32 = 0; + zi->ci.bstream.total_in_lo32 = 0; + zi->ci.bstream.total_out_hi32 = 0; + zi->ci.bstream.total_out_lo32 = 0; +#endif + + zi->ci.stream.avail_in = (uint16_t)0; + zi->ci.stream.avail_out = Z_BUFSIZE; + zi->ci.stream.next_out = zi->ci.buffered_data; + zi->ci.stream.total_in = 0; + zi->ci.stream.total_out = 0; + zi->ci.stream.data_type = Z_BINARY; + + if ((err == ZIP_OK) && (!zi->ci.raw)) + { + if (method == Z_DEFLATED) + { + zi->ci.stream.zalloc = (alloc_func)0; + zi->ci.stream.zfree = (free_func)0; + zi->ci.stream.opaque = (voidpf)zi; + + if (windowBits > 0) + windowBits = -windowBits; + +#ifdef HAVE_APPLE_COMPRESSION + err = compression_stream_init(&zi->ci.astream, COMPRESSION_STREAM_ENCODE, COMPRESSION_ZLIB); + if (err == COMPRESSION_STATUS_ERROR) + err = Z_ERRNO; + else + err = Z_OK; +#else + err = deflateInit2(&zi->ci.stream, level, Z_DEFLATED, windowBits, memLevel, strategy); +#endif + if (err == Z_OK) + zi->ci.stream_initialised = Z_DEFLATED; + } + else if (method == Z_BZIP2ED) + { +#ifdef HAVE_BZIP2 + zi->ci.bstream.bzalloc = 0; + zi->ci.bstream.bzfree = 0; + zi->ci.bstream.opaque = (voidpf)0; + + err = BZ2_bzCompressInit(&zi->ci.bstream, level, 0, 35); + if (err == BZ_OK) + zi->ci.stream_initialised = Z_BZIP2ED; +#endif + } + } + +#ifndef NOCRYPT + if ((err == Z_OK) && (password != NULL)) + { +#ifdef HAVE_AES + if (zi->ci.method == AES_METHOD) + { + unsigned char passverify[AES_PWVERIFYSIZE]; + unsigned char saltvalue[AES_MAXSALTLENGTH]; + uint16_t saltlength = 0; + + if ((AES_ENCRYPTIONMODE < 1) || (AES_ENCRYPTIONMODE > 3)) + return Z_ERRNO; + + saltlength = SALT_LENGTH(AES_ENCRYPTIONMODE); + + prng_init(cryptrand, zi->ci.aes_rng); + prng_rand(saltvalue, saltlength, zi->ci.aes_rng); + prng_end(zi->ci.aes_rng); + + fcrypt_init(AES_ENCRYPTIONMODE, (uint8_t *)password, (uint32_t)strlen(password), saltvalue, passverify, &zi->ci.aes_ctx); + + if (ZWRITE64(zi->z_filefunc, zi->filestream, saltvalue, saltlength) != saltlength) + err = ZIP_ERRNO; + if (ZWRITE64(zi->z_filefunc, zi->filestream, passverify, AES_PWVERIFYSIZE) != AES_PWVERIFYSIZE) + err = ZIP_ERRNO; + + zi->ci.total_compressed += saltlength + AES_PWVERIFYSIZE + AES_AUTHCODESIZE; + } + else +#endif + { + unsigned char buf_head[RAND_HEAD_LEN]; + uint32_t size_head = 0; + uint8_t verify1 = 0; + uint8_t verify2 = 0; + + zi->ci.pcrc_32_tab = get_crc_table(); + + /* + Info-ZIP modification to ZipCrypto format: + If bit 3 of the general purpose bit flag is set, it uses high byte of 16-bit File Time. + */ + verify1 = (uint8_t)((zi->ci.dos_date >> 16) & 0xff); + verify2 = (uint8_t)((zi->ci.dos_date >> 8) & 0xff); + + size_head = crypthead(password, buf_head, RAND_HEAD_LEN, zi->ci.keys, zi->ci.pcrc_32_tab, verify1, verify2); + zi->ci.total_compressed += size_head; + + if (ZWRITE64(zi->z_filefunc, zi->filestream, buf_head, size_head) != size_head) + err = ZIP_ERRNO; + } + } +#endif + + if (err == Z_OK) + zi->in_opened_file_inzip = 1; + return err; +} + +extern int ZEXPORT zipOpenNewFileInZip4_64(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw, int windowBits, int memLevel, + int strategy, const char *password, ZIP_UNUSED uint32_t crc_for_crypting, uint16_t version_madeby, uint16_t flag_base, int zip64) +{ + uint8_t aes = 0; +#ifdef HAVE_AES + aes = 1; +#endif + return zipOpenNewFileInZip5(file, filename, zipfi, extrafield_local, size_extrafield_local, extrafield_global, + size_extrafield_global, comment, flag_base, zip64, method, level, raw, windowBits, memLevel, strategy, password, aes, + version_madeby); +} + +extern int ZEXPORT zipOpenNewFileInZip4(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw, int windowBits, + int memLevel, int strategy, const char *password, ZIP_UNUSED uint32_t crc_for_crypting, uint16_t version_madeby, uint16_t flag_base) +{ + return zipOpenNewFileInZip4_64(file, filename, zipfi, extrafield_local, size_extrafield_local, + extrafield_global, size_extrafield_global, comment, method, level, raw, windowBits, memLevel, + strategy, password, crc_for_crypting, version_madeby, flag_base, 0); +} + +extern int ZEXPORT zipOpenNewFileInZip3(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw, int windowBits, + int memLevel, int strategy, const char *password, ZIP_UNUSED uint32_t crc_for_crypting) +{ + return zipOpenNewFileInZip4_64(file, filename, zipfi, extrafield_local, size_extrafield_local, + extrafield_global, size_extrafield_global, comment, method, level, raw, windowBits, memLevel, + strategy, password, crc_for_crypting, VERSIONMADEBY, 0, 0); +} + +extern int ZEXPORT zipOpenNewFileInZip3_64(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw, int windowBits, + int memLevel, int strategy, const char *password, ZIP_UNUSED uint32_t crc_for_crypting, int zip64) +{ + return zipOpenNewFileInZip4_64(file, filename, zipfi, extrafield_local, size_extrafield_local, + extrafield_global, size_extrafield_global, comment, method, level, raw, windowBits, memLevel, strategy, + password, crc_for_crypting, VERSIONMADEBY, 0, zip64); +} + +extern int ZEXPORT zipOpenNewFileInZip2(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw) +{ + return zipOpenNewFileInZip4_64(file, filename, zipfi, extrafield_local, size_extrafield_local, + extrafield_global, size_extrafield_global, comment, method, level, raw, -MAX_WBITS, DEF_MEM_LEVEL, + Z_DEFAULT_STRATEGY, NULL, 0, VERSIONMADEBY, 0, 0); +} + +extern int ZEXPORT zipOpenNewFileInZip2_64(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw, int zip64) +{ + return zipOpenNewFileInZip4_64(file, filename, zipfi, extrafield_local, size_extrafield_local, + extrafield_global, size_extrafield_global, comment, method, level, raw, -MAX_WBITS, DEF_MEM_LEVEL, + Z_DEFAULT_STRATEGY, NULL, 0, VERSIONMADEBY, 0, zip64); +} + +extern int ZEXPORT zipOpenNewFileInZip64(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int zip64) +{ + return zipOpenNewFileInZip4_64(file, filename, zipfi, extrafield_local, size_extrafield_local, + extrafield_global, size_extrafield_global, comment, method, level, 0, -MAX_WBITS, DEF_MEM_LEVEL, + Z_DEFAULT_STRATEGY, NULL, 0, VERSIONMADEBY, 0, zip64); +} + +extern int ZEXPORT zipOpenNewFileInZip(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level) +{ + return zipOpenNewFileInZip4_64(file, filename, zipfi, extrafield_local, size_extrafield_local, + extrafield_global, size_extrafield_global, comment, method, level, 0, -MAX_WBITS, DEF_MEM_LEVEL, + Z_DEFAULT_STRATEGY, NULL, 0, VERSIONMADEBY, 0, 0); +} + +/* Flushes the write buffer to disk */ +static int zipFlushWriteBuffer(zip64_internal *zi) +{ + uint64_t size_available = 0; + uint32_t written = 0; + uint32_t total_written = 0; + uint32_t write = 0; + uint32_t max_write = 0; + int err = ZIP_OK; + + if ((zi->ci.flag & 1) != 0) + { +#ifndef NOCRYPT +#ifdef HAVE_AES + if (zi->ci.method == AES_METHOD) + { + fcrypt_encrypt(zi->ci.buffered_data, zi->ci.pos_in_buffered_data, &zi->ci.aes_ctx); + } + else +#endif + { + uint32_t i = 0; + uint8_t t = 0; + + for (i = 0; i < zi->ci.pos_in_buffered_data; i++) + zi->ci.buffered_data[i] = (uint8_t)zencode(zi->ci.keys, zi->ci.pcrc_32_tab, zi->ci.buffered_data[i], t); + } +#endif + } + + write = zi->ci.pos_in_buffered_data; + + do + { + max_write = write; + + if (zi->disk_size > 0) + { + zipGetDiskSizeAvailable((zipFile)zi, &size_available); + + if (size_available == 0) + { + err = zipGoToNextDisk((zipFile)zi); + if (err != ZIP_OK) + return err; + } + + if (size_available < (uint64_t)max_write) + max_write = (uint32_t)size_available; + } + + written = ZWRITE64(zi->z_filefunc, zi->filestream, zi->ci.buffered_data + total_written, max_write); + if (written != max_write) + { + err = ZIP_ERRNO; + break; + } + + total_written += written; + write -= written; + } + while (write > 0); + + zi->ci.total_compressed += zi->ci.pos_in_buffered_data; + +#ifdef HAVE_BZIP2 + if (zi->ci.compression_method == Z_BZIP2ED) + { + zi->ci.total_uncompressed += zi->ci.bstream.total_in_lo32; + zi->ci.bstream.total_in_lo32 = 0; + zi->ci.bstream.total_in_hi32 = 0; + } + else +#endif + { + zi->ci.total_uncompressed += zi->ci.stream.total_in; + zi->ci.stream.total_in = 0; + } + + zi->ci.pos_in_buffered_data = 0; + + return err; +} + +extern int ZEXPORT zipWriteInFileInZip(zipFile file, const void *buf, uint32_t len) +{ + zip64_internal *zi = NULL; + int err = ZIP_OK; + + if (file == NULL) + return ZIP_PARAMERROR; + zi = (zip64_internal*)file; + + if (zi->in_opened_file_inzip == 0) + return ZIP_PARAMERROR; + + zi->ci.crc32 = (uint32_t)crc32(zi->ci.crc32, buf, len); + +#ifdef HAVE_BZIP2 + if ((zi->ci.compression_method == Z_BZIP2ED) && (!zi->ci.raw)) + { + zi->ci.bstream.next_in = (void*)buf; + zi->ci.bstream.avail_in = len; + err = BZ_RUN_OK; + + while ((err == BZ_RUN_OK) && (zi->ci.bstream.avail_in > 0)) + { + if (zi->ci.bstream.avail_out == 0) + { + err = zipFlushWriteBuffer(zi); + + zi->ci.bstream.avail_out = (uint16_t)Z_BUFSIZE; + zi->ci.bstream.next_out = (char*)zi->ci.buffered_data; + } + else + { + uint32_t total_out_before_lo = zi->ci.bstream.total_out_lo32; + uint32_t total_out_before_hi = zi->ci.bstream.total_out_hi32; + + err = BZ2_bzCompress(&zi->ci.bstream, BZ_RUN); + + zi->ci.pos_in_buffered_data += (uint16_t)(zi->ci.bstream.total_out_lo32 - total_out_before_lo); + } + } + + if (err == BZ_RUN_OK) + err = ZIP_OK; + } + else +#endif + { + zi->ci.stream.next_in = (uint8_t*)buf; + zi->ci.stream.avail_in = len; + + while ((err == ZIP_OK) && (zi->ci.stream.avail_in > 0)) + { + if (zi->ci.stream.avail_out == 0) + { + err = zipFlushWriteBuffer(zi); + + zi->ci.stream.avail_out = Z_BUFSIZE; + zi->ci.stream.next_out = zi->ci.buffered_data; + } + + if (err != ZIP_OK) + break; + + if ((zi->ci.compression_method == Z_DEFLATED) && (!zi->ci.raw)) + { +#ifdef HAVE_APPLE_COMPRESSION + uLong total_out_before = zi->ci.stream.total_out; + + zi->ci.astream.src_ptr = zi->ci.stream.next_in; + zi->ci.astream.src_size = zi->ci.stream.avail_in; + zi->ci.astream.dst_ptr = zi->ci.stream.next_out; + zi->ci.astream.dst_size = zi->ci.stream.avail_out; + + compression_status status = 0; + compression_stream_flags flags = 0; + + status = compression_stream_process(&zi->ci.astream, flags); + + uLong total_out_after = len - zi->ci.astream.src_size; + + zi->ci.stream.next_in = zi->ci.astream.src_ptr; + zi->ci.stream.avail_in = zi->ci.astream.src_size; + zi->ci.stream.next_out = zi->ci.astream.dst_ptr; + zi->ci.stream.avail_out = zi->ci.astream.dst_size; + zi->ci.stream.total_in += total_out_after; + //zi->ci.stream.total_out += copy_this; + zi->ci.pos_in_buffered_data += total_out_after; + + if (status == COMPRESSION_STATUS_ERROR) + err = ZIP_INTERNALERROR; +#else + uint32_t total_out_before = (uint32_t)zi->ci.stream.total_out; + err = deflate(&zi->ci.stream, Z_NO_FLUSH); + zi->ci.pos_in_buffered_data += (uint32_t)(zi->ci.stream.total_out - total_out_before); +#endif + } + else + { + uint32_t copy_this = 0; + uint32_t i = 0; + if (zi->ci.stream.avail_in < zi->ci.stream.avail_out) + copy_this = zi->ci.stream.avail_in; + else + copy_this = zi->ci.stream.avail_out; + + for (i = 0; i < copy_this; i++) + *(((char*)zi->ci.stream.next_out)+i) = + *(((const char*)zi->ci.stream.next_in)+i); + + zi->ci.stream.avail_in -= copy_this; + zi->ci.stream.avail_out -= copy_this; + zi->ci.stream.next_in += copy_this; + zi->ci.stream.next_out += copy_this; + zi->ci.stream.total_in += copy_this; + zi->ci.stream.total_out += copy_this; + zi->ci.pos_in_buffered_data += copy_this; + } + } + } + + return err; +} + +extern int ZEXPORT zipCloseFileInZipRaw64(zipFile file, uint64_t uncompressed_size, uint32_t crc32) +{ + zip64_internal *zi = NULL; + uint16_t extra_data_size = 0; + uint32_t i = 0; + unsigned char *extra_info = NULL; + int err = ZIP_OK; + + if (file == NULL) + return ZIP_PARAMERROR; + zi = (zip64_internal*)file; + + if (zi->in_opened_file_inzip == 0) + return ZIP_PARAMERROR; + zi->ci.stream.avail_in = 0; + + if (!zi->ci.raw) + { + if (zi->ci.compression_method == Z_DEFLATED) + { + while (err == ZIP_OK) + { + uint32_t total_out_before = 0; + + if (zi->ci.stream.avail_out == 0) + { + err = zipFlushWriteBuffer(zi); + + zi->ci.stream.avail_out = Z_BUFSIZE; + zi->ci.stream.next_out = zi->ci.buffered_data; + } + + if (err != ZIP_OK) + break; + +#ifdef HAVE_APPLE_COMPRESSION + total_out_before = zi->ci.stream.total_out; + + zi->ci.astream.src_ptr = zi->ci.stream.next_in; + zi->ci.astream.src_size = zi->ci.stream.avail_in; + zi->ci.astream.dst_ptr = zi->ci.stream.next_out; + zi->ci.astream.dst_size = zi->ci.stream.avail_out; + + compression_status status = 0; + status = compression_stream_process(&zi->ci.astream, COMPRESSION_STREAM_FINALIZE); + + uint32_t total_out_after = Z_BUFSIZE - zi->ci.astream.dst_size; + + zi->ci.stream.next_in = zi->ci.astream.src_ptr; + zi->ci.stream.avail_in = zi->ci.astream.src_size; + zi->ci.stream.next_out = zi->ci.astream.dst_ptr; + zi->ci.stream.avail_out = zi->ci.astream.dst_size; + //zi->ci.stream.total_in += total_out_after; + //zi->ci.stream.total_out += copy_this; + zi->ci.pos_in_buffered_data += total_out_after; + + if (status == COMPRESSION_STATUS_ERROR) + { + err = ZIP_INTERNALERROR; + } + else if (status == COMPRESSION_STATUS_END) + { + err = Z_STREAM_END; + } +#else + total_out_before = (uint32_t)zi->ci.stream.total_out; + err = deflate(&zi->ci.stream, Z_FINISH); + zi->ci.pos_in_buffered_data += (uint16_t)(zi->ci.stream.total_out - total_out_before); +#endif + } + } + else if (zi->ci.compression_method == Z_BZIP2ED) + { +#ifdef HAVE_BZIP2 + err = BZ_FINISH_OK; + while (err == BZ_FINISH_OK) + { + uint32_t total_out_before = 0; + + if (zi->ci.bstream.avail_out == 0) + { + err = zipFlushWriteBuffer(zi); + + zi->ci.bstream.avail_out = (uint16_t)Z_BUFSIZE; + zi->ci.bstream.next_out = (char*)zi->ci.buffered_data; + } + + total_out_before = zi->ci.bstream.total_out_lo32; + err = BZ2_bzCompress(&zi->ci.bstream, BZ_FINISH); + if (err == BZ_STREAM_END) + err = Z_STREAM_END; + zi->ci.pos_in_buffered_data += (uint16_t)(zi->ci.bstream.total_out_lo32 - total_out_before); + } + + if (err == BZ_FINISH_OK) + err = ZIP_OK; +#endif + } + } + + if (err == Z_STREAM_END) + err = ZIP_OK; /* this is normal */ + + if ((zi->ci.pos_in_buffered_data > 0) && (err == ZIP_OK)) + { + err = zipFlushWriteBuffer(zi); + } + +#ifdef HAVE_AES + if (zi->ci.method == AES_METHOD) + { + unsigned char authcode[AES_AUTHCODESIZE]; + + fcrypt_end(authcode, &zi->ci.aes_ctx); + + if (ZWRITE64(zi->z_filefunc, zi->filestream, authcode, AES_AUTHCODESIZE) != AES_AUTHCODESIZE) + err = ZIP_ERRNO; + } +#endif + + if (!zi->ci.raw) + { + if (zi->ci.compression_method == Z_DEFLATED) + { + int tmp_err = 0; +#ifdef HAVE_APPLE_COMPRESSION + tmp_err = compression_stream_destroy(&zi->ci.astream); +#else + tmp_err = deflateEnd(&zi->ci.stream); +#endif + if (err == ZIP_OK) + err = tmp_err; + zi->ci.stream_initialised = 0; + } +#ifdef HAVE_BZIP2 + else if (zi->ci.compression_method == Z_BZIP2ED) + { + int tmperr = BZ2_bzCompressEnd(&zi->ci.bstream); + if (err == ZIP_OK) + err = tmperr; + zi->ci.stream_initialised = 0; + } +#endif + + crc32 = zi->ci.crc32; + uncompressed_size = zi->ci.total_uncompressed; + } + + /* Write data descriptor */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)DATADESCRIPTORMAGIC, 4); + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, crc32, 4); + if (err == ZIP_OK) + { + if (zi->ci.zip64) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->ci.total_compressed, 8); + else + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)zi->ci.total_compressed, 4); + } + if (err == ZIP_OK) + { + if (zi->ci.zip64) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, uncompressed_size, 8); + else + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)uncompressed_size, 4); + } + + /* Update crc and sizes to central directory */ + zipWriteValueToMemory(zi->ci.central_header + 16, crc32, 4); /* crc */ + if (zi->ci.total_compressed >= UINT32_MAX) + zipWriteValueToMemory(zi->ci.central_header + 20, UINT32_MAX, 4); /* compr size */ + else + zipWriteValueToMemory(zi->ci.central_header + 20, zi->ci.total_compressed, 4); /* compr size */ + if (uncompressed_size >= UINT32_MAX) + zipWriteValueToMemory(zi->ci.central_header + 24, UINT32_MAX, 4); /* uncompr size */ + else + zipWriteValueToMemory(zi->ci.central_header + 24, uncompressed_size, 4); /* uncompr size */ + if (zi->ci.stream.data_type == Z_ASCII) + zipWriteValueToMemory(zi->ci.central_header + 36, (uint16_t)Z_ASCII, 2); /* internal file attrib */ + + /* Add ZIP64 extra info field for uncompressed size */ + if (uncompressed_size >= UINT32_MAX) + extra_data_size += 8; + /* Add ZIP64 extra info field for compressed size */ + if (zi->ci.total_compressed >= UINT32_MAX) + extra_data_size += 8; + /* Add ZIP64 extra info field for relative offset to local file header of current file */ + if (zi->ci.pos_local_header >= UINT32_MAX) + extra_data_size += 8; + + /* Add ZIP64 extra info header to central directory */ + if (extra_data_size > 0) + { + if ((uint32_t)(extra_data_size + 4) > zi->ci.size_centralextrafree) + return ZIP_BADZIPFILE; + + extra_info = (unsigned char*)zi->ci.central_header + zi->ci.size_centralheader; + + zipWriteValueToMemoryAndMove(&extra_info, 0x0001, 2); + zipWriteValueToMemoryAndMove(&extra_info, extra_data_size, 2); + + if (uncompressed_size >= UINT32_MAX) + zipWriteValueToMemoryAndMove(&extra_info, uncompressed_size, 8); + if (zi->ci.total_compressed >= UINT32_MAX) + zipWriteValueToMemoryAndMove(&extra_info, zi->ci.total_compressed, 8); + if (zi->ci.pos_local_header >= UINT32_MAX) + zipWriteValueToMemoryAndMove(&extra_info, zi->ci.pos_local_header, 8); + + zi->ci.size_centralextrafree -= extra_data_size + 4; + zi->ci.size_centralheader += extra_data_size + 4; + zi->ci.size_centralextra += extra_data_size + 4; + + zipWriteValueToMemory(zi->ci.central_header + 30, zi->ci.size_centralextra, 2); + } + +#ifdef HAVE_AES + /* Write AES extra info header to central directory */ + if (zi->ci.method == AES_METHOD) + { + extra_info = (unsigned char*)zi->ci.central_header + zi->ci.size_centralheader; + extra_data_size = 7; + + if ((uint32_t)(extra_data_size + 4) > zi->ci.size_centralextrafree) + return ZIP_BADZIPFILE; + + zipWriteValueToMemoryAndMove(&extra_info, 0x9901, 2); + zipWriteValueToMemoryAndMove(&extra_info, extra_data_size, 2); + zipWriteValueToMemoryAndMove(&extra_info, AES_VERSION, 2); + zipWriteValueToMemoryAndMove(&extra_info, 'A', 1); + zipWriteValueToMemoryAndMove(&extra_info, 'E', 1); + zipWriteValueToMemoryAndMove(&extra_info, AES_ENCRYPTIONMODE, 1); + zipWriteValueToMemoryAndMove(&extra_info, zi->ci.compression_method, 2); + + zi->ci.size_centralextrafree -= extra_data_size + 4; + zi->ci.size_centralheader += extra_data_size + 4; + zi->ci.size_centralextra += extra_data_size + 4; + + zipWriteValueToMemory(zi->ci.central_header + 30, zi->ci.size_centralextra, 2); + } +#endif + /* Restore comment to correct position */ + for (i = 0; i < zi->ci.size_comment; i++) + zi->ci.central_header[zi->ci.size_centralheader+i] = + zi->ci.central_header[zi->ci.size_centralheader+zi->ci.size_centralextrafree+i]; + zi->ci.size_centralheader += zi->ci.size_comment; + + if (err == ZIP_OK) + err = add_data_in_datablock(&zi->central_dir, zi->ci.central_header, zi->ci.size_centralheader); + + free(zi->ci.central_header); + + zi->number_entry++; + zi->in_opened_file_inzip = 0; + + return err; +} + +extern int ZEXPORT zipCloseFileInZipRaw(zipFile file, uint32_t uncompressed_size, uint32_t crc32) +{ + return zipCloseFileInZipRaw64(file, uncompressed_size, crc32); +} + +extern int ZEXPORT zipCloseFileInZip(zipFile file) +{ + return zipCloseFileInZipRaw(file, 0, 0); +} + +extern int ZEXPORT zipClose(zipFile file, const char *global_comment) +{ + return zipClose_64(file, global_comment); +} + +extern int ZEXPORT zipClose_64(zipFile file, const char *global_comment) +{ + return zipClose2_64(file, global_comment, VERSIONMADEBY); +} + +extern int ZEXPORT zipClose2_64(zipFile file, const char *global_comment, uint16_t version_madeby) +{ + zip64_internal *zi = NULL; + uint32_t size_centraldir = 0; + uint16_t size_global_comment = 0; + uint64_t centraldir_pos_inzip = 0; + uint64_t pos = 0; + uint64_t cd_pos = 0; + uint32_t write = 0; + int err = ZIP_OK; + + if (file == NULL) + return ZIP_PARAMERROR; + zi = (zip64_internal*)file; + + if (zi->in_opened_file_inzip == 1) + err = zipCloseFileInZip(file); + +#ifndef NO_ADDFILEINEXISTINGZIP + if (global_comment == NULL) + global_comment = zi->globalcomment; +#endif + + if (zi->filestream != zi->filestream_with_CD) + { + if (ZCLOSE64(zi->z_filefunc, zi->filestream) != 0) + if (err == ZIP_OK) + err = ZIP_ERRNO; + if (zi->disk_size > 0) + zi->number_disk_with_CD = zi->number_disk + 1; + zi->filestream = zi->filestream_with_CD; + } + + centraldir_pos_inzip = ZTELL64(zi->z_filefunc, zi->filestream); + + if (err == ZIP_OK) + { + linkedlist_datablock_internal *ldi = zi->central_dir.first_block; + while (ldi != NULL) + { + if ((err == ZIP_OK) && (ldi->filled_in_this_block > 0)) + { + write = ZWRITE64(zi->z_filefunc, zi->filestream, ldi->data, ldi->filled_in_this_block); + if (write != ldi->filled_in_this_block) + err = ZIP_ERRNO; + } + + size_centraldir += ldi->filled_in_this_block; + ldi = ldi->next_datablock; + } + } + + free_linkedlist(&(zi->central_dir)); + + pos = centraldir_pos_inzip - zi->add_position_when_writting_offset; + + /* Write the ZIP64 central directory header */ + if (pos >= UINT32_MAX || zi->number_entry > UINT32_MAX) + { + uint64_t zip64_eocd_pos_inzip = ZTELL64(zi->z_filefunc, zi->filestream); + uint32_t zip64_datasize = 44; + + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)ZIP64ENDHEADERMAGIC, 4); + + /* Size of this 'zip64 end of central directory' */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint64_t)zip64_datasize, 8); + /* Version made by */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, version_madeby, 2); + /* version needed */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint16_t)45, 2); + /* Number of this disk */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->number_disk_with_CD, 4); + /* Number of the disk with the start of the central directory */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->number_disk_with_CD, 4); + /* Total number of entries in the central dir on this disk */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->number_entry, 8); + /* Total number of entries in the central dir */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->number_entry, 8); + /* Size of the central directory */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint64_t)size_centraldir, 8); + + if (err == ZIP_OK) + { + /* Offset of start of central directory with respect to the starting disk number */ + cd_pos = centraldir_pos_inzip - zi->add_position_when_writting_offset; + err = zipWriteValue(&zi->z_filefunc, zi->filestream, cd_pos, 8); + } + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)ZIP64ENDLOCHEADERMAGIC, 4); + + /* Number of the disk with the start of the central directory */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->number_disk_with_CD, 4); + /* Relative offset to the Zip64EndOfCentralDirectory */ + if (err == ZIP_OK) + { + cd_pos = zip64_eocd_pos_inzip - zi->add_position_when_writting_offset; + err = zipWriteValue(&zi->z_filefunc, zi->filestream, cd_pos, 8); + } + /* Number of the disk with the start of the central directory */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, zi->number_disk_with_CD + 1, 4); + } + + /* Write the central directory header */ + + /* Signature */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)ENDHEADERMAGIC, 4); + /* Number of this disk */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint16_t)zi->number_disk_with_CD, 2); + /* Number of the disk with the start of the central directory */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint16_t)zi->number_disk_with_CD, 2); + /* Total number of entries in the central dir on this disk */ + if (err == ZIP_OK) + { + if (zi->number_entry >= UINT16_MAX) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, UINT16_MAX, 2); /* use value in ZIP64 record */ + else + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint16_t)zi->number_entry, 2); + } + /* Total number of entries in the central dir */ + if (err == ZIP_OK) + { + if (zi->number_entry >= UINT16_MAX) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, UINT16_MAX, 2); /* use value in ZIP64 record */ + else + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint16_t)zi->number_entry, 2); + } + /* Size of the central directory */ + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, size_centraldir, 4); + /* Offset of start of central directory with respect to the starting disk number */ + if (err == ZIP_OK) + { + cd_pos = centraldir_pos_inzip - zi->add_position_when_writting_offset; + if (pos >= UINT32_MAX) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, UINT32_MAX, 4); + else + err = zipWriteValue(&zi->z_filefunc, zi->filestream, (uint32_t)cd_pos, 4); + } + + /* Write global comment */ + + if (global_comment != NULL) + size_global_comment = (uint16_t)strlen(global_comment); + if (err == ZIP_OK) + err = zipWriteValue(&zi->z_filefunc, zi->filestream, size_global_comment, 2); + if (err == ZIP_OK && size_global_comment > 0) + { + if (ZWRITE64(zi->z_filefunc, zi->filestream, global_comment, size_global_comment) != size_global_comment) + err = ZIP_ERRNO; + } + + if ((ZCLOSE64(zi->z_filefunc, zi->filestream) != 0) && (err == ZIP_OK)) + err = ZIP_ERRNO; + +#ifndef NO_ADDFILEINEXISTINGZIP + TRYFREE(zi->globalcomment); +#endif + TRYFREE(zi); + + return err; +} diff --git a/SSZipArchive/minizip/zip.h b/SSZipArchive/minizip/zip.h new file mode 100644 index 0000000..38805ad --- /dev/null +++ b/SSZipArchive/minizip/zip.h @@ -0,0 +1,215 @@ +/* zip.h -- IO on .zip files using zlib + Version 1.2.0, September 16th, 2017 + part of the MiniZip project + + Copyright (C) 2012-2017 Nathan Moinvaziri + https://github.com/nmoinvaz/minizip + Copyright (C) 2009-2010 Mathias Svensson + Modifications for Zip64 support + http://result42.com + Copyright (C) 1998-2010 Gilles Vollant + http://www.winimage.com/zLibDll/minizip.html + + This program is distributed under the terms of the same license as zlib. + See the accompanying LICENSE file for the full text of the license. +*/ + +#ifndef _ZIP_H +#define _ZIP_H + +#define HAVE_AES + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef _ZLIB_H +# include "zlib.h" +#endif + +#ifndef _ZLIBIOAPI_H +# include "ioapi.h" +#endif + +#ifdef HAVE_BZIP2 +# include "bzlib.h" +#endif + +#define Z_BZIP2ED 12 + +#if defined(STRICTZIP) || defined(STRICTZIPUNZIP) +/* like the STRICT of WIN32, we define a pointer that cannot be converted + from (void*) without cast */ +typedef struct TagzipFile__ { int unused; } zip_file__; +typedef zip_file__ *zipFile; +#else +typedef voidp zipFile; +#endif + +#define ZIP_OK (0) +#define ZIP_EOF (0) +#define ZIP_ERRNO (Z_ERRNO) +#define ZIP_PARAMERROR (-102) +#define ZIP_BADZIPFILE (-103) +#define ZIP_INTERNALERROR (-104) + +#ifndef DEF_MEM_LEVEL +# if MAX_MEM_LEVEL >= 8 +# define DEF_MEM_LEVEL 8 +# else +# define DEF_MEM_LEVEL MAX_MEM_LEVEL +# endif +#endif + +typedef struct +{ + uint32_t dos_date; + uint16_t internal_fa; /* internal file attributes 2 bytes */ + uint32_t external_fa; /* external file attributes 4 bytes */ +} zip_fileinfo; + +#define APPEND_STATUS_CREATE (0) +#define APPEND_STATUS_CREATEAFTER (1) +#define APPEND_STATUS_ADDINZIP (2) + +/***************************************************************************/ +/* Writing a zip file */ + +extern zipFile ZEXPORT zipOpen(const char *path, int append); +extern zipFile ZEXPORT zipOpen64(const void *path, int append); +/* Create a zipfile. + + path should contain the full path (by example, on a Windows XP computer + "c:\\zlib\\zlib113.zip" or on an Unix computer "zlib/zlib113.zip". + + return NULL if zipfile cannot be opened + return zipFile handle if no error + + If the file path exist and append == APPEND_STATUS_CREATEAFTER, the zip + will be created at the end of the file. (useful if the file contain a self extractor code) + If the file path exist and append == APPEND_STATUS_ADDINZIP, we will add files in existing + zip (be sure you don't add file that doesn't exist) + + NOTE: There is no delete function into a zipfile. If you want delete file into a zipfile, + you must open a zipfile, and create another. Of course, you can use RAW reading and writing to copy + the file you did not want delete. */ + +extern zipFile ZEXPORT zipOpen2(const char *path, int append, const char **globalcomment, + zlib_filefunc_def *pzlib_filefunc_def); + +extern zipFile ZEXPORT zipOpen2_64(const void *path, int append, const char **globalcomment, + zlib_filefunc64_def *pzlib_filefunc_def); + +extern zipFile ZEXPORT zipOpen3(const char *path, int append, uint64_t disk_size, + const char **globalcomment, zlib_filefunc_def *pzlib_filefunc_def); +/* Same as zipOpen2 but allows specification of spanned zip size */ + +extern zipFile ZEXPORT zipOpen3_64(const void *path, int append, uint64_t disk_size, + const char **globalcomment, zlib_filefunc64_def *pzlib_filefunc_def); + +extern int ZEXPORT zipOpenNewFileInZip(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level); +/* Open a file in the ZIP for writing. + + filename : the filename in zip (if NULL, '-' without quote will be used + *zipfi contain supplemental information + extrafield_local buffer to store the local header extra field data, can be NULL + size_extrafield_local size of extrafield_local buffer + extrafield_global buffer to store the global header extra field data, can be NULL + size_extrafield_global size of extrafield_local buffer + comment buffer for comment string + method contain the compression method (0 for store, Z_DEFLATED for deflate) + level contain the level of compression (can be Z_DEFAULT_COMPRESSION) + zip64 is set to 1 if a zip64 extended information block should be added to the local file header. + this MUST be '1' if the uncompressed size is >= 0xffffffff. */ + +extern int ZEXPORT zipOpenNewFileInZip64(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int zip64); +/* Same as zipOpenNewFileInZip with zip64 support */ + +extern int ZEXPORT zipOpenNewFileInZip2(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw); +/* Same as zipOpenNewFileInZip, except if raw=1, we write raw file */ + +extern int ZEXPORT zipOpenNewFileInZip2_64(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw, int zip64); +/* Same as zipOpenNewFileInZip3 with zip64 support */ + +extern int ZEXPORT zipOpenNewFileInZip3(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw, int windowBits, int memLevel, + int strategy, const char *password, ZIP_UNUSED uint32_t crc_for_crypting); +/* Same as zipOpenNewFileInZip2, except + windowBits, memLevel, strategy : see parameter strategy in deflateInit2 + password : crypting password (NULL for no crypting) + crc_for_crypting : crc of file to compress (needed for crypting) */ + +extern int ZEXPORT zipOpenNewFileInZip3_64(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw, int windowBits, int memLevel, + int strategy, const char *password, ZIP_UNUSED uint32_t crc_for_crypting, int zip64); +/* Same as zipOpenNewFileInZip3 with zip64 support */ + +extern int ZEXPORT zipOpenNewFileInZip4(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw, int windowBits, int memLevel, + int strategy, const char *password, ZIP_UNUSED uint32_t crc_for_crypting, uint16_t version_madeby, uint16_t flag_base); +/* Same as zipOpenNewFileInZip3 except versionMadeBy & flag fields */ + +extern int ZEXPORT zipOpenNewFileInZip4_64(zipFile file, const char *filename, const zip_fileinfo *zipfi, + const void *extrafield_local, uint16_t size_extrafield_local, const void *extrafield_global, + uint16_t size_extrafield_global, const char *comment, uint16_t method, int level, int raw, int windowBits, int memLevel, + int strategy, const char *password, ZIP_UNUSED uint32_t crc_for_crypting, uint16_t version_madeby, uint16_t flag_base, int zip64); +/* Same as zipOpenNewFileInZip4 with zip64 support */ + +extern int ZEXPORT zipOpenNewFileInZip5(zipFile file, + const char *filename, + const zip_fileinfo *zipfi, + const void *extrafield_local, + uint16_t size_extrafield_local, + const void *extrafield_global, + uint16_t size_extrafield_global, + const char *comment, + uint16_t flag_base, + int zip64, + uint16_t method, + int level, + int raw, + int windowBits, + int memLevel, + int strategy, + const char *password, + int aes, + uint16_t version_madeby); +/* Allowing optional aes */ + +extern int ZEXPORT zipWriteInFileInZip(zipFile file, const void *buf, uint32_t len); +/* Write data in the zipfile */ + +extern int ZEXPORT zipCloseFileInZip(zipFile file); +/* Close the current file in the zipfile */ + +extern int ZEXPORT zipCloseFileInZipRaw(zipFile file, uint32_t uncompressed_size, uint32_t crc32); +extern int ZEXPORT zipCloseFileInZipRaw64(zipFile file, uint64_t uncompressed_size, uint32_t crc32); +/* Close the current file in the zipfile, for file opened with parameter raw=1 in zipOpenNewFileInZip2 + where raw is compressed data. Parameters uncompressed_size and crc32 are value for the uncompressed data. */ + +extern int ZEXPORT zipClose(zipFile file, const char *global_comment); +/* Close the zipfile */ + +extern int ZEXPORT zipClose_64(zipFile file, const char *global_comment); + +extern int ZEXPORT zipClose2_64(zipFile file, const char *global_comment, uint16_t version_madeby); +/* Same as zipClose_64 except version_madeby field */ + +/***************************************************************************/ + +#ifdef __cplusplus +} +#endif + +#endif /* _ZIP_H */ diff --git a/TDAppDelegate.h b/TDAppDelegate.h new file mode 100644 index 0000000..bc7e573 --- /dev/null +++ b/TDAppDelegate.h @@ -0,0 +1,8 @@ +#import + +@interface TDAppDelegate : UIResponder + +@property (nonatomic, strong) UIWindow *window; +@property (nonatomic, strong) UINavigationController *rootViewController; + +@end diff --git a/TDAppDelegate.m b/TDAppDelegate.m new file mode 100644 index 0000000..993c1b7 --- /dev/null +++ b/TDAppDelegate.m @@ -0,0 +1,14 @@ +#import "TDAppDelegate.h" +#import "TDRootViewController.h" + +@implementation TDAppDelegate + +- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { + _window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds]; + _rootViewController = [[UINavigationController alloc] initWithRootViewController:[[TDRootViewController alloc] init]]; + _window.rootViewController = _rootViewController; + [_window makeKeyAndVisible]; + return YES; +} + +@end diff --git a/TDDumpDecrypted.h b/TDDumpDecrypted.h new file mode 100644 index 0000000..ffe588d --- /dev/null +++ b/TDDumpDecrypted.h @@ -0,0 +1,17 @@ +@interface DumpDecrypted : NSObject { + char decryptedAppPathStr[PATH_MAX]; + char *filename; + char *appDirName; + char *appDirPath; +} + +@property (assign) NSString *appPath; +@property (assign) NSString *docPath; +@property (assign) NSString *appName; +@property (assign) NSString *appVersion; + +- (id)initWithPathToBinary:(NSString *)pathToBinary appName:(NSString *)appName appVersion:(NSString *)appVersion; +- (void)createIPAFile:(pid_t)pid; +- (BOOL)dumpDecryptedImage:(const struct mach_header *)image_mh fileName:(const char *)encryptedImageFilenameStr image:(int)imageNum task:(vm_map_t)targetTask; +- (NSString *)IPAPath; +@end \ No newline at end of file diff --git a/TDDumpDecrypted.m b/TDDumpDecrypted.m new file mode 100644 index 0000000..36aabda --- /dev/null +++ b/TDDumpDecrypted.m @@ -0,0 +1,615 @@ +/* + bfinject - Inject shared libraries into running App Store apps on iOS 11.x < 11.2 + https://github.com/BishopFox/bfinject + + Carl Livitt @ Bishop Fox + + Based on code originally by 10n1c: https://github.com/stefanesser/dumpdecrypted/blob/master/dumpdecrypted.c + Now with the following enhancements: + - Dump ALL encrypted images in the target application: the app itself, its frameworks, etc. + - Create a valid .ipa containing the decrypted binaries. Save it in ~/Documents/decrypted-app.ipa + - The .ipa can be modified and re-signed with a developer cert for redeployment to non-jailbroken devices + - Auto detection of all the necessary sandbox paths + - Converted into an Objective-C class for ease of use. +*/ +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#import "SSZipArchive/SSZipArchive.h" +#import +#import + +#include +#include +#include +#include +#include + +#include "TDDumpDecrypted.h" +#import "TDUtils.h" + +kern_return_t +mach_vm_read_overwrite(vm_map_t, mach_vm_address_t, mach_vm_size_t, mach_vm_address_t, mach_vm_size_t *); +// kern_return_t mach_vm_read(vm_map_t target_task, mach_vm_address_t address, mach_vm_size_t size, vm_offset_t *data, mach_msg_type_number_t *dataCnt); +kern_return_t +mach_vm_region(vm_map_read_t target_task, mach_vm_address_t *address, mach_vm_size_t *size, vm_region_flavor_t flavor, vm_region_info_t info, mach_msg_type_number_t *infoCnt, mach_port_t *object_name); + + +//#define DEBUG(...) NSLog(__VA_ARGS__); +// #define DEBUG(...) {} + +#define swap32(value) (((value & 0xFF000000) >> 24) | ((value & 0x00FF0000) >> 8) | ((value & 0x0000FF00) << 8) | ((value & 0x000000FF) << 24) ) + +unsigned char *readProcessMemory (mach_port_t proc, mach_vm_address_t addr, mach_msg_type_number_t* size) { + mach_msg_type_number_t dataCnt = (mach_msg_type_number_t) *size; + vm_offset_t readMem; + + kern_return_t kr = vm_read(proc, addr, *size, &readMem, &dataCnt); + + if (kr) { + //fprintf (stderr, "Unable to read target task's memory @%p - kr 0x%x\n", (void *) addr, kr); + return NULL; + } + + return ((unsigned char *) readMem); +} + +static kern_return_t +readmem(mach_vm_offset_t *buffer, mach_vm_address_t address, mach_vm_size_t size, vm_map_t targetTask, vm_region_basic_info_data_64_t *info) +{ + // get task for pid + vm_map_t port = targetTask; + + kern_return_t kr; + mach_msg_type_number_t info_cnt = sizeof (vm_region_basic_info_data_64_t); + mach_port_t object_name; + mach_vm_size_t size_info; + mach_vm_address_t address_info = address; + kr = mach_vm_region(port, &address_info, &size_info, VM_REGION_BASIC_INFO_64, (vm_region_info_t)info, &info_cnt, &object_name); + if (kr) + { + fprintf(stderr, "[ERROR] mach_vm_region failed with error %d\n", (int)kr); + return KERN_FAILURE; + } + + /* read memory - vm_read_overwrite because we supply the buffer */ + mach_vm_size_t nread; + kr = mach_vm_read_overwrite(port, address, size, (mach_vm_address_t)buffer, &nread); + if (kr) + { + fprintf(stderr, "[ERROR] vm_read failed! %d\n", kr); + return KERN_FAILURE; + } + else if (nread != size) + { + fprintf(stderr, "[ERROR] vm_read failed! requested size: 0x%llx read: 0x%llx\n", size, nread); + return KERN_FAILURE; + } + return KERN_SUCCESS; +} + +int64_t +get_image_size(mach_vm_address_t address, vm_map_t targetTask, uint64_t *vmaddr_slide) +{ + vm_region_basic_info_data_64_t region_info = {0}; + // allocate a buffer to read the header info + // NOTE: this is not exactly correct since the 64bit version has an extra 4 bytes + // but this will work for this purpose so no need for more complexity! + struct mach_header header = {0}; + if (readmem((mach_vm_offset_t*)&header, address, sizeof(struct mach_header), targetTask, ®ion_info)) + { + printf("Can't read header!\n"); + return -1; + } + + if (header.magic != MH_MAGIC && header.magic != MH_MAGIC_64) + { + printf("[ERROR] Target is not a mach-o binary!\n"); + return -1; + } + + int64_t imagefilesize = -1; + /* read the load commands */ + uint8_t *loadcmds = (uint8_t*)malloc(header.sizeofcmds); + uint16_t mach_header_size = sizeof(struct mach_header); + if (header.magic == MH_MAGIC_64) + { + mach_header_size = sizeof(struct mach_header_64); + } + if (readmem((mach_vm_offset_t*)loadcmds, address+mach_header_size, header.sizeofcmds, targetTask, ®ion_info)) + { + printf("Can't read load commands\n"); + free(loadcmds); + return -1; + } + + /* process and retrieve address and size of linkedit */ + uint8_t *loadCmdAddress = 0; + loadCmdAddress = (uint8_t*)loadcmds; + struct load_command *loadCommand = NULL; + struct segment_command *segCmd = NULL; + struct segment_command_64 *segCmd64 = NULL; + for (uint32_t i = 0; i < header.ncmds; i++) + { + loadCommand = (struct load_command*)loadCmdAddress; + if (loadCommand->cmd == LC_SEGMENT) + { + segCmd = (struct segment_command*)loadCmdAddress; + if (strncmp(segCmd->segname, "__PAGEZERO", 16) != 0) + { + if (strncmp(segCmd->segname, "__TEXT", 16) == 0) + { + *vmaddr_slide = address - segCmd->vmaddr; + } + imagefilesize += segCmd->filesize; + } + } + else if (loadCommand->cmd == LC_SEGMENT_64) + { + segCmd64 = (struct segment_command_64*)loadCmdAddress; + if (strncmp(segCmd64->segname, "__PAGEZERO", 16) != 0) + { + if (strncmp(segCmd64->segname, "__TEXT", 16) == 0) + { + *vmaddr_slide = address - segCmd64->vmaddr; + } + imagefilesize += segCmd64->filesize; + } + } + // advance to next command + loadCmdAddress += loadCommand->cmdsize; + } + free(loadcmds); + return imagefilesize; +} + +int find_off_cryptid(const char *filePath) { + NSLog(@"[trolldecrypt] %s filePath: %s", __FUNCTION__, filePath); + int off_cryptid = 0; + FILE* file = fopen(filePath, "rb"); + if (!file) return 1; + + fseek(file, 0, SEEK_END); + long fileSize = ftell(file); + fseek(file, 0, SEEK_SET); + + char* buffer = malloc(fileSize);//new char[fileSize]; + fread(buffer, 1, fileSize, file); + + struct mach_header_64* header = (struct mach_header_64*)buffer; + if (header->magic != MH_MAGIC_64) { + printf("[-] error: not a valid macho file\n"); + free(buffer); + fclose(file); + return 2; + } + + struct load_command* lc = (struct load_command*)((mach_vm_address_t)header + sizeof(struct mach_header_64)); + for (uint32_t i = 0; i < header->ncmds; i++) { + if (lc->cmd == LC_ENCRYPTION_INFO || lc->cmd == LC_ENCRYPTION_INFO_64) { + struct encryption_info_command *encryption_info = (struct encryption_info_command*) lc; + + + NSLog(@"[trolldecrypt] cryptid: %d\n", encryption_info->cryptid); + NSLog(@"[trolldecrypt] Found cryptid at offset: 0x%llx\n", (mach_vm_address_t)lc + offsetof(struct encryption_info_command, cryptid) - (mach_vm_address_t)header); + + off_cryptid = (mach_vm_address_t)lc + offsetof(struct encryption_info_command, cryptid) - (mach_vm_address_t)header; + break; + } + lc = (struct load_command*)((mach_vm_address_t)lc + lc->cmdsize); + } + free(buffer); + fclose(file); + + return off_cryptid; +} + +@implementation DumpDecrypted + +-(id) initWithPathToBinary:(NSString *)pathToBinary appName:(NSString *)appName appVersion:(NSString *)appVersion { + if(!self) { + self = [super init]; + } + + self.appName = appName; + self.appVersion = appVersion; + + [self setAppPath:[pathToBinary stringByDeletingLastPathComponent]]; + [self setDocPath:[NSString stringWithFormat:@"%@/Documents", NSHomeDirectory()]]; + + char *lastPartOfAppPath = strdup([[self appPath] UTF8String]); + lastPartOfAppPath = strrchr(lastPartOfAppPath, '/') + 1; + NSLog(@"[trolldecrypt] init: appDirName: %s", lastPartOfAppPath); + self->appDirName = strdup(lastPartOfAppPath); + + return self; +} + + +-(void) makeDirectories:(const char *)encryptedImageFilenameStr { + char *appPath = (char *)[[self appPath] UTF8String]; + char *docPath = (char *)[[self docPath] UTF8String]; + char *savePtr; + char *encryptedImagePathStr = savePtr = strdup(encryptedImageFilenameStr); + self->filename = strdup(strrchr(encryptedImagePathStr, '/') + 1); + + // Normalize the filenames + if(strstr(encryptedImagePathStr, "/private") == encryptedImagePathStr) + encryptedImagePathStr += 8; + if(strstr(appPath, "/private") == appPath) + appPath += 8; + + // Find start of image path, relative to the base of the app sandbox (ie. /var/mobile/.../FooBar.app/THIS_PART_HERE) + encryptedImagePathStr += strlen(appPath) + 1; // skip over the app path + char *p = strrchr(encryptedImagePathStr, '/'); + if(p) + *p = '\0'; + + NSLog(@"[trolldecrypt] encryptedImagePathStr: %s", encryptedImagePathStr); + + NSFileManager *fm = [[NSFileManager alloc] init]; + NSError *err; + char *lastPartOfAppPath = strdup(appPath); // Must free() + lastPartOfAppPath = strrchr(lastPartOfAppPath, '/'); + lastPartOfAppPath++; + NSString *path = [NSString stringWithFormat:@"%s/ipa/Payload/%s", docPath, lastPartOfAppPath]; + self->appDirPath = strdup([path UTF8String]); + if(p) + path = [NSString stringWithFormat:@"%@/%s", path, encryptedImagePathStr]; + + NSLog(@"[trolldecrypt] make_directories making dir: %@", path); + if(! [fm createDirectoryAtPath:path withIntermediateDirectories:true attributes:nil error:&err]) { + NSLog(@"[trolldecrypt] WARNING: make_directories failed to make directory %@. Error: %@", path, err); + } + + free(savePtr); + + snprintf(self->decryptedAppPathStr, PATH_MAX, "%s/%s", [path UTF8String], self->filename); + + return; +} + + +-(BOOL) dumpDecryptedImage:(vm_address_t)imageAddress fileName:(const char *)encryptedImageFilenameStr image:(int)imageNum task:(vm_map_t)targetTask{ + // struct load_command *lc; + struct encryption_info_command *eic; + struct fat_header *fh; + struct fat_arch *arch; + // struct mach_header *mh; + char buffer[1024]; + unsigned int fileoffs = 0, off_cryptid = 0, restsize; + int i, fd, outfd, r, n; + + struct mach_header header = {0}; + vm_region_basic_info_data_64_t region_info = {0}; + if (readmem((mach_vm_offset_t*)&header, imageAddress, sizeof(struct mach_header), targetTask, ®ion_info)) + { + NSLog(@"[trolldecrypt] Can't read header!"); + exit(1); + } + //XXX: change all image_mh -> header NOW + + struct load_command *lc = (struct load_command*)malloc(header.sizeofcmds); + + /* detect if this is a arm64 binary */ + if (header.magic == MH_MAGIC_64) { + // lc = (struct load_command *)((unsigned char *)header + sizeof(struct mach_header_64)); + readmem((mach_vm_offset_t*)lc, imageAddress+sizeof(struct mach_header_64), header.sizeofcmds, targetTask, ®ion_info); + NSLog(@"[trolldecrypt] detected 64bit ARM binary in memory.\n"); + } else if(header.magic == MH_MAGIC) { /* we might want to check for other errors here, too */ + // lc = (struct load_command *)((unsigned char *)header + sizeof(struct mach_header)); + readmem((mach_vm_offset_t*)lc, imageAddress+sizeof(struct mach_header), header.sizeofcmds, targetTask, ®ion_info); + NSLog(@"[trolldecrypt] detected 32bit ARM binary in memory.\n"); + } else { + NSLog(@"[trolldecrypt] No valid header found!!"); + return false; + } + + + // sleep(1);exit(1); + const struct mach_header *image_mh = &header; + + /* searching all load commands for an LC_ENCRYPTION_INFO load command */ + for (i=0; incmds; i++) { + if (lc->cmd == LC_ENCRYPTION_INFO || lc->cmd == LC_ENCRYPTION_INFO_64) { + eic = (struct encryption_info_command *)lc; + // struct encryption_info_command *eic = (uint8_t*)malloc(sizeof(struct encryption_info_command);); + // readmem((mach_vm_offset_t*)eic, imageAddress+sizeof(struct mach_header_64), header.sizeofcmds, targetTask, ®ion_info); + + const char *appFilename = strrchr(encryptedImageFilenameStr, '/'); + if(appFilename == NULL) { + NSLog(@"[trolldecrypt] There are no / in the filename. This is an error.\n"); + return false; + } + appFilename++; + + /* If this load command is present, but data is not crypted then exit */ + if (eic->cryptid == 0) { + NSLog(@"[trolldecrypt] CryptID = 0!! "); + return false; + } + + // Create a dir structure in ~ just like in /path/to/FooApp.app/Whatever + [self makeDirectories:encryptedImageFilenameStr]; + + //0x1518 + uint32_t aslr_slide = 0; + get_image_size(imageAddress, targetTask, &aslr_slide); + NSLog(@"[trolldecrypt] aslr_slide= 0x%x", aslr_slide); + + off_cryptid=find_off_cryptid(encryptedImageFilenameStr); + + NSLog(@"[trolldecrypt] offset to cryptid (%d) found in memory @ %p (from %p). off_cryptid = %u (0x%x)\n", eic->cryptid, &eic->cryptid, image_mh, off_cryptid, off_cryptid); + //NSLog(@"[trolldecrypt] Found encrypted data at offset %u 0x%08x. image_mh @ %p. cryptedData @ 0x%x. cryptsize = %u (0x%x) bytes.\n", eic->cryptoff, eic->cryptoff, image_mh, (unsigned int)image_mh + eic->cryptoff, eic->cryptsize, eic->cryptsize); + + NSLog(@"[trolldecrypt] Dumping: %s", encryptedImageFilenameStr); + NSLog(@"[trolldecrypt] Into: %s", self->decryptedAppPathStr); + fd = open(encryptedImageFilenameStr, O_RDONLY); + if (fd == -1) { + NSLog(@"[trolldecrypt] Failed to open %s", encryptedImageFilenameStr); + return false; + } + + NSLog(@"[trolldecrypt] Reading header"); + n = read(fd, (void *)buffer, sizeof(buffer)); + if (n != sizeof(buffer)) { + NSLog(@"[trolldecrypt] Warning read only %d of %lu bytes from encrypted file.\n", n, sizeof(buffer)); + return false; + } + + NSLog(@"[trolldecrypt] Detecting header type\n"); + fh = (struct fat_header *)buffer; + + /* Is this a FAT file - we assume the right endianess */ + if (fh->magic == FAT_CIGAM) { + NSLog(@"[trolldecrypt] Executable is a FAT image - searching for right architecture\n"); + arch = (struct fat_arch *)&fh[1]; + for (i=0; infat_arch); i++) { + if ((image_mh->cputype == swap32(arch->cputype)) && (image_mh->cpusubtype == swap32(arch->cpusubtype))) { + fileoffs = swap32(arch->offset); + NSLog(@"[trolldecrypt] Correct arch is at offset 0x%x in the file.\n", fileoffs); + break; + } + arch++; + } + if (fileoffs == 0) { + NSLog(@"[trolldecrypt] Could not find correct arch in FAT image\n"); + return false; + } + } else if (fh->magic == MH_MAGIC || fh->magic == MH_MAGIC_64) { + NSLog(@"[trolldecrypt] Executable is a plain MACH-O image, fileoffs = 0\n"); + } else { + NSLog(@"[trolldecrypt] Executable is of unknown type, fileoffs = 0\n"); + return false; + } + + NSLog(@"[trolldecrypt] Opening %s for writing.\n", decryptedAppPathStr); + outfd = open(decryptedAppPathStr, O_RDWR|O_CREAT|O_TRUNC, 0644); + if (outfd == -1) { + NSLog(@"[trolldecrypt] Failed opening: "); + return false; + } + + /* calculate address of beginning of crypted data */ + n = fileoffs + eic->cryptoff; + + restsize = lseek(fd, 0, SEEK_END) - n - eic->cryptsize; + //NSLog(@"[trolldecrypt] restsize = %u, n = %u, cryptsize = %u, total = %u", restsize, n, eic->cryptsize, n + eic->cryptsize + restsize); + lseek(fd, 0, SEEK_SET); + + NSLog(@"[trolldecrypt] Copying the not encrypted start of the file (%u bytes)\n", n); + + /* first copy all the data before the encrypted data */ + char *buf = (char *)malloc((size_t)n); + r = read(fd, buf, n); + if(r != n) { + NSLog(@"[trolldecrypt] Error reading start of file\n"); + return false; + } + r = write(outfd, buf, n); + if(r != n) { + NSLog(@"[trolldecrypt] Error writing start of file\n"); + return false; + } + free(buf); + + /* now write the previously encrypted data */ + + NSLog(@"[trolldecrypt] Dumping the decrypted data into the file (%u bytes)\n", eic->cryptsize); + buf = (char *)malloc((size_t)eic->cryptsize); + readmem((mach_vm_offset_t*)buf, imageAddress+eic->cryptoff, eic->cryptsize, targetTask, ®ion_info); + // r = write(outfd, (unsigned char *)image_mh + eic->cryptoff, eic->cryptsize); + r = write(outfd, buf, eic->cryptsize); + if (r != eic->cryptsize) { + NSLog(@"[trolldecrypt] Error writing encrypted part of file\n"); + return false; + } + free(buf); + + + /* and finish with the remainder of the file */ + NSLog(@"[trolldecrypt] Copying the not encrypted remainder of the file (%u bytes)\n", restsize); + lseek(fd, eic->cryptsize, SEEK_CUR); + buf = (char *)malloc((size_t)restsize); + r = read(fd, buf, restsize); + if (r != restsize) { + NSLog(@"[trolldecrypt] Error reading rest of file, got %u bytes\n", r); + return false; + } + r = write(outfd, buf, restsize); + if (r != restsize) { + NSLog(@"[trolldecrypt] Error writing rest of file\n"); + return false; + } + free(buf); + + + if (off_cryptid) { + uint32_t zero=0; + NSLog(@"[trolldecrypt] Setting the LC_ENCRYPTION_INFO->cryptid to 0 at offset 0x%x into file\n", off_cryptid); + if (lseek(outfd, off_cryptid, SEEK_SET) == off_cryptid) { + if(write(outfd, &zero, 4) != 4) { + NSLog(@"[trolldecrypt] Error writing cryptid value!!\n"); + // Not a fatal error, just warn + } + } else { + NSLog(@"[trolldecrypt] Failed to seek to cryptid offset!!"); + // this error is not treated as fatal + } + } + + close(fd); + close(outfd); + sync(); + // exit(1); + + return true; + } + + lc = (struct load_command *)((unsigned char *)lc+lc->cmdsize); + // readmem((mach_vm_offset_t*)lc, lc+lc->cmdsize, header.sizeofcmds, targetTask, ®ion_info); + } + // DEBUG(@"[!] This mach-o file is not encrypted. Nothing was decrypted.\n"); + return false; +} + + +-(void) dumpDecrypted:(pid_t)pid { + + vm_map_t targetTask = 0; + if (task_for_pid(mach_task_self(), pid, &targetTask)) + { + NSLog(@"[trolldecrypt] Can't execute task_for_pid! Do you have the right permissions/entitlements?\n"); + exit(1); + } + + //numberOfImages + struct task_dyld_info dyld_info; + mach_msg_type_number_t count = TASK_DYLD_INFO_COUNT; + + if(task_info(targetTask, TASK_DYLD_INFO, (task_info_t)&dyld_info, &count) != KERN_SUCCESS) exit(1); + + mach_msg_type_number_t size = sizeof(struct dyld_all_image_infos); + uint8_t* data = readProcessMemory(targetTask, dyld_info.all_image_info_addr, &size); + struct dyld_all_image_infos* infos = (struct dyld_all_image_infos *) data; + + mach_msg_type_number_t size2 = sizeof(struct dyld_image_info) * infos->infoArrayCount; + uint8_t* info_addr = readProcessMemory(targetTask, (mach_vm_address_t) infos->infoArray, &size2); + struct dyld_image_info* info = (struct dyld_image_info*) info_addr; + + uint32_t numberOfImages = infos->infoArrayCount; + mach_vm_address_t imageAddress = 0; + const char *appPath = [[self appPath] UTF8String]; + + NSLog(@"[trolldecrypt] There are %d images mapped.", numberOfImages); + + for (int i = 0; i < numberOfImages; i++) { + NSLog(@"[trolldecrypt] image %d", i); + mach_msg_type_number_t size3 = PATH_MAX; + uint8_t *fpath_addr = readProcessMemory(targetTask, (mach_vm_address_t) info[i].imageFilePath, &size3); + + imageAddress = (struct mach_header *)info[i].imageLoadAddress; + const char *imageName = fpath_addr; + + if(!imageName || !imageAddress) + continue; + + NSLog(@"[trolldecrypt] Comparing %s to %s", imageName, appPath); + + if(strstr(imageName, appPath) != NULL) { + NSLog(@"[trolldecrypt] Dumping image %d: %s", i, imageName); + [self dumpDecryptedImage:imageAddress fileName:imageName image:i task: targetTask]; + } + } +} + + +-(BOOL)fileManager:(NSFileManager *)f shouldProceedAfterError:(BOOL)proceed copyingItemAtPath:(NSString *)path toPath:(NSString *)dest { + return true; +} + +-(NSString *)IPAPath { + return [NSString stringWithFormat:@"%@/%@_%@_decrypted.ipa", [self docPath], self.appName, self.appVersion]; +} + +-(void) createIPAFile:(pid_t)pid { + NSString *IPAFile = [self IPAPath]; + NSString *appDir = [self appPath]; + NSString *appCopyDir = [NSString stringWithFormat:@"%@/ipa/Payload/%s", [self docPath], self->appDirName]; + NSString *zipDir = [NSString stringWithFormat:@"%@/ipa", [self docPath]]; + NSFileManager *fm = [[NSFileManager alloc] init]; + NSError *err; + + [fm removeItemAtPath:IPAFile error:nil]; + [fm removeItemAtPath:appCopyDir error:nil]; + [fm createDirectoryAtPath:appCopyDir withIntermediateDirectories:true attributes:nil error:nil]; + + [fm setDelegate:(id)self]; + + NSLog(@"[trolldecrypt] ======== START FILE COPY - IGNORE ANY SANDBOX WARNINGS ========"); + NSLog(@"[trolldecrypt] IPAFile: %@", IPAFile); + NSLog(@"[trolldecrypt] appDir: %@", appDir); + NSLog(@"[trolldecrypt] appCopyDir: %@", appCopyDir); + NSLog(@"[trolldecrypt] zipDir: %@", zipDir); + + [fm copyItemAtPath:appDir toPath:appCopyDir error:&err]; + NSLog(@"[trolldecrypt] ======== END OF FILE COPY ========"); + // sleep(1); + // exit(1); + // Replace encrypted binaries with decrypted versions + NSLog(@"[trolldecrypt] ======== START DECRYPTION PROCESS ========"); + [self dumpDecrypted:pid]; + NSLog(@"[trolldecrypt] ======== DECRYPTION COMPLETE ========"); + + // ZIP it up + NSLog(@"[trolldecrypt] ======== STARTING ZIP ========"); + NSLog(@"[trolldecrypt] IPA file: %@", IPAFile); + NSLog(@"[trolldecrypt] ZIP dir: %@", zipDir); + unlink([IPAFile UTF8String]); + @try { + BOOL success = [SSZipArchive createZipFileAtPath:IPAFile + withContentsOfDirectory:zipDir + keepParentDirectory:NO + compressionLevel:1 + password:nil + AES:NO + progressHandler:nil + ]; + NSLog(@"[trolldecrypt] ======== ZIP operation complete: %s ========", (success)?"success":"failed"); + } + @catch(NSException *e) { + NSLog(@"[trolldecrypt] BAAAAAAAARF during ZIP operation!!! , %@", e); + } + + + // Clean up. Leave only the .ipa file. + [fm removeItemAtPath:zipDir error:nil]; + + NSLog(@"[trolldecrypt] ======== Wrote %@ ========", [self IPAPath]); + return; +} + +@end \ No newline at end of file diff --git a/TDFileManagerViewController.h b/TDFileManagerViewController.h new file mode 100644 index 0000000..cc3aaae --- /dev/null +++ b/TDFileManagerViewController.h @@ -0,0 +1,7 @@ +#import + +@interface TDFileManagerViewController : UITableViewController + +@property (nonatomic, strong) NSArray *fileList; + +@end \ No newline at end of file diff --git a/TDFileManagerViewController.m b/TDFileManagerViewController.m new file mode 100644 index 0000000..46bdac5 --- /dev/null +++ b/TDFileManagerViewController.m @@ -0,0 +1,97 @@ +#import "TDFileManagerViewController.h" +#import "TDUtils.h" + +@implementation TDFileManagerViewController + +- (void)loadView { + [super loadView]; + + self.title = @"Decrypted IPAs"; + self.fileList = decryptedFileList(); + + self.navigationItem.rightBarButtonItem = [[UIBarButtonItem alloc] initWithTitle:@"Done" style:UIBarButtonItemStyleDone target:self action:@selector(done)]; +} + +- (void)refresh { + self.fileList = decryptedFileList(); + [self.tableView reloadData]; +} + +- (void)done { + [self dismissViewControllerAnimated:YES completion:nil]; +} + +- (NSInteger)numberOfSelectionsInTableView:(UITableView *)tableView { + return 1; +} + +- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { + return self.fileList.count; +} + +- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { + static NSString *cellIdentifier = @"FileCell"; + UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:cellIdentifier]; + + if (!cell) { + cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:cellIdentifier]; + } + + NSString *path = [docPath() stringByAppendingPathComponent:self.fileList[indexPath.row]]; + NSDictionary *attributes = [[NSFileManager defaultManager] attributesOfItemAtPath:path error:nil]; + NSDate *date = attributes[NSFileModificationDate]; + NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init]; + [dateFormatter setDateFormat:@"MMM d, yyyy h:mm a"]; + + NSNumber *fileSize = attributes[NSFileSize]; + + + cell.textLabel.text = self.fileList[indexPath.row]; + cell.detailTextLabel.text = [dateFormatter stringFromDate:date]; + cell.detailTextLabel.textColor = [UIColor systemGray2Color]; + cell.imageView.image = [UIImage systemImageNamed:@"doc.fill"]; + + UILabel *label = [[UILabel alloc] init]; + label.text = [NSString stringWithFormat:@"%.2f MB", [fileSize doubleValue] / 1000000.0f]; + label.textColor = [UIColor systemGray2Color]; + label.font = [UIFont systemFontOfSize:12.0f]; + [label sizeToFit]; + label.textAlignment = NSTextAlignmentCenter; + cell.accessoryView = label; + + + return cell; +} + +- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath { + return 65.0f; +} + +- (bool)tableView:(UITableView *)tableView canEditRowAtIndexPath:(NSIndexPath *)indexPath { + return YES; +} + +- (UISwipeActionsConfiguration *)tableView:(UITableView *)tableView trailingSwipeActionsConfigurationForRowAtIndexPath:(NSIndexPath *)indexPath { + UIContextualAction *deleteAction = [UIContextualAction contextualActionWithStyle:UIContextualActionStyleDestructive title:@"Delete" handler:^(UIContextualAction *action, UIView *sourceView, void (^completionHandler)(BOOL)) { + NSString *file = self.fileList[indexPath.row]; + NSString *path = [docPath() stringByAppendingPathComponent:file]; + [[NSFileManager defaultManager] removeItemAtPath:path error:nil]; + [self refresh]; + }]; + + UISwipeActionsConfiguration *swipeActions = [UISwipeActionsConfiguration configurationWithActions:@[deleteAction]]; + return swipeActions; +} + +- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath { + NSString *file = self.fileList[indexPath.row]; + NSString *path = [docPath() stringByAppendingPathComponent:file]; + NSURL *url = [NSURL fileURLWithPath:path]; + + UIActivityViewController *activityViewController = [[UIActivityViewController alloc] initWithActivityItems:@[url] applicationActivities:nil]; + [self presentViewController:activityViewController animated:YES completion:nil]; + + [tableView deselectRowAtIndexPath:indexPath animated:YES]; +} + +@end \ No newline at end of file diff --git a/TDRootViewController.h b/TDRootViewController.h new file mode 100644 index 0000000..7b50b79 --- /dev/null +++ b/TDRootViewController.h @@ -0,0 +1,7 @@ +#import + +@interface TDRootViewController : UITableViewController + +@property (nonatomic, strong) NSArray *apps; + +@end diff --git a/TDRootViewController.m b/TDRootViewController.m new file mode 100644 index 0000000..1a5e1d0 --- /dev/null +++ b/TDRootViewController.m @@ -0,0 +1,109 @@ +#import "TDRootViewController.h" +#import "TDFileManagerViewController.h" +#import "TDUtils.h" + +@implementation TDRootViewController + +- (void)loadView { + [super loadView]; + + self.apps = appList(); + self.title = @"TrollDecrypt"; + self.navigationController.navigationBar.prefersLargeTitles = YES; + self.navigationItem.rightBarButtonItem = [[UIBarButtonItem alloc] initWithImage:[UIImage systemImageNamed:@"info.circle"] style:UIBarButtonItemStylePlain target:self action:@selector(about:)]; + self.navigationItem.leftBarButtonItem = [[UIBarButtonItem alloc] initWithImage:[UIImage systemImageNamed:@"folder"] style:UIBarButtonItemStylePlain target:self action:@selector(openDocs:)]; + + UIRefreshControl *refreshControl = [[UIRefreshControl alloc] init]; + [refreshControl addTarget:self action:@selector(refreshApps:) forControlEvents:UIControlEventValueChanged]; + self.refreshControl = refreshControl; +} + +- (void)openDocs:(id)sender { + TDFileManagerViewController *fmVC = [[TDFileManagerViewController alloc] init]; + UINavigationController *navController = [[UINavigationController alloc] initWithRootViewController:fmVC]; + [self presentViewController:navController animated:YES completion:nil]; +} + +- (void)about:(id)sender { + UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"TrollDecrypt" message:@"by fiore\nIcon by @super.user\nbfdecrypt by @bishopfox\ndumpdecrypted by @i0n1c\nUpdated for TrollStore by @wh1te4ever" preferredStyle:UIAlertControllerStyleAlert]; + [alert addAction:[UIAlertAction actionWithTitle:@"Dismiss" style:UIAlertActionStyleCancel handler:nil]]; + [self presentViewController:alert animated:YES completion:nil]; +} + +- (void)refreshApps:(UIRefreshControl *)refreshControl { + self.apps = appList(); + [self.tableView reloadData]; + [refreshControl endRefreshing]; +} + +- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { + return 1; +} + +- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { + return self.apps.count; +} + +- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { + static NSString *cellIdentifier = @"AppCell"; + UITableViewCell *cell; + if (([self.apps count] - 1) != indexPath.row) { + cell = [tableView dequeueReusableCellWithIdentifier:cellIdentifier]; + if (cell == nil) cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:cellIdentifier]; + + NSDictionary *app = self.apps[indexPath.row]; + + cell.textLabel.text = app[@"name"]; + cell.detailTextLabel.text = [NSString stringWithFormat:@"%@ • %@", app[@"version"], app[@"bundleID"]]; + cell.imageView.image = [UIImage _applicationIconImageForBundleIdentifier:app[@"bundleID"] format:iconFormat() scale:[UIScreen mainScreen].scale]; + } else { + cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:nil]; + + cell.textLabel.text = @"Advanced"; + cell.detailTextLabel.text = @"Decrypt app from a specified PID"; + cell.accessoryType = UITableViewCellAccessoryDisclosureIndicator; + } + + return cell; +} + +- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath { + return 80.0f; +} + +- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath { + UIAlertController *alert; + + if (([self.apps count] - 1) != indexPath.row) { + NSDictionary *app = self.apps[indexPath.row]; + + alert = [UIAlertController alertControllerWithTitle:@"Decrypt" message:[NSString stringWithFormat:@"Decrypt %@?", app[@"name"]] preferredStyle:UIAlertControllerStyleAlert]; + UIAlertAction *cancel = [UIAlertAction actionWithTitle:@"Cancel" style:UIAlertActionStyleCancel handler:nil]; + UIAlertAction *decrypt = [UIAlertAction actionWithTitle:@"Yes" style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) { + decryptApp(app); + }]; + + [alert addAction:decrypt]; + [alert addAction:cancel]; + } else { + alert = [UIAlertController alertControllerWithTitle:@"Decrypt" message:@"Enter PID to decrypt" preferredStyle:UIAlertControllerStyleAlert]; + [alert addTextFieldWithConfigurationHandler:^(UITextField *textField) { + textField.placeholder = @"PID"; + textField.keyboardType = UIKeyboardTypeNumberPad; + }]; + + UIAlertAction *cancel = [UIAlertAction actionWithTitle:@"Cancel" style:UIAlertActionStyleCancel handler:nil]; + UIAlertAction *decrypt = [UIAlertAction actionWithTitle:@"Decrypt" style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) { + NSString *pid = alert.textFields.firstObject.text; + decryptAppWithPID([pid intValue]); + }]; + + [alert addAction:decrypt]; + [alert addAction:cancel]; + } + + [self presentViewController:alert animated:YES completion:nil]; + [tableView deselectRowAtIndexPath:indexPath animated:YES]; +} + +@end \ No newline at end of file diff --git a/TDUtils.h b/TDUtils.h new file mode 100644 index 0000000..d7f61de --- /dev/null +++ b/TDUtils.h @@ -0,0 +1,58 @@ +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#import +#import +#import + +@interface UIApplication (tweakName) ++ (id)sharedApplication; +- (BOOL)launchApplicationWithIdentifier:(id)arg1 suspended:(BOOL)arg2; +@end + +@interface LSApplicationProxy : NSObject +@property (readonly, nonatomic) NSString *bundleIdentifier; // ivar: _bundleIdentifier +@property (readonly) NSString *shortVersionString; +@property (readonly, nonatomic) NSString *canonicalExecutablePath; +@property (getter=isLaunchProhibited) BOOL launchProhibited; +@property (readonly, nonatomic) NSArray *appTags; +@property(readonly) NSString * applicationType; +- (NSString *)localizedName; ++ (instancetype)applicationProxyForIdentifier:(NSString*)identifier; +@end + +@interface LSApplicationWorkspace : NSObject ++ (instancetype)defaultWorkspace; +- (NSMutableArray *)allApplications; +- (NSArray *)allInstalledApplications; +@end + +@interface UIImage (Private) ++ (UIImage *)_applicationIconImageForBundleIdentifier:(NSString *)bundleIdentifier format:(NSUInteger)format scale:(CGFloat)scale; +@end + +#define PROC_PIDPATHINFO 11 +#define PROC_PIDPATHINFO_SIZE (MAXPATHLEN) +#define PROC_PIDPATHINFO_MAXSIZE (4 * MAXPATHLEN) +#define PROC_ALL_PIDS 1 +#ifndef DEBUG +# define NSLog(...) (void)0 +#endif + +int proc_pidpath(int pid, void *buffer, uint32_t buffersize); +int proc_listpids(uint32_t type, uint32_t typeinfo, void *buffer, int buffersize); +NSArray *appList(void); +NSUInteger iconFormat(void); +NSArray *sysctl_ps(void); +void decryptApp(NSDictionary *app); +void decryptAppWithPID(pid_t pid); +void bfinject_rocknroll(pid_t pid, NSString *appName, NSString *version); +NSArray *decryptedFileList(void); +NSString *docPath(void); \ No newline at end of file diff --git a/TDUtils.m b/TDUtils.m new file mode 100644 index 0000000..c907ab7 --- /dev/null +++ b/TDUtils.m @@ -0,0 +1,372 @@ +#import "TDUtils.h" +#import "TDDumpDecrypted.h" + +UIWindow *alertWindow = NULL; +UIWindow *kw = NULL; +UIViewController *root = NULL; +UIAlertController *alertController = NULL; +UIAlertController *doneController = NULL; +UIAlertController *errorController = NULL; + +NSArray *appList(void) { + NSMutableArray *apps = [NSMutableArray array]; + + for (LSApplicationProxy *app in [[LSApplicationWorkspace defaultWorkspace] allInstalledApplications]) { + if (![[app applicationType] isEqualToString:@"User"]) continue; + + NSString *bundleID = app.bundleIdentifier; + NSString *name = [app localizedName]; + NSString *version = app.shortVersionString; + NSString *executable = [app canonicalExecutablePath]; + + NSDictionary *item = @{ + @"bundleID":bundleID, + @"name":name, + @"version":version, + @"executable":executable + }; + + [apps addObject:item]; + } + + NSSortDescriptor *descriptor = [[NSSortDescriptor alloc] initWithKey:@"name" ascending:YES selector:@selector(localizedCaseInsensitiveCompare:)]; + [apps sortUsingDescriptors:@[descriptor]]; + + [apps addObject:@{@"bundleID":@"", @"name":@"", @"version":@"", @"executable":@""}]; + + return [apps copy]; +} + +NSUInteger iconFormat(void) { + return (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad) ? 8 : 10; +} + +NSArray *sysctl_ps(void) { + // int mib[4] = {CTL_KERN, KERN_PROC, KERN_PROC_ALL, 0}; + // size_t miblen = 4; + // size_t size; + // int st = sysctl(mib, miblen, NULL, &size, NULL, 0); + // struct kinfo_proc * process = NULL; + // struct kinfo_proc * newprocess = NULL; + + // do { + // size += size / 10; + // newprocess = realloc(process, size); + // if (!newprocess){ + // if (process){ + // free(process); + // } + // return nil; + // } + // process = newprocess; + // st = sysctl(mib, miblen, process, &size, NULL, 0); + // } while (st == -1 && errno == ENOMEM); + + // if (st == 0) { + // if (size % sizeof(struct kinfo_proc) == 0){ + // int nprocess = size / sizeof(struct kinfo_proc); + // if (nprocess){ + // NSMutableArray * array = [[NSMutableArray alloc] init]; + // for (int i = nprocess - 1; i >= 0; i--){ + // NSString *processID = [[NSString alloc] initWithFormat:@"%d", process[i].kp_proc.p_pid]; + // NSString *processName = [[NSString alloc] initWithFormat:@"%s", process[i].kp_proc.p_comm]; + // NSDictionary *dict = [[NSDictionary alloc] initWithObjects:[NSArray arrayWithObjects:processID, processName, nil] forKeys:[NSArray arrayWithObjects:@"pid", @"proc_name", nil]]; + // [array addObject:dict]; + // } + // free(process); + // return array; + // } + // } + // } + NSMutableArray *array = [[NSMutableArray alloc] init]; + + int numberOfProcesses = proc_listpids(PROC_ALL_PIDS, 0, NULL, 0); + pid_t pids[numberOfProcesses]; + bzero(pids, sizeof(pids)); + proc_listpids(PROC_ALL_PIDS, 0, pids, sizeof(pids)); + for (int i = 0; i < numberOfProcesses; ++i) { + if (pids[i] == 0) { continue; } + char pathBuffer[PROC_PIDPATHINFO_MAXSIZE]; + bzero(pathBuffer, PROC_PIDPATHINFO_MAXSIZE); + proc_pidpath(pids[i], pathBuffer, sizeof(pathBuffer)); + + if (strlen(pathBuffer) > 0) { + NSString *processID = [[NSString alloc] initWithFormat:@"%d", pids[i]]; + NSString *processName = [[NSString stringWithUTF8String:pathBuffer] lastPathComponent]; + NSDictionary *dict = [[NSDictionary alloc] initWithObjects:[NSArray arrayWithObjects:processID, processName, nil] forKeys:[NSArray arrayWithObjects:@"pid", @"proc_name", nil]]; + + [array addObject:dict]; + } + } + + return [array copy]; +} + +void decryptApp(NSDictionary *app) { + dispatch_async(dispatch_get_main_queue(), ^{ + alertWindow = [[UIWindow alloc] initWithFrame: [UIScreen mainScreen].bounds]; + alertWindow.rootViewController = [UIViewController new]; + alertWindow.windowLevel = UIWindowLevelAlert + 1; + [alertWindow makeKeyAndVisible]; + + // Show a "Decrypting!" alert on the device and block the UI + + kw = alertWindow; + if([kw respondsToSelector:@selector(topmostPresentedViewController)]) + root = [kw performSelector:@selector(topmostPresentedViewController)]; + else + root = [kw rootViewController]; + root.modalPresentationStyle = UIModalPresentationFullScreen; + }); + + NSLog(@"[trolldecrypt] spawning thread to do decryption in background..."); + + dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{ + NSLog(@"[trolldecrypt] inside decryption thread."); + + NSString *bundleID = app[@"bundleID"]; + NSString *name = app[@"name"]; + NSString *version = app[@"version"]; + NSString *executable = app[@"executable"]; + NSString *binaryName = [executable lastPathComponent]; + + NSLog(@"[trolldecrypt] bundleID: %@", bundleID); + NSLog(@"[trolldecrypt] name: %@", name); + NSLog(@"[trolldecrypt] version: %@", version); + NSLog(@"[trolldecrypt] executable: %@", executable); + NSLog(@"[trolldecrypt] binaryName: %@", binaryName); + + [[UIApplication sharedApplication] launchApplicationWithIdentifier:bundleID suspended:YES]; + sleep(1); + + pid_t pid = -1; + NSArray *processes = sysctl_ps(); + for (NSDictionary *process in processes) { + NSString *proc_name = process[@"proc_name"]; + if ([proc_name isEqualToString:binaryName]) { + pid = [process[@"pid"] intValue]; + break; + } + } + + if (pid == -1) { + dispatch_async(dispatch_get_main_queue(), ^{ + [alertController dismissViewControllerAnimated:NO completion:nil]; + NSLog(@"[trolldecrypt] failed to get pid for binary name: %@", binaryName); + + errorController = [UIAlertController alertControllerWithTitle:@"Error: -1" message:[NSString stringWithFormat:@"Failed to get PID for binary name: %@", binaryName] preferredStyle:UIAlertControllerStyleAlert]; + UIAlertAction *okAction = [UIAlertAction actionWithTitle:NSLocalizedString(@"Ok", @"Ok") style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) { + NSLog(@"[trolldecrypt] Ok action"); + [errorController dismissViewControllerAnimated:NO completion:nil]; + [kw removeFromSuperview]; + kw.hidden = YES; + }]; + + [errorController addAction:okAction]; + [root presentViewController:errorController animated:YES completion:nil]; + }); + + return; + } + + NSLog(@"[trolldecrypt] pid: %d", pid); + + bfinject_rocknroll(pid, name, version); + }); +} + +void bfinject_rocknroll(pid_t pid, NSString *appName, NSString *version) { + NSLog(@"[trolldecrypt] Spawning thread to do decryption in the background..."); + + dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{ + NSLog(@"[trolldecrypt] Inside decryption thread"); + + char pathbuf[PROC_PIDPATHINFO_MAXSIZE]; + // int proc_pidpath(pid, pathbuf, sizeof(pathbuf)); + proc_pidpath(pid, pathbuf, sizeof(pathbuf)); + const char *fullPathStr = pathbuf; + + + NSLog(@"[trolldecrypt] fullPathStr: %s", fullPathStr); + DumpDecrypted *dd = [[DumpDecrypted alloc] initWithPathToBinary:[NSString stringWithUTF8String:fullPathStr] appName:appName appVersion:version]; + if(!dd) { + NSLog(@"[trolldecrypt] ERROR: failed to get DumpDecrypted instance"); + return; + } + + NSLog(@"[trolldecrypt] Full path to app: %s /// IPA File: %@", fullPathStr, [dd IPAPath]); + + dispatch_async(dispatch_get_main_queue(), ^{ + alertWindow = [[UIWindow alloc] initWithFrame: [UIScreen mainScreen].bounds]; + alertWindow.rootViewController = [UIViewController new]; + alertWindow.windowLevel = UIWindowLevelAlert + 1; + [alertWindow makeKeyAndVisible]; + + // Show a "Decrypting!" alert on the device and block the UI + alertController = [UIAlertController + alertControllerWithTitle:@"Decrypting" + message:@"Please wait, this will take a few seconds..." + preferredStyle:UIAlertControllerStyleAlert]; + + kw = alertWindow; + if([kw respondsToSelector:@selector(topmostPresentedViewController)]) + root = [kw performSelector:@selector(topmostPresentedViewController)]; + else + root = [kw rootViewController]; + root.modalPresentationStyle = UIModalPresentationFullScreen; + [root presentViewController:alertController animated:YES completion:nil]; + }); + + // Do the decryption + [dd createIPAFile:pid]; + + // Dismiss the alert box + dispatch_async(dispatch_get_main_queue(), ^{ + [alertController dismissViewControllerAnimated:NO completion:nil]; + + doneController = [UIAlertController alertControllerWithTitle:@"Decryption Complete!" message:[NSString stringWithFormat:@"IPA file saved to:\n%@", [dd IPAPath]] preferredStyle:UIAlertControllerStyleAlert]; + UIAlertAction *okAction = [UIAlertAction actionWithTitle:NSLocalizedString(@"Ok", @"Ok") style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) { + NSLog(@"[trolldecrypt] Ok action"); + [doneController dismissViewControllerAnimated:NO completion:nil]; + [kw removeFromSuperview]; + kw.hidden = YES; + }]; + + [doneController addAction:okAction]; + [root presentViewController:doneController animated:YES completion:nil]; + }); // dispatch on main + + NSLog(@"[trolldecrypt] Over and out."); + while(1) + sleep(9999999); + }); // dispatch in background + + NSLog(@"[trolldecrypt] All done, exiting constructor."); +} + +NSArray *decryptedFileList(void) { + NSMutableArray *files = [NSMutableArray array]; + + // iterate through all files in the Documents directory + NSFileManager *fileManager = [NSFileManager defaultManager]; + NSDirectoryEnumerator *directoryEnumerator = [fileManager enumeratorAtPath:docPath()]; + + NSString *file; + while (file = [directoryEnumerator nextObject]) { + if ([[file pathExtension] isEqualToString:@"ipa"]) { + NSString *filePath = [[docPath() stringByAppendingPathComponent:file] stringByStandardizingPath]; + + NSDictionary *fileAttributes = [fileManager attributesOfItemAtPath:filePath error:nil]; + NSDate *modificationDate = [fileAttributes fileModificationDate]; + + NSDictionary *fileInfo = @{@"fileName": file, @"modificationDate": modificationDate}; + [files addObject:fileInfo]; + } + } + + // Sort the array based on modification date + NSArray *sortedFiles = [files sortedArrayUsingComparator:^NSComparisonResult(id obj1, id obj2) { + NSDate *date1 = [obj1 objectForKey:@"modificationDate"]; + NSDate *date2 = [obj2 objectForKey:@"modificationDate"]; + return [date2 compare:date1]; + }]; + + return [sortedFiles valueForKey:@"fileName"]; +} + +NSString *docPath(void) { + return [NSHomeDirectory() stringByAppendingPathComponent:@"Documents"]; +} + +void decryptAppWithPID(pid_t pid) { + // generate App NSDictionary object to pass into decryptApp() + // proc_pidpath(self.pid, buffer, sizeof(buffer)); + NSString *message = nil; + NSString *error = nil; + + dispatch_async(dispatch_get_main_queue(), ^{ + alertWindow = [[UIWindow alloc] initWithFrame: [UIScreen mainScreen].bounds]; + alertWindow.rootViewController = [UIViewController new]; + alertWindow.windowLevel = UIWindowLevelAlert + 1; + [alertWindow makeKeyAndVisible]; + + // Show a "Decrypting!" alert on the device and block the UI + + kw = alertWindow; + if([kw respondsToSelector:@selector(topmostPresentedViewController)]) + root = [kw performSelector:@selector(topmostPresentedViewController)]; + else + root = [kw rootViewController]; + root.modalPresentationStyle = UIModalPresentationFullScreen; + }); + + NSLog(@"[trolldecrypt] pid: %d", pid); + + char pathbuf[PROC_PIDPATHINFO_MAXSIZE]; + proc_pidpath(pid, pathbuf, sizeof(pathbuf)); + + NSString *executable = [NSString stringWithUTF8String:pathbuf]; + NSString *path = [executable stringByDeletingLastPathComponent]; + NSDictionary *infoPlist = [NSDictionary dictionaryWithContentsOfFile:[path stringByAppendingPathComponent:@"Info.plist"]]; + NSString *bundleID = infoPlist[@"CFBundleIdentifier"]; + + if (!bundleID) { + error = @"Error: -2"; + message = [NSString stringWithFormat:@"Failed to get bundle id for pid: %d", pid]; + } + + LSApplicationProxy *app = [LSApplicationProxy applicationProxyForIdentifier:bundleID]; + if (!app) { + error = @"Error: -3"; + message = [NSString stringWithFormat:@"Failed to get LSApplicationProxy for bundle id: %@", bundleID]; + } + + if (message) { + dispatch_async(dispatch_get_main_queue(), ^{ + [alertController dismissViewControllerAnimated:NO completion:nil]; + NSLog(@"[trolldecrypt] failed to get bundleid for pid: %d", pid); + + errorController = [UIAlertController alertControllerWithTitle:error message:message preferredStyle:UIAlertControllerStyleAlert]; + UIAlertAction *okAction = [UIAlertAction actionWithTitle:NSLocalizedString(@"Ok", @"Ok") style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) { + NSLog(@"[trolldecrypt] Ok action"); + [errorController dismissViewControllerAnimated:NO completion:nil]; + [kw removeFromSuperview]; + kw.hidden = YES; + }]; + + [errorController addAction:okAction]; + [root presentViewController:errorController animated:YES completion:nil]; + }); + } + + NSLog(@"[trolldecrypt] app: %@", app); + + NSString *name = [app localizedName]; + NSString *version = app.shortVersionString; + if (!version) version = @"1.0"; + + NSString *exec = [app canonicalExecutablePath]; + + NSDictionary *appInfo = @{ + @"bundleID":bundleID, + @"name":name, + @"version":version, + @"executable":exec + }; + + NSLog(@"[trolldecrypt] appInfo: %@", appInfo); + + dispatch_async(dispatch_get_main_queue(), ^{ + [alertController dismissViewControllerAnimated:NO completion:nil]; + UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"Decrypt" message:[NSString stringWithFormat:@"Decrypt %@?", appInfo[@"name"]] preferredStyle:UIAlertControllerStyleAlert]; + UIAlertAction *cancel = [UIAlertAction actionWithTitle:@"Cancel" style:UIAlertActionStyleCancel handler:nil]; + UIAlertAction *decrypt = [UIAlertAction actionWithTitle:@"Yes" style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) { + decryptApp(appInfo); + }]; + + [alert addAction:decrypt]; + [alert addAction:cancel]; + + [root presentViewController:alert animated:YES completion:nil]; + }); +} \ No newline at end of file diff --git a/control b/control new file mode 100644 index 0000000..bee2982 --- /dev/null +++ b/control @@ -0,0 +1,8 @@ +Package: com.fiore.trolldecrypt +Name: TrollDecrypt +Version: 0.0.1 +Architecture: iphoneos-arm +Description: An awesome application! +Maintainer: fiore +Author: fiore +Section: Utilities diff --git a/entitlements.plist b/entitlements.plist new file mode 100644 index 0000000..357e5fb --- /dev/null +++ b/entitlements.plist @@ -0,0 +1,38 @@ + + + + + platform-application + + application-identifier + com.fiore.trolldecrypt + com.apple.security.exception.files.absolute-path.read-write + + / + + com.apple.private.security.no-sandbox + + com.apple.private.persona-mgmt + + com.apple.private.MobileContainerManager.allowed + + com.apple.private.security.container-manager + + com.apple.private.security.storage.AppBundles + + com.apple.private.security.storage.AppDataContainers + + task_for_pid-allow + + get-task-allow + + com.apple.security.get-task-allow + + proc_info-allow + + com.apple.system-task-ports + + com.apple.springboard.launchapplications + + + \ No newline at end of file diff --git a/main.m b/main.m new file mode 100644 index 0000000..ad03dbd --- /dev/null +++ b/main.m @@ -0,0 +1,8 @@ +#import +#import "TDAppDelegate.h" + +int main(int argc, char *argv[]) { + @autoreleasepool { + return UIApplicationMain(argc, argv, nil, NSStringFromClass(TDAppDelegate.class)); + } +}