Manual Pages  — FHREADLINK

fhreadlink – read value of a symbolic link

LIBRARY SYNOPSIS DESCRIPTION RETURN VALUES ERRORS SEE ALSO HISTORY

Standard C Library (libc, -lc)

#include <sys/param.h>

#include <sys/mount.h>

int
fhreadlink(fhandle_t *fhp, char *buf, size_t bufsize);

The fhreadlink() system call places the contents of the symbolic link fhp in the buffer buf, which has size bufsiz. The fhreadlink() system call does not append a NUL character to buf.

The call returns the count of characters placed in the buffer if it succeeds, or a -1 if an error occurs, placing the error code in the global variable errno.

The fhreadlink() system call will fail if:

[ENOENT]
	The named file does not exist.
[ELOOP]
	Too many symbolic links were encountered in translating the file handle fhp.
[EINVAL]
	The named file is not a symbolic link.
[EIO]	An I/O error occurred while reading from the file system.
[EINTEGRITY]
	Corrupted data was detected while reading from the file system.
[EFAULT]
	The buf argument extends outside the process's allocated address space.
[ESTALE]
	The file handle fhp is no longer valid

The fhreadlink() system call first appeared in FreeBSD 12.1 .