OSDN Git Service

LDP: Update original to LDP v3.79
[linuxjm/LDP_man-pages.git] / original / man2 / open_by_handle_at.2
index ed11537..1df341d 100644 (file)
 .\" 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>
@@ -165,7 +165,7 @@ is interpreted relative to the directory referred to by
 .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
@@ -276,7 +276,7 @@ points outside your accessible address space.
 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
@@ -351,6 +351,11 @@ These system calls first appeared in Linux 2.6.39.
 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 ()
@@ -729,10 +734,11 @@ release 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/.