xnu-2782.1.97.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 01b4443558bdc965dd9d23ad0bca81355073a597..3d5f3c5e6408c4f5e521617edae20fb100e8de87 100644 (file)
--- a/bsd/man/man2/setxattr.2
+++ b/bsd/man/man2/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 .
 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
 .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 ,
 .El
 .Sh SEE ALSO
 .Xr getxattr 2 ,

+.Xr listxattr 2 ,

 .Xr removexattr 2 ,
 .Xr removexattr 2 ,

-.Xr listxattr 2
+.Xr pathconf 2

 .Sh HISTORY
 .Fn setxattr
 and
 .Sh HISTORY
 .Fn setxattr
 and