.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
-.TH OPEN_BY_HANDLE_AT 2 2014-03-24 "Linux" "Linux Programmer's Manual"
+.TH OPEN_BY_HANDLE_AT 2 2014-06-13 "Linux" "Linux Programmer's Manual"
.SH NAME
name_to_handle_at, open_by_handle_at \- obtain handle
for a pathname and open file via a handle
.SH SYNOPSIS
.nf
-.B #define _GNU_SOURCE
+.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <sys/types.h>
.B #include <sys/stat.h>
.B #include <fcntl.h>
.IR dirfd ,
and a handle is returned for the file to which it refers.
(See
-.BR openat (3)
+.BR openat (2)
for an explanation of why "directory file descriptors" are useful.)
.IP *
If
includes an invalid bit value.
.TP
.B EINVAL
-.IR handle_bytes\->handle_bytes
+.IR handle\->handle_bytes
is greater than
.BR MAX_HANDLE_SZ .
.TP
Library support is provided in glibc since version 2.14.
.SH CONFORMING TO
These system calls are nonstandard Linux extensions.
+
+FreeBSD has a broadly similar pair of system calls in the form of
+.BR getfh ()
+and
+.BR openfh ().
.SH NOTES
A file handle can be generated in one process using
.BR name_to_handle_at ()
.UR https://www.kernel.org/pub/linux/utils/util-linux/
.UE
.SH COLOPHON
-This page is part of release 3.64 of the Linux
+This page is part of release 3.79 of the Linux
.I man-pages
project.
A description of the project,
-and information about reporting bugs,
+information about reporting bugs,
+and the latest version of this page,
can be found at
\%http://www.kernel.org/doc/man\-pages/.