File::ExtAttr is a Perl module providing access to the extended attributes of files.
Perl C Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
inc/Devel
lib/File
scripts
t
.gitignore
Changes
ExtAttr.xs
MANIFEST
MANIFEST.SKIP
META.yml
Makefile.PL
README
TODO
UBUNTU_BITS
UBUNTU_REMOUNT
extattr_bsd.c
extattr_bsd.h
extattr_linux.c
extattr_linux.h
extattr_macosx.c
extattr_macosx.h
extattr_os.h
extattr_solaris.c
extattr_solaris.h
flags.c
flags.h
portable.h
ppport.h
typemap

README

File-ExtAttr version 1.10
=========================

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

On Linux, you will need to have the C library dev packages installed.
On Debian this is libc6-dev. This should provide a header at <sys/xattr.h>.
If your C library doesn't support xattrs, you will need to install the package
that provides the header files <attr/attributes.h> and <attr/xattr.h>. 
On Debian this is libattr1-dev.
On Fedora you can install these as follows:

  yum -y install libattr-devel

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, 2009, 2011, 2012 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.