extlink

extlink

Define an External Link

Portability: SAS/C extension

SYNOPSIS
DESCRIPTION
RETURN VALUE
RELATED FUNCTIONS

SYNOPSIS

#include <unistd.h>
int extlink(const char *ename,
            const char *lname);

DESCRIPTION

The extlink functions creates a link from the UNIX System Services hierachical file system to an external (non-HFS) file. The argument ename is the name of the external file, and lname specifies the name of the link. lname must specify the name of an HFS file. For programs not compiled with the posix option, style prefixes may be required. The external name, ename, must not specify a style prefix. See "File Naming Conventions" in SAS/C Library Reference, Volume 1, for further information.

Note: External links are not transparent, similar to other UNIX System Services symbolic links. That is, opening or unlinking an external link will not open or delete the referenced external file. External links are used by IBM's NFS implementation and can be used by other applications, but are not handled automatically by either UNIX System Services or the SAS/C library. The contents of an external link can be accessed using the readextlink function. [cautionend]

RETURN VALUE

extlink returns 0 if successful, or -1 if unsuccessful.

RELATED FUNCTIONS

lstat, readextlink

Chapter Contents
Previous
Next
Top of Page