Document lgetfh(2).

2 files changed, 22 insertions, 5 deletions

diff --git a/lib/libc/sys/Makefile.inc b/lib/libc/sys/Makefile.inc
index 76f81b9..64836b9 100644
--- a/lib/libc/sys/Makefile.inc
+++ b/lib/libc/sys/Makefile.inc
@@ -104,6 +104,7 @@ MLINKS+=extattr_get_file.2 extattr_set_file.2 \
 	extattr_get_file.2 extattr.2
 MLINKS+=fhopen.2 fhstat.2 fhopen.2 fhstatfs.2
 MLINKS+=getdirentries.2 getdents.2
+MLINKS+=getfh.2 lgetfh.2
 MLINKS+=getgid.2 getegid.2
 MLINKS+=getitimer.2 setitimer.2
 MLINKS+=getlogin.2 getlogin_r.3
diff --git a/lib/libc/sys/getfh.2 b/lib/libc/sys/getfh.2
index 44caa76..ef5909b 100644
--- a/lib/libc/sys/getfh.2
+++ b/lib/libc/sys/getfh.2
@@ -36,7 +36,8 @@
 .Dt GETFH 2
 .Os
 .Sh NAME
-.Nm getfh
+.Nm getfh ,
+.Nm lgetfh
 .Nd get file handle
 .Sh LIBRARY
 .Lb libc
@@ -45,6 +46,8 @@
 .In sys/mount.h
 .Ft int
 .Fn getfh "const char *path" "fhandle_t *fhp"
+.Ft int
+.Fn lgetfh "const char *path" "fhandle_t *fhp"
 .Sh DESCRIPTION
 The
 .Fn getfh
@@ -52,14 +55,27 @@ system call
 returns a file handle for the specified file or directory
 in the file handle pointed to by
 .Fa fhp .
-This system call is restricted to the superuser.
+The
+.Fn lgetfh
+system call is like
+.Fn getfh
+except in the case where the named file is a symbolic link,
+in which case
+.Fn lgetfh
+returns information about the link,
+while
+.Fn getfh
+returns information about the file the link references.
+These system calls are restricted to the superuser.
 .Sh RETURN VALUES
-.Rv -std getfh
+.Rv -std
 .Sh ERRORS
 The
 .Fn getfh
-system call
-fails if one or more of the following are true:
+and
+.Fn lgetfgh
+system calls
+fail if one or more of the following are true:
 .Bl -tag -width Er
 .It Bq Er ENOTDIR
 A component of the path prefix of