home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / doc / chmod.man < prev    next >
Text File  |  1993-06-13  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. CHMOD(1L)                                               CHMOD(1L)
  5.  
  6.  
  7. NAME
  8.        chmod - change the access permissions of files
  9.  
  10. SYNOPSIS
  11.        chmod   [-Rcfv]   [--recursive]   [--changes]   [--silent]
  12.        [--quiet] [--verbose] [--help] [--version] mode file...
  13.  
  14. DESCRIPTION
  15.        This manual page  documents  the  GNU  version  of  chmod.
  16.        chmod changes the permissions of each given file according
  17.        to mode, which can be either a symbolic representation  of
  18.        changes  to  make, or an octal number representing the bit
  19.        pattern for the new permissions.
  20.  
  21.        The     format     of     a     symbolic      mode      is
  22.        `[ugoa...][[+-=][rwxXstugo...]...][,...]'.   Multiple sym-
  23.        bolic operations can be given, separated by commas.
  24.  
  25.        A combination of the letters `ugoa' controls which  users'
  26.        access  to  the file will be changed: the user who owns it
  27.        (u), other users in the file's group (g), other users  not
  28.        in  the  file's  group  (o), or all users (a).  If none of
  29.        these are given, the effect is as if `a' were  given,  but
  30.        bits that are set in the umask are not affected.
  31.  
  32.        The  operator  `+'  causes  the permissions selected to be
  33.        added to the existing permissions of each file; `-' causes
  34.        them  to  be  removed;  and `=' causes them to be the only
  35.        permissions that the file has.
  36.  
  37.        The letters `rwxXstugo' select the new permissions for the
  38.        affected  users:  read  (r), write (w), execute (or access
  39.        for directories) (x), execute only if the file is a direc-
  40.        tory  or already has execute permission for some user (X),
  41.        set user or group ID on execution (s), save  program  text
  42.        on swap device (t), the permissions that the user who owns
  43.        the file currently has for it (u),  the  permissions  that
  44.        other  users  in the file's group have for it (g), and the
  45.        permissions that other users not in the file's group  have
  46.        for it (o).
  47.  
  48.        A  numeric  mode  is  from one to four octal digits (0-7),
  49.        derived by adding up the bits with values  4,  2,  and  1.
  50.        Any  omitted  digits are assumed to be leading zeros.  The
  51.        first digit selects the set user ID (4) and set  group  ID
  52.        (2)  and save text image (1) attributes.  The second digit
  53.        selects permissions for the user who owns the  file:  read
  54.        (4), write (2), and execute (1); the third selects permis-
  55.        sions for other users in the file's group, with  the  same
  56.        values;  and  the fourth for other users not in the file's
  57.        group, with the same values.
  58.  
  59.        chmod ignores symbolic links; the chmod system call cannot
  60.        change their permissions.  This is not a problem since the
  61.  
  62.  
  63.  
  64. FSF                     GNU File Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CHMOD(1L)                                               CHMOD(1L)
  71.  
  72.  
  73.        permissions of symbolic links are never used.
  74.  
  75.    OPTIONS
  76.        -c, --changes
  77.               Verbosely describe  only  files  whose  permissions
  78.               actually change.
  79.  
  80.        -f, --silent, --quiet
  81.               Do  not print error messages about files whose per-
  82.               missions cannot be changed.
  83.  
  84.        -v, --verbose
  85.               Verbosely describe changed permissions.
  86.  
  87.        -R, --recursive
  88.               Recursively change permissions of  directories  and
  89.               their contents.
  90.  
  91.        --help Print a usage message and exit with a non-zero sta-
  92.               tus.
  93.  
  94.        --version
  95.               Print version information on  standard  error  then
  96.               exit.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FSF                     GNU File Utilities                      2
  131.  
  132.  
  133.