summaryrefslogtreecommitdiff
path: root/usr.bin/chflags/chflags.1
diff options
context:
space:
mode:
authoruwe <uwe@NetBSD.org>2023-05-19 19:50:59 +0000
committeruwe <uwe@NetBSD.org>2023-05-19 19:50:59 +0000
commitfbb6e912fb5ddcd554e71cdc7c3b32eabfa66e12 (patch)
treec562735c497095690e0f0cc786b996b39170b069 /usr.bin/chflags/chflags.1
parent32580573e1b2f5e59acdea25184e3905d16c54af (diff)
chflags(1): minor markup fixes
Diffstat (limited to 'usr.bin/chflags/chflags.1')
-rw-r--r--usr.bin/chflags/chflags.143
1 files changed, 21 insertions, 22 deletions
diff --git a/usr.bin/chflags/chflags.1 b/usr.bin/chflags/chflags.1
index b5662070491..e76da495b46 100644
--- a/usr.bin/chflags/chflags.1
+++ b/usr.bin/chflags/chflags.1
@@ -1,4 +1,4 @@
-.\" $NetBSD: chflags.1,v 1.27 2023/05/19 16:14:00 jschauma Exp $
+.\" $NetBSD: chflags.1,v 1.28 2023/05/19 19:50:59 uwe Exp $
.\"
.\" Copyright (c) 1989, 1990, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@@ -57,7 +57,7 @@ as specified by the
operand.
.Pp
The options are as follows:
-.Bl -tag -width Ds
+.Bl -tag -width Fl
.It Fl d
If the change requested would not alter the
flags currently set for
@@ -67,12 +67,12 @@ then attempt no change operation.
If the
.Fl R
option is specified, symbolic links on the command line are followed.
-(Symbolic links encountered in the tree traversal are not followed.)
+Symbolic links encountered in the tree traversal are not followed.
.It Fl h
If the
.Ar file
or a file encountered during directory traversal is a symbolic link,
-the file flags of the link itself is changed.
+the file flags of the link itself are changed.
.It Fl L
If the
.Fl R
@@ -84,33 +84,32 @@ option is specified, no symbolic links are followed.
.It Fl R
Change the file flags for the file hierarchies rooted
in the
-.Ar files
+.Ar file\^ Ns s
instead of just the
-.Ar files
+.Ar file\^ Ns s
themselves.
.El
.Pp
Flags are a comma separated list of keywords.
The following keywords are currently defined:
-.Bl -column -offset indent "Keyword " "system append-only" "Permission"
+.\" XXX: list the actual chflags(2) macro names
+.Bl -column -offset indent ".Sy Keyword" "system append-only"
.It Sy Keyword Ta Sy Flag Ta Sy Permission
-.It arch Ta archived Ta super-user only
-.It opaque Ta opaque Ta owner or super-user
-.It nodump Ta nodump Ta owner or super-user
-.It sappnd Ta system append-only Ta super-user only
-.It schg Ta system immutable Ta super-user only
-.It uappnd Ta user append-only Ta owner or super-user
-.It uchg Ta user immutable Ta owner or super-user
+.It Li arch Ta archived Ta super-user only
+.It Li opaque Ta opaque Ta owner or super-user
+.It Li nodump Ta nodump Ta owner or super-user
+.It Li sappnd Ta system append-only Ta super-user only
+.It Li schg Ta system immutable Ta super-user only
+.It Li uappnd Ta user append-only Ta owner or super-user
+.It Li uchg Ta user immutable Ta owner or super-user
.El
.Pp
Putting the letters
-.Dq no
-before an option causes the flag to be turned off.
-For example:
-.Bl -tag -offset indent -width "nouchg"
-.It nouchg
-the immutable bit should be cleared
-.El
+.Sq Cm no
+before a keyword causes the flag to be turned off.
+For example,
+.Li nouchg
+requests the immutable bit should be cleared.
.Pp
The
.Fl H ,
@@ -138,7 +137,7 @@ devices to be changed except by the super-user.
.Pp
Note that the ability to clear certain flags is
dependent on the current kernel
-.Em securelevel .
+.Va securelevel .
See
.Xr secmodel_securelevel 9
for details.