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

FreeBSD Manual Pages

  
 
  

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 ports 15.quarterly	November 30, 2022		   FHREADLINK(2)

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

home | help