This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Upgrade to Time-HiRes-1.9712
[perl5.git] / opcode.pl
CommitLineData
d6480c9d
NC
1#!/usr/bin/perl -w
2use strict;
3
36bb303b
NC
4BEGIN {
5 # Get function prototypes
9ad884cb 6 require 'regen_lib.pl';
36bb303b 7}
79072805 8
d6480c9d
NC
9my $opcode_new = 'opcode.h-new';
10my $opname_new = 'opnames.h-new';
bb6f4497 11open(OC, ">$opcode_new") || die "Can't create $opcode_new: $!\n";
dfb1454f 12binmode OC;
bb6f4497 13open(ON, ">$opname_new") || die "Can't create $opname_new: $!\n";
dfb1454f 14binmode ON;
79072805
LW
15select OC;
16
17# Read data.
18
d6480c9d
NC
19my %seen;
20my (@ops, %desc, %check, %ckname, %flags, %args);
21
79072805
LW
22while (<DATA>) {
23 chop;
24 next unless $_;
25 next if /^#/;
d6480c9d
NC
26 my ($key, $desc, $check, $flags, $args) = split(/\t+/, $_, 5);
27 $args = '' unless defined $args;
c07a80fd
PP
28
29 warn qq[Description "$desc" duplicates $seen{$desc}\n] if $seen{$desc};
30 die qq[Opcode "$key" duplicates $seen{$key}\n] if $seen{$key};
31 $seen{$desc} = qq[description of opcode "$key"];
32 $seen{$key} = qq[opcode "$key"];
33
79072805 34 push(@ops, $key);
c07a80fd 35 $desc{$key} = $desc;
79072805
LW
36 $check{$key} = $check;
37 $ckname{$check}++;
38 $flags{$key} = $flags;
39 $args{$key} = $args;
40}
41
1d5774de
NC
42# Set up aliases
43
44my %alias;
45
46# Format is "this function" => "does these op names"
47my @raw_alias = (
6faeeb49 48 Perl_do_kv => [qw( keys values )],
d83386fa 49 Perl_unimplemented_op => [qw(padany mapstart custom)],
0b612f93
NC
50 # All the ops with a body of { return NORMAL; }
51 Perl_pp_null => [qw(scalar regcmaybe lineseq scope)],
52
53 Perl_pp_goto => ['dump'],
54 Perl_pp_require => ['dofile'],
55 Perl_pp_untie => ['dbmclose'],
56 Perl_pp_sysread => [qw(read recv)],
57 Perl_pp_sysseek => ['seek'],
58 Perl_pp_ioctl => ['fcntl'],
59 Perl_pp_ssockopt => ['gsockopt'],
60 Perl_pp_getpeername => ['getsockname'],
61 Perl_pp_stat => ['lstat'],
f1cb2d48 62 Perl_pp_ftrowned => [qw(fteowned ftzero ftsock ftchr ftblk
17ad201a
NC
63 ftfile ftdir ftpipe ftsuid ftsgid
64 ftsvtx)],
0b612f93
NC
65 Perl_pp_fttext => ['ftbinary'],
66 Perl_pp_gmtime => ['localtime'],
67 Perl_pp_semget => [qw(shmget msgget)],
68 Perl_pp_semctl => [qw(shmctl msgctl)],
0b612f93
NC
69 Perl_pp_ghostent => [qw(ghbyname ghbyaddr)],
70 Perl_pp_gnetent => [qw(gnbyname gnbyaddr)],
71 Perl_pp_gprotoent => [qw(gpbyname gpbynumber)],
72 Perl_pp_gservent => [qw(gsbyname gsbyport)],
73 Perl_pp_gpwent => [qw(gpwnam gpwuid)],
74 Perl_pp_ggrent => [qw(ggrnam ggrgid)],
957b0e1d 75 Perl_pp_ftis => [qw(ftsize ftmtime ftatime ftctime)],
605b9385 76 Perl_pp_chown => [qw(unlink chmod utime kill)],
ce6987d0 77 Perl_pp_link => ['symlink'],
af9e49b4
NC
78 Perl_pp_ftrread => [qw(ftrwrite ftrexec fteread ftewrite
79 fteexec)],
ca563b4e 80 Perl_pp_shmwrite => [qw(shmread msgsnd msgrcv semop)],
64a1bc8e 81 Perl_pp_send => ['syswrite'],
c960fc3b 82 Perl_pp_defined => [qw(dor dorassign)],
62726f23
SP
83 Perl_pp_and => ['andassign'],
84 Perl_pp_or => ['orassign'],
12e9c124 85 Perl_pp_ucfirst => ['lcfirst'],
afd9910b 86 Perl_pp_sle => [qw(slt sgt sge)],
0d863452 87 Perl_pp_print => ['say'],
2723d216 88 Perl_pp_index => ['rindex'],
daa2adfd 89 Perl_pp_oct => ['hex'],
789b4bc9 90 Perl_pp_shift => ['pop'],
71302fe3 91 Perl_pp_sin => [qw(cos exp log sqrt)],
3658c1f1 92 Perl_pp_bit_or => ['bit_xor'],
17ab7946 93 Perl_pp_rv2av => ['rv2hv'],
878d132a 94 Perl_pp_akeys => ['avalues'],
605b9385 95 );
1d5774de
NC
96
97while (my ($func, $names) = splice @raw_alias, 0, 2) {
6faeeb49 98 $alias{$_} = $func for @$names;
1d5774de
NC
99}
100
79072805
LW
101# Emit defines.
102
748a9306 103print <<"END";
37442d52
RGS
104/* -*- buffer-read-only: t -*-
105 *
d6376244
JH
106 * opcode.h
107 *
699a97de
RGS
108 * Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
109 * 2001, 2002, 2003, 2004, 2005, 2006, 2007 by Larry Wall and others
d6376244
JH
110 *
111 * You may distribute under the terms of either the GNU General Public
112 * License or the Artistic License, as specified in the README file.
113 *
114 * !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
115 * This file is built by opcode.pl from its data. Any changes made here
116 * will be lost!
117 */
a27f85b3 118
27da23d5
JH
119#ifndef PERL_GLOBAL_STRUCT_INIT
120
864dbfa3
GS
121#define Perl_pp_i_preinc Perl_pp_preinc
122#define Perl_pp_i_predec Perl_pp_predec
123#define Perl_pp_i_postinc Perl_pp_postinc
124#define Perl_pp_i_postdec Perl_pp_postdec
748a9306 125
65bca31a
NC
126PERL_PPDEF(Perl_unimplemented_op)
127
748a9306 128END
abdd5c84
GS
129
130print ON <<"END";
37442d52
RGS
131/* -*- buffer-read-only: t -*-
132 *
d6376244
JH
133 * opnames.h
134 *
cfc85103 135 * Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
699a97de 136 * 2007 by Larry Wall and others
d6376244
JH
137 *
138 * You may distribute under the terms of either the GNU General Public
139 * License or the Artistic License, as specified in the README file.
140 *
141 *
142 * !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
143 * This file is built by opcode.pl from its data. Any changes made here
144 * will be lost!
145 */
abdd5c84
GS
146
147typedef enum opcode {
148END
149
d6480c9d 150my $i = 0;
79072805 151for (@ops) {
abdd5c84 152 print ON "\t", &tab(3,"OP_\U$_,"), "/* ", $i++, " */\n";
79072805 153}
abdd5c84
GS
154print ON "\t", &tab(3,"OP_max"), "\n";
155print ON "} opcode;\n";
4c80c0b2
NC
156print ON "\n#define MAXO ", scalar @ops, "\n";
157print ON "#define OP_phoney_INPUT_ONLY -1\n";
158print ON "#define OP_phoney_OUTPUT_ONLY -2\n\n";
79072805 159
c07a80fd 160# Emit op names and descriptions.
79072805
LW
161
162print <<END;
73c4f7a1
GS
163START_EXTERN_C
164
4a36906c
RGS
165#define OP_NAME(o) ((o)->op_type == OP_CUSTOM ? custom_op_name(o) : \\
166 PL_op_name[(o)->op_type])
167#define OP_DESC(o) ((o)->op_type == OP_CUSTOM ? custom_op_desc(o) : \\
168 PL_op_desc[(o)->op_type])
53e06cf0 169
79072805 170#ifndef DOINIT
27da23d5 171EXTCONST char* const PL_op_name[];
79072805 172#else
27da23d5 173EXTCONST char* const PL_op_name[] = {
79072805
LW
174END
175
176for (@ops) {
c07a80fd
PP
177 print qq(\t"$_",\n);
178}
179
180print <<END;
181};
182#endif
183
184END
185
186print <<END;
187#ifndef DOINIT
27da23d5 188EXTCONST char* const PL_op_desc[];
c07a80fd 189#else
27da23d5 190EXTCONST char* const PL_op_desc[] = {
c07a80fd
PP
191END
192
193for (@ops) {
42d38218
MS
194 my($safe_desc) = $desc{$_};
195
a567e93b 196 # Have to escape double quotes and escape characters.
42d38218
MS
197 $safe_desc =~ s/(^|[^\\])([\\"])/$1\\$2/g;
198
199 print qq(\t"$safe_desc",\n);
79072805
LW
200}
201
202print <<END;
203};
204#endif
205
73c4f7a1
GS
206END_EXTERN_C
207
27da23d5 208#endif /* !PERL_GLOBAL_STRUCT_INIT */
22c35a8c 209END
79072805 210
22c35a8c 211# Emit function declarations.
79072805 212
22c35a8c 213#for (sort keys %ckname) {
cea2e8a9 214# print "OP *\t", &tab(3,$_),"(pTHX_ OP* o);\n";
22c35a8c
GS
215#}
216#
217#print "\n";
218#
219#for (@ops) {
cea2e8a9 220# print "OP *\t", &tab(3, "pp_$_"), "(pTHX);\n";
22c35a8c 221#}
79072805
LW
222
223# Emit ppcode switch array.
224
225print <<END;
226
73c4f7a1
GS
227START_EXTERN_C
228
27da23d5 229#ifdef PERL_GLOBAL_STRUCT_INIT
97aff369 230# define PERL_PPADDR_INITED
27da23d5 231static const Perl_ppaddr_t Gppaddr[]
79072805 232#else
27da23d5 233# ifndef PERL_GLOBAL_STRUCT
97aff369 234# define PERL_PPADDR_INITED
27da23d5
JH
235EXT Perl_ppaddr_t PL_ppaddr[] /* or perlvars.h */
236# endif
237#endif /* PERL_GLOBAL_STRUCT */
238#if (defined(DOINIT) && !defined(PERL_GLOBAL_STRUCT)) || defined(PERL_GLOBAL_STRUCT_INIT)
97aff369 239# define PERL_PPADDR_INITED
27da23d5 240= {
79072805
LW
241END
242
243for (@ops) {
6faeeb49
MB
244 if (my $name = $alias{$_}) {
245 print "\tMEMBER_TO_FPTR($name),\t/* Perl_pp_$_ */\n";
246 }
247 else {
248 print "\tMEMBER_TO_FPTR(Perl_pp_$_),\n";
249 }
79072805
LW
250}
251
252print <<END;
27da23d5 253}
79072805 254#endif
97aff369 255#ifdef PERL_PPADDR_INITED
27da23d5 256;
97aff369 257#endif
79072805
LW
258
259END
260
261# Emit check routines.
262
263print <<END;
27da23d5 264#ifdef PERL_GLOBAL_STRUCT_INIT
97aff369 265# define PERL_CHECK_INITED
27da23d5 266static const Perl_check_t Gcheck[]
79072805 267#else
27da23d5 268# ifndef PERL_GLOBAL_STRUCT
97aff369 269# define PERL_CHECK_INITED
27da23d5
JH
270EXT Perl_check_t PL_check[] /* or perlvars.h */
271# endif
272#endif
273#if (defined(DOINIT) && !defined(PERL_GLOBAL_STRUCT)) || defined(PERL_GLOBAL_STRUCT_INIT)
97aff369 274# define PERL_CHECK_INITED
27da23d5 275= {
79072805
LW
276END
277
278for (@ops) {
2b260de0 279 print "\t", &tab(3, "MEMBER_TO_FPTR(Perl_$check{$_}),"), "\t/* $_ */\n";
79072805
LW
280}
281
282print <<END;
27da23d5 283}
79072805 284#endif
97aff369 285#ifdef PERL_CHECK_INITED
27da23d5 286;
97aff369 287#endif /* #ifdef PERL_CHECK_INITED */
79072805
LW
288
289END
290
291# Emit allowed argument types.
292
c2dedb93
MHM
293my $ARGBITS = 32;
294
79072805 295print <<END;
27da23d5
JH
296#ifndef PERL_GLOBAL_STRUCT_INIT
297
79072805 298#ifndef DOINIT
1ccb7c8d 299EXTCONST U32 PL_opargs[];
79072805 300#else
1ccb7c8d 301EXTCONST U32 PL_opargs[] = {
79072805
LW
302END
303
d6480c9d
NC
304my %argnum = (
305 'S', 1, # scalar
306 'L', 2, # list
307 'A', 3, # array value
308 'H', 4, # hash value
309 'C', 5, # code value
310 'F', 6, # file value
311 'R', 7, # scalar reference
79072805
LW
312);
313
d6480c9d 314my %opclass = (
db173bac
MB
315 '0', 0, # baseop
316 '1', 1, # unop
317 '2', 2, # binop
318 '|', 3, # logop
1a67a97c
SM
319 '@', 4, # listop
320 '/', 5, # pmop
350de78d 321 '$', 6, # svop_or_padop
7934575e 322 '#', 7, # padop
1a67a97c
SM
323 '"', 8, # pvop_or_svop
324 '{', 9, # loop
325 ';', 10, # cop
326 '%', 11, # baseop_or_unop
327 '-', 12, # filestatop
328 '}', 13, # loopexop
db173bac
MB
329);
330
c2dedb93
MHM
331my %opflags = (
332 'm' => 1, # needs stack mark
333 'f' => 2, # fold constants
334 's' => 4, # always produces scalar
335 't' => 8, # needs target scalar
336 'T' => 8 | 256, # ... which may be lexical
337 'i' => 16, # always produces integer
338 'I' => 32, # has corresponding int op
339 'd' => 64, # danger, unknown side effects
340 'u' => 128, # defaults to $_
341);
342
a85d93d9
JH
343my %OP_IS_SOCKET;
344my %OP_IS_FILETEST;
c2dedb93
MHM
345my $OCSHIFT = 9;
346my $OASHIFT = 13;
a85d93d9 347
c2dedb93 348for my $op (@ops) {
d6480c9d 349 my $argsum = 0;
c2dedb93
MHM
350 my $flags = $flags{$op};
351 for my $flag (keys %opflags) {
352 if ($flags =~ s/$flag//) {
353 die "Flag collision for '$op' ($flags{$op}, $flag)"
354 if $argsum & $opflags{$flag};
355 $argsum |= $opflags{$flag};
356 }
357 }
358 die qq[Opcode '$op' has no class indicator ($flags{$op} => $flags)]
359 unless exists $opclass{$flags};
360 $argsum |= $opclass{$flags} << $OCSHIFT;
361 my $argshift = $OASHIFT;
362 for my $arg (split(' ',$args{$op})) {
a85d93d9 363 if ($arg =~ /^F/) {
c2dedb93
MHM
364 $OP_IS_SOCKET{$op} = 1 if $arg =~ s/s//;
365 $OP_IS_FILETEST{$op} = 1 if $arg =~ s/-//;
a85d93d9 366 }
d6480c9d 367 my $argnum = ($arg =~ s/\?//) ? 8 : 0;
c2dedb93
MHM
368 die "op = $op, arg = $arg\n"
369 unless exists $argnum{$arg};
79072805 370 $argnum += $argnum{$arg};
c2dedb93
MHM
371 die "Argument overflow for '$op'\n"
372 if $argshift >= $ARGBITS ||
373 $argnum > ((1 << ($ARGBITS - $argshift)) - 1);
374 $argsum += $argnum << $argshift;
375 $argshift += 4;
79072805
LW
376 }
377 $argsum = sprintf("0x%08x", $argsum);
c2dedb93 378 print "\t", &tab(3, "$argsum,"), "/* $op */\n";
79072805
LW
379}
380
381print <<END;
382};
383#endif
73c4f7a1 384
bae1192d
JH
385#endif /* !PERL_GLOBAL_STRUCT_INIT */
386
73c4f7a1 387END_EXTERN_C
27da23d5 388
79072805
LW
389END
390
a85d93d9
JH
391if (keys %OP_IS_SOCKET) {
392 print ON "\n#define OP_IS_SOCKET(op) \\\n\t(";
393 print ON join(" || \\\n\t ",
394 map { "(op) == OP_" . uc() } sort keys %OP_IS_SOCKET);
395 print ON ")\n\n";
396}
397
398if (keys %OP_IS_FILETEST) {
399 print ON "\n#define OP_IS_FILETEST(op) \\\n\t(";
400 print ON join(" || \\\n\t ",
401 map { "(op) == OP_" . uc() } sort keys %OP_IS_FILETEST);
402 print ON ")\n\n";
403}
404
37442d52
RGS
405print OC "/* ex: set ro: */\n";
406print ON "/* ex: set ro: */\n";
407
735e0d5c 408close OC or die "Error closing opcode.h: $!";
abdd5c84 409close ON or die "Error closing opnames.h: $!";
735e0d5c 410
36bb303b
NC
411foreach ('opcode.h', 'opnames.h') {
412 safer_rename_silent $_, "$_-old";
413}
414safer_rename $opcode_new, 'opcode.h';
415safer_rename $opname_new, 'opnames.h';
46f659cb 416
d6480c9d
NC
417my $pp_proto_new = 'pp_proto.h-new';
418my $pp_sym_new = 'pp.sym-new';
bb6f4497
CL
419
420open PP, ">$pp_proto_new" or die "Error creating $pp_proto_new: $!";
dfb1454f 421binmode PP;
bb6f4497 422open PPSYM, ">$pp_sym_new" or die "Error creating $pp_sym_new: $!";
dfb1454f 423binmode PPSYM;
22c35a8c 424
a27f85b3 425print PP <<"END";
37442d52
RGS
426/* -*- buffer-read-only: t -*-
427 !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
a27f85b3
GS
428 This file is built by opcode.pl from its data. Any changes made here
429 will be lost!
430*/
431
432END
433
434print PPSYM <<"END";
37442d52 435# -*- buffer-read-only: t -*-
a27f85b3 436#
a567e93b 437# !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
a27f85b3
GS
438# This file is built by opcode.pl from its data. Any changes made here
439# will be lost!
440#
441
442END
443
444
22c35a8c 445for (sort keys %ckname) {
864dbfa3
GS
446 print PP "PERL_CKDEF(Perl_$_)\n";
447 print PPSYM "Perl_$_\n";
20ce7b12 448#OP *\t", &tab(3,$_),"(OP* o);\n";
22c35a8c
GS
449}
450
451print PP "\n\n";
452
735e0d5c 453for (@ops) {
15e52e56 454 next if /^i_(pre|post)(inc|dec)$/;
53e06cf0 455 next if /^custom$/;
864dbfa3
GS
456 print PP "PERL_PPDEF(Perl_pp_$_)\n";
457 print PPSYM "Perl_pp_$_\n";
735e0d5c 458}
37442d52
RGS
459print PP "\n/* ex: set ro: */\n";
460print PPSYM "\n# ex: set ro:\n";
735e0d5c
IZ
461
462close PP or die "Error closing pp_proto.h: $!";
22c35a8c 463close PPSYM or die "Error closing pp.sym: $!";
735e0d5c 464
36bb303b
NC
465foreach ('pp_proto.h', 'pp.sym') {
466 safer_rename_silent $_, "$_-old";
467}
468safer_rename $pp_proto_new, 'pp_proto.h';
469safer_rename $pp_sym_new, 'pp.sym';
46f659cb 470
24600adc
JH
471END {
472 foreach ('opcode.h', 'opnames.h', 'pp_proto.h', 'pp.sym') {
473 1 while unlink "$_-old";
474 }
475}
476
79072805
LW
477###########################################################################
478sub tab {
d6480c9d 479 my ($l, $t) = @_;
79072805
LW
480 $t .= "\t" x ($l - (length($t) + 1) / 8);
481 $t;
482}
483###########################################################################
b162f9ea
IZ
484
485# Some comments about 'T' opcode classifier:
486
487# Safe to set if the ppcode uses:
488# tryAMAGICbin, tryAMAGICun, SETn, SETi, SETu, PUSHn, PUSHTARG, SETTARG,
489# SETs(TARG), XPUSHn, XPUSHu,
490
491# Unsafe to set if the ppcode uses dTARG or [X]RETPUSH[YES|NO|UNDEF]
492
493# lt and friends do SETs (including ncmp, but not scmp)
494
21f5b33c
GS
495# Additional mode of failure: the opcode can modify TARG before it "used"
496# all the arguments (or may call an external function which does the same).
497# If the target coincides with one of the arguments ==> kaboom.
498
b162f9ea
IZ
499# pp.c pos substr each not OK (RETPUSHUNDEF)
500# substr vec also not OK due to LV to target (are they???)
501# ref not OK (RETPUSHNO)
502# trans not OK (dTARG; TARG = sv_newmortal();)
503# ucfirst etc not OK: TMP arg processed inplace
69b47968 504# quotemeta not OK (unsafe when TARG == arg)
91e74348 505# each repeat not OK too due to list context
b162f9ea 506# pack split - unknown whether they are safe
dae78bb1
IZ
507# sprintf: is calling do_sprintf(TARG,...) which can act on TARG
508# before other args are processed.
b162f9ea 509
21f5b33c
GS
510# Suspicious wrt "additional mode of failure" (and only it):
511# schop, chop, postinc/dec, bit_and etc, negate, complement.
512
513# Also suspicious: 4-arg substr, sprintf, uc/lc (POK_only), reverse, pack.
514
515# substr/vec: doing TAINT_off()???
516
b162f9ea
IZ
517# pp_hot.c
518# readline - unknown whether it is safe
519# match subst not OK (dTARG)
520# grepwhile not OK (not always setting)
69b47968 521# join not OK (unsafe when TARG == arg)
b162f9ea 522
21f5b33c
GS
523# Suspicious wrt "additional mode of failure": concat (dealt with
524# in ck_sassign()), join (same).
525
b162f9ea
IZ
526# pp_ctl.c
527# mapwhile flip caller not OK (not always setting)
528
529# pp_sys.c
530# backtick glob warn die not OK (not always setting)
531# warn not OK (RETPUSHYES)
532# open fileno getc sysread syswrite ioctl accept shutdown
533# ftsize(etc) readlink telldir fork alarm getlogin not OK (RETPUSHUNDEF)
534# umask select not OK (XPUSHs(&PL_sv_undef);)
535# fileno getc sysread syswrite tell not OK (meth("FILENO" "GETC"))
536# sselect shm* sem* msg* syscall - unknown whether they are safe
537# gmtime not OK (list context)
538
21f5b33c
GS
539# Suspicious wrt "additional mode of failure": warn, die, select.
540
79072805
LW
541__END__
542
d83386fa
NC
543# New ops always go at the end
544# The restriction on having custom as the last op has been removed
7399586d 545
64b99527
SC
546# A recapitulation of the format of this file:
547# The file consists of five columns: the name of the op, an English
548# description, the name of the "check" routine used to optimize this
549# operation, some flags, and a description of the operands.
550
551# The flags consist of options followed by a mandatory op class signifier
552
553# The classes are:
554# baseop - 0 unop - 1 binop - 2
555# logop - | listop - @ pmop - /
556# padop/svop - $ padop - # (unused) loop - {
557# baseop/unop - % loopexop - } filestatop - -
3508218b 558# pvop/svop - " cop - ;
64b99527
SC
559
560# Other options are:
561# needs stack mark - m
562# needs constant folding - f
563# produces a scalar - s
564# produces an integer - i
565# needs a target - t
566# target can be in a pad - T
567# has a corresponding integer version - I
568# has side effects - d
569# uses $_ if no argument given - u
570
571# Values for the operands are:
572# scalar - S list - L array - A
573# hash - H sub (CV) - C file - F
574# socket - Fs filetest - F- reference - R
575# "?" denotes an optional operand.
576
79072805
LW
577# Nothing.
578
579null null operation ck_null 0
93a17b20 580stub stub ck_null 0
db173bac 581scalar scalar ck_fun s% S
79072805
LW
582
583# Pushy stuff.
584
db173bac
MB
585pushmark pushmark ck_null s0
586wantarray wantarray ck_null is0
79072805 587
db173bac 588const constant item ck_svconst s$
79072805 589
7934575e
GS
590gvsv scalar variable ck_null ds$
591gv glob value ck_null ds$
db173bac
MB
592gelem glob elem ck_null d2 S S
593padsv private variable ck_null ds0
594padav private array ck_null d0
595padhv private hash ck_null d0
f1612b5c 596padany private value ck_null d0
79072805 597
1167e5da 598pushre push regexp ck_null d/
79072805
LW
599
600# References and stuff.
601
db173bac 602rv2gv ref-to-glob cast ck_rvconst ds1
b89fed5f 603rv2sv scalar dereference ck_rvconst ds1
db173bac 604av2arylen array length ck_null is1
b89fed5f 605rv2cv subroutine dereference ck_rvconst d1
db173bac
MB
606anoncode anonymous subroutine ck_anoncode $
607prototype subroutine prototype ck_null s% S
5d11ae5e 608refgen reference constructor ck_spair m1 L
dfa0f641 609srefgen single ref constructor ck_null fs1 S
db173bac
MB
610ref reference-type operator ck_fun stu% S?
611bless bless ck_fun s@ S S?
79072805
LW
612
613# Pushy I/O.
614
01f5bc1b 615backtick quoted execution (``, qx) ck_open tu% S?
0a753a76 616# glob defaults its first arg to $_
649da076 617glob glob ck_glob t@ S?
e4b7ebf3 618readline <HANDLE> ck_readline t% F?
5fc9b9e4 619rcatline append I/O operator ck_null t$
79072805
LW
620
621# Bindable operators.
622
f1612b5c
GS
623regcmaybe regexp internal guard ck_fun s1 S
624regcreset regexp internal reset ck_fun s1 S
625regcomp regexp compilation ck_null s| S
626match pattern match (m//) ck_match d/
627qr pattern quote (qr//) ck_match s/
59f00321 628subst substitution (s///) ck_match dis/ S
f1612b5c 629substcont substitution iterator ck_null dis|
59f00321 630trans transliteration (tr///) ck_match is" S
79072805
LW
631
632# Lvalue operators.
db173bac
MB
633# sassign is special-cased for op class
634
b162f9ea 635sassign scalar assignment ck_sassign s0
db173bac
MB
636aassign list assignment ck_null t2 L L
637
21f5b33c
GS
638chop chop ck_spair mts% L
639schop scalar chop ck_null stu% S?
f1612b5c
GS
640chomp chomp ck_spair mTs% L
641schomp scalar chomp ck_null sTu% S?
69794302 642defined defined operator ck_defined isu% S?
db173bac
MB
643undef undef operator ck_lfun s% S?
644study study ck_fun su% S?
645pos match position ck_lfun stu% S?
646
42d38218
MS
647preinc preincrement (++) ck_lfun dIs1 S
648i_preinc integer preincrement (++) ck_lfun dis1 S
649predec predecrement (--) ck_lfun dIs1 S
650i_predec integer predecrement (--) ck_lfun dis1 S
21f5b33c 651postinc postincrement (++) ck_lfun dIst1 S
42d38218 652i_postinc integer postincrement (++) ck_lfun disT1 S
21f5b33c 653postdec postdecrement (--) ck_lfun dIst1 S
42d38218 654i_postdec integer postdecrement (--) ck_lfun disT1 S
79072805
LW
655
656# Ordinary operators.
657
42d38218
MS
658pow exponentiation (**) ck_null fsT2 S S
659
f1612b5c 660multiply multiplication (*) ck_null IfsT2 S S
42d38218
MS
661i_multiply integer multiplication (*) ck_null ifsT2 S S
662divide division (/) ck_null IfsT2 S S
663i_divide integer division (/) ck_null ifsT2 S S
664modulo modulus (%) ck_null IifsT2 S S
665i_modulo integer modulus (%) ck_null ifsT2 S S
666repeat repeat (x) ck_repeat mt2 L S
667
668add addition (+) ck_null IfsT2 S S
669i_add integer addition (+) ck_null ifsT2 S S
670subtract subtraction (-) ck_null IfsT2 S S
671i_subtract integer subtraction (-) ck_null ifsT2 S S
df91b2c5 672concat concatenation (.) or string ck_concat fsT2 S S
b162f9ea 673stringify string ck_fun fsT@ S
db173bac 674
42d38218
MS
675left_shift left bitshift (<<) ck_bitop fsT2 S S
676right_shift right bitshift (>>) ck_bitop fsT2 S S
677
678lt numeric lt (<) ck_null Iifs2 S S
679i_lt integer lt (<) ck_null ifs2 S S
680gt numeric gt (>) ck_null Iifs2 S S
681i_gt integer gt (>) ck_null ifs2 S S
682le numeric le (<=) ck_null Iifs2 S S
683i_le integer le (<=) ck_null ifs2 S S
684ge numeric ge (>=) ck_null Iifs2 S S
685i_ge integer ge (>=) ck_null ifs2 S S
686eq numeric eq (==) ck_null Iifs2 S S
687i_eq integer eq (==) ck_null ifs2 S S
688ne numeric ne (!=) ck_null Iifs2 S S
689i_ne integer ne (!=) ck_null ifs2 S S
690ncmp numeric comparison (<=>) ck_null Iifst2 S S
691i_ncmp integer comparison (<=>) ck_null ifst2 S S
db173bac 692
2de3dbcc
JH
693slt string lt ck_null ifs2 S S
694sgt string gt ck_null ifs2 S S
695sle string le ck_null ifs2 S S
696sge string ge ck_null ifs2 S S
db173bac
MB
697seq string eq ck_null ifs2 S S
698sne string ne ck_null ifs2 S S
2de3dbcc 699scmp string comparison (cmp) ck_null ifst2 S S
db173bac 700
21f5b33c
GS
701bit_and bitwise and (&) ck_bitop fst2 S S
702bit_xor bitwise xor (^) ck_bitop fst2 S S
703bit_or bitwise or (|) ck_bitop fst2 S S
db173bac 704
21f5b33c 705negate negation (-) ck_null Ifst1 S
f1612b5c 706i_negate integer negation (-) ck_null ifsT1 S
db173bac 707not not ck_null ifs1 S
21f5b33c 708complement 1's complement (~) ck_bitop fst1 S
79072805 709
fdecdb95
NC
710smartmatch smart match ck_smartmatch s2
711
79072805
LW
712# High falutin' math.
713
f1612b5c
GS
714atan2 atan2 ck_fun fsT@ S S
715sin sin ck_fun fsTu% S?
716cos cos ck_fun fsTu% S?
717rand rand ck_fun sT% S?
718srand srand ck_fun s% S?
719exp exp ck_fun fsTu% S?
720log log ck_fun fsTu% S?
721sqrt sqrt ck_fun fsTu% S?
79072805 722
cf26c822
CS
723# Lowbrow math.
724
b162f9ea
IZ
725int int ck_fun fsTu% S?
726hex hex ck_fun fsTu% S?
727oct oct ck_fun fsTu% S?
728abs abs ck_fun fsTu% S?
79072805
LW
729
730# String stuff.
731
b162f9ea 732length length ck_lengthconst isTu% S?
35fba0d9 733substr substr ck_substr st@ S S S? S?
db173bac 734vec vec ck_fun ist@ S S S
79072805 735
b162f9ea
IZ
736index index ck_index isT@ S S S?
737rindex rindex ck_index isT@ S S S?
79072805 738
fc7325bb 739sprintf sprintf ck_fun mst@ S L
db173bac 740formline formline ck_fun ms@ S L
b162f9ea
IZ
741ord ord ck_fun ifsTu% S?
742chr chr ck_fun fsTu% S?
743crypt crypt ck_fun fsT@ S S
2de3dbcc
JH
744ucfirst ucfirst ck_fun fstu% S?
745lcfirst lcfirst ck_fun fstu% S?
746uc uc ck_fun fstu% S?
747lc lc ck_fun fstu% S?
69b47968 748quotemeta quotemeta ck_fun fstu% S?
79072805
LW
749
750# Arrays.
751
f1612b5c 752rv2av array dereference ck_rvconst dt1
7934575e 753aelemfast constant array element ck_null s$ A S
db173bac
MB
754aelem array element ck_null s2 A S
755aslice array slice ck_null m@ A L
79072805 756
878d132a
NC
757aeach each on array ck_each % A
758akeys keys on array ck_each t% A
759avalues values on array ck_each t% A
760
aa689395 761# Hashes.
79072805 762
878d132a
NC
763each each ck_each % H
764values values ck_each t% H
765keys keys ck_each t% H
db173bac 766delete delete ck_delete % S
42d38218 767exists exists ck_exists is% S
f1612b5c 768rv2hv hash dereference ck_rvconst dt1
c2dedb93 769helem hash element ck_null s2 H S
db173bac 770hslice hash slice ck_null m@ H L
79072805
LW
771
772# Explosives and implosives.
773
bab9c0ac 774unpack unpack ck_unpack @ S S?
db173bac
MB
775pack pack ck_fun mst@ S L
776split split ck_split t@ S S S
297b36dc 777join join or string ck_join mst@ S L
79072805
LW
778
779# List operators.
780
db173bac
MB
781list list ck_null m@ L
782lslice list slice ck_null 2 H L L
42d38218
MS
783anonlist anonymous list ([]) ck_fun ms@ L
784anonhash anonymous hash ({}) ck_fun ms@ L
79072805 785
db173bac 786splice splice ck_fun m@ A S? S? L
b162f9ea 787push push ck_fun imsT@ A L
26f600bc
RGS
788pop pop ck_shift s% A?
789shift shift ck_shift s% A?
b162f9ea 790unshift unshift ck_fun imsT@ A L
9850bf21 791sort sort ck_sort dm@ C? L
db173bac 792reverse reverse ck_fun mt@ L
79072805 793
f1612b5c
GS
794grepstart grep ck_grep dm@ C L
795grepwhile grep iterator ck_null dt|
79072805 796
f1612b5c
GS
797mapstart map ck_grep dm@ C L
798mapwhile map iterator ck_null dt|
a0d0e21e 799
79072805
LW
800# Range stuff.
801
1a67a97c 802range flipflop ck_null | S S
db173bac
MB
803flip range (or flip) ck_null 1 S S
804flop range (or flop) ck_null 1
79072805
LW
805
806# Control.
807
42d38218 808and logical and (&&) ck_null |
f1612b5c
GS
809or logical or (||) ck_null |
810xor logical xor ck_null fs2 S S
fdecdb95 811dor defined or (//) ck_null |
f1612b5c 812cond_expr conditional expression ck_null d|
42d38218
MS
813andassign logical and assignment (&&=) ck_null s|
814orassign logical or assignment (||=) ck_null s|
fdecdb95 815dorassign defined or assignment (//=) ck_null s|
db173bac 816
f5d5a27c 817method method lookup ck_method d1
db173bac
MB
818entersub subroutine entry ck_subr dmt1 L
819leavesub subroutine exit ck_null 1
78f9721b 820leavesublv lvalue subroutine return ck_null 1
db173bac
MB
821caller caller ck_fun t% S?
822warn warn ck_fun imst@ L
96e176bf 823die die ck_die dimst@ L
f1612b5c 824reset symbol reset ck_fun is% S?
db173bac
MB
825
826lineseq line sequence ck_null @
722969e2
DM
827nextstate next statement ck_null s;
828dbstate debug next statement ck_null s;
e9c54c90 829unstack iteration finalizer ck_null s0
79072805 830enter block entry ck_null 0
db173bac
MB
831leave block exit ck_null @
832scope block ck_null @
833enteriter foreach loop entry ck_null d{
79072805 834iter foreach loop iterator ck_null 0
db173bac
MB
835enterloop loop entry ck_null d{
836leaveloop loop exit ck_null 2
78f9721b 837return return ck_return dm@ L
db173bac
MB
838last last ck_null ds}
839next next ck_null ds}
840redo redo ck_null ds}
841dump dump ck_null ds}
842goto goto ck_null ds}
d98f61e7 843exit exit ck_exit ds% S?
fdecdb95
NC
844method_named method with known name ck_null d$
845
846entergiven given() ck_null d|
847leavegiven leave given block ck_null 1
848enterwhen when() ck_null d|
849leavewhen leave when block ck_null 1
850break break ck_null 0
851continue continue ck_null 0
79072805 852
79072805
LW
853# I/O.
854
a567e93b 855open open ck_open ismt@ F S? L
db173bac
MB
856close close ck_fun is% F?
857pipe_op pipe ck_fun is@ F F
79072805 858
db173bac 859fileno fileno ck_fun ist% F
a86a20aa 860umask umask ck_fun ist% S?
1c1fc3ea 861binmode binmode ck_fun s@ F S?
79072805 862
db173bac
MB
863tie tie ck_fun idms@ R S L
864untie untie ck_fun is% R
865tied tied ck_fun s% R
866dbmopen dbmopen ck_fun is@ H S S
867dbmclose dbmclose ck_fun is% H
79072805 868
db173bac
MB
869sselect select system call ck_select t@ S S S S
870select select ck_select st@ F?
79072805 871
db173bac 872getc getc ck_eof st% F?
d1a002d4 873read read ck_fun imst@ F R S S?
db173bac
MB
874enterwrite write ck_fun dis% F?
875leavewrite write exit ck_null 1
79072805 876
db173bac
MB
877prtf printf ck_listiob ims@ F? L
878print print ck_listiob ims@ F? L
fdecdb95 879say say ck_listiob ims@ F? L
79072805 880
db173bac
MB
881sysopen sysopen ck_fun s@ F S S S?
882sysseek sysseek ck_fun s@ F S S
d1a002d4 883sysread sysread ck_fun imst@ F R S S?
145d37e2 884syswrite syswrite ck_fun imst@ F S S? S?
79072805 885
a85d93d9
JH
886send send ck_fun imst@ Fs S S S?
887recv recv ck_fun imst@ Fs R S S
79072805 888
db173bac
MB
889eof eof ck_eof is% F?
890tell tell ck_fun st% F?
891seek seek ck_fun s@ F S S
9b01e405 892# truncate really behaves as if it had both "S S" and "F S"
db173bac 893truncate truncate ck_trunc is@ S S
79072805 894
db173bac
MB
895fcntl fcntl ck_fun st@ F S S
896ioctl ioctl ck_fun st@ F S S
b162f9ea 897flock flock ck_fun isT@ F S
79072805
LW
898
899# Sockets.
900
a85d93d9
JH
901socket socket ck_fun is@ Fs S S S
902sockpair socketpair ck_fun is@ Fs Fs S S S
79072805 903
a85d93d9
JH
904bind bind ck_fun is@ Fs S
905connect connect ck_fun is@ Fs S
906listen listen ck_fun is@ Fs S
907accept accept ck_fun ist@ Fs Fs
908shutdown shutdown ck_fun ist@ Fs S
79072805 909
a85d93d9
JH
910gsockopt getsockopt ck_fun is@ Fs S S
911ssockopt setsockopt ck_fun is@ Fs S S S
79072805 912
a85d93d9
JH
913getsockname getsockname ck_fun is% Fs
914getpeername getpeername ck_fun is% Fs
79072805
LW
915
916# Stat calls.
917
db173bac
MB
918lstat lstat ck_ftst u- F
919stat stat ck_ftst u- F
a85d93d9
JH
920ftrread -R ck_ftst isu- F-
921ftrwrite -W ck_ftst isu- F-
922ftrexec -X ck_ftst isu- F-
923fteread -r ck_ftst isu- F-
924ftewrite -w ck_ftst isu- F-
925fteexec -x ck_ftst isu- F-
926ftis -e ck_ftst isu- F-
a85d93d9
JH
927ftsize -s ck_ftst istu- F-
928ftmtime -M ck_ftst stu- F-
929ftatime -A ck_ftst stu- F-
930ftctime -C ck_ftst stu- F-
7834bb7e
NC
931ftrowned -O ck_ftst isu- F-
932fteowned -o ck_ftst isu- F-
933ftzero -z ck_ftst isu- F-
a85d93d9
JH
934ftsock -S ck_ftst isu- F-
935ftchr -c ck_ftst isu- F-
936ftblk -b ck_ftst isu- F-
937ftfile -f ck_ftst isu- F-
938ftdir -d ck_ftst isu- F-
939ftpipe -p ck_ftst isu- F-
a85d93d9
JH
940ftsuid -u ck_ftst isu- F-
941ftsgid -g ck_ftst isu- F-
942ftsvtx -k ck_ftst isu- F-
7834bb7e 943ftlink -l ck_ftst isu- F-
a85d93d9
JH
944fttty -t ck_ftst is- F-
945fttext -T ck_ftst isu- F-
946ftbinary -B ck_ftst isu- F-
79072805
LW
947
948# File calls.
949
d4ac975e
GA
950# chdir really behaves as if it had both "S?" and "F?"
951chdir chdir ck_chdir isT% S?
b162f9ea
IZ
952chown chown ck_fun imsT@ L
953chroot chroot ck_fun isTu% S?
954unlink unlink ck_fun imsTu@ L
a86a20aa 955chmod chmod ck_fun imsT@ L
b162f9ea
IZ
956utime utime ck_fun imsT@ L
957rename rename ck_fun isT@ S S
958link link ck_fun isT@ S S
959symlink symlink ck_fun isT@ S S
db173bac 960readlink readlink ck_fun stu% S?
491873e5 961mkdir mkdir ck_fun isTu@ S? S?
b162f9ea 962rmdir rmdir ck_fun isTu% S?
79072805
LW
963
964# Directory calls.
965
1e2c6ed7 966open_dir opendir ck_fun is@ F S
db173bac
MB
967readdir readdir ck_fun % F
968telldir telldir ck_fun st% F
969seekdir seekdir ck_fun s@ F S
970rewinddir rewinddir ck_fun s% F
971closedir closedir ck_fun is% F
79072805
LW
972
973# Process control.
974
db173bac 975fork fork ck_null ist0
b162f9ea
IZ
976wait wait ck_null isT0
977waitpid waitpid ck_fun isT@ S S
978system system ck_exec imsT@ S? L
979exec exec ck_exec dimsT@ S? L
980kill kill ck_fun dimsT@ L
981getppid getppid ck_null isT0
982getpgrp getpgrp ck_fun isT% S?
983setpgrp setpgrp ck_fun isT@ S? S?
984getpriority getpriority ck_fun isT@ S S
985setpriority setpriority ck_fun isT@ S S S
79072805
LW
986
987# Time calls.
988
cd39f2b6
JH
989# NOTE: MacOS patches the 'i' of time() away later when the interpreter
990# is created because in MacOS time() is already returning times > 2**31-1,
991# that is, non-integers.
992
b162f9ea 993time time ck_null isT0
79072805 994tms times ck_null 0
db173bac
MB
995localtime localtime ck_fun t% S?
996gmtime gmtime ck_fun t% S?
997alarm alarm ck_fun istu% S?
b162f9ea 998sleep sleep ck_fun isT% S?
79072805
LW
999
1000# Shared memory.
1001
db173bac
MB
1002shmget shmget ck_fun imst@ S S S
1003shmctl shmctl ck_fun imst@ S S S
1004shmread shmread ck_fun imst@ S S S S
1005shmwrite shmwrite ck_fun imst@ S S S S
79072805
LW
1006
1007# Message passing.
1008
db173bac
MB
1009msgget msgget ck_fun imst@ S S
1010msgctl msgctl ck_fun imst@ S S S
1011msgsnd msgsnd ck_fun imst@ S S S
1012msgrcv msgrcv ck_fun imst@ S S S S S
79072805
LW
1013
1014# Semaphores.
1015
7834bb7e 1016semop semop ck_fun imst@ S S
db173bac
MB
1017semget semget ck_fun imst@ S S S
1018semctl semctl ck_fun imst@ S S S S
79072805
LW
1019
1020# Eval.
1021
db173bac 1022require require ck_require du% S?
b3f4d674
GS
1023dofile do "file" ck_fun d1 S
1024entereval eval "string" ck_eval d% S
1025leaveeval eval "string" exit ck_null 1 S
db173bac 1026#evalonce eval constant string ck_null d1 S
42d38218 1027entertry eval {block} ck_null |
f1612b5c 1028leavetry eval {block} exit ck_null @
79072805
LW
1029
1030# Get system info.
1031
db173bac
MB
1032ghbyname gethostbyname ck_fun % S
1033ghbyaddr gethostbyaddr ck_fun @ S S
79072805 1034ghostent gethostent ck_null 0
db173bac
MB
1035gnbyname getnetbyname ck_fun % S
1036gnbyaddr getnetbyaddr ck_fun @ S S
79072805 1037gnetent getnetent ck_null 0
db173bac
MB
1038gpbyname getprotobyname ck_fun % S
1039gpbynumber getprotobynumber ck_fun @ S
79072805 1040gprotoent getprotoent ck_null 0
db173bac
MB
1041gsbyname getservbyname ck_fun @ S S
1042gsbyport getservbyport ck_fun @ S S
79072805 1043gservent getservent ck_null 0
db173bac
MB
1044shostent sethostent ck_fun is% S
1045snetent setnetent ck_fun is% S
1046sprotoent setprotoent ck_fun is% S
1047sservent setservent ck_fun is% S
1048ehostent endhostent ck_null is0
1049enetent endnetent ck_null is0
1050eprotoent endprotoent ck_null is0
1051eservent endservent ck_null is0
1052gpwnam getpwnam ck_fun % S
1053gpwuid getpwuid ck_fun % S
79072805 1054gpwent getpwent ck_null 0
db173bac
MB
1055spwent setpwent ck_null is0
1056epwent endpwent ck_null is0
1057ggrnam getgrnam ck_fun % S
1058ggrgid getgrgid ck_fun % S
79072805 1059ggrent getgrent ck_null 0
db173bac
MB
1060sgrent setgrent ck_null is0
1061egrent endgrent ck_null is0
1062getlogin getlogin ck_null st0
79072805
LW
1063
1064# Miscellaneous.
1065
db173bac 1066syscall syscall ck_fun imst@ S L
c0329465
MB
1067
1068# For multi-threading
5a47f09b 1069lock lock ck_rfun s% R
7399586d 1070
c5917253
NC
1071# For state support
1072
1073once once ck_null |
1074
53e06cf0 1075custom unknown custom operator ck_null 0