Imported Upstream version 2.4.46
[platform/upstream/attr.git] / doc / INSTALL
1 This document describes how to configure and build the extended
2 attribute library and utility from source, and how to install them.
3
4 0. If you have the binary rpm, simply install it and skip to step 2 (below).
5    The rpm command to do this is:
6         # rpm -Uvh attr
7
8    The Debian command to do this is:
9         # dpkg -i attr
10    or, if you have apt configured (don't need the binary package):
11         # apt-get install attr
12
13 1. Configure, build and install the package
14
15    The "attr" package uses autoconf/configure and expects a GNU build
16    environment (your platform must at least have both autoconf and gmake). 
17
18    If you just want to spin an RPM and/or tar file, use the Makepkgs
19    script in the top level directory. This will configure and build
20    the package and leave binary and src RPMs in the build/rpm
21    directory.  It will also leave a tar file in the build/tar
22    directory.
23
24        # ./Makepkgs verbose
25
26    If you want to build the package and install it manually, use the
27    following steps:
28
29        # make configure  (or run autoconf; ./configure)
30        # make
31        # su root
32        # make install install-lib
33
34    Note that there are so many "install" variants out there that we
35    wrote our own script (see "install-sh" in the top level directory).
36
37    If you wish to turn off debugging asserts in the command build and
38    turn on the optimizer then set the shell environment variables:
39
40         OPTIMIZER=-O
41         DEBUG=-DNDEBUG
42
43    before running make configure or Makepkgs.
44
45 2. How to Contribute
46
47    See the README file in this directory for details about how to
48    contribute to the Linux extended attributes project.