This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Doc patch for Tie::Hash
[perl5.git] / README.qnx
CommitLineData
a83b6f46
JH
1If you read this file _as_is_, just ignore the funny characters you see.
2It is written in the POD format (see pod/perlpod.pod) which is specially
3designed to be readable as is.
ff68c719 4
a83b6f46
JH
5=head1 NAME
6
7README.qnx - Perl version 5 on QNX
8
9=head1 DESCRIPTION
10
11As of perl5.004_04, all tests pass under:
12
13 QNX 4.23A
14 Watcom 10.6 with Beta/970211.wcc.update.tar.F
15 socket3r.lib Nov21 1996.
16
af23fe4d
NA
17Update June 2001: Perl 5.6.1 works fine in QNX4 with
18a few 'known' failures in the test suite.
19
20[ Perl 5.6.0 is shipping with QNX RTP (aka QNX6, Neutrino), but
21the build does not appear to be straightforward. If anyone has
22more data in this regard, please let me know.
23
24These notes were originally written for QNX4 and do not
25necessarily apply to Neutrino, but see hints/qnx.sh for
26more information. ]
a83b6f46
JH
27
28=head2 Required Software for Compiling Perl on QNX
29
30As with many unix ports, this one depends on a few "standard"
31unix utilities which are not necessarily standard for QNX.
32
33=over 4
34
35=item /bin/sh
36
37This is used heavily by Configure and then by
38perl itself. QNX's version is fine, but Configure
39will choke on the 16-bit version, so if you are
40running QNX 4.22, link /bin/sh to /bin32/ksh
41
42=item ar
43
44This is the standard unix library builder.
45We use wlib. With Watcom 10.6, when wlib is
46linked as "ar", it behaves like ar and all is
47fine. Under 9.5, a cover is required. One is
48included in ../qnx
49
50=item nm
51
52This is used (optionally) by configure to list
53the contents of libraries. I will generate
54a cover function on the fly in the UU directory.
55
56=item cpp
57
58Configure and perl need a way to invoke a C
59preprocessor. I have created a simple cover
60for cc which does the right thing. Without this,
022735b4 61Configure will create its own wrapper which works,
a83b6f46
JH
62but it doesn't handle some of the command line arguments
63that perl will throw at it.
64
65=item make
66
67You really need GNU make to compile this. GNU make
68ships by default with QNX 4.23, but you can get it
69from quics for earlier versions.
70
71=back
72
73=head2 Outstanding Issues with Perl on QNX
74
af23fe4d
NA
75There is no support for dynamically linked libraries in QNX4.
76
77The following tests may report errors:
78
79ext/Cwd/Cwd.t will complain if `pwd` and cwd don't give
80the same results. cwd calls `fullpath -t`, so if you
81cd `fullpath -t` before running the test, it will
82pass.
83
84lib/File/Find/taint.t will complain if '.' is in your
85PATH. The PATH test is triggered because cwd calls
86`fullpath -t`.
87
88ext/IO/lib/IO/t/io_sock.t Still investigating
89ext/POSIX/sigaction.t Still investigating
a83b6f46
JH
90
91=head2 QNX auxiliary files
ff68c719
PP
92
93The files in the "qnx" directory are:
94
a83b6f46
JH
95=over 4
96
97=item qnx/ar
98
99A script that emulates the standard unix archive (aka library)
100utility. Under Watcom 10.6, ar is linked to wlib and provides the
101expected interface. With Watcom 9.5, a cover function is
102required. This one is fairly crude but has proved adequate for
103compiling perl. A more thorough version is available at:
ff68c719
PP
104
105 http://www.fdma.com/pub/qnx/porting/ar
106
a83b6f46
JH
107=item qnx/cpp
108
109A script that provides C preprocessing functionality. Configure can
110generate a similar cover, but it doesn't handle all the command-line
111options that perl throws at it. This might be reasonably placed in
112/usr/local/bin.
113
114=back
115
116=head1 AUTHOR
ff68c719 117
ff68c719 118Norton T. Allen (allen@huarp.harvard.edu)
a83b6f46 119