linux/ohmyzsh
1
0
Fork 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2025-12-12 01:52:31 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

fix(perms)!: change function name from fixperms to resetperms and document caution (#10686)

Browse source 
BREAKING CHANGE: function `fixperms` has been renamed to the more accurate `resetperms`.
Please read the README carefully before using it as it may badly reset the permissions.

Fixes #10648
Closes #10686
This commit is contained in:
Carlo Sala 2022-02-11 15:20:03 +01:00 • committed by Marc Cornellà
commit 62929263fa
No known key found for this signature in database
GPG key ID: 0314585E776A9C1B
2 changed files with 29 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

16
plugins/perms/README.md
View file

@ -10,6 +10,16 @@ plugins=(... perms)
## Usage
* `set755` recursively sets all given directories (default to .) to octal 755.
* `set644` recursively sets all given files (default to .) to octal 644.
* `fixperms` is a wrapper around `set755` and `set644` applied to a specified directory or the current directory otherwise. It also prompts prior to execution unlike the other two aliases.
> **CAUTION:** these functions are harmful if you don't know what they do.
- `set755`: sets the permission to octal 755 for all given directories and their child directories (by default, starting from the current directory).
- `set644`: sets the permission to octal 644 for all files of the given directory (by default, the current directory), recursively. It will only affect regular files (no symlinks).
- `resetperms` is a wrapper around `set755` and `set644` applied to a specified directory or the current directory otherwise.
It will set the permissions to 755 for directories, and 644 for files.
## Reference
- octal 644: _read and write_ for the owner, _read_ for the group and others users.
- octal 755: _read, write and execute_ permissions for the owner, and _read and execute_ for the group and others users.