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


Manual Reference Pages  -  LGETFH (2)

NAME

getfh, lgetfh - get file handle

CONTENTS

Library
Synopsis
Description
Return Values
Errors
See Also
History

LIBRARY


.Lb libc

SYNOPSIS


.In sys/param.h
.In sys/mount.h int getfh const char *path fhandle_t *fhp int lgetfh const char *path fhandle_t *fhp

DESCRIPTION

The getfh system call returns a file handle for the specified file or directory in the file handle pointed to by fhp. The lgetfh system call is like getfh except in the case where the named file is a symbolic link, in which case lgetfh returns information about the link, while getfh returns information about the file the link references. These system calls are restricted to the superuser.

RETURN VALUES


.Rv -std

ERRORS

The getfh and lgetfh system calls fail if one or more of the following are true:
[ENOTDIR]
  A component of the path prefix of path is not a directory.
[ENAMETOOLONG]
  The length of a component of path exceeds 255 characters, or the length of path exceeds 1023 characters.
[ENOENT]
  The file referred to by path does not exist.
[EACCES]
  Search permission is denied for a component of the path prefix of path.
[ELOOP]
  Too many symbolic links were encountered in translating path.
[EFAULT]
  The fhp argument points to an invalid address.
[EIO] An I/O error occurred while reading from or writing to the file system.

SEE ALSO

fhopen(2), open(2), stat(2)

HISTORY

The getfh system call first appeared in BSD 4.4 .
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 manServer 1.07.