Peter Schiffer
parent
5cee1c193b
commit
fd2778a5e2
143
man-pages-3.52-open.patch
Normal file
143
man-pages-3.52-open.patch
Normal file
@ -0,0 +1,143 @@
|
||||
diff -ur man-pages-3.52.orig/man2/open.2 man-pages-3.52/man2/open.2
|
||||
--- man-pages-3.52.orig/man2/open.2 2013-07-04 12:54:00.000000000 +0200
|
||||
+++ man-pages-3.52/man2/open.2 2013-07-22 10:12:51.000000000 +0200
|
||||
@@ -47,9 +47,8 @@
|
||||
.\" FIXME . Apr 08: The next POSIX revision has O_EXEC, O_SEARCH, and
|
||||
.\" O_TTYINIT. Eventually these may need to be documented. --mtk
|
||||
.\" FIXME Linux 2.6.33 has O_DSYNC, and a hidden __O_SYNC.
|
||||
-.\" FIXME: Linux 2.6.39 added O_PATH
|
||||
.\"
|
||||
-.TH OPEN 2 2013-02-18 "Linux" "Linux Programmer's Manual"
|
||||
+.TH OPEN 2 2013-07-21 "Linux" "Linux Programmer's Manual"
|
||||
.SH NAME
|
||||
open, creat \- open and possibly create a file or device
|
||||
.SH SYNOPSIS
|
||||
@@ -316,9 +315,7 @@
|
||||
avoid denial-of-service problems if
|
||||
.BR opendir (3)
|
||||
is called on a
|
||||
-FIFO or tape device, but should not be used outside of the
|
||||
-implementation of
|
||||
-.BR opendir (3).
|
||||
+FIFO or tape device.
|
||||
.TP
|
||||
.B O_EXCL
|
||||
Ensure that this call creates the file:
|
||||
@@ -424,6 +421,9 @@
|
||||
This is a FreeBSD extension, which was added to Linux in version 2.1.126.
|
||||
Symbolic links in earlier components of the pathname will still be
|
||||
followed.
|
||||
+See also
|
||||
+.BR O_NOPATH
|
||||
+below.
|
||||
.\" The headers from glibc 2.0.100 and later include a
|
||||
.\" definition of this flag; \fIkernels before 2.1.126 will ignore it if
|
||||
.\" used\fP.
|
||||
@@ -441,6 +441,96 @@
|
||||
in conjunction with mandatory file locks and with file leases, see
|
||||
.BR fcntl (2).
|
||||
.TP
|
||||
+.BR O_PATH " (since Linux 2.6.39)"
|
||||
+.\" commit 1abf0c718f15a56a0a435588d1b104c7a37dc9bd
|
||||
+.\" commit 326be7b484843988afe57566b627fb7a70beac56
|
||||
+.\" commit 65cfc6722361570bfe255698d9cd4dccaf47570d
|
||||
+.\"
|
||||
+.\" http://thread.gmane.org/gmane.linux.man/2790/focus=3496
|
||||
+.\" Subject: Re: [PATCH] open(2): document O_PATH
|
||||
+.\" Newsgroups: gmane.linux.man, gmane.linux.kernel
|
||||
+.\"
|
||||
+Obtain a file descriptor that can be used for two purposes:
|
||||
+to indicate a location in the file-system tree and
|
||||
+to perform operations that act purely at the file descriptor level.
|
||||
+The file itself is not opened, and other file operations (e.g.,
|
||||
+.BR read (2),
|
||||
+.BR write (2),
|
||||
+.BR fchmod (2),
|
||||
+.BR fchown (2),
|
||||
+.BR fgetxattr (2))
|
||||
+fail with the error
|
||||
+.BR EBADF .
|
||||
+
|
||||
+The following operations
|
||||
+.I can
|
||||
+be performed on the resulting file descriptor:
|
||||
+.RS
|
||||
+.IP * 3
|
||||
+.BR close (2);
|
||||
+.BR fchdir (2)
|
||||
+(since Linux 3.5);
|
||||
+.\" commit 332a2e1244bd08b9e3ecd378028513396a004a24
|
||||
+.BR fstat (2)
|
||||
+(since Linux 3.6).
|
||||
+.\" fstat(): commit 55815f70147dcfa3ead5738fd56d3574e2e3c1c2
|
||||
+.IP *
|
||||
+Duplicating the file descriptor
|
||||
+.RB ( dup (2),
|
||||
+.BR fcntl (2)
|
||||
+.BR F_DUPFD ,
|
||||
+etc.).
|
||||
+.IP *
|
||||
+Getting and setting file descriptor flags
|
||||
+.RB ( fcntl (2)
|
||||
+.BR F_GETFD
|
||||
+and
|
||||
+.BR F_SETFD ).
|
||||
+.IP *
|
||||
+Retrieving open file status flags using the
|
||||
+.BR fcntl (2)
|
||||
+.BR F_GETFL
|
||||
+operation: the returned flags will include the bit
|
||||
+.BR O_PATH .
|
||||
+
|
||||
+.IP *
|
||||
+Passing the file descriptor as the
|
||||
+.IR dirfd
|
||||
+argument of
|
||||
+.BR openat (2)
|
||||
+and the other "*at()" system calls.
|
||||
+.IP *
|
||||
+Passing the file descriptor to another process via a UNIX domain socket
|
||||
+(see
|
||||
+.BR SCM_RIGHTS
|
||||
+in
|
||||
+.BR unix (7)).
|
||||
+.RE
|
||||
+.IP
|
||||
+When
|
||||
+.B O_PATH
|
||||
+is specified in
|
||||
+.IR flags ,
|
||||
+flag bits other than
|
||||
+.BR O_DIRECTORY
|
||||
+and
|
||||
+.BR O_NOFOLLOW
|
||||
+are ignored.
|
||||
+
|
||||
+If the
|
||||
+.BR O_NOFOLLOW
|
||||
+flag is also specified,
|
||||
+then the call returns a file descriptor referring to the symbolic link.
|
||||
+This file descriptor can be used as the
|
||||
+.I dirfd
|
||||
+argument in calls to
|
||||
+.BR fchownat (2),
|
||||
+.BR fstatat (2),
|
||||
+.BR linkat (2),
|
||||
+and
|
||||
+.BR readlinkat (2)
|
||||
+with an empty pathname to have the calls operate on the symbolic link.
|
||||
+.TP
|
||||
.B O_SYNC
|
||||
The file is opened for synchronous I/O.
|
||||
Any
|
||||
@@ -631,8 +721,9 @@
|
||||
The
|
||||
.BR O_DIRECTORY ,
|
||||
.BR O_NOATIME ,
|
||||
+.BR O_NOFOLLOW ,
|
||||
and
|
||||
-.B O_NOFOLLOW
|
||||
+.BR O_PATH
|
||||
flags are Linux-specific, and one may need to define
|
||||
.B _GNU_SOURCE
|
||||
(before including
|
||||
@ -37,6 +37,8 @@ Patch22: man-pages-3.42-connect.patch
|
||||
Patch23: man-pages-3.43-tcp-congestion.patch
|
||||
# resolves: #984108
|
||||
Patch24: man-pages-3.52-futex.patch
|
||||
# resolves: #885740
|
||||
Patch25: man-pages-3.52-open.patch
|
||||
|
||||
|
||||
Autoreq: false
|
||||
@ -61,6 +63,7 @@ Documentation Project (LDP).
|
||||
%patch22 -p1
|
||||
%patch23 -p1
|
||||
%patch24 -p1
|
||||
%patch25 -p1
|
||||
|
||||
## Remove man pages we are not going to use ##
|
||||
|
||||
@ -127,6 +130,8 @@ cd ..
|
||||
- resolves: #981385
|
||||
updated to 3.52
|
||||
- fixed broken sentence on the futex(7) man page
|
||||
- resolves: #885740
|
||||
documented O_PATH flag on the open(2) man page
|
||||
|
||||
* Tue Apr 23 2013 Peter Schiffer <pschiffe@redhat.com> - 3.51-1
|
||||
- resolves: #921911
|
||||
|
||||
Loading…
Reference in New Issue
Block a user