xnu-2782.30.5.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..3d5f3c5e6408c4f5e521617edae20fb100e8de87 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,26 @@ is identical to
 except that it sets an extended attribute on an open file referenced by
 file descriptor
 .Fa fd .
+.Sh NOTES
+On some filesystems, such as
+.Dv HFS+ ,
+setting the extended attribute
+.Dv com.apple.ResourceFork
+will update the modification time (``mtime'') of
+the file.
+.Pp
+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 .
+.Pp
+The maximum supported size of extended attribute can be found out using 
+.Xr pathconf 2 
+with _PC_XATTR_SIZE_BITS option.  
 .Sh RETURN VALUES
 On success, 0 is returned.  On failure, -1 is returned and the global
 variable
@@ -166,8 +186,9 @@ Not enough space left on the file system.
 .El
 .Sh SEE ALSO
 .Xr getxattr 2 ,
+.Xr listxattr 2 ,
 .Xr removexattr 2 ,
-.Xr listxattr 2
+.Xr pathconf 2
 .Sh HISTORY
 .Fn setxattr
 and