chflags(1): xref stat_flags(3)

revert my previous commit as there is no agreement on it being either desired
or appropriate

chflags(1): fix wrong markup in previous

Briefly describe the 'arch' and 'nodump' flags.

chflags(1): minor markup fixes

We mention secmodel_securelevel(9) in the details, so might as well add it to
SEE ALSO.

Note that the ability to change certain flags depends on the current securelevel.

If chown and chgrp can grow -d flags to suppress performing the
operation when it will have no effect (other than changing the
inode's ctime value) then chmod and chflags should also have -d
flags for the same purpose. Make it so.

In all man pages that say:

The -H, -L and -P options are ignored unless the -R option is
specified. In addition, these options override each other and the
command's actions are determined by the last one specified.

Add:

The default is as if the -P option had been specified.

- Sort option list;
- create separate section, use `.Ex' macro for, and put in the
correct location exit status information;
- bump date.

From Bug Hunting.

- Remove incorrect use of `.Em' (this is a presentation term and
should not be used for stylistically decorating technical terms);
- remove superfluous `.Pp' macro (fixes mandoc(1) warning).

From Bug Hunting.

branches: 1.21.6; 1.21.12;
Missing -width for .Bl -tag

Clarify the wording in the table.

Use a table instead of a literal .Bd "list".

Add some markup to improve clarity.

branches: 1.17.18; 1.17.28; 1.17.40; 1.17.44; 1.17.46;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

add xref to init where security levels are discussed, more should probably
be written in this manpage on this subject.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Whitespace cleanup.

"compact" is no valid .Bd argument, "-compact" is (groff-1.17.2-found).

Nit.

Describe -h option and xref lchflags.

implement lchflags(2), which does the chflags(2) dance without following
symlinks, and thus can operate on symlinks. remove a bogus comment in
chflags(1) that claims symlinks do not have file flags.

XXX: todo -- make chflags(1) use lchflags(2) when given the right options.

Document kernel behaviour: flags on block and character devices cannot
be changed except by the superuser. [Commit by cjs.]

Xref dump(8).

highlight that ls -o lists the flags

WARNSify, fix .Nm usage

Note that the 'arch' flag may only be changed by the superuser; from
Paul Boven in PR kern/3491.

Sync with 4.4lite2

Document the `arch' flag. Fix the test of the getopt(3) return value.

Changed to conform to NetBSD's new RCS Id convention.

branches: 1.1.1;
Initial revision