home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / gnu / fileutils-3.9-bin.lha / man / cat1 / chmod.0 < prev    next >
Text File  |  1993-12-07  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. CHMOD(1L)                                               CHMOD(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        chmod - change the access permissions of files
  9.  
  10. SSYYNNOOPPSSIISS
  11.        cchhmmoodd   [-Rcfv]   [--recursive]   [--changes]   [--silent]
  12.        [--quiet] [--verbose] [--help] [--version] mode file...
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        This manual page  documents  the  GNU  version  of  cchhmmoodd.
  16.        cchhmmoodd changes the permissions of each given file according
  17.        to _m_o_d_e, 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.        cchhmmoodd ignores symbolic links; the cchhmmoodd 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.    OOPPTTIIOONNSS
  76.        _-_c_, _-_-_c_h_a_n_g_e_s
  77.               Verbosely describe  only  files  whose  permissions
  78.               actually change.
  79.  
  80.        _-_f_, _-_-_s_i_l_e_n_t_, _-_-_q_u_i_e_t
  81.               Do  not print error messages about files whose per-
  82.               missions cannot be changed.
  83.  
  84.        _-_v_, _-_-_v_e_r_b_o_s_e
  85.               Verbosely describe changed permissions.
  86.  
  87.        _-_R_, _-_-_r_e_c_u_r_s_i_v_e
  88.               Recursively change permissions of  directories  and
  89.               their contents.
  90.  
  91.        _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
  92.               tus.
  93.  
  94.        _-_-_v_e_r_s_i_o_n
  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.