PXFLINK

POSIX Subroutine: Creates a link to a file or directory.

Module

USE IFPOSIX

Syntax

CALL PXFLINK (existing,lenexist,new,lennew,ierror)

existing

(Input) Character. The path to the file or directory you want to link to.

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. This new name can be used exactly as the old one for any operation. Both names refer to the same file (so they have the same permissions and ownership) and it is impossible to tell which name was the "original".

Note iconNote

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