Debian Codegraph @

INSTALL

raw
1 Installation Instructions
2 -------------------------
3
4 Usually all you have to do is:
5
6 perl Makefile.PL
7 make
8 make test
9 make install
10 make clean
11
12 If this fails, regard the following instructions step by step.
13 Note that this module does not support installation by the CPAN(++) module.
14
15 Options:
16
17 -> Support for Solaris VxFS should be added automatically if the module
18 is installed. If not, #define or #undef SOLARIS_VXFS in myconfig.h
19
20 -> If you want support for AFS, you need the OpenAFS package
21 (tested with OpenAFS on (SuSE) Linux, HP-UX10, Solaris 2.6, 2.8, AIX 4.3
22 and IRIX 6.5).
23 The Makefile.PL tries to detect automatically if AFS is preset on a
24 system. If that fails, edit the Makefile.PL to always define $hasafs
25 (and drop me a mail).
26
27
28 1) On Linux systems make sure you have configured your kernel with quota
29 support. You also need the quota utilities and headers. E.g., with
30 the SuSE Linux 6.0 distribution you'll find them in package ap::quota.
31 If your distribution doesn't include the package you can get it from
32 <URL:http://sourceforge.net/projects/linuxquota>. See also (6) below.
33
34 Since 2019, SUN-RPC support has been split off from glibc in some
35 Linux distributions. If you run into compilation problems due to
36 missing header rpc/rpc.h, install package "libtirpc-dev"
37
38 2) Link or create the hints file.
39
40 a) Should be done by Makefile.PL for all supported systems. If not, and
41 there is a file below hints/ for your operating system (maybe for a
42 previous release), just create a link named "myconfig.h" to that file:
43 ln -s hints/my-os.h myconfig.h
44
45 b) Else, use hints/none.h to create a myconfig.h of your own. Check which
46 #includes you need in the online manuals. Contact me before you invest
47 a lot of time, it might already be done.
48
49 Edit Makefile.PL to maybe add/delete some libraries. Usually you'll
50 need only librpcsvc for the quota RPC mechanism. If you don't have
51 this library or it lacks the quota routines, #define MY_XDR in
52 myconfig.h to include the routines provided with this module. If you
53 don't have /usr/include/rpcsvc/rquota.h, include "include/rquota.h"
54 instead. If you don't need RPC at all, just define NO_RPC.
55
56 3) Generate the Makefile: perl Makefile.PL
57
58 4) Compile the module: make
59
60 5) Run "make test" to check if the module routines do work correctly.
61 Run the script once for user-quota and once group-quota, if needed.
62
63 6) Linux specials:
64
65 a) If you're using an ancient version of the Linux quota tools on a NFS
66 server, check Quota::query() results for block usage and limits.
67 Old versions of the rpc.rquotad did report a wrong block size, hence
68 all sizes were 4 times too large. If your system shows this error,
69 you should uncomment #define LINUX_RQUOTAD_BUG in the hints file and
70 recompile. The better solution is to update your quota tools though.
71
72 b) If you're using RedHat 7.1 or later, or the Alan Cox (ac) branch of
73 the Linux 2.4.x kernels, you're victim of a new and completely
74 backwards incompatible Quota file format and quotactl API. If you've
75 downloaded the kernel separately, make sure to install the latest
76 version of the quota tools: see (1).
77
78 If the Quota module does not find quotas for any users anymore, the
79 reason may be you've not set up the new aquota.user/group files yet.
80 Remember: after creating these files with quotackeck(8) or
81 convertquota(8) you have to execute quotaon(8) another time. You'll
82 not see this requirement with quota(1) because that program reads the
83 quota files directly if the kernel query fails; the module however only
84 goes through the kernel. If in doubt, do an strace(1) on the quota(1)
85 call. Normally you should see no access to the aquota files in the trace.
86 Alternatively, make the quota files readable for root only (recommended
87 anyway) and try quota -v again under a non-root login. If this fails,
88 the kernel has not enabled quota support.
89
90 7) To install the module in your perl tree: "make install"
91 You may need to su root before this step.
92
93 The contrib directory contains some usage examples, donated by
94 users. No guarantee from me that they do anything useful or don't
95 format your hard drive.
96
97 8) Before you start for another OS, type "make clean"
98
99
100 Please submit a ticket at CPAN (https://metacpan.org/pod/Quota) for any
101 changes in the hints files or Makefile.PL you had to apply to get the
102 package to compile. Please remember to include the name of the OS and
103 version numbers of OS (uname -rs) and Quota module.