xnu-2782.40.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..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.
 .\"
 .\"
 .\" 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
 .\"
 .\" 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.
 .\"
 .\" 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
 .\"
 .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 .
 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