This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
RE: [PATCH] 5.005_02 and 5.005_51: Stratus VOS port
[perl5.git] / README.vos
1 Perl 5 README file for the Stratus VOS operating system.
2 Paul Green (Paul_Green@stratus.com)
3 August 12, 1998
4
5 Introduction
6 ------------
7 This is a port of Perl version 5, revision 005-02, to VOS.  Perl
8 is a scripting or macro language that is popular on many
9 systems.  See your local computer bookstore for a number of good
10 books on Perl.
11
12 Most of the Perl features should work on VOS.  However, any
13 attempt by perl.pm to call the following unimplemented POSIX
14 functions will result in an error message and an immediate and
15 fatal call to the VOS debugger.  They are "dup", "execlp",
16 "execl", "execvp", "fork", and "waitpid".
17
18 Compiling Perl 5 on VOS
19 -----------------------
20 Before you can build Perl 5 on VOS, you need to have or acquire the
21 following additional items.
22
23 1.   The VOS Standard C Compiler and Runtime, or the VOS Standard C
24      Cross-Compiler.  This is a standard Stratus product.
25
26 2.   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
31 3.   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
38 To 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
40 you have the cross-compilers and wish to build for a specific
41 architecture, say "<build -processor pa7100" (for example).  You
42 can also customize the "compile_perl.cm" command macro for your
43 system.
44
45 Changes to Perl for VOS
46 -----------------------
47 1.   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
52 Unimplemented Features
53 ----------------------
54 If Perl 5 attempts to call an unimplemented VOS POSIX.1
55 function, it will print a fatal error message and enter the VOS
56 debugger.  This error is not recoverable.  See vos_dummies.c for
57 a list of the unimplemented POSIX.1 functions.  To see what the
58 error message looks like, compile and execute
59 "test_vos_dummies.c".
60
61 Restrictions
62 ------------
63 This port of Perl version 5 to VOS uses Unix-style,
64 slash-separated pathnames, not VOS-style greater-than-separated
65 pathnames.  If you wish to have it use VOS-style pathnames, try
66 setting the external variable s$c_options to 4 with the
67 following command line.  Note that this way of configuring Perl
68 5 has not been tested; I don't know if Perl can handle the
69 presence 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
73 The following command can be used to check the value:
74
75      get_external_variable s$c_options -in perl.pm -type integer
76
77 See the documentation for VOS POSIX.1 for the full set of option
78 values.
79
80 Support Status
81 --------------
82 I'm offering this port "as is".  You can ask me questions, but I
83 can't guarantee I'll be able to answer them; I don't know much
84 about Perl itself; I'm still learning that.
85
86 (end)
87