diff options
| author |  axel <axel@liljencrantz.se> | 2005-10-23 22:14:29 +1000 |
|---|---|---|
| committer | axel <axel@liljencrantz.se> | 2005-10-23 22:14:29 +1000 |
| commit | f8de9de13de17a4dadab7d2fb1c2094c6a5b105c (patch) | |
| tree | 6677aaae8134e12db5231432fbf19d05c7a91cf6 /doc_src/umask.txt | |
| parent | ba6ad5025e7792471a2b31c3c5409d771007b19d (diff) | |
Code cleanups and API documentation updates
darcs-hash:20051023121429-ac50b-6ff72171b5a90b6e398bd84e748388c1dba831d9.gz
Diffstat (limited to 'doc_src/umask.txt')
| -rw-r--r-- | doc_src/umask.txt | 27 |
1 files changed, 24 insertions, 3 deletions
diff --git a/doc_src/umask.txt b/doc_src/umask.txt index cda5ff83..b355135b 100644 --- a/doc_src/umask.txt +++ b/doc_src/umask.txt @@ -10,9 +10,30 @@ With no argument, the current file-creation mask is printed, if an argument is specified, it is the new file creation mask. The mask may be specified as an octal number, in which case it is interpreted as the rights that should be masked away, i.e. it is the inverse of the -file permissions any new files will have. If a synbolic mask is -specified, the actual file permission bits, and not the inverse, are -specified. +file permissions any new files will have. + +If a symbolic mask is specified, the actual file permission bits, and +not the inverse, should be specified. A symbolic mask is a comma +separated list of rights. Each right consists of three parts: + +- The first part specifies to whom this set of right applies, and can +be one of \c u, \c g, \c o or \c a, where \c u specifies the user who +owns the file, \c g specifies the group owner of the file, \c o +specifiec other users rights and \c a specifies all three should be +changed. +- The second part of a right specifies the mode, and can be one of \c +=, \c + or \c -, where \c = specifies that the rights should be set to +the new value, \c + specifies that the specified right should be added +to those previously specified and \c - specifies that the specified +rights should be removed from those previously specified. +- The third part of a right specifies what rights should be changed +and can be any compination of \c r, \c w and \c x, representing +read, write and execute rights. + +If the first and second parts are skipped, they are assumed to be \c a +and \c =, respectively. As an example, <code>r,u+w</code> means all +users should have read access and the file owner should also have +write access. - <code>-h</code> or <code>--help</code> print this message - <code>-S</code> or <code>--symbolic</code> prints the file-creation mask in symbolic form instead of octal form. Use <code>man chmod</code> for more information. |