Debian Codegraph @

upstream/opensuse-tumbleweed/man1/perlplan9.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "PERLPLAN9 1"
61 .TH PERLPLAN9 1 2026-03-09 "perl v5.42.1" "Perl Programmers Reference Guide"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SH NAME
67 perlplan9 \- Plan 9\-specific documentation for Perl
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 These are a few notes describing features peculiar to
71 Plan 9 Perl. As such, it is not intended to be a replacement
72 for the rest of the Perl 5 documentation (which is both
73 copious and excellent). If you have any questions to
74 which you can\*(Aqt find answers in these man pages, contact
75 Luther Huffman at [email protected] and we\*(Aqll try to
76 answer them.
77 .SS "Invoking Perl"
78 .IX Subsection "Invoking Perl"
79 Perl is invoked from the command line as described in
80 perl. Most perl scripts, however, do have a first line
81 such as "#!/usr/local/bin/perl". This is known as a shebang
82 (shell\-bang) statement and tells the OS shell where to find
83 the perl interpreter. In Plan 9 Perl this statement should be
84 "#!/bin/perl" if you wish to be able to directly invoke the
85 script by its name.
86 Alternatively, you may invoke perl with the command "Perl"
87 instead of "perl". This will produce Acme\-friendly error
88 messages of the form "filename:18".
89 .PP
90 Some scripts, usually identified with a *.PL extension, are
91 self\-configuring and are able to correctly create their own
92 shebang path from config information located in Plan 9
93 Perl. These you won\*(Aqt need to be worried about.
94 .SS "What\*(Aqs in Plan 9 Perl"
95 .IX Subsection "What's in Plan 9 Perl"
96 Although Plan 9 Perl currently only provides static
97 loading, it is built with a number of useful extensions.
98 These include Opcode, FileHandle, Fcntl, and POSIX. Expect
99 to see others (and DynaLoading!) in the future.
100 .SS "What\*(Aqs not in Plan 9 Perl"
101 .IX Subsection "What's not in Plan 9 Perl"
102 As mentioned previously, dynamic loading isn\*(Aqt currently
103 available nor is MakeMaker. Both are high\-priority items.
104 .SS "Perl5 Functions not currently supported in Plan 9 Perl"
105 .IX Subsection "Perl5 Functions not currently supported in Plan 9 Perl"
106 Some, such as \f(CW\*(C`chown\*(C'\fR and \f(CW\*(C`umask\*(C'\fR aren\*(Aqt provided
107 because the concept does not exist within Plan 9. Others,
108 such as some of the socket\-related functions, simply
109 haven\*(Aqt been written yet. Many in the latter category
110 may be supported in the future.
111 .PP
112 The functions not currently implemented include:
113 .PP
114 .Vb 5
115 \& chown, chroot, dbmclose, dbmopen, getsockopt,
116 \& setsockopt, recvmsg, sendmsg, getnetbyname,
117 \& getnetbyaddr, getnetent, getprotoent, getservent,
118 \& sethostent, setnetent, setprotoent, setservent,
119 \& endservent, endnetent, endprotoent, umask
120 .Ve
121 .PP
122 There may be several other functions that have undefined
123 behavior so this list shouldn\*(Aqt be considered complete.
124 .SS "Signals in Plan 9 Perl"
125 .IX Subsection "Signals in Plan 9 Perl"
126 For compatibility with perl scripts written for the Unix
127 environment, Plan 9 Perl uses the POSIX signal emulation
128 provided in Plan 9\*(Aqs ANSI POSIX Environment (APE). Signal stacking
129 isn\*(Aqt supported. The signals provided are:
130 .PP
131 .Vb 4
132 \& SIGHUP, SIGINT, SIGQUIT, SIGILL, SIGABRT,
133 \& SIGFPE, SIGKILL, SIGSEGV, SIGPIPE, SIGPIPE, SIGALRM,
134 \& SIGTERM, SIGUSR1, SIGUSR2, SIGCHLD, SIGCONT,
135 \& SIGSTOP, SIGTSTP, SIGTTIN, SIGTTOU
136 .Ve
137 .SH "COMPILING AND INSTALLING PERL ON PLAN 9"
138 .IX Header "COMPILING AND INSTALLING PERL ON PLAN 9"
139 WELCOME to Plan 9 Perl, brave soul!
140 .PP
141 .Vb 5
142 \& This is a preliminary alpha version of Plan 9 Perl. Still to be
143 \&implemented are MakeMaker and DynaLoader. Many perl commands are
144 \&missing or currently behave in an inscrutable manner. These gaps will,
145 \&with perseverance and a modicum of luck, be remedied in the near
146 \&future.To install this software:
147 .Ve
148 .PP
149 1. Create the source directories and libraries for perl by running the
150 plan9/setup.rc command (i.e., located in the plan9 subdirectory).
151 Note: the setup routine assumes that you haven\*(Aqt dearchived these
152 files into /sys/src/cmd/perl. After running setup.rc you may delete
153 the copy of the source you originally detarred, as source code has now
154 been installed in /sys/src/cmd/perl. If you plan on installing perl
155 binaries for all architectures, run "setup.rc \-a".
156 .PP
157 2. After making sure that you have adequate privileges to build system
158 software, from /sys/src/cmd/perl/5.00301 (adjust version
159 appropriately) run:
160 .PP
161 .Vb 1
162 \& mk install
163 .Ve
164 .PP
165 If you wish to install perl versions for all architectures (68020,
166 mips, sparc and 386) run:
167 .PP
168 .Vb 1
169 \& mk installall
170 .Ve
171 .PP
172 3. Wait. The build process will take a *long* time because perl
173 bootstraps itself. A 75MHz Pentium, 16MB RAM machine takes roughly 30
174 minutes to build the distribution from scratch.
175 .SS "Installing Perl Documentation on Plan 9"
176 .IX Subsection "Installing Perl Documentation on Plan 9"
177 This perl distribution comes with a tremendous amount of
178 documentation. To add these to the built\-in manuals that come with
179 Plan 9, from /sys/src/cmd/perl/5.00301 (adjust version appropriately)
180 run:
181 .PP
182 .Vb 1
183 \& mk man
184 .Ve
185 .PP
186 To begin your reading, start with:
187 .PP
188 .Vb 1
189 \& man perl
190 .Ve
191 .PP
192 This is a good introduction and will direct you towards other man
193 pages that may interest you.
194 .PP
195 (Note: "mk man" may produce some extraneous noise. Fear not.)
196 .SH BUGS
197 .IX Header "BUGS"
198 "As many as there are grains of sand on all the beaches of the
199 world . . ." \- Carl Sagan
200 .SH "Revision date"
201 .IX Header "Revision date"
202 This document was revised 09\-October\-1996 for Perl 5.003_7.
203 .SH AUTHOR
204 .IX Header "AUTHOR"
205 Direct questions, comments, and the unlikely bug report (ahem) direct
206 comments toward:
207 .PP
208 Luther Huffman, [email protected],
209 Strategic Computer Solutions, Inc.