chattr(1)                                                            chattr(1)


NAME
     chattr, lsattr - change or list file attributes

SYNOPSIS
     chattr [-R|-D] [+-rdtPn] file ...
     lsattr [-R|-D] file ...


DESCRIPTION
     chattr changes the file attributes on an XFS filesystem.  This mechanism
     enables and disables particular properties for individual files and
     directories.

     The  operator  `+'  causes  the  selected attributes to be added to the
     existing attributes of the files; `-'  causes them  to  be  removed.

     The letters `rdtPn' select the new attributes for the files:  realtime
     (r), no dump (d), realtime inheritance (t), project inheritance (P), and
     no symbolic links (n).

     lsattr lists the current set of attributes of a file.

OPTIONS
     -R   Recursively change or list attributes of directories and their
          contents.  Symbolic links encountered during recursive directory
          traversals are ignored.

     -D   Recursively change or list attributes of directories only.

ATTRIBUTES
     (r)       The file is a realtime file.

     (d)       The file should be skipped by backup utilities.

     (t)       Realtime inheritance bit - new files created in the directory
               will be automatically realtime, and new directories created in
               the directory will inherit the inheritance bit.

     (P)       New files created in the directory will have the project ID of
               the directory, and new directories created in the directory
               will inherit the inheritance bit.

     (n)       Symbolic links cannot be created in this directory.

EXAMPLES
     Some examples of modifying a files attributes:

          chattr +d file

          chattr -d file


     Firstly mark file to be ignored by xfsdump(1M), then clear the flag, such
     that file is backed up on subsequent dumps.

SEE ALSO
     fcntl(2), xfs(4).


                                                                        Page 2