POSIX Subroutine: Creates a link to a file. On Linux* and Mac OS* X systems, it can also create a link to a directory.
Module
USE IFPOSIX
Syntax
CALL PXFLINK (existing,lenexist,new,lennew,ierror)
existing |
(Input) Character. The path to the file you want to link to. On Linux and Mac OS X systems, it can also be a path to a directory. |
lenexist |
(Input) INTEGER(4). The length of the existing string. |
new |
(Input) Character. The name of the new link file. |
lennew |
(Input) INTEGER(4). The length of the new string. |
ierror |
(Output) INTEGER(4). The error status. |
If successful, ierror is not changed; otherwise, an error code.
The PXFLINK subroutine creates a new link (also known as a hard link) to an existing file; on Linux and Mac OS X systems, the link can be created to an existing directory.
This new name can be used exactly as the old one for any operation. Both names refer to the same entity (so they have the same permissions and ownership) and it is impossible to tell which name was the "original".
Note
On Windows* systems, this subroutine is only valid for NTFS file systems; for FAT systems, it returns an error.
Compatibility
CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB