/
README
74 lines (52 loc) · 2.2 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
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.