Chapter Contents

Previous

Next
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

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.