Secure File System. More...

#import <BlackBerryDynamics/GD/GDFileManager.h>

Description

This class is a subclass of the native NSFileManager class, for access to the BlackBerry Dynamics secure file system.

Secure File System

The secure file system is part of the BlackBerry Dynamics Secure Storage feature.

For applications, the BlackBerry Dynamics secure file system behaves like the default file system, with the following differences.

All data within the secure file system is stored on the device in an encrypted form.
Directory and file names are also encrypted.
The secure file system cannot be accessed until BlackBerry Dynamics authorization processing is complete, see under authorize (GDiOS) .

Every operating system has a maximum supported length for the names of files and directories. For example, iOS 11 supports a maximum length of 255 bytes, given by the NAME_MAX constant. The encrypted form of the name of a directory or file will typically be longer than the plaintext, and it is the encrypted form that must be within the limits supported by the operating system. This means that names in the secure file system have a shorter effective maximum supported length. It isn't possible to give a simple maximum but the following should be expected.

Names that are 16 bytes or longer will be increased by a factor of 4:3 approximately.
Shorter names will be increased to a length of 20 bytes approximately.

Encryption and decryption is transparent to the application code:

The application passes its data to a file writing interface. The BlackBerry Dynamics runtime encrypts the data and stores it on the device.
When a file-reading interface is utilized, the runtime decrypts and returns the data.
Path access interfaces accept plaintext parameters for directory and file names. The runtime encrypts the parameter values in order to create paths in the secure store.
Directory and file names provided as return values are plaintext. The runtime decrypts paths in the secure store in order to generate the return values.

The encryption method used by the BlackBerry Dynamics runtime generally requires that the user has entered a security password, from which an encryption key is derived.

Usage

This class is a subclass of the native NSFileManager class. It should be easy to replace references to NSFileManager with references to GDFileManager, in order to convert application code that utilizes the native file system into code that utilizes the secure file system.

The differences between this class and NSFileManager are:

Write access is limited to the secure store.
There is no access to "Ubiquitous" files and directories, i.e. no access to items in "cloud" storage.
There is no access to native application group containers, which aren't secured by BlackBerry Dynamics. The containerURLForSecurityApplicationGroupIdentifier: function returns the same value as the base class would for an invalid group identifier.
The secure file system doesn't have a designated temporary directory. The temporaryDirectory property mustn't be used to create paths.
File Provider extensions aren't supported. The getFileProviderServicesForItemAtURL:completionHandler: interface always fails.
Returned NSURL values for locations within the secure file system can only be utilized by BlackBerry Dynamics programming interfaces, see below.
Returned NSString values for paths within the secure file system can only be utilized by BlackBerry Dynamics programming interfaces, see below.
Error codes could be in the specific GDFileManager error domain, or could be general NS error codes.

The NSURL values returned by functions in this class can only be used to access files and directories by BlackBerry Dynamics programming interfaces. They cannot be used by native interfaces, such as NSInputStream nor stringWithContentsOfURL: for example.

The NSString values for paths returned by functions in this class can only be used to access files and directories by BlackBerry Dynamics programming interfaces. They cannot be used by native interfaces, such as stringByResolvingSymlinksInPath, nor dataWithContentsOfFile: for example.

To read and write files in the secure store, use functions in this class or in one of the other BlackBerry Dynamics programming interfaces. For example:

createFileAtPath: or getWriteStream: to write.
contentsAtPath: or getReadStream: to read.
The GDFileHandle class.
The BlackBerry Dynamics C Language programming interface.

Don't use file-reading and -writing functions in the native NS classes to access files in the secure store.

Best practice for building paths for use with this class is as follows. First use an NSSearchPathDirectory value to generate a path prefix, for example by calling the NSSearchPathForDirectoriesInDomains: function. Then append to the prefix, for example by calling the NSString stringByAppendingPath: function or the NSURL URLByAppendingPathComponent function.

The functions in this API utilize NSError in a conventional way. Function calls accept as a parameter the location of a pointer to NSError, i.e. a pointer to a pointer, with type NSError**. The location may be nil. If the location isn't nil, and an error occurs, the BlackBerry Dynamics runtime overwrites the pointer at the specified location with the address of an object that describes the error that occurred.

The documentation of this class includes descriptions for functions and other elements of the programming interface that:

Have different semantics to the corresponding elements in the base class.
Are not present in the base class.

Elements of the base class that are overriden, but have the same semantics, are listed in the documentation of this class, but not described further. Elements of the base class that aren't overriden are not listed. See the documentation of the base class, NSFileManager, for full descriptions.

See also: NSFileManager class reference on the apple.com developer website.; Error Handling Programming Guide on the apple.com developer website.; NSSearchPathForDirectoriesInDomains reference documentation on the apple.com developer website.; GDFileManager Error Domain; Secure SQL Database API; GDPersistentStoreCoordinator; GDFileHandle; C Language Programming Interface List

Code Snippets

The following code snippets illustrate some common tasks.

Simple conversion to secure file system

The following code snippets illustrate simple conversion of a function that uses the native file system to use the secure files system instead.

The second function in the snippet is the original; the third is the converted version. The changed line is flagged with a comment. The first function in the snippet is a utility that is used by both the original and the converted function, with no changes.

- (NSString *)documentsFolderPathForFileNamed:(NSString *)fileName
{
    NSArray *paths =
    NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
                                        NSUserDomainMask,
                                        YES);
    NSString *documentsDirectory = [paths objectAtIndex:0];
    return [documentsDirectory stringByAppendingPathComponent:fileName];
}
 
- (BOOL)writeMyFile
{
    NSString *text = @"Text that is not protected.";
    NSData *fileData = [text dataUsingEncoding:NSUTF8StringEncoding];
    
    BOOL fileCreated =
    [[NSFileManager defaultManager]
     createFileAtPath:[self
                       documentsFolderPathForFileNamed:@"MyFile.txt"]
     contents:fileData
     attributes:nil];
    return fileCreated;
}
 
- (BOOL)writeMyFileGD
{
    NSString *text = @"Text to be protected by BlackBerry Dynamics.";
    NSData *fileData = [text dataUsingEncoding:NSUTF8StringEncoding];
 
    // Following assignment uses GDFileManager instead of NSFileManager.
    BOOL fileCreated =
    [[GDFileManager defaultManager]
     createFileAtPath:[self
                       documentsFolderPathForFileNamed:@"MyFile.txt"]
     contents:fileData
     attributes:nil];
    return fileCreated;
}

Instance Methods
(nullable NSURL *)	- URLForDirectory:inDomain:appropriateForURL:create:error:

(NSArray< NSURL * > *)	- URLsForDirectory:inDomains:

(nullable NSURL *)	- containerURLForSecurityApplicationGroupIdentifier:
	Not available. More...

(nullable NSArray< NSURL * > *)	- contentsOfDirectoryAtURL:includingPropertiesForKeys:options:error:

(nullable NSArray< NSString * > *)	- contentsOfDirectoryAtPath:error:

(nullable NSDirectoryEnumerator< NSURL * > *)	- enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:

(nullable NSDirectoryEnumerator< NSString * > *)	- enumeratorAtPath:

(nullable NSArray< NSString * > *)	- subpathsOfDirectoryAtPath:error:

(nullable NSArray< NSString * > *)	- subpathsAtPath:

(BOOL)	- createDirectoryAtURL:withIntermediateDirectories:attributes:error:

(BOOL)	- createDirectoryAtPath:withIntermediateDirectories:attributes:error:

(BOOL)	- createFileAtPath:contents:attributes:

(BOOL)	- removeItemAtURL:error:

(BOOL)	- removeItemAtPath:error:

(BOOL)	- replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error:

(BOOL)	- copyItemAtURL:toURL:error:

(BOOL)	- copyItemAtPath:toPath:error:

(BOOL)	- moveItemAtURL:toURL:error:

(BOOL)	- moveItemAtPath:toPath:error:

(nullable NSURL *)	- URLForUbiquityContainerIdentifier:
	Not available. More...

(BOOL)	- isUbiquitousItemAtURL:
	Not available. More...

(BOOL)	- setUbiquitous:itemAtURL:destinationURL:error:
	Not available. More...

(BOOL)	- startDownloadingUbiquitousItemAtURL:error:
	Not available. More...

(BOOL)	- evictUbiquitousItemAtURL:error:
	Not available. More...

(nullable NSURL *)	- URLForPublishingUbiquitousItemAtURL:expirationDate:error:
	Not available. More...

(void)	- getFileProviderServicesForItemAtURL:completionHandler:
	Not available. More...

(BOOL)	- createSymbolicLinkAtURL:withDestinationURL:error:

(BOOL)	- createSymbolicLinkAtPath:withDestinationPath:error:

(BOOL)	- linkItemAtURL:toURL:error:

(BOOL)	- linkItemAtPath:toPath:error:

(nullable NSString *)	- destinationOfSymbolicLinkAtPath:error:

(BOOL)	- fileExistsAtPath:

(BOOL)	- fileExistsAtPath:isDirectory:

(BOOL)	- isReadableFileAtPath:

(BOOL)	- isWritableFileAtPath:

(BOOL)	- isExecutableFileAtPath:

(BOOL)	- isDeletableFileAtPath:

(nullable NSDictionary< GD_NSFileAttributeKey, id > *)	- attributesOfItemAtPath:error:

(nullable NSDictionary< GD_NSFileAttributeKey, id > *)	- attributesOfFileSystemForPath:error:

(BOOL)	- setAttributes:ofItemAtPath:error:

(nullable NSData *)	- contentsAtPath:

(BOOL)	- contentsEqualAtPath:andPath:

(const char *)	- fileSystemRepresentationWithPath:

(NSString *)	- stringWithFileSystemRepresentation:length:

(BOOL)	- changeCurrentDirectoryPath:

(NSString *)	- currentDirectoryPath

(BOOL)	- changeFileAttributes:atPath:
	Deprecated in base class. More...

(nullable NSDictionary *)	- fileAttributesAtPath:traverseLink:
	Deprecated in base class. More...

(nullable NSDictionary *)	- fileSystemAttributesAtPath:
	Deprecated in base class. More...

(nullable NSArray *)	- directoryContentsAtPath:
	Deprecated in base class. More...

(BOOL)	- createDirectoryAtPath:attributes:
	Deprecated in base class. More...

(BOOL)	- createSymbolicLinkAtPath:pathContent:
	Deprecated in base class. More...

(nullable NSString *)	- pathContentOfSymbolicLinkAtPath:
	Deprecated in base class. More...

Class Methods
(GDFileManager *)	+ defaultManager

(nullable GDCReadStream *)	+ getReadStream:error:
	Open a file that is in the secure store, for reading. More...

(nullable GDCWriteStream *)	+ getWriteStream:appendmode:error:
	Open a file in the secure store, for writing. More...

(nullable NSString *)	+ getAbsoluteEncryptedPath:
	Get the absolute encrypted path of a file within the secure store. More...

(nullable NSString *)	+ pathForCFromManagerPath:
	Convert a path for use with the BlackBerry Dynamics POSIX-level C language programming interface. More...

(nullable NSString *)	+ pathForManagerFromCPath:
	Convert a path from the BlackBerry Dynamics POSIX-level C language programming interface. More...

(BOOL)	+ exportLogFileToDocumentsFolder:
	Dump BlackBerry Dynamics logs out to an accessible folder (deprecated). More...

Properties
id< NSObject, NSCopying, NSSecureCoding >	ubiquityIdentityToken
	Not available. More...

NSURL *	temporaryDirectory
	Not available. More...

Method Documentation

◆ defaultManager

+ (GDFileManager *) defaultManager

◆ getReadStream:error:

+ (nullable GDCReadStream*) getReadStream:	(NSString *)	filePath
error:	(NSError **)	error

Call this function to open a file in the secure store for reading. Files in the secure store are encrypted on the device; this function provides access to decrypted data.

Parameters

filePath	`NSString` of the path, within the secure store, that represents the file to be opened.
error	For returning an `NSError` object if an error occurs. If `nil`, no object will be returned.

Returns: GDCReadStream object from which the file's data can be read, or a null pointer if the file could not be opened.

◆ getWriteStream:appendmode:error:

+ (nullable GDCWriteStream*) getWriteStream:	(NSString *)	filePath
appendmode:	(BOOL)	flag
error:	(NSError **)	error

Call this function to create a new file in the secure store, or to open an existing file for writing. Files in the secure store are encrypted on the device; data written to the stream returned by this function will be encrypted, transparently to the application.

If a file already exists at the specified path, the file can either be appended to, or overwritten.

Parameters

filePath	`NSString` of the path, within the secure store, that represents the file to be opened.
flag	Selects the action to take if a file already exists at the path. `YES` to append to the file, or `NO` to overwrite.
error	For returning an `NSError` object if an error occurs. If `nil`, no object will be returned.

Returns: GDCWriteStream object to which data can be written, or a null pointer if the file could not be opened.

◆ getAbsoluteEncryptedPath:

+ (nullable NSString*) getAbsoluteEncryptedPath: (NSString *) filePath

This function returns the encrypted path for a file or directory within the secure store. The principal usage for this function is to provide a path that is compatible with the SQL ATTACH command.

Parameters

filePath NSString of the path, within the secure store, that represents the item for which the encrypted path is required.

Returns: NSString containing the encrypted path.

◆ pathForCFromManagerPath:

+ (nullable NSString*) pathForCFromManagerPath: (NSString *) filePath

Call this function to convert a path so that it can be used with the BlackBerry Dynamics POSIX-level C language programming interface.

Paths used with this class, GDFileManager, have a different root to the file access functions in the POSIX-level C programming interface. This is because this class is an NSFileManager subclass. This function maps a path with the GDFileManager root to a path with the POSIX-level root.

The pathForManagerFromCPath: and pathForCFromManagerPath:, functions facilitate inter-operation of the programming interfaces. For example, a file could be created with POSIX-level C functions, then read back with functions in this class.

Parameters

filePath NSString containing a path for use with this class.

Returns: NSString containing the converted path.

See also: C Language Programming Interface.

◆ pathForManagerFromCPath:

+ (nullable NSString*) pathForManagerFromCPath: (NSString *) filePath

Call this function to convert a path from the BlackBerry Dynamics POSIX-level C programming interface.

Paths used with this class, GDFileManager, have a different root to the file access functions in the POSIX-level C programming interface. This is because this class is an NSFileManager subclass. This function maps a path with the POSIX-level root to a path with the GDFileManager root.

The pathForManagerFromCPath: and pathForCFromManagerPath:, functions facilitate inter-operation of the programming interfaces. For example, a file could be created with POSIX-level C functions, then read back with functions in this class.

Parameters

filePath NSString containing a path for use with the POSIX-level C programming interface.

Returns: NSString containing the converted path.

See also: C Language Programming Interface.

◆ exportLogFileToDocumentsFolder:

+ (BOOL) exportLogFileToDocumentsFolder: (NSError **) error

Deprecated:: This function is deprecated and will be removed in a future release. Use the programming interface in the GDLogManager class to upload log files instead.

Call this function to create a dump of BlackBerry Dynamics activity logs. The logs will be dumped to a file that is outside the secure store, in the Documents folder. The file will not be encrypted.

Parameters

error For returning an NSError object if an error occurs. If nil, no object will be returned.

The log file can be copied from the device in the normal way, and sent to BlackBerry to assist in support analysis.

◆ URLForDirectory:inDomain:appropriateForURL:create:error:

- (nullable NSURL *) URLForDirectory:	(NSSearchPathDirectory)	directory
inDomain:	(NSSearchPathDomainMask)	domain
appropriateForURL:	(nullable NSURL *)	url
create:	(BOOL)	shouldCreate
error:	(NSError **)	error

◆ URLsForDirectory:inDomains:

- (NSArray<NSURL > ) URLsForDirectory:	(NSSearchPathDirectory)	directory
inDomains:	(NSSearchPathDomainMask)	domainMask

◆ containerURLForSecurityApplicationGroupIdentifier:

- (nullable NSURL *) containerURLForSecurityApplicationGroupIdentifier: (NSString *) groupIdentifier

This element of the base class interface isn't available in this subclass. See under Usage, above.

Returns: nil always.

◆ contentsOfDirectoryAtURL:includingPropertiesForKeys:options:error:

- (nullable NSArray<NSURL>) contentsOfDirectoryAtURL:	(NSURL *)	url
includingPropertiesForKeys:	(nullable NSArray< GD_NSURLResourceKey > *)	keys
options:	(NSDirectoryEnumerationOptions)	mask
error:	(NSError **)	error

◆ contentsOfDirectoryAtPath:error:

- (nullable NSArray<NSString>) contentsOfDirectoryAtPath:	(NSString *)	path
error:	(NSError **)	error

◆ enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:

- (nullable NSDirectoryEnumerator<NSURL > ) enumeratorAtURL:	(NSURL *)	url
includingPropertiesForKeys:	(nullable NSArray< GD_NSURLResourceKey > *)	keys
options:	(NSDirectoryEnumerationOptions)	mask
errorHandler:	(nullable BOOL(^)(NSURL url, NSError error))	handler

◆ enumeratorAtPath:

- (nullable NSDirectoryEnumerator<NSString *> *) enumeratorAtPath: (NSString *) path

◆ subpathsOfDirectoryAtPath:error:

- (nullable NSArray<NSString> ) subpathsOfDirectoryAtPath:	(NSString *)	pathRaw
error:	(NSError **)	error

◆ subpathsAtPath:

- (nullable NSArray<NSString*> *) subpathsAtPath: (NSString *) path

◆ createDirectoryAtURL:withIntermediateDirectories:attributes:error:

- (BOOL) createDirectoryAtURL:	(NSURL *)	url
withIntermediateDirectories:	(BOOL)	createIntermediates
attributes:	(nullable NSDictionary< NSString , id > )	attributes
error:	(NSError **)	error

◆ createDirectoryAtPath:withIntermediateDirectories:attributes:error:

- (BOOL) createDirectoryAtPath:	(NSString *)	path
withIntermediateDirectories:	(BOOL)	createIntermediates
attributes:	(nullable NSDictionary< NSString , id > )	attributes
error:	(NSError **)	error

◆ createFileAtPath:contents:attributes:

- (BOOL) createFileAtPath:	(NSString *)	path
contents:	(nullable NSData *)	contents
attributes:	(nullable NSDictionary< NSString , id > )	attributes

◆ removeItemAtURL:error:

- (BOOL) removeItemAtURL:	(NSURL *)	URL
error:	(NSError **)	error

◆ removeItemAtPath:error:

- (BOOL) removeItemAtPath:	(NSString *)	filePath
error:	(NSError **)	error

◆ replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error:

- (BOOL) replaceItemAtURL:	(NSURL *)	originalItemURL
withItemAtURL:	(NSURL *)	newItemURL
backupItemName:	(nullable NSString *)	backupItemName
options:	(NSFileManagerItemReplacementOptions)	options
resultingItemURL:	(NSURL _Nullable _Nullable)	resultingURL
error:	(NSError **)	error

◆ copyItemAtURL:toURL:error:

- (BOOL) copyItemAtURL:	(NSURL *)	srcURL
toURL:	(NSURL *)	dstURL
error:	(NSError **)	error

◆ copyItemAtPath:toPath:error:

- (BOOL) copyItemAtPath:	(NSString *)	srcPath
toPath:	(NSString *)	dstPath
error:	(NSError **)	error

◆ moveItemAtURL:toURL:error:

- (BOOL) moveItemAtURL:	(NSURL *)	srcURL
toURL:	(NSURL *)	dstURL
error:	(NSError **)	error

◆ moveItemAtPath:toPath:error:

- (BOOL) moveItemAtPath:	(NSString *)	srcPath
toPath:	(NSString *)	dstPath
error:	(NSError **)	error

◆ URLForUbiquityContainerIdentifier:

- (nullable NSURL *) URLForUbiquityContainerIdentifier: (nullable NSString *) containerIdentifier

This element of the base class interface isn't available in this subclass. See under Usage, above.

Returns: nil always.

◆ isUbiquitousItemAtURL:

- (BOOL) isUbiquitousItemAtURL: (NSURL *) url

This element of the base class interface isn't available in this subclass. See under Usage, above.

Returns: NO always.

◆ setUbiquitous:itemAtURL:destinationURL:error:

- (BOOL) setUbiquitous:	(BOOL)	flag
itemAtURL:	(NSURL *)	url
destinationURL:	(NSURL *)	destinationURL
error:	(NSError **)	error

This element of the base class interface isn't available in this subclass. See under Usage, above.

Returns: NO always. Sets GDFileManagerErrorICloudNotSupported if an error location is specified.

◆ startDownloadingUbiquitousItemAtURL:error:

- (BOOL) startDownloadingUbiquitousItemAtURL:	(NSURL *)	url
error:	(NSError **)	error

This element of the base class interface isn't available in this subclass. See under Usage, above.

Returns: NO always. Sets GDFileManagerErrorICloudNotSupported if an error location is specified.

◆ evictUbiquitousItemAtURL:error:

- (BOOL) evictUbiquitousItemAtURL:	(NSURL *)	url
error:	(NSError **)	error

This element of the base class interface isn't available in this subclass. See under Usage, above.

Returns: NO always. Sets GDFileManagerErrorICloudNotSupported if an error location is specified.

◆ URLForPublishingUbiquitousItemAtURL:expirationDate:error:

- (nullable NSURL *) URLForPublishingUbiquitousItemAtURL:	(NSURL *)	url
expirationDate:	(NSDate _Nullable _Nullable)	outDate
error:	(NSError **)	error

This element of the base class interface isn't available in this subclass. See under Usage, above.

Returns: nil always. Sets GDFileManagerErrorICloudNotSupported if an error location is specified.

◆ getFileProviderServicesForItemAtURL:completionHandler:

- (void) getFileProviderServicesForItemAtURL:	(NSURL *)	url
completionHandler:	(void(^)(NSDictionary< NSFileProviderServiceName, NSFileProviderService * > services, NSError error))	completionHandler

This element of the base class interface isn't available in this subclass. See under Usage, above.

Calling this function in the subclass causes the specified completion handler to be invoked as follows. The services parameter will receive nil. The error parameter will receive an NSError object with the GDFileManagerErrorNotSupported code. The invocation will be on a background thread.

◆ createSymbolicLinkAtURL:withDestinationURL:error:

- (BOOL) createSymbolicLinkAtURL:	(NSURL *)	url
withDestinationURL:	(NSURL *)	destURL
error:	(NSError **)	error

◆ createSymbolicLinkAtPath:withDestinationPath:error:

- (BOOL) createSymbolicLinkAtPath:	(NSString *)	path
withDestinationPath:	(NSString *)	destPath
error:	(NSError **)	error

◆ linkItemAtURL:toURL:error:

- (BOOL) linkItemAtURL:	(NSURL *)	srcURL
toURL:	(NSURL *)	dstURL
error:	(NSError **)	error

◆ linkItemAtPath:toPath:error:

- (BOOL) linkItemAtPath:	(NSString *)	srcPath
toPath:	(NSString *)	dstPath
error:	(NSError **)	error

◆ destinationOfSymbolicLinkAtPath:error:

- (nullable NSString *) destinationOfSymbolicLinkAtPath:	(NSString *)	path
error:	(NSError **)	error

◆ fileExistsAtPath:

- (BOOL) fileExistsAtPath: (NSString *) path

◆ fileExistsAtPath:isDirectory:

- (BOOL) fileExistsAtPath:	(NSString *)	path
isDirectory:	(nullable BOOL *)	isDirectory

◆ isReadableFileAtPath:

- (BOOL) isReadableFileAtPath: (NSString *) path

◆ isWritableFileAtPath:

- (BOOL) isWritableFileAtPath: (NSString *) path

◆ isExecutableFileAtPath:

- (BOOL) isExecutableFileAtPath: (NSString *) path

◆ isDeletableFileAtPath:

- (BOOL) isDeletableFileAtPath: (NSString *) path

◆ attributesOfItemAtPath:error:

- (nullable NSDictionary<GD_NSFileAttributeKey, id> *) attributesOfItemAtPath:	(NSString *)	path
error:	(NSError **)	error

◆ attributesOfFileSystemForPath:error:

- (nullable NSDictionary<GD_NSFileAttributeKey, id> *) attributesOfFileSystemForPath:	(NSString *)	path
error:	(NSError **)	error

◆ setAttributes:ofItemAtPath:error:

- (BOOL) setAttributes:	(NSDictionary< GD_NSFileAttributeKey, id > *)	attributes
ofItemAtPath:	(NSString *)	path
error:	(NSError **)	error

◆ contentsAtPath:

- (nullable NSData *) contentsAtPath: (NSString *) path

◆ contentsEqualAtPath:andPath:

- (BOOL) contentsEqualAtPath:	(NSString *)	path1
andPath:	(NSString *)	path2

◆ fileSystemRepresentationWithPath:

- (const char *) fileSystemRepresentationWithPath: (NSString *) NS_RETURNS_INNER_POINTER

◆ stringWithFileSystemRepresentation:length:

- (NSString *) stringWithFileSystemRepresentation:	(const char *)	string
length:	(NSUInteger)	len

◆ changeCurrentDirectoryPath:

- (BOOL) changeCurrentDirectoryPath: (NSString *) path

◆ currentDirectoryPath

- (NSString *) currentDirectoryPath

◆ changeFileAttributes:atPath:

- (BOOL) changeFileAttributes:	(NSDictionary *)	attributes
atPath:	(NSString *)	path

Deprecated:: This function is deprecated in the base class. Use setAttributes:ofItemAtPath:error: instead.

◆ fileAttributesAtPath:traverseLink:

- (nullable NSDictionary *) fileAttributesAtPath:	(NSString *)	path
traverseLink:	(BOOL)	flag

Deprecated:: This function is deprecated in the base class. Use attributesOfItemAtPath:error: instead.

◆ fileSystemAttributesAtPath:

- (nullable NSDictionary *) fileSystemAttributesAtPath: (NSString *) path

Deprecated:: This function is deprecated in the base class. Use attributesOfFileSystemForPath:error: instead.

◆ directoryContentsAtPath:

- (nullable NSArray *) directoryContentsAtPath: (NSString *) path

Deprecated:: This function is deprecated in the base class. Use contentsOfDirectoryAtPath:error: instead.

◆ createDirectoryAtPath:attributes:

- (BOOL) createDirectoryAtPath:	(NSString *)	path
attributes:	(NSDictionary *)	attributes

Deprecated:: This function is deprecated in the base class. Use createDirectoryAtPath:withIntermediateDirectories:attributes:error: instead.

◆ createSymbolicLinkAtPath:pathContent:

- (BOOL) createSymbolicLinkAtPath:	(NSString *)	path
pathContent:	(NSString *)	otherPath

Deprecated:: This function is deprecated in the base class. Use createSymbolicLinkAtPath:withDestinationPath:error: instead.

◆ pathContentOfSymbolicLinkAtPath:

- (nullable NSString *) pathContentOfSymbolicLinkAtPath: (NSString *) path

Deprecated:: This function is deprecated in the base class. Use destinationOfSymbolicLinkAtPath:error: instead.

Property Documentation

◆ ubiquityIdentityToken

- (id<NSObject, NSCopying, NSSecureCoding>) ubiquityIdentityToken

readatomiccopy

This element of the base class interface isn't available in this subclass. See under Usage, above.

Returns: nil always.

◆ temporaryDirectory

- (NSURL*) temporaryDirectory

readatomiccopy

This element of the base class interface isn't available in this subclass. See under Usage, above.

Returns: Instance of NSURL class with no path always.

The documentation for this class was generated from the following file:

GDFileManager.h

Description

Secure File System

Usage

Code Snippets

Simple conversion to secure file system

Instance Methods

Class Methods

Properties

Method Documentation

◆ defaultManager

◆ getReadStream:error:

◆ getWriteStream:appendmode:error:

◆ getAbsoluteEncryptedPath:

◆ pathForCFromManagerPath:

◆ pathForManagerFromCPath:

◆ exportLogFileToDocumentsFolder:

◆ URLForDirectory:inDomain:appropriateForURL:create:error:

◆ URLsForDirectory:inDomains:

◆ containerURLForSecurityApplicationGroupIdentifier:

◆ contentsOfDirectoryAtURL:includingPropertiesForKeys:options:error:

◆ contentsOfDirectoryAtPath:error:

◆ enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:

◆ enumeratorAtPath:

◆ subpathsOfDirectoryAtPath:error:

◆ subpathsAtPath:

◆ createDirectoryAtURL:withIntermediateDirectories:attributes:error:

◆ createDirectoryAtPath:withIntermediateDirectories:attributes:error:

◆ createFileAtPath:contents:attributes:

◆ removeItemAtURL:error:

◆ removeItemAtPath:error:

◆ replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error:

◆ copyItemAtURL:toURL:error:

◆ copyItemAtPath:toPath:error:

◆ moveItemAtURL:toURL:error:

◆ moveItemAtPath:toPath:error:

◆ URLForUbiquityContainerIdentifier:

◆ isUbiquitousItemAtURL:

◆ setUbiquitous:itemAtURL:destinationURL:error:

◆ startDownloadingUbiquitousItemAtURL:error:

◆ evictUbiquitousItemAtURL:error:

◆ URLForPublishingUbiquitousItemAtURL:expirationDate:error:

◆ getFileProviderServicesForItemAtURL:completionHandler:

◆ createSymbolicLinkAtURL:withDestinationURL:error:

◆ createSymbolicLinkAtPath:withDestinationPath:error:

◆ linkItemAtURL:toURL:error:

◆ linkItemAtPath:toPath:error:

◆ destinationOfSymbolicLinkAtPath:error:

◆ fileExistsAtPath:

◆ fileExistsAtPath:isDirectory:

◆ isReadableFileAtPath:

◆ isWritableFileAtPath:

◆ isExecutableFileAtPath:

◆ isDeletableFileAtPath:

◆ attributesOfItemAtPath:error:

◆ attributesOfFileSystemForPath:error:

◆ setAttributes:ofItemAtPath:error:

◆ contentsAtPath:

◆ contentsEqualAtPath:andPath:

◆ fileSystemRepresentationWithPath:

◆ stringWithFileSystemRepresentation:length:

◆ changeCurrentDirectoryPath:

◆ currentDirectoryPath

◆ changeFileAttributes:atPath:

◆ fileAttributesAtPath:traverseLink:

◆ fileSystemAttributesAtPath:

◆ directoryContentsAtPath:

◆ createDirectoryAtPath:attributes:

◆ createSymbolicLinkAtPath:pathContent:

◆ pathContentOfSymbolicLinkAtPath:

Property Documentation

◆ ubiquityIdentityToken

◆ temporaryDirectory