pSOSystem System Calls - Read

ead_link pHILE+ System Calls
read_link Reads the value of a symbolic link.
unsigned long read_link(
char *name, /* a file containing the symbolic link */
char *buf, /* user buffer to hold the returned contents */
unsigned long *bufsize /* maximum buffer size */
)
Volume Types
Description
Arguments
Return Value
NFS volumes.
read_link() reads the contents of the symbolic link of a file. The returned data is
not null-terminated.
name Points to the null-terminated pathname of the file
containing the symbolic link.
buf Points to the memory area that receives the data.
bufsize Points to the maximum buffer size before the call, and the
length of the data returned in buf after the call.
If successful, read_link stores in *bufsize the length of the data stored in buf. If
this is the same as the maximum buffer size, only part of the data may have been
returned.
This system call returns 0 on success or an error code on failure.
2-96 pSOSystem System Calls