NAME
    Filesys::Ext2 - Interface to e2fs filesystem attributes

SYNOPSIS
            use Filesys::Ext2 qw(chattr lsattr);
            $mode = lsattr("/etc/passwd");
            chattr("+aud", "/etc/passwd");
            #or equivalently
            #chattr($mode|0x0062, "/etc/passwd");

DESCRIPTION
    `chattr($mask, @files)'
            Change the mode of *@files* to match *$mask*. *$mask*
            may be a symbolic mode or a bitmask.

    `lsattr($file)'
            In list context it returns a list containing symbols
            representing the symbolic mode of *$file*. In scalar
            context it returns a bitmask.

    `lstat($file)'
            Same as `CORE::lstat', but appends the numerical
            attribute bitmask.

    `stat($file)'
            Same as `CORE::stat', but appends the numerical
            attribute bitmask.

    `calcSymMask'
            Accepts a bitmask and returns the symbolic mode. In list
            context it returns a symbol list like lsattr, in scalar
            mode it returns a string that matches the --------
            region of lsattr(1) (akin to that of ls -l e.g. drwxr-x-
            --)

SEE ALSO
    chattr(1), lsattr(1)

NOTES
    Of course, this would be more efficient if it were an XSUB.

    The bit mappings for attributes, from ext2_fs.h

            s #define EXT2_SECRM_FL           0x00000001 /* Secure deletion */
            u #define EXT2_UNRM_FL            0x00000002 /* Undelete */
            c #define EXT2_COMPR_FL           0x00000004 /* Compress file */
            S #define EXT2_SYNC_FL            0x00000008 /* Synchronous updates */
            i #define EXT2_IMMUTABLE_FL       0x00000010 /* Immutable file */
            a #define EXT2_APPEND_FL          0x00000020 /* writes to file may only append */
            d #define EXT2_NODUMP_FL          0x00000040 /* do not dump file */
            A #define EXT2_NOATIME_FL         0x00000080 /* do not update atime */

AUTHOR
    Jerrad Pierce <belg4mit@mit.edu>, <webmaster@pthbb.org>