pSOSystem System Calls - Read

symlink_f pHILE+ System Calls
symlink_f Creates a symbolic link to a file.
unsigned long symlink_f(
char *name1, /* a string used in creating the
* symbolic link */
char *name2 /* the name of the file to be created */
)
Volume Types
Description
Arguments
Return Value
Error Codes
NFS volumes.
symlink_f() creates a symbolic link name1 in the file name2. The files do not need
to be on the same volume.
The file to which the symbolic link points is used when an open_f() is performed
on the link. A stat_f() performed on a symbolic link returns the linked-to file
(whereas lstat_f() returns information about the link itself). read_link() can
be used to read the contents of a symbolic link.
name1 Points to the null-terminated pathname of the symbolic link.
name2 Points to the null-terminated pathname of the file.
This system call returns 0 on success or an error code on failure.
Hex Mnemonic Description
0x2001 E_FUNC Invalid function number.
0x200C E_IFN Illegal pathname.
0x200D E_NDD No default directory.
2-112 pSOSystem System Calls