xnu-3248.20.55.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 70cb5097bb8cf7556c936058dfcef2592c223c76..8df34340760043da4b7a4c2093bd0aa2e8c3c479 100644 (file)
--- a/bsd/man/man2/chflags.2
+++ b/bsd/man/man2/chflags.2
@@ -44,9 +44,9 @@
 .Fd #include <sys/stat.h>
 .Fd #include <unistd.h>
 .Ft int
 .Fd #include <sys/stat.h>
 .Fd #include <unistd.h>
 .Ft int

-.Fn chflags "const char *path"  "u_long flags"
+.Fn chflags "const char *path"  "u_int flags"

 .Ft int
 .Ft int

-.Fn fchflags "int fd" "u_long flags"
+.Fn fchflags "int fd" "u_int flags"

 .Sh DESCRIPTION
 The file whose name
 is given by
 .Sh DESCRIPTION
 The file whose name
 is given by


@@ -60,15 +60,19 @@ The flags specified are formed by
 .Em or Ns 'ing
 the following values
 .Pp
 .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 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
 .It SF_IMMUTABLE
 The file may not be changed.
 .It SF_APPEND


@@ -76,12 +80,15 @@ The file may only be appended to.
 .El
 .Pp
 The
 .El
 .Pp
 The

-.Dq UF_IMMUTABLE
+.Dq UF_IMMUTABLE ,
+.Dq UF_APPEND ,
+.Dq UF_OPAQUE ,

 and
 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
 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
 .Dq SF_IMMUTABLE
 and
 .Dq SF_APPEND


@@ -89,7 +96,7 @@ 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
 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
+.Xr launchd 8

 for details.)
 .Sh RETURN VALUES
 Upon successful completion, a value of 0 is returned.
 for details.)
 .Sh RETURN VALUES
 Upon successful completion, a value of 0 is returned.


@@ -98,7 +105,7 @@ Otherwise, -1 is returned and the global variable
 is set to indicate the error.
 .Sh ERRORS
 .Fn Chflags
 is set to indicate the error.
 .Sh ERRORS
 .Fn Chflags

-will fail it:
+will fail if:

 .Bl -tag -width Er
 .It Bq Er ENOTDIR
 A component of the path prefix is not a directory.
 .Bl -tag -width Er
 .It Bq Er ENOTDIR
 A component of the path prefix is not a directory.


@@ -126,6 +133,8 @@ points outside the process's allocated address space.
 An
 .Tn I/O
 error occurred while reading from or writing to the 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
 .Pp
 .Fn Fchflags
 .El
 .Pp
 .Fn Fchflags


@@ -145,10 +154,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.
 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 ,
 .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
 .Sh HISTORY
 The
 .Fn chflags