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
       succeeds, 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	trans-
			  lating 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 allo-
			  cated	address	space.

       [ESTALE]		  The file handle fhp is no longer valid

SEE ALSO
       fhlink(2), fhstat(2)

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

FreeBSD	14.3		       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+14.3-RELEASE+and+Ports>

home | help