Penguin
Recent Changes
Annotated edit history of perlvos(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 PERLVOS
2 !!!PERLVOS
3 NAME
4 SYNOPSIS
5 INSTALLING PERL IN VOS
6 USING PERL IN VOS
7 SUPPORT STATUS
8 AUTHOR
9 LAST UPDATE
10 ----
11 !!NAME
12
13
14 README .vos - Perl for Stratus VOS
15 !!SYNOPSIS
16
17
18 This is a port of Perl version 5 to VOS .
19 Perl is a scripting or macro language that is popular on
20 many systems. See your local computer bookstore for a number
21 of good books on Perl.
22
23
24 __Stratus__ __POSIX
25 Support__
26
27
28 Note that there are two different implementations
29 of POSIX .1 support on VOS . There is
30 an alpha version of POSIX that is available from
31 the Stratus anonymous ftp site
32 (ftp://ftp.stratus.com/pub/vos/posix/alpha/alpha.html).
33 There is a generally-available version of POSIX
34 that comes with the VOS Standard C compiler
35 and C runtime in VOS Release 14.3.0 or higher.
36 This port of POSIX will compile and bind with
37 either version of POSIX .
38
39
40 Most of the Perl features should work on VOS
41 regardless of which version of POSIX that
42 you are using. However, the alpha version of POSIX
43 is missing a number of key functions, and therefore any
44 attempt by perl.pm to call the following unimplemented
45 POSIX functions will result in an error message and an
46 immediate and fatal call to the VOS debugger.
47 They are ``dup'', ``fork'', and ``waitpid''. The lack of
48 these functions pretty much prevents you from starting
49 VOS commands and grabbing their output in perl. The
50 workaround is to run the commands outside of perl, then have
51 perl process the output file. These functions are all
52 available in the generally-available version of POSIX
53 .
54 !!INSTALLING PERL IN VOS
55
56
57 __Compiling Perl 5 on__
58 __VOS__
59
60
61 Before you can build Perl 5 on VOS , you
62 need to have or acquire the following additional
63 items.
64
65
66 1
67
68
69 The VOS Standard C Compiler and Runtime, or
70 the VOS Standard C Cross-Compiler. This is a
71 standard Stratus product.
72
73
74 2
75
76
77 Either the VOS OS TCP/IP or STCP
78 product set. If you are building with the alpha version
79 of POSIX you need the OS TCP/IP
80 product set. If you are building with the
81 generally-available version of POSIX you need
82 the STCP product set. These are standard Stratus
83 products.
84
85
86 3
87
88
89 Either the alpha or generally-available version of
90 the VOS POSIX .1 environment.
91
92
93 The alpha version of POSIX .1 support is
94 available on the Stratus FTP site. Login
95 anonymously to ftp.stratus.com and get the file
96 /pub/vos/posix/alpha/posix.save.evf.gz in binary
97 file-transfer mode. Or use the Uniform Resource Locator
98 ( URL )
99 ftp://ftp.stratus.com/pub/vos/alpha/posix.save.evf.gz from
100 your web browser. Instructions for unbundling this file are
101 at ftp://ftp.stratus.com/pub/vos/utility/utility.html. This
102 is not a standard Stratus product.
103
104
105 The generally-available version of POSIX .1
106 support is bundled with the VOS Standard C
107 compiler and Runtime (or Cross-Compiler) in VOS
108 Release 14.3.0 or higher. This is a standard Stratus
109 product.
110
111
112 4
113
114
115 You must compile this version of Perl 5 on VOS
116 Release 14.1.0 or higher because some of the perl
117 source files contain more than 32,767 source lines. Due
118 to VOS release-compatibility rules, this port of
119 perl may not execute on VOS Release 12 or
120 earlier.
121
122
123 To build perl 5, change to the ``vos'' subdirectory and
124 type the command ``compile_perl -processor X'', where X is
125 the processor type (mc68020, i80860, pa7100, pa8000) that
126 you wish to use. Note that the generally-available version
127 of POSIX .1 support is not available for the
128 mc68020 or i80860 processors.
129
130
131 You must have purchased the VOS Standard C
132 Cross Compiler in order to compile perl for a processor type
133 that is different from the processor type of the
134 module.
135
136
137 Note that code compiled for the pa7100 processor type
138 can execute on the PA7100 , PA8000
139 , PA8500 and PA8600 processors,
140 and that code compiled for the pa8000 processor type can
141 execute on the PA8000 , PA8500
142 and PA8600 processors.
143
144
145 __Installing Perl 5 on__
146 __VOS__
147
148
149 1
150
151
152 Create the directory
153
154
155 2
156
157
158 Copy the appropriate version of the perl program module
159 to this directory. For example, with your current directory
160 set to the top-level directory of Perl 5, to install the
161 executable program module for the Motorola 68K architecture,
162 enter:
163
164
165 !copy_file vos
166 (If you wish to use both Perl version 4 and Perl version 5, you must give them different names; for example, perl.pm and perl5.pm).
167
168
169 3
170
171
172 Create the directory
173
174
175 4
176
177
178 Copy all of the files and subdirectories from the lib
179 subdirectory into this new directory. For example, with the
180 current directory set to the top-level directory of the perl
181 distribution, enter:
182
183
184 !copy_dir lib
185
186
187 5
188
189
190 While there are currently no architecture-specific
191 extensions or modules distributed with perl, the following
192 directories can be used to hold such
193 files:
194
195
196
197
198
199 6
200
201
202 Site-specific perl extensions and modules can be
203 installed in one of two places. Put architecture-independent
204 files into:
205
206
207
208 Put architecture-dependent files into one of the following directories:
209
210
211
212
213
214 7
215
216
217 You can examine the @INC variable from within
218 a perl program to see the order in which Perl searches these
219 directories.
220 !!USING PERL IN VOS
221
222
223 __Unimplemented Features__
224
225
226 If perl is built with the alpha version of VOS
227 POSIX .1 support and if it attempts to call an
228 unimplemented VOS POSIX .1 function, it will
229 print a fatal error message and enter the VOS
230 debugger. This error is not recoverable. See
231 vos_dummies.c for a list of the unimplemented POSIX
232 .1 functions. To see what functions are unimplemented
233 and what the error message looks like, compile and execute
234 ``test_vos_dummies.c''.
235
236
237 __Restrictions__
238
239
240 This port of Perl version 5 to VOS prefers
241 Unix-style, slash-separated pathnames over VOS-style
242 greater-than-separated pathnames. VOS-style pathnames should
243 work in most contexts, but if you have trouble, replace all
244 greater-than characters by slash characters. Because the
245 slash character is used as a pathname delimiter, Perl cannot
246 process VOS pathnames containing a slash
247 character in a directory or file name; these must be
248 renamed.
249
250
251 This port of Perl also uses Unix-epoch date values
252 internally. As long as you are dealing with ASCII
253 character string representations of dates, this should
254 not be an issue. The supported epoch is January 1, 1980 to
255 January 17, 2038.
256
257
258 See the file pod/perlport.pod for more information
259 about the VOS port of Perl.
260 !!SUPPORT STATUS
261
262
263 I'm offering this port ``as is''. You can ask me
264 questions, but I can't guarantee I'll be able to answer
265 them. There are some excellent books available on the Perl
266 language; consult a book seller.
267 !!AUTHOR
268
269
270 Paul Green (Paul_Green@stratus.com)
271 !!LAST UPDATE
272
273
274 February 13, 2001
275 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.