55 lines
941 B
Groff
55 lines
941 B
Groff
.TH READLINK 2
|
|
.UC 4
|
|
.SH NAME
|
|
readlink \- read value of link
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.B #include <unistd.h>
|
|
.B int readlink (const char *path, char *buf, int len);
|
|
.fi
|
|
.SH DESCRIPTION
|
|
.B readlink()
|
|
reads up to
|
|
.I len
|
|
characters of the link named by
|
|
.I *path,
|
|
into
|
|
.I buf.
|
|
0 is returned on success, and a negative value on failure.
|
|
This is one of the VFS operations.
|
|
.SH ERRORS
|
|
.B -EINVAL
|
|
is returned if
|
|
.I len
|
|
is negative, the
|
|
.B readlink
|
|
operation is not supported for a given file system, or
|
|
.I path
|
|
is not a link.
|
|
.PP
|
|
.B -ENOENT
|
|
is returned if
|
|
.I path
|
|
does not exist.
|
|
.SH FILES
|
|
linux/fs/stat.c
|
|
.br
|
|
linux/fs/minix/namei.c
|
|
.br
|
|
/usr/include/linux/sys.h
|
|
.br
|
|
/usr/include/unistd.h
|
|
.SH SEE ALSO
|
|
stat(2)
|
|
.SH BUGS
|
|
A user can read links in directories
|
|
they don't have permissions for if they know the names.
|
|
.PP
|
|
A maximum of 1023 charcters is read by the
|
|
.B minix_readlink()
|
|
function.
|
|
.PP
|
|
No terminating \\0 is appended to the string.
|
|
|
|
|