xnu-4903.270.47.tar.gz

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

diff --git a/bsd/man/man2/clonefile.2 b/bsd/man/man2/clonefile.2
index 09558f405d9afeda136dcd8d8b5e539aab023bbe..114321e0d15400f91c2ef897f0f336925ebb17d5 100644 (file)
--- a/bsd/man/man2/clonefile.2
+++ b/bsd/man/man2/clonefile.2
@@ -53,10 +53,18 @@ with the exceptions listed below
 .Bl -enum
 .
 .It
-ownership information and timestamps are set as they would be if
+ownership information is set as it would be if
 .Fa dst
 was created by
 .Xr openat 2
+or
+.Xr mkdirat 2
+or
+.Xr symlinkat 2
+if the current user does not have privileges to change ownership. If the optional
+flag CLONE_NOOWNERCOPY is passed, the ownership information is the same as if the
+the current user does not have privileges to change ownership
+
 .
 .It
 setuid and setgid bits are turned off in the mode bits for regular files.
@@ -127,6 +135,17 @@ names a symbolic link.
 .
 .El
 .Pp
+.Bl -tag -width CLONE_NOOWNERCOPY 
+.
+.It CLONE_NOOWNERCOPY 
+Don't copy ownership information from the source when run called with superuser privileges.
+The symbolic link is itself cloned if
+.Fa src
+names a symbolic link.
+.
+.El
+.Pp
+The
 The
 .Fn clonefile ,
 .Fn clonefileat
@@ -261,6 +280,7 @@ nor a file descriptor associated with a directory.
 .Sh SEE ALSO
 .
 .Xr copyfile 3
+.Xr chown 2
 .
 .Sh HISTORY
 The