xnu-2050.7.9.tar.gz

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

diff --git a/bsd/man/man2/setxattr.2 b/bsd/man/man2/setxattr.2
index 999aa691e239a249201ba7b2e8afb1edfe20b0d1..240e8298d841c135b268d0e5ac71b7e2fbf9f920 100644 (file)
--- a/bsd/man/man2/setxattr.2
+++ b/bsd/man/man2/setxattr.2
@@ -1,7 +1,7 @@
 .\"
 .\" Copyright (c) 2004 Apple Computer, Inc. All rights reserved.
 .\"
-.\" @APPLE_OSREFERENCE_LICENSE_HEADER_START@
+.\" @APPLE_LICENSE_HEADER_START@
 .\"
 .\" This file contains Original Code and/or Modifications of Original Code
 .\" as defined in and that are subject to the Apple Public Source License
@@ -18,7 +18,7 @@
 .\" Please see the License for the specific language governing rights and
 .\" limitations under the License.
 .\"
-.\" @APPLE_OSREFERENCE_LICENSE_HEADER_END@
+.\" @APPLE_LICENSE_HEADER_END@
 .\"
 .Dd Oct 19, 2004
 .Dt SETXATTR 2
@@ -91,6 +91,13 @@ is identical to
 except that it sets an extended attribute on an open file referenced by
 file descriptor
 .Fa fd .
+.Sh NOTE
+On some filesystems, such as
+.Dv HFS+ ,
+setting the extended attribute
+.Dv com.apple.ResourceFork
+will update the modification time (``mtime'') of
+the file.
 .Sh RETURN VALUES
 On success, 0 is returned.  On failure, -1 is returned and the global
 variable
@@ -166,8 +173,17 @@ Not enough space left on the file system.
 .El
 .Sh SEE ALSO
 .Xr getxattr 2 ,
-.Xr removexattr 2 ,
-.Xr listxattr 2
+.Xr listxattr 2 ,
+.Xr removexattr 2
+.Sh NOTES
+Due to historical reasons, the
+.Dv XATTR_FINDERINFO_NAME
+(defined to be 
+.Dq com.apple.FinderInfo )
+extended attribute must be 32 bytes; see the
+.Dv ATTR_CMN_FNDRINFO
+section in
+.Xr getattrlist 2 .
 .Sh HISTORY
 .Fn setxattr
 and