X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/91447636331957f3d9b5ca5b508f07c526b0074d..bca245acd4c03fd752d1a45f011ad495e60fe53d:/bsd/man/man2/chflags.2 diff --git a/bsd/man/man2/chflags.2 b/bsd/man/man2/chflags.2 index 66a036bbb..6bea184c4 100644 --- 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