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
|