LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man3 / dirfd.3

diff --git a/original/man3/dirfd.3 b/original/man3/dirfd.3
index 8b4971e..489fd04 100644 (file)
--- a/original/man3/dirfd.3
+++ b/original/man3/dirfd.3
@@ -1,5 +1,6 @@
 .\" Copyright (C) 2002 Andries Brouwer (aeb@cwi.nl)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,8 +20,9 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.TH DIRFD 3 2008-08-21 "Linux" "Linux Programmer's Manual"
+.TH DIRFD 3 2013-07-05 "Linux" "Linux Programmer's Manual"
 .SH NAME
 dirfd \- get directory stream file descriptor
 .SH SYNOPSIS
@@ -36,7 +38,19 @@ Feature Test Macro Requirements for glibc (see
 .in
 .sp
 .BR dirfd ():
+.br
+.RS 4
+.PD 0
+.ad l
 _BSD_SOURCE || _SVID_SOURCE
+.br
+|| /* Since glibc 2.10: */
+.RS 4
+(_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700)
+.RE
+.PD
+.RE
+.ad
 .SH DESCRIPTION
 The function
 .BR dirfd ()
@@ -44,7 +58,7 @@ returns the file descriptor associated with the directory stream
 .IR dirp .
 .LP
 This descriptor is the one used internally by the directory stream.
-As a result, it is only useful for functions which do not depend on
+As a result, it is useful only for functions which do not depend on
 or alter the file position, such as
 .BR fstat (2)
 and
@@ -54,7 +68,9 @@ It will be automatically closed when
 is called.
 .SH RETURN VALUE
 On success, a nonnegative file descriptor is returned.
-On error, \-1 is returned.
+On error, \-1 is returned, and
+.I errno
+is set to indicate the cause of the error.
 .SH ERRORS
 POSIX.1-2008 specifies two errors,
 neither of which is returned by the current
@@ -68,19 +84,24 @@ does not refer to a valid directory stream.
 .B ENOTSUP
 The implementation does not support the association of a file
 descriptor with a directory.
-.SH "CONFORMING TO"
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR dirfd ()
+function is thread-safe.
+.SH CONFORMING TO
 POSIX.1-2008.
 This function was a BSD extension, present in 4.3BSD-Reno, not in 4.2BSD.
 .\" It is present in libc5 (since 5.1.2) and in glibc2.
 .SH NOTES
 The prototype for
 .BR dirfd ()
-is only available if
+is available only if
 .B _BSD_SOURCE
 or
 .B _SVID_SOURCE
 is defined.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR open (2),
 .BR closedir (3),
 .BR opendir (3),
@@ -89,3 +110,12 @@ is defined.
 .BR scandir (3),
 .BR seekdir (3),
 .BR telldir (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.