File-ExtAttr version 1.08 ========================= File::ExtAttr is a Perl module providing access to the extended attributes of files. Extended attributes are metadata associated with a file. Examples are access control lists (ACLs) and other security parameters. But users can add their own key=value pairs. Extended attributes may not be supported by your operating system. This module is aimed at Linux, Unix or Unix-like operating systems (e.g.: Mac OS X, FreeBSD, NetBSD). Extended attributes may also not be supported by your filesystem or require special options to be enabled for a particular filesystem (e.g. "mount -o user_xattr /dev/hda1 /some/path"). Please see the POD documentation for more detailed information ("perldoc File::ExtAttr"). INSTALLATION To install this module type the following: perl Makefile.PL make make test make install Installation requires a C compiler. "make test" will fail if the filesystem you are building and running the test suite does not support extended attributes. You can use the "ATTR_TEST_DIR" environment variable to make the test suite use a different file system, e.g.: mkdir -p /path/to/somewhere/with/extattr/test-dir export ATTR_TEST_DIR=/path/to/somewhere/with/extattr/test-dir make test DEPENDENCIES This module requires these other modules: Carp Scalar::Util This module's test suite is enhanced by the presence of the following modules: Test::Distribution Test::Pod File::Find::Rule Module::CoreList COPYRIGHT AND LICENCE Copyright (C) 2005 by Kevin M. Goess Copyright (C) 2005, 2006, 2007, 2008 by Richard Dawe This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.5 or, at your option, any later version of Perl 5 you may have available.