This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
fix parse error on C<{ use strict }> and other constructs that
[perl5.git] / README.vos
CommitLineData
495c5fdc
GP
1Perl 5 README file for the Stratus VOS operating system.
2Paul Green (Paul_Green@stratus.com)
3August 12, 1998
4
5Introduction
6------------
7This is a port of Perl version 5, revision 005-02, to VOS. Perl
8is a scripting or macro language that is popular on many
9systems. See your local computer bookstore for a number of good
10books on Perl.
11
12Most of the Perl features should work on VOS. However, any
13attempt by perl.pm to call the following unimplemented POSIX
14functions will result in an error message and an immediate and
15fatal call to the VOS debugger. They are "dup", "execlp",
16"execl", "execvp", "fork", and "waitpid".
17
18Compiling Perl 5 on VOS
19-----------------------
20Before you can build Perl 5 on VOS, you need to have or acquire the
21following additional items.
22
231. The VOS Standard C Compiler and Runtime, or the VOS Standard C
24 Cross-Compiler. This is a standard Stratus product.
25
262. The VOS OS TCP/IP product set. While the necessary header files
27 are included in this distribution, you still need the appropriate
28 object files in order to bind perl.pm. This is a standard
29 Stratus product.
30
313. The VOS POSIX.1 environment. As of this writing, this is
32 available on the VOS FTP site. Login to ftp.stratus.com
33 anonymously and get the file /pub/vos/alpha/posix.save.evf.gz in
34 binary file-transfer mode. Or use the Uniform Resource Locator
35 (URL) ftp://ftp.stratus.com/pub/vos/alpha/posix.save.evf.gz from
36 your web browser. This is not a standard Stratus product.
37
38To build build 5, change to one of the VOS object directories
39(e.g., perl5.005_02>vos>obj), and give the command "<build". If
40you have the cross-compilers and wish to build for a specific
41architecture, say "<build -processor pa7100" (for example). You
42can also customize the "compile_perl.cm" command macro for your
43system.
44
45Changes to Perl for VOS
46-----------------------
471. The header perl.h was changed to include vosish.h instead
48 of unixish.h. This change is necessary because VOS POSIX.1
49 does not (yet) implement the getgrname() or getgrgid()
50 functions.
51
52Unimplemented Features
53----------------------
54If Perl 5 attempts to call an unimplemented VOS POSIX.1
55function, it will print a fatal error message and enter the VOS
56debugger. This error is not recoverable. See vos_dummies.c for
57a list of the unimplemented POSIX.1 functions. To see what the
58error message looks like, compile and execute
59"test_vos_dummies.c".
60
61Restrictions
62------------
63This port of Perl version 5 to VOS uses Unix-style,
64slash-separated pathnames, not VOS-style greater-than-separated
65pathnames. If you wish to have it use VOS-style pathnames, try
66setting the external variable s$c_options to 4 with the
67following command line. Note that this way of configuring Perl
685 has not been tested; I don't know if Perl can handle the
69presence of the greater-thans, and the absence of the slashes.
70
71 set_external_variable s$c_options -in perl.pm -type integer -to 4
72
73The following command can be used to check the value:
74
75 get_external_variable s$c_options -in perl.pm -type integer
76
77See the documentation for VOS POSIX.1 for the full set of option
78values.
79
80Support Status
81--------------
82I'm offering this port "as is". You can ask me questions, but I
83can't guarantee I'll be able to answer them; I don't know much
84about Perl itself; I'm still learning that.
85
86(end)
87