Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35) Standard preamble: ========================================================================
NAMEperlqnx - Perl version 5 on QNX
DESCRIPTIONAs of perl5.7.2 all tests pass under:
QNX 4.24G Watcom 10.6 with Beta/970211.wcc.update.tar.F socket3r.lib Nov21 1996.
As of perl5.8.1 there is at least one test still failing.
Some tests may complain under known circumstances.
See below and hints/qnx.sh for more information.
Required Software for Compiling Perl on QNX4
As with many unix ports, this one depends on a few ``standard''
unix utilities which are not necessarily standard for
This is used heavily by Configure and then by
perl itself. QNX4's version is fine, but Configure will choke on the 16-bit version, so if you are runningQNX 4.22,link /bin/sh to /bin32/ksh
- This is the standard unix library builder. We use wlib. With Watcom 10.6, when wlib is linked as ``ar'', it behaves like ar and all is fine. Under 9.5, a cover is required. One is included in ../qnx
This is used (optionally) by configure to list
the contents of libraries. I will generate
a cover function on the fly in the UUdirectory.
- Configure and perl need a way to invoke a C preprocessor. I have created a simple cover for cc which does the right thing. Without this, Configure will create its own wrapper which works, but it doesn't handle some of the command line arguments that perl will throw at it.
You really need GNUmake to compile this.GNUmake ships by default withQNX 4.23,but you can get it from quics for earlier versions.
Outstanding Issues with Perl on QNX4
There is no support for dynamically linked libraries in
If you wish to compile with the Socket extension, you need to have the
The following tests may report errors under
dist/Cwd/Cwd.t will complain if `pwd` and cwd don't give the same results. cwd calls `fullpath -t`, so if you cd `fullpath -t` before running the test, it will pass.
lib/File/Find/taint.t will complain if '.' is in your
ext/IO/lib/IO/t/io_sock.t: Subtests 14 and 22 are skipped due to the fact that the functionality to read back the non-blocking status of a socket is not implemented in
t/io/tell.t: Subtest 27 is failing. We are still investigating.
QNX auxiliary files
The files in the ``qnx'' directory are:
- A script that emulates the standard unix archive (aka library) utility. Under Watcom 10.6, ar is linked to wlib and provides the expected interface. With Watcom 9.5, a cover function is required. This one is fairly crude but has proved adequate for compiling perl.
- A script that provides C preprocessing functionality. Configure can generate a similar cover, but it doesn't handle all the command-line options that perl throws at it. This might be reasonably placed in /usr/local/bin.
Outstanding issues with perl under QNX6
The following tests are still failing for Perl 5.8.1 under
op/sprintf.........................FAILED at test 91 lib/Benchmark......................FAILED at test 26
This is due to a bug in the C library's printf routine. printf(``'%e''', 0. ) produces '0.000000e+0', but
Cross-compilationPerl supports cross-compiling to
Setting up a cross-compilation environment
You can download the
See <developer.blackberry.com/native/documentation/cascades/getting_started/setting_up.html> for instructions to set up your device prior to attempting anything else.
Once you've installed the
So instead you'll want to do something like this:
$ orig_path=$PATH $ source $location_of_bbndk/bbndk-env*.sh $ export PATH="$orig_path:$PATH"
Besides putting the cross-compiler and the rest of the toolchain in your
Preparing the target system
It's quite possible that the target system doesn't have a readily available /tmp, so it's generall safer to do something like this:
$ ssh $TARGETUSER@$TARGETHOST 'rm -rf perl; mkdir perl; mkdir perl/tmp' $ export TARGETDIR=`ssh $TARGETUSER@$TARGETHOST pwd`/perl $ export TARGETENV="export TMPDIR=$TARGETDIR/tmp; "
Later on, we'll pass this to Configure through -Dtargetenv
If you are targetting an
A sample Configure invocation looks something like this:
./Configure -des -Dusecrosscompile \ -Dsysroot=$QNX_TARGET \ -Dtargetdir=$TARGETDIR \ -Dtargetenv="$TARGETENV" \ -Dcc=ntox86-gcc \ -Dtarghost=... # Usual cross-compilation options