diff options
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/chmod.1')
| -rw-r--r-- | upstream/opensuse-tumbleweed/man1/chmod.1 | 36 |
1 files changed, 30 insertions, 6 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/chmod.1 b/upstream/opensuse-tumbleweed/man1/chmod.1 index c0869f14..14aa4375 100644 --- a/upstream/opensuse-tumbleweed/man1/chmod.1 +++ b/upstream/opensuse-tumbleweed/man1/chmod.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CHMOD "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CHMOD "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME chmod \- change file mode bits .SH SYNOPSIS @@ -66,17 +66,19 @@ file's group, with the same values; and the fourth for other users not in the file's group, with the same values. .PP .B chmod -never changes the permissions of symbolic links; the +doesn't change the permissions of symbolic links; the .B chmod -system call cannot change their permissions. This is not a problem -since the permissions of symbolic links are never used. +system call cannot change their permissions on most systems, +and most systems ignore permissions of symbolic links. However, for each symbolic link listed on the command line, .B chmod changes the permissions of the pointed-to file. In contrast, .B chmod ignores symbolic links encountered during recursive directory -traversals. +traversals. Options that modify this behavior are described in the +.B OPTIONS +section. .SH "SETUID AND SETGID BITS" .B chmod clears the set-group-ID bit of a @@ -133,6 +135,13 @@ suppress most error messages \fB\-v\fR, \fB\-\-verbose\fR output a diagnostic for every file processed .TP +\fB\-\-dereference\fR +affect the referent of each symbolic link, +rather than the symbolic link itself +.TP +\fB\-h\fR, \fB\-\-no\-dereference\fR +affect each symbolic link, rather than the referent +.TP \fB\-\-no\-preserve\-root\fR do not treat '/' specially (the default) .TP @@ -145,6 +154,21 @@ RFILE is always dereferenced if a symbolic link. .TP \fB\-R\fR, \fB\-\-recursive\fR change files and directories recursively +.PP +The following options modify how a hierarchy is traversed when the \fB\-R\fR +option is also specified. If more than one is specified, only the final +one takes effect. '\-H' is the default. +.TP +\fB\-H\fR +if a command line argument is a symbolic link +to a directory, traverse it +.TP +\fB\-L\fR +traverse every symbolic link to a directory +encountered +.TP +\fB\-P\fR +do not traverse any symbolic links .TP \fB\-\-help\fR display this help and exit @@ -160,7 +184,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. |