File: README

package info (click to toggle)
libfile-extattr-perl 1.09-7
  • links: PTS
  • area: main
  • in suites: forky, sid
  • size: 364 kB
  • sloc: ansic: 1,864; perl: 1,221; makefile: 42
file content (71 lines) | stat: -rw-r--r-- 2,000 bytes parent folder | download | duplicates (3)
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
File-ExtAttr version 1.09
=========================

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 install the package that provides
the <sys/xattr.h> header file. On Fedora you can install
these as follows:

  dnf -y install glibc-headers

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.