File: INSTALL

package info (click to toggle)
libbsd-resource-perl 1.2904-1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze, wheezy
  • size: 300 kB
  • ctags: 623
  • sloc: perl: 87; makefile: 5
file content (66 lines) | stat: -rw-r--r-- 1,960 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
#
# INSTALL
#

To compile

	perl Makefile.PL
	make
	make test

Note that some of the tests (especially getrusage.t and times.t) are
sensitive to timing, and therefore sensitive to the overall load of
the testing machine.  If you get failures, wait for less busy moment
and rerun the tests few times.

To install

	make install

The documentation is the pod inlined into Resource.pm, use for example

	pod2man Resource.pm | nroff -man | more

to view the examples.

You can test how well the extension works with

	make test

Please report any bugs and/or missing/excess functionality to me.
Especially if your system does support these BSD functions but
the Makefile.PL fails to locate them, please let me know.
Remember to send the outputs of 'perl -v' and 'uname -a' (or equivalent).

NOTE 1: The test t/getrusage.t is known to be tricky and to fail once
in a while. This is because the results depend on timing issues and
the activity of the operating system, it is moderately icky to
guestimate such tolerances that leave some slack while still proving
anything. Please retry 'make test' for a couple times, "eventually"
the test should pass. If even that fails, please see that the $debug
in the script is 1 and then run the test separately:

	perl -Mblib t/getrusage.t

or (if the above does not work)

	perl -Iblib/arch -Iblib/lib t/getrusage.t

and send the results to me. Ditto for the other tests: running them
separately with the $debug on is useful for, well, debugging.

NOTE 2: The test t/getpriority may fail because in some systems the
login shell may have an initial priority that is not 0 or 19, the
usual values and this priority may be inherited by your Perl process
doing the testing. Please run the test like this

	perl -Mblib t/getpriority.t

or (if the above does not work)

	perl -Iblib/arch -Iblib/lib t/getpriority.t

and report to me what it says and tell what kind of login you made.
(telnet, rlogin, slogin, klogin, ...?)

# eof