Commit | Line | Data |
---|---|---|
91144103 JH |
1 | If you read this file _as_is_, just ignore the funny characters you |
2 | see. It is written in the POD format (see perlpod manpage) which is | |
3 | specially designed to be readable as is. | |
4 | ||
5 | =head1 NAME | |
6 | ||
7 | perluts - Perl under UTS | |
8 | ||
9 | =head1 SYNOPSIS | |
10 | ||
11 | This document can be read I<as is>: as F<README.uts>, or you | |
12 | can read it after you build your package using "man perluts". | |
13 | ||
14 | The purpose is to help you build Perl for UTS, which, if you | |
15 | follow these instructions, should be easy, and result in | |
16 | a solidly working installation. | |
17 | ||
18 | =head1 DESCRIPTION | |
19 | ||
20 | Perl 5.7.2 (Developmental) or Perl 5.8.x (forthcoming) for UTS | |
21 | ||
22 | =head1 BUILDING PERL ON UTS | |
23 | ||
24 | NOTE: Some sites have redefined the way uname works, and if yours | |
25 | does this, special steps must be taken so that Configure can | |
26 | recognize your system as a UTS system. To see if you are in | |
27 | this category, issue the command "uname -a". It should look | |
28 | something like: | |
29 | ||
30 | uts juno 4 4.4 9672 370 | |
31 | ||
32 | At any rate, the first field should be "uts". If this is not | |
33 | the case; supposing it is, say telcoUTS, create a script, uts/uname | |
34 | (i.e. uname, in the subdirectory "uts" of the main Perl source dir): | |
35 | # uname | |
36 | /usr/bin/uname "$@" | sed -e 's/^telcoUTS/uts/' | |
37 | ||
38 | and when you execute Configure, do it as below, except for adding | |
39 | PATH=uts:$PATH as a prefix. I.e. do: | |
40 | ||
41 | PATH=uts:$PATH ./Configure ... | |
42 | ||
43 | There is no need to do an interactive configure, just type | |
44 | ||
45 | ./Configure -de [-Dusedevel] [-Doptimize=-g ] 2>&1 | tee Conf.out | |
46 | ||
47 | "-Dusedevel" may be required to configure Perl 5.7.2 non-interactively. | |
48 | Use -Doptimize=-g if you want to run Perl under sdb or gdb, OR | |
49 | if you want to be able to use the -D command line flags to perl, | |
50 | which are occasionally useful in debugging perl scripts. | |
51 | ||
52 | In this and the following steps, the "2>&1 | tee XXX.out" records all | |
53 | output from the process, which will be useful if anything unexpected | |
54 | goes wrong. | |
55 | ||
56 | Then do the compilation with | |
57 | ||
58 | make 2>&1 | tee make.out | |
59 | ||
60 | Finally, test using | |
61 | ||
62 | make test 2>&1 | tee make-test.out | |
63 | ||
64 | In the output, the only failures you should see should look like: | |
65 | ||
66 | lib/Math/BigInt/t/bigfltpm.........Use of uninitialized value ... | |
67 | FAILED at test 57 | |
68 | lib/Math/BigInt/t/bigintc..........ok | |
69 | lib/Math/BigInt/t/bigintpm.........FAILED at test 204 | |
70 | lib/Math/BigInt/t/mbimbf...........Use of uninitialized value ... | |
71 | Illegal division by zero at ../lib/Math/BigInt/Calc.pm line 314. | |
72 | FAILED at test 71 | |
73 | lib/Math/Complex...................exp: OVERFLOW | |
74 | FAILED at test 250 | |
75 | lib/Math/Trig......................exp: OVERFLOW | |
76 | ok | |
77 | lib/Memoize/t/array................ok | |
78 | ... | |
79 | lib/Net/protoent...................ok | |
80 | lib/Net/servent....................FAILED at test 0 | |
81 | ||
82 | This means that everything passes except for some problems in the | |
83 | packages "Math::BigInt", "Math::Complex", and "Math::Trig". | |
84 | The lib/Net/servent failure seems to be a bug in the test | |
85 | program. To confirm this, from the main Perl source dir, do: | |
86 | ||
87 | LD_LIBRARY_PATH=`pwd` ./perl -Ilib lib/Net/servent.t | |
88 | ||
89 | and it should output | |
90 | ||
91 | 1..3 | |
92 | ok 1 | |
93 | ok 2 | |
94 | ok 3 | |
95 | ||
96 | =head1 Installing the built perl on UTS | |
97 | ||
98 | Run the command "make install" | |
99 | ||
100 | =head1 AUTHOR | |
101 | ||
102 | Hal Morris | |
103 | UTS Global LLC | |
104 | email: hom00@utsglobal.com | |
105 | ||
106 | =cut | |
107 |