Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FHREADLINK(2)		    BSD	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 readlink() system call	will fail if:

     [ENOENT]		The named file does not	exist.

     [ELOOP]		Too many symbolic links	were encountered in translat-
			ing 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 allo-
			cated address space.

     [ESTALE]		The file handle	fhp is no longer valid

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

BSD				March 30, 2020				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fhreadlink&sektion=2&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help