xnu-6153.121.1.tar.gz

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

diff --git a/bsd/man/man2/chflags.2 b/bsd/man/man2/chflags.2
index 66a036bbb9c7502226eba9f0571c100c0164aec2..6bea184c416eedde8c13c855748626e8f08fcc54 100644 (file)
--- a/bsd/man/man2/chflags.2
+++ b/bsd/man/man2/chflags.2
@@ -60,45 +60,56 @@ The flags specified are formed by
 .Em or Ns 'ing
 the following values
 .Pp
-.Bl -tag -width "SF_IMMUTABLE" -compact -offset indent
+.Bl -tag -width "SF_IMMUTABLEX" -compact -offset indent
 .It UF_NODUMP
 Do not dump the file.
 .It UF_IMMUTABLE
 The file may not be changed.
 .It UF_APPEND
 The file may only be appended to.
-.\".It ARCHIVED
-.\"File is archived.
+.It UF_OPAQUE
+The directory is opaque when viewed through a union stack.
+.It UF_HIDDEN
+The file or directory is not intended to be displayed to the user.
+.It SF_ARCHIVED
+The file has been archived.
 .It SF_IMMUTABLE
 The file may not be changed.
 .It SF_APPEND
 The file may only be appended to.
+.It SF_DATALESSFAULT
+The file is a dataless placeholder.
+The system will attempt to materialize it when accessed according to the dataless file materialization policy of the accessing thread or process.
+See
+.Xr getiopolicy_np 3 .
 .El
 .Pp
 The
-.Dq UF_IMMUTABLE
+.Dq UF_IMMUTABLE ,
+.Dq UF_APPEND ,
+.Dq UF_OPAQUE ,
 and
-.Dq UF_APPEND
+.Dq UF_HIDDEN
 flags may be set or unset by either the owner of a file or the super-user.
 .Pp
 The
+.Dq SF_ARCHIVED ,
 .Dq SF_IMMUTABLE
 and
 .Dq SF_APPEND
 flags may only be set or unset by the super-user.
-They may be set at any time, but normally may only be unset when
-the system is in single-user mode.
-(See
-.Xr init 8
-for details.)
+.Pp
+The
+.Dq SF_DATALESSFAULT
+flag is an internal flag and may not be set from user space.
 .Sh RETURN VALUES
 Upon successful completion, a value of 0 is returned.
 Otherwise, -1 is returned and the global variable
 .Va errno
 is set to indicate the error.
 .Sh ERRORS
-.Fn Chflags
-will fail it:
+.Fn chflags
+will fail if:
 .Bl -tag -width Er
 .It Bq Er ENOTDIR
 A component of the path prefix is not a directory.
@@ -126,9 +137,11 @@ points outside the process's allocated address space.
 An
 .Tn I/O
 error occurred while reading from or writing to the file system.
+.It Bq Er ENOTSUP
+The operation isn't supported by the filesystem.
 .El
 .Pp
-.Fn Fchflags
+.Fn fchflags
 will fail if:
 .Bl -tag -width Er
 .It Bq Er EBADF
@@ -145,10 +158,15 @@ The file resides on a read-only file system.
 An
 .Tn I/O
 error occurred while reading from or writing to the file system.
+.It Bq Er ENOTSUP
+The operation isn't supported by the filesystem.
 .El
 .Sh SEE ALSO
 .Xr chflags 1 ,
-.Xr init 8
+.Xr fflagstostr 3 ,
+.Xr lchflags 3 ,
+.Xr strtofflags 3 ,
+.Xr launchd 8
 .Sh HISTORY
 The
 .Fn chflags