# PXFLINK (L*X, M*X)

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

## Module

USE IFPOSIX

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

existing | (Input) Character. The path to the file or directory that 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 or 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".

Parent topic: POSIX* Library Routines