home | help
FHREADLINK(2)		       System Calls Manual		   FHREADLINK(2)

NAME
     fhreadlink -- read value of a symbolic link

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <sys/param.h>
     #include <sys/mount.h>

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

DESCRIPTION
     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.

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

ERRORS
     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  sys-
			tem.

     [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

SEE ALSO
     fhlink(2), fhstat(2), readlink(2)

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

FreeBSD 15.1			November 30, 2022		   FHREADLINK(2)

home | help