perl5.git.perl.org Git - perl5.git/blame_incremental

... / ...

Commit	Line	Data
	1	If you read this file _as_is_, just ignore the funny characters you see.
	2	It is written in the POD format (see pod/perlpod.pod) which is specially
	3	designed to be readable as is.
	4
	5	=head1 NAME
	6
	7	README.qnx - Perl version 5 on QNX
	8
	9	=head1 DESCRIPTION
	10
	11	As of perl5.7.2 all tests pass under:
	12
	13	QNX 4.24G
	14	Watcom 10.6 with Beta/970211.wcc.update.tar.F
	15	socket3r.lib Nov21 1996.
	16
	17	Some tests may complain under known circumstances. See
	18	below and hints/qnx.sh for more information.
	19
	20	Under QNX 6.1.0 there are still a few tests which fail.
	21	See below and hints/qnx.sh for more information.
	22
	23	=head2 Required Software for Compiling Perl on QNX4
	24
	25	As with many unix ports, this one depends on a few "standard"
	26	unix utilities which are not necessarily standard for QNX4.
	27
	28	=over 4
	29
	30	=item /bin/sh
	31
	32	This is used heavily by Configure and then by
	33	perl itself. QNX4's version is fine, but Configure
	34	will choke on the 16-bit version, so if you are
	35	running QNX 4.22, link /bin/sh to /bin32/ksh
	36
	37	=item ar
	38
	39	This is the standard unix library builder.
	40	We use wlib. With Watcom 10.6, when wlib is
	41	linked as "ar", it behaves like ar and all is
	42	fine. Under 9.5, a cover is required. One is
	43	included in ../qnx
	44
	45	=item nm
	46
	47	This is used (optionally) by configure to list
	48	the contents of libraries. I will generate
	49	a cover function on the fly in the UU directory.
	50
	51	=item cpp
	52
	53	Configure and perl need a way to invoke a C
	54	preprocessor. I have created a simple cover
	55	for cc which does the right thing. Without this,
	56	Configure will create its own wrapper which works,
	57	but it doesn't handle some of the command line arguments
	58	that perl will throw at it.
	59
	60	=item make
	61
	62	You really need GNU make to compile this. GNU make
	63	ships by default with QNX 4.23, but you can get it
	64	from quics for earlier versions.
	65
	66	=back
	67
	68	=head2 Outstanding Issues with Perl on QNX4
	69
	70	There is no support for dynamically linked libraries in QNX4.
	71
	72	The following tests may report errors under QNX4:
	73
	74	ext/Cwd/Cwd.t will complain if `pwd` and cwd don't give
	75	the same results. cwd calls `fullpath -t`, so if you
	76	cd `fullpath -t` before running the test, it will
	77	pass.
	78
	79	lib/File/Find/taint.t will complain if '.' is in your
	80	PATH. The PATH test is triggered because cwd calls
	81	`fullpath -t`.
	82
	83	ext/IO/lib/IO/t/io_sock.t: Subtest 14 is skipped due to
	84	the fact that the functionality to read back the non-blocking
	85	status of a socket is not implemented in QNX's TCP/IP. This
	86	has been reported to QNX and it may work with later versions
	87	of TCP/IP.
	88
	89	=head2 QNX auxiliary files
	90
	91	The files in the "qnx" directory are:
	92
	93	=over 4
	94
	95	=item qnx/ar
	96
	97	A script that emulates the standard unix archive (aka library)
	98	utility. Under Watcom 10.6, ar is linked to wlib and provides the
	99	expected interface. With Watcom 9.5, a cover function is
	100	required. This one is fairly crude but has proved adequate for
	101	compiling perl.
	102
	103	=item qnx/cpp
	104
	105	A script that provides C preprocessing functionality. Configure can
	106	generate a similar cover, but it doesn't handle all the command-line
	107	options that perl throws at it. This might be reasonably placed in
	108	/usr/local/bin.
	109
	110	=back
	111
	112	=head2 Outstanding issues with perl under QNX6
	113
	114	The following tests are still failing for Perl 5.7.1 under QNX 6.1.0:
	115
	116	op/sprintf.........................FAILED at test 91
	117	lib/1_compile......................FAILED at test 33
	118	ext/IO/lib/IO/t/io_sock............FAILED at test 12
	119	ext/IO/lib/IO/t/io_udp.............FAILED at test 4
	120
	121	=head1 AUTHOR
	122
	123	Norton T. Allen (allen@huarp.harvard.edu)
	124