1 files changed, 55 insertions, 13 deletions

diff --git a/bin/chflags/chflags.1 b/bin/chflags/chflags.1
index 801e78ae0420..57d35aca4dd2 100644
--- a/bin/chflags/chflags.1
+++ b/bin/chflags/chflags.1
@@ -32,7 +32,7 @@
 .\"	@(#)chflags.1	8.4 (Berkeley) 5/2/95
 .\" $FreeBSD$
 .\"
-.Dd May 14, 2005
+.Dd March 3, 2006
 .Dt CHFLAGS 1
 .Os
 .Sh NAME
@@ -85,24 +85,24 @@ The flags are specified as an octal number or a comma separated list
 of keywords.
 The following keywords are currently defined:
 .Pp
-.Bl -tag -offset indent -width ".Ar opaque"
-.It Ar arch , archived
+.Bl -tag -offset indent -width ".Cm opaque"
+.It Cm arch , archived
 set the archived flag (super-user only)
-.It Ar opaque
+.It Cm opaque
 set the opaque flag (owner or super-user only)
-.It Ar nodump
+.It Cm nodump
 set the nodump flag (owner or super-user only)
-.It Ar sappnd , sappend
+.It Cm sappnd , sappend
 set the system append-only flag (super-user only)
-.It Ar schg , schange , simmutable
+.It Cm schg , schange , simmutable
 set the system immutable flag (super-user only)
-.It Ar sunlnk , sunlink
+.It Cm sunlnk , sunlink
 set the system undeletable flag (super-user only)
-.It Ar uappnd , uappend
+.It Cm uappnd , uappend
 set the user append-only flag (owner or super-user only)
-.It Ar uchg , uchange , uimmutable
+.It Cm uchg , uchange , uimmutable
 set the user immutable flag (owner or super-user only)
-.It Ar uunlnk , uunlink
+.It Cm uunlnk , uunlink
 set the user undeletable flag (owner or super-user only)
 .El
 .Pp
@@ -114,12 +114,45 @@ from a keyword causes the flag to be cleared.
 For example:
 .Pp
 .Bl -tag -offset indent -width "nouchg" -compact
-.It Ar nouchg
+.It Cm nouchg
 clear the user immutable flag (owner or super-user only)
-.It Ar dump
+.It Cm dump
 clear the nodump flag (owner or super-user only)
 .El
 .Pp
+A few of the octal values include:
+.Bl -tag -offset indent -width ".Li 10"
+.It Li 0
+Clear all file flags.
+.It Li 1
+Translates to the
+.Cm nodump
+keyword.
+.It Li 2
+Translates to the
+.Cm uchg
+keyword.
+.It Li 3
+Translates to the
+.Cm uchg , nodump
+keywords.
+.It Li 4
+Translates to the
+.Cm uappnd
+keyword.
+.It Li 10
+Translates to the
+.Cm opaque
+keyword.
+.It Li 20
+translates to the
+.Cm uunlnk
+keyword.
+.El
+.Pp
+Other combinations of keywords may be placed by using
+the octets assigned; however, these are the most notable.
+.Pp
 Unless the
 .Fl H ,
 .Fl L ,
@@ -140,6 +173,14 @@ In addition, these options override each other and the
 command's actions are determined by the last one specified.
 .Pp
 You can use "ls -lo" to see the flags of existing files.
+.Pp
+Note that the ability to change certain flags is dependent
+on the current kernel
+.Va securelevel
+setting.
+See
+.Xr security 7
+for more information on this setting.
 .Sh EXIT STATUS
 .Ex -std
 .Sh SEE ALSO
@@ -147,6 +188,7 @@ You can use "ls -lo" to see the flags of existing files.
 .Xr chflags 2 ,
 .Xr stat 2 ,
 .Xr fts 3 ,
+.Xr security 7 ,
 .Xr symlink 7
 .Sh HISTORY
 The