Annotation of coherent/a/usr/man/COHERENT/chmod.c, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: chmod                        Command                        chmod
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Change the modes of a file
        !             9: 
        !            10: cchhmmoodd +_m_o_d_e_s _f_i_l_e
        !            11: cchhmmoodd -_m_o_d_e_s _f_i_l_e
        !            12: 
        !            13: The COHERENT  system assigns a mode to every  file, to govern how
        !            14: users access  the file.  The mode grants  or denies permission to
        !            15: read, write, or execute a file.
        !            16: 
        !            17: The mode grants permission separately  to the owner of a file, to
        !            18: users  from the  owner's group,  and to all  other users.   For a
        !            19: directory,  execute  permission grants  or  denies  the right  to
        !            20: search the  directory, whereas write permission  grants or denies
        !            21: the right to create and remove files.
        !            22: 
        !            23: In addition,  the mode contains  three bits that  perform special
        !            24: tasks: the  set-user-id bit, the set-group-id  bit, and the save-
        !            25: text or  ``sticky'' bit.  See the Lexicon  entry for the COHERENT
        !            26: system call chmod for more information on how to use these bits.
        !            27: 
        !            28: The command chmod  changes the permissions of each specified file
        !            29: according  to the  given mode  argument.  mode  may be  either an
        !            30: octal number or a symbolic mode.  Only the owner of a file or the
        !            31: superuser may  change a file's mode.  Only  the superuser may set
        !            32: the sticky bit.
        !            33: 
        !            34: A symbolic  mode may have  the following form.   No spaces should
        !            35: separate the fields in the actual mode specification.
        !            36: 
        !            37: 
        !            38:              [_w_h_i_c_h] _h_o_w _p_e_r_m ... [, ...]
        !            39: 
        !            40: 
        !            41: which specifies the permissions that are affected by the command.
        !            42: It may consist of one or more of the following:
        !            43: 
        !            44: 
        !            45:              aa       All permissions, equivalent to ggoouu
        !            46:              gg       Group permissions
        !            47:              oo       Other permissions
        !            48:              uu       User permissions
        !            49: 
        !            50: 
        !            51: If no which is given, a  is assumed and chmod uses the file crea-
        !            52: tion mask, as described in umask.
        !            53: 
        !            54: how specifies how the permissions will be changed.  It can be
        !            55: 
        !            56: 
        !            57:              =       Set permissions
        !            58:              +       Add permissions
        !            59:              -       Take away permissions
        !            60: 
        !            61: 
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: chmod                        Command                        chmod
        !            70: 
        !            71: 
        !            72: 
        !            73: 
        !            74: perm specifies which  permissions are changed.  It may consist of
        !            75: one or more of the following:
        !            76: 
        !            77: 
        !            78:              gg       Current group permissions
        !            79:              oo       Current other permissions
        !            80:              rr       Read permission
        !            81:              ss       Setuid upon execution
        !            82:              tt       Save text (sticky bit)
        !            83:              uu       Current user permissions
        !            84:              ww       Write permission
        !            85:              xx       Execute permission
        !            86: 
        !            87: 
        !            88: Multiple _h_o_w/_p_e_r_m pairs have the same which applied to them.  One
        !            89: or more  specifications separated by  commas tell chmod  to apply
        !            90: each specification to the file successively.
        !            91: 
        !            92: The octal modes (see stat) are as follows:
        !            93: 
        !            94: 
        !            95:          0044000000    Set user id upon execution
        !            96:          0022000000    Set group id upon execution
        !            97:          0011000000    Sticky bit (save text)
        !            98:          0000440000    Owner read permission
        !            99:          0000220000    Owner write permission
        !           100:          0000110000    Owner execute permission
        !           101:          0000004400    Group read permission
        !           102:          0000002200    Group write permission
        !           103:          0000001100    Group execute permission
        !           104:          0000000044    Others read permission
        !           105:          0000000022    Others write permission
        !           106:          0000000011    Others execute permission
        !           107: 
        !           108: 
        !           109: An octal mode argument to  chmod is obtained by oring the desired
        !           110: mode bits together.
        !           111: 
        !           112: ***** Examples *****
        !           113: 
        !           114: The first  example below sets  the owner's permissions  to read +
        !           115: write +  execute, and the  group and other permissions  to read +
        !           116: execute.   The   second  example  adds   execute  permission  for
        !           117: everyone.
        !           118: 
        !           119: 
        !           120:     chmod u=rwx,go=rx file
        !           121:     chmod +x file
        !           122: 
        !           123: 
        !           124: ***** See Also *****
        !           125: 
        !           126: chgrp, chown, commands, ls, stat, umask
        !           127: 
        !           128: 
        !           129: 
        !           130: COHERENT Lexicon                                           Page 2
        !           131: 
        !           132: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.