Instance Method


Creates a symbolic link that points to the specified destination.


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



The path at which to create the new symbolic link. The last path component is used as the name of the link.


The path that contains the item to be pointed to by the link. In other words, this is the destination of the link.


If an error occurs, upon return contains an NSError object that describes the problem. Pass NULL if you do not want error information.

Return Value

YES if the symbolic link was created or NO if an error occurred. This method also returns NO if a file, directory, or link already exists at path.


This method does not traverse symbolic links contained in destPath, making it possible to create symbolic links to locations that do not yet exist. Also, if the final path component in path is a symbolic link, that link is not followed.

See Also

Creating Symbolic and Hard Links

- createSymbolicLinkAtURL:withDestinationURL:error:

Creates a symbolic link at the specified URL that points to an item at the given URL.

- linkItemAtURL:toURL:error:

Creates a hard link between the items at the specified URLs.

- linkItemAtPath:toPath:error:

Creates a hard link between the items at the specified paths.

- destinationOfSymbolicLinkAtPath:error:

Returns the path of the item pointed to by a symbolic link.