~sircmpwn/ctools

a4d5fab8fd18ee90f2ec40bb84b83f107eb1c04b — Drew DeVault 2 years ago cda4cb8
chmod: improve man page
1 files changed, 7 insertions(+), 7 deletions(-)

M doc/chmod.1.scd
M doc/chmod.1.scd => doc/chmod.1.scd +7 -7
@@ 35,7 35,7 @@ The "who" part specifies the users affected by the change:
|  a
:  Update all permissions

The "who" part may be omitted, in which case *a* is the default.
The "who" part may be omitted, in such cases *a* is implied.

The "how" part specifies how to apply the change:



@@ 61,12 61,12 @@ that file. "u=w" will clear the "write" bit of the "user" permissions,
preventing anyone without direct ownership from writing to the file. "-x" will
prevent any user from executing the file. And so on.

In technical terms, the symbolic mode corresponds to bitwise operations
performed against the existing numeric file mode. The "who" part forms a mask,
the "how" part selects an operation, and the "what" part specifies the value to
apply. "g+rwx" will select 777 as the value, mask it with 070 (to affect the
group bits), then perform a bitwise OR with the file's existing mode to
determine the new file mode.
In technical terms, the symbolic mode represents a bitwise operation performed
against the existing numeric file mode. The "who" part forms a mask, the "how"
part selects an operation, and the "what" part specifies the value to apply.
"g+rwx" will select 777 as the value, mask it with 070 (to affect the group
bits), then perform a bitwise OR with the file's existing mode to determine the
new file mode.

## SPECIAL SYMBOLIC MODES