xnu-1699.22.73.tar.gz

[apple/xnu.git] / bsd / man / man2 / open.2

diff --git a/bsd/man/man2/open.2 b/bsd/man/man2/open.2
index 2d121402db54249b9675bd41029bb003e94dcc6d..80c29362615167b1fe1454fc3a482f9beb0b3610 100644 (file)
--- a/bsd/man/man2/open.2
+++ b/bsd/man/man2/open.2
@@ -1,5 +1,5 @@
 .\"
 .\"

-.\" Copyright (c) 2008 Apple Inc.  All rights reserved.
+.\" Copyright (c) 2010 Apple Inc.  All rights reserved.

 .\"
 .\" @APPLE_LICENSE_HEADER_START@
 .\" 
 .\"
 .\" @APPLE_LICENSE_HEADER_START@
 .\" 


@@ -56,7 +56,7 @@
 .\"
 .\"     @(#)open.2     8.2 (Berkeley) 11/16/93
 .\"
 .\"
 .\"     @(#)open.2     8.2 (Berkeley) 11/16/93
 .\"

-.Dd October 7, 2008
+.Dd November 10, 2010

 .Dt OPEN 2
 .Os BSD 4
 .Sh NAME
 .Dt OPEN 2
 .Os BSD 4
 .Sh NAME


@@ -114,6 +114,7 @@ O_EXLOCK    atomically obtain an exclusive lock
 O_NOFOLLOW     do not follow symlinks
 O_SYMLINK      allow open of symlinks
 O_EVTONLY      descriptor requested for event notifications only
 O_NOFOLLOW     do not follow symlinks
 O_SYMLINK      allow open of symlinks
 O_EVTONLY      descriptor requested for event notifications only

+O_CLOEXEC      mark as close-on-exec

 .Ed
 .Pp
 Opening a file with
 .Ed
 .Pp
 Opening a file with


@@ -133,7 +134,9 @@ returns an error.
 This may be used to implement a simple exclusive-access locking mechanism.
 If
 .Dv O_EXCL
 This may be used to implement a simple exclusive-access locking mechanism.
 If
 .Dv O_EXCL

-is set and the last component of the pathname is a symbolic link,
+is set with
+.Dv O_CREAT
+and the last component of the pathname is a symbolic link,

 .Fn open
 will fail even if the symbolic link points to a non-existent name.
 .Pp
 .Fn open
 will fail even if the symbolic link points to a non-existent name.
 .Pp


@@ -184,6 +187,15 @@ flag is only intended for monitoring a file for changes (e.g. kqueue). Note: whe
 this flag is used, the opened file will not prevent an unmount 
 of the volume that contains the file.
 .Pp
 this flag is used, the opened file will not prevent an unmount 
 of the volume that contains the file.
 .Pp

+The
+.Dv O_CLOEXEC
+flag causes the file descriptor to be marked as close-on-exec,
+setting the
+.Dv FD_CLOEXEC
+flag.  The state of the file descriptor flags can be inspected
+using the F_GETFD fcntl.  See
+.Xr fcntl 2 .
+.Pp

 If successful,
 .Fn open
 returns a non-negative integer, termed a file descriptor.
 If successful,
 .Fn open
 returns a non-negative integer, termed a file descriptor.