xnu-2422.1.72.tar.gz

[apple/xnu.git] / bsd / man / man3 / posix_spawnattr_setflags.3

diff --git a/bsd/man/man3/posix_spawnattr_setflags.3 b/bsd/man/man3/posix_spawnattr_setflags.3
index 78cd67398ab859ae9fd437330fb4186eb051433c..3359497ec9890d7db3ba11c8a513be749e35850b 100644 (file)
--- a/bsd/man/man3/posix_spawnattr_setflags.3
+++ b/bsd/man/man3/posix_spawnattr_setflags.3
@@ -1,5 +1,5 @@
 .\"
 .\"

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

 .\"
 .\" @APPLE_OSREFERENCE_LICENSE_HEADER_START@
 .\" 
 .\"
 .\" @APPLE_OSREFERENCE_LICENSE_HEADER_START@
 .\" 


@@ -27,7 +27,7 @@
 .\"
 .\"     @(#)posix_spawnattr_setflags.3
 .
 .\"
 .\"     @(#)posix_spawnattr_setflags.3
 .

-.Dd August 22, 2007
+.Dd October 28, 2010

 .Dt POSIX_SPAWNATTR_SETFLAGS 3
 .Os "Mac OS X"
 .Sh NAME
 .Dt POSIX_SPAWNATTR_SETFLAGS 3
 .Os "Mac OS X"
 .Sh NAME


@@ -67,13 +67,12 @@ The argument
 is either 0 or a logical OR of one or more of the following flags:
 .Bl -tag -width POSIX_SPAWN_START_SUSPENDED
 .It Dv POSIX_SPAWN_RESETIDS
 is either 0 or a logical OR of one or more of the following flags:
 .Bl -tag -width POSIX_SPAWN_START_SUSPENDED
 .It Dv POSIX_SPAWN_RESETIDS

-If the set group bit is set on the process image being spawned, this
-bit has no effect; otherwise, if not set, the child process will
-inherit the effective group ID of the parent process, and if set, the
-child process will inherit the real group ID of the parent process.
+If this bit is set, the child process will inherit the real (rather than the effective) user and
+group ID of the parent process. NOTE: This flag has no effect when the set-group bit is set on the
+process image being spawned.

 .It Dv POSIX_SPAWN_SETPGROUP
 If this bit is not set, then the child process inherits the parent
 .It Dv POSIX_SPAWN_SETPGROUP
 If this bit is not set, then the child process inherits the parent

-process group; if set, then the child process shall behave as if the
+process group; if it is set, then the child process will behave as if the

 .Xr setpgid 2
 function had been called with a
 .Fa pid
 .Xr setpgid 2
 function had been called with a
 .Fa pid


@@ -120,6 +119,13 @@ manipulate the process before it begins execution in user space.  This
 permits, for example, obtaining exact instruction counts, or debugging
 very early in
 .Xr dyld 1 .
 permits, for example, obtaining exact instruction counts, or debugging
 very early in
 .Xr dyld 1 .

+.It Dv POSIX_SPAWN_CLOEXEC_DEFAULT
+.Em Apple Extension :
+If this bit is set, then only file descriptors explicitly described by the
+.Fa file_actions
+argument are available in the spawned process; all
+of the other file descriptors are
+automatically closed in the spawned process.

 .El
 .Sh RETURN VALUES
 On success, these functions return 0; on failure they return an error
 .El
 .Sh RETURN VALUES
 On success, these functions return 0; on failure they return an error


@@ -155,6 +161,7 @@ is invalid.
 .Xr posix_spawnattr_setpgroup 3 ,
 .Xr posix_spawnattr_setsigdefault 3 ,
 .Xr posix_spawnattr_setsigmask 3 ,
 .Xr posix_spawnattr_setpgroup 3 ,
 .Xr posix_spawnattr_setsigdefault 3 ,
 .Xr posix_spawnattr_setsigmask 3 ,

+.Xr posix_spawn_file_actions_init 3 ,

 .Xr setpgid 2 ,
 .Xr execve 2 ,
 .Xr dyld 1
 .Xr setpgid 2 ,
 .Xr execve 2 ,
 .Xr dyld 1