Filesys::Ext2 - Interface to ext2 and ext3 filesystem attributes

NAME

Filesys::Ext2 - Interface to ext2 and ext3 filesystem attributes

SYNOPSIS

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

DESCRIPTION

You may specify the path of the e2fsprogs upon use

  use Filesys::Ext2 {PATH=>'/path/to/binaries'};

Otherwise the module will use the default path /usr/bin/

chattr($mask, @files)
Change the mode of @files to match $mask. $mask may be a bitmask or symbolic mode eg; 
  =DIE
  +cad
  -s-i

Throws an exception upon failure.

lsattr(@files)
Returns bitmasks respresenting the attributes of @files.

Throws an exception upon failure.

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($mask)
Accepts a bitmask and returns the symbolic mode. In list context it returns a symbol list like lsattr, in scalar context it returns a string that matches the - region of lsattr(1) eg; 
  s-----A------

SEE ALSO

chattr(1), lsattr(1)

NOTES

Ideally this would be implemented with XS, maybe someday.

The bit mappings for attributes, from other/ext2_fs.h

  1. x00000001 == s
    Secure deletion

  2. x00000002 == u
    Undelete

  3. x00000004 == c
    Compress file

  4. x00000008 == S
    Synchronous updates

  5. x00000010 == i
    Immutable file

  6. x00000020 == a
    Writes to file may only append

  7. x00000040 == d
    Do not dump file

  8. x00000080 == A
    Do not update atime

  9. x00000100 == Z
    Dirty compressed data

    Not user modifiable.

  10. x00000400 == X
    Access raw compressed data

    Not (currently) user modifiable.

  11. x00000800 == E
    Compression error.

    Not user modifiable.

  12. x00001000 == I
    btree format dir / hash-indexed directory

    Not user modifiable.

  13. x00004000 == j
    File data should be journaed

  14. x00008000 == t
    File tail should not be merged

  15. x00010000 == D
    Synchronous directory modifications

  16. x00020000 == T
    Top of directory hierarchies

AUTHOR

Jerrad Pierce <jpierce@cpan.org>

 Filesys::Ext2 - Interface to ext2 and ext3 filesystem attributes