This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
msgrcv: properly downgrade the receive buffer
[perl5.git] / README.vos
CommitLineData
9a997319
JH
1If you read this file _as_is_, just ignore the funny characters you
2see. It is written in the POD format (see pod/perlpod.pod) which is
3specially designed to be readable as is.
4
5=head1 NAME
6
48951f7e 7perlvos - Perl for Stratus OpenVOS
9a997319
JH
8
9=head1 SYNOPSIS
24e8e380 10
48951f7e 11This file contains notes for building perl on the Stratus OpenVOS
050dfae0 12operating system. Perl is a scripting or macro language that is
48951f7e
PG
13popular on many systems. See L<perlbook> for a number of good books
14on Perl.
4f3de37c 15
10fb90aa 16These are instructions for building Perl from source. This version of
48951f7e
PG
17Perl requires the dynamic linking support that is found in OpenVOS
18Release 17.1 and thus is not supported on OpenVOS Release 17.0 or
19earlier releases.
495c5fdc 20
050dfae0 21If you are running VOS Release 14.4.1 or later, you can obtain a
48951f7e
PG
22pre-compiled, supported copy of perl by purchasing the GNU Tools
23product from Stratus Technologies.
050dfae0 24
48951f7e 25=head1 BUILDING PERL FOR OPENVOS
050dfae0 26
48951f7e
PG
27To build perl from its source code on the Stratus V Series platform
28you must have OpenVOS Release 17.1.0 or later, GNU Tools Release
293.5 or later, and the C/POSIX Runtime Libraries.
24e8e380 30
48951f7e
PG
31Follow the normal instructions for building perl; e.g, enter bash, run
32the Configure script, then use "gmake" to build perl.
9a997319 33
48951f7e 34=head1 INSTALLING PERL IN OPENVOS
9a997319 35
050dfae0 36=over 4
24e8e380 37
050dfae0 38=item 1
24e8e380 39
48951f7e
PG
40After you have built perl using the Configure script, ensure that you
41have modify and default write permission to C<< >system>ported >> and
42all subdirectories. Then type
9a997319 43
050dfae0 44 gmake install
24e8e380 45
050dfae0 46=item 2
24e8e380 47
10fb90aa
PG
48While there are currently no architecture-specific extensions or
49modules distributed with perl, the following directories can be
50used to hold such files (replace the string VERSION by the
51appropriate version number):
24e8e380 52
10fb90aa 53 >system>ported>lib>perl5>VERSION>i786
24e8e380 54
3fd80bd6 55=item 3
9a997319
JH
56
57Site-specific perl extensions and modules can be installed in one of
58two places. Put architecture-independent files into:
24e8e380 59
10fb90aa 60 >system>ported>lib>perl5>site_perl>VERSION
24e8e380 61
050dfae0
PG
62Put site-specific architecture-dependent files into one of the
63following directories:
24e8e380 64
10fb90aa 65 >system>ported>lib>perl5>site_perl>VERSION>i786
24e8e380 66
3fd80bd6 67=item 4
9a997319
JH
68
69You can examine the @INC variable from within a perl program
70to see the order in which Perl searches these directories.
495c5fdc 71
9a997319
JH
72=back
73
48951f7e 74=head1 USING PERL IN OPENVOS
9a997319 75
48951f7e 76=head2 Restrictions of Perl on OpenVOS
495c5fdc 77
48951f7e
PG
78This port of Perl version 5 prefers Unix-style, slash-separated
79pathnames over OpenVOS-style greater-than-separated pathnames.
80OpenVOS-style pathnames should work in most contexts, but if you have
81trouble, replace all greater-than characters by slash characters.
82Because the slash character is used as a pathname delimiter, Perl
83cannot process OpenVOS pathnames containing a slash character in a
84directory or file name; these must be renamed.
495c5fdc 85
24e8e380
GS
86This port of Perl also uses Unix-epoch date values internally.
87As long as you are dealing with ASCII character string
88representations of dates, this should not be an issue. The
89supported epoch is January 1, 1980 to January 17, 2038.
495c5fdc 90
48951f7e 91See the file pod/perlport.pod for more information about the OpenVOS
24e8e380 92port of Perl.
495c5fdc 93
11d33b1d
PG
94=head1 TEST STATUS
95
48951f7e
PG
96A number of the perl self-tests fails for various reasons; generally
97these are minor and due to subtle differences between common
98POSIX-based environments and the OpenVOS POSIX environment. Ensure
99that you conduct sufficient testing of your code to guarantee that it
100works properly in the OpenVOS environment.
11d33b1d 101
9a997319 102=head1 SUPPORT STATUS
495c5fdc 103
495c5fdc 104I'm offering this port "as is". You can ask me questions, but I
5b8c1387 105can't guarantee I'll be able to answer them. There are some
24e8e380
GS
106excellent books available on the Perl language; consult a book
107seller.
495c5fdc 108
48951f7e
PG
109If you want a supported version of perl for OpenVOS, purchase the
110OpenVOS GNU Tools product from Stratus Technologies, along with a
111support contract (or from anyone else who will sell you support).
050dfae0 112
9a997319
JH
113=head1 AUTHOR
114
4f3de37c 115Paul Green (Paul.Green@stratus.com)
9a997319
JH
116
117=head1 LAST UPDATE
118
48951f7e 119February 28, 2013
9a997319
JH
120
121=cut