SecureBlackbox Lite 2020 iOS Edition

Questions / Feedback?

ArchiveWriter Class

Properties   Methods   Events   Configuration Settings   Errors  

The ArchiveWriter class allows compressing, updating and modifying files for zip, tar, gzip and bzip2 archives.

Syntax

SecureBlackboxLiteArchiveWriter
SecureBlackboxLiteArchiveWriterSwift

Remarks

Use ArchiveWriter to compress, update, and modify files in archives.

Property List


The following is the full list of the properties of the class with short descriptions. Click on the links for further details.

- archiveTypeThe type of the archive.
- compressionLevelThe compression level to apply to the archived data.
- decryptionCertCountThe number of records in the DecryptionCert arrays.
- decryptionCertBytes:(int)decryptionCertIndexReturns raw certificate data in DER format.
- decryptionCertHandle:(int)decryptionCertIndexAllows to get or set a 'handle', a unique identifier of the underlying property object.
- decryptionPasswordThe decryption password.
- encryptionAlgorithmSpecifies the encryption algorithm to apply to the archive.
- encryptionCertBytesReturns raw certificate data in DER format.
- encryptionCertHandleAllows to get or set a 'handle', a unique identifier of the underlying property object.
- encryptionPasswordSpecifies the archive encryption password.
- encryptionTypeThe type of encryption to apply to the archive.
- fileDataThe contents of the file being added to the archive.
- fileCountThe number of records in the File arrays.
- fileAction:(int)fileIndexThe action to apply to the file.
- fileCompressedSize:(int)fileIndexThe size of the file after compression.
- fileDataSource:(int)fileIndexThe type of the data source for this entry.
- fileDirectory:(int)fileIndexTells if the entry is a directory or a regular file.
- fileEncryptionAlgorithm:(int)fileIndexReturns the symmetric algorithm that was used to encrypt the file.
- fileEncryptionKeyLength:(int)fileIndexReturns the length, in bits, of the encryption key.
- fileEncryptionType:(int)fileIndexThe type of encryption applied to the file.
- fileFileName:(int)fileIndexThe original name of the compressed file or folder.
- fileFolder:(int)fileIndexThe containing folder of the entry.
- fileLocalPath:(int)fileIndexThe local path associated with this entry.
- fileMTime:(int)fileIndexThe entry's last modification time.
- fileNewFile:(int)fileIndexIndicates whether the entry corresponds to a file to be added to the archive.
- filePath:(int)fileIndexThe full internal path of the archived entry.
- fileSignatureCount:(int)fileIndexThe number of signatures covering the entry.
- fileSigned:(int)fileIndexIndicates whether the entry is signed.
- fileSize:(int)fileIndexThe size of the file before compression.
- newArchiveIndicates whether the archive object represents a new (rather than opened) archive.
- openedIndicates whether class is currently in edit mode.
- signingCertBytesReturns raw certificate data in DER format.
- signingCertHandleAllows to get or set a 'handle', a unique identifier of the underlying property object.
- signingChainCountThe number of records in the SigningChain arrays.
- signingChainBytes:(int)signingChainIndexReturns raw certificate data in DER format.
- signingChainHandle:(int)signingChainIndexAllows to get or set a 'handle', a unique identifier of the underlying property object.

Method List


The following is the full list of the methods of the class with short descriptions. Click on the links for further details.

- addEmptyDirAdds an empty folder to the archive.
- addFileAdds a file to the archive.
- addFilesAdds a group of files to the archive.
- addVirtualAdds a file placeholder to the archive.
- closeCloses the archive.
- configSets or retrieves a configuration setting.
- createNewCreates a new archive.
- openOpens an archive file.
- openBytesLoads an archive file from a byte array.
- removeRemoves file(s) and/or folder(s) from the archive.
- saveCompresses the archive and saves it to a file.
- saveBytesCompresses the archive and saves it to a byte array.
- updateFileUpdates an existing compressed entry with a fresher local version.
- updateFilesUpdates a selection of files in the archive.
- updateVirtualUpdates an entry in the archive with on-the-fly content.

Event List


The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.

- onAfterCompressFileMarks the completion of compression of a file.
- onBeforeCompressFileMarks the start of compression of a file.
- onDecryptionPasswordNeededFires when the class needs a password to decrypt the archive.
- onErrorReports information about errors during archive assembling.
- onNotificationThis event notifies the application about an underlying control flow event.
- onPrepareFileFires for every file to be compressed before the compression starts.
- onProgressReports the progress of data compression.
- onRecipientFoundSignifies that the archive was found to be encrypted with a digital certificate.

Configuration Settings


The following is a list of configuration settings for the class with short descriptions. Click on the links for further details.

EncryptionKeyLengthThe length of the encryption key.
TempPathPath for storing temporary files.
UsePaxEnables use of PAX algorithm when creating TAR directories.
UseUStarEnables use of UStar variant of file name packaging when creating TAR directories.

Copyright (c) 2022 /n software inc. - All rights reserved.
SecureBlackbox Lite 2020 iOS Edition - Version 20.0 [Build 8166]