GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
FHREADLINK(2) FreeBSD System Calls Manual FHREADLINK(2)

fhreadlink
read value of a symbolic link

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 readlink() system call will fail if:
[]
The named file does not exist.
[]
Too many symbolic links were encountered in translating the file handle fhp.
[]
The named file is not a symbolic link.
[]
An I/O error occurred while reading from the file system.
[]
Corrupted data was detected while reading from the file system.
[]
The buf argument extends outside the process's allocated address space.
[]
The file handle fhp is no longer valid

fhstat(2), fhlink(2),
March 30, 2020 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 2 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.