This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perl 3.0 patch #3 Patch #2 continued
[perl5.git] / perl.h
CommitLineData
03a14243 1/* $Header: perl.h,v 3.0.1.1 89/10/26 23:17:08 lwall Locked $
a687059c
LW
2 *
3 * Copyright (c) 1989, Larry Wall
4 *
5 * You may distribute under the terms of the GNU General Public License
6 * as specified in the README file that comes with the perl 3.0 kit.
8d063cd8
LW
7 *
8 * $Log: perl.h,v $
03a14243
LW
9 * Revision 3.0.1.1 89/10/26 23:17:08 lwall
10 * patch1: vfork now conditionally defined based on VFORK
11 * patch1: DEC risc machines have a buggy memcmp
12 * patch1: perl.h now includes <netinet/in.h> if it exists
13 *
a687059c
LW
14 * Revision 3.0 89/10/18 15:21:21 lwall
15 * 3.0 baseline
8d063cd8
LW
16 *
17 */
18
378cc40b 19#ifndef lint
8d063cd8 20#define DEBUGGING
378cc40b 21#endif
8d063cd8
LW
22
23#define VOIDUSED 1
24#include "config.h"
25
a687059c
LW
26#ifdef IAMSUID
27# ifndef TAINT
28# define TAINT
29# endif
30#endif
31
03a14243
LW
32#ifndef VFORK
33# define vfork fork
34#endif
35
36#if defined(MEMCMP) && defined(mips) && BYTEORDER == 01234
37#undef MEMCMP
38#endif
39
378cc40b
LW
40#ifdef MEMCPY
41extern char *memcpy(), *memset();
a687059c
LW
42#define bcopy(s1,s2,l) memcpy(s2,s1,l)
43#define bzero(s,l) memset(s,0,l)
44#endif
45#ifndef BCMP /* prefer bcmp slightly 'cuz it doesn't order */
46#define bcmp(s1,s2,l) memcmp(s1,s2,l)
8d063cd8
LW
47#endif
48
49#include <stdio.h>
50#include <ctype.h>
51#include <setjmp.h>
378cc40b
LW
52#include <sys/param.h> /* if this needs types.h we're still wrong */
53
03a14243
LW
54#ifdef I_NETINET_IN
55#include <netinet/in.h>
56#endif
57
378cc40b
LW
58#ifndef _TYPES_ /* If types.h defines this it's easy. */
59#ifndef major /* Does everyone's types.h define this? */
8d063cd8 60#include <sys/types.h>
378cc40b
LW
61#endif
62#endif
63
8d063cd8 64#include <sys/stat.h>
135863df
AB
65
66#ifdef TMINSYS
67#include <sys/time.h>
68#else
a687059c
LW
69#ifdef I_SYSTIME
70#include <sys/time.h>
71#else
8d063cd8 72#include <time.h>
135863df 73#endif
a687059c 74#endif
135863df 75
8d063cd8
LW
76#include <sys/times.h>
77
a687059c
LW
78#ifdef I_SYSIOCTL
79#ifndef _IOCTL_
80#include <sys/ioctl.h>
81#endif
82#endif
83
84#if defined(mc300) || defined(mc500) || defined(mc700) /* MASSCOMP */
85#ifdef SOCKETPAIR
86#undef SOCKETPAIR
87#endif
88#ifdef NDBM
89#undef NDBM
90#endif
91#endif
92
93#ifdef NDBM
94#include <ndbm.h>
95#define SOME_DBM
96#else
97#ifdef ODBM
98#ifdef NULL
99#undef NULL /* suppress redefinition message */
100#endif
101#include <dbm.h>
102#ifdef NULL
103#undef NULL
104#endif
105#define NULL 0 /* silly thing is, we don't even use this */
106#define SOME_DBM
107#define dbm_fetch(db,dkey) fetch(dkey)
108#define dbm_delete(db,dkey) delete(dkey)
109#define dbm_store(db,dkey,dcontent,flags) store(dkey,dcontent)
110#define dbm_close(db) dbmclose()
111#define dbm_firstkey(db) firstkey()
112#endif /* ODBM */
113#endif /* NDBM */
114#ifdef SOME_DBM
115EXT char *dbmkey;
116EXT int dbmlen;
117#endif
118
119#if INTSIZE == 2
120#define htoni htons
121#define ntohi ntohs
122#else
123#define htoni htonl
124#define ntohi ntohl
125#endif
126
127#ifdef I_DIRENT
128#include <dirent.h>
129#define DIRENT dirent
130#else
131#ifdef I_SYSDIR
132#include <sys/dir.h>
133#define DIRENT direct
134#endif
135#endif
136
8d063cd8
LW
137typedef struct arg ARG;
138typedef struct cmd CMD;
139typedef struct formcmd FCMD;
140typedef struct scanpat SPAT;
8d063cd8 141typedef struct stio STIO;
378cc40b 142typedef struct sub SUBR;
8d063cd8
LW
143typedef struct string STR;
144typedef struct atbl ARRAY;
145typedef struct htbl HASH;
378cc40b 146typedef struct regexp REGEXP;
a687059c
LW
147typedef struct stabptrs STBP;
148typedef struct stab STAB;
8d063cd8 149
378cc40b
LW
150#include "handy.h"
151#include "regexp.h"
8d063cd8 152#include "str.h"
378cc40b 153#include "util.h"
8d063cd8
LW
154#include "form.h"
155#include "stab.h"
156#include "spat.h"
157#include "arg.h"
158#include "cmd.h"
159#include "array.h"
160#include "hash.h"
161
a687059c
LW
162#if defined(iAPX286) || defined(M_I286) || defined(I80286)
163# define I286
164#endif
165
166#ifndef __STDC__
135863df
AB
167#ifdef CHARSPRINTF
168 char *sprintf();
169#else
170 int sprintf();
171#endif
a687059c 172#endif
135863df 173
8d063cd8
LW
174EXT char *Yes INIT("1");
175EXT char *No INIT("");
176
a687059c
LW
177/* "gimme" values */
178
179/* Note: cmd.c assumes that it can use && to produce one of these values! */
180#define G_SCALAR 0
181#define G_ARRAY 1
182
183#ifdef CRIPPLED_CC
184int str_true();
185#else /* !CRIPPLED_CC */
186#define str_true(str) (Str = (str), \
187 (Str->str_pok ? \
188 ((*Str->str_ptr > '0' || \
189 Str->str_cur > 1 || \
190 (Str->str_cur && *Str->str_ptr != '0')) ? 1 : 0) \
191 : \
192 (Str->str_nok ? (Str->str_u.str_nval != 0.0) : 0 ) ))
193#endif /* CRIPPLED_CC */
8d063cd8 194
135863df 195#ifdef DEBUGGING
a687059c
LW
196#define str_peek(str) (Str = (str), \
197 (Str->str_pok ? \
198 Str->str_ptr : \
199 (Str->str_nok ? \
200 (sprintf(tokenbuf,"num(%g)",Str->str_u.str_nval), \
201 (char*)tokenbuf) : \
202 "" )))
135863df
AB
203#endif
204
a687059c
LW
205#ifdef CRIPPLED_CC
206char *str_get();
207#else
208#ifdef TAINT
209#define str_get(str) (Str = (str), tainted |= Str->str_tainted, \
210 (Str->str_pok ? Str->str_ptr : str_2ptr(Str)))
211#else
8d063cd8 212#define str_get(str) (Str = (str), (Str->str_pok ? Str->str_ptr : str_2ptr(Str)))
a687059c
LW
213#endif /* TAINT */
214#endif /* CRIPPLED_CC */
215
216#ifdef CRIPPLED_CC
217double str_gnum();
218#else /* !CRIPPLED_CC */
219#ifdef TAINT
220#define str_gnum(str) (Str = (str), tainted |= Str->str_tainted, \
221 (Str->str_nok ? Str->str_u.str_nval : str_2num(Str)))
222#else /* !TAINT */
223#define str_gnum(str) (Str = (str), (Str->str_nok ? Str->str_u.str_nval : str_2num(Str)))
224#endif /* TAINT*/
225#endif /* CRIPPLED_CC */
8d063cd8
LW
226EXT STR *Str;
227
228#define GROWSTR(pp,lp,len) if (*(lp) < (len)) growstr(pp,lp,len)
229
a687059c
LW
230#define STR_GROW(str,len) if ((str)->str_len < (len)) str_grow(str,len)
231
232#ifndef BYTEORDER
233#define BYTEORDER 01234
234#endif
235
236#ifndef HTONL
237#if BYTEORDER != 04321
238#define HTONS
239#define HTONL
240#define NTOHS
241#define NTOHL
242#define MYSWAP
243#define htons my_swap
244#define htonl my_htonl
245#define ntohs my_swap
246#define ntohl my_ntohl
247#endif
248#else
249#if BYTEORDER == 04321
250#undef HTONS
251#undef HTONL
252#undef NTOHS
253#undef NTOHL
254#endif
255#endif
256
8d063cd8
LW
257CMD *add_label();
258CMD *block_head();
259CMD *append_line();
260CMD *make_acmd();
261CMD *make_ccmd();
a687059c 262CMD *make_icmd();
8d063cd8
LW
263CMD *invert();
264CMD *addcond();
265CMD *addloop();
266CMD *wopt();
378cc40b 267CMD *over();
8d063cd8 268
8d063cd8 269STAB *stabent();
378cc40b 270STAB *genstab();
8d063cd8 271
378cc40b 272ARG *stab2arg();
8d063cd8
LW
273ARG *op_new();
274ARG *make_op();
8d063cd8
LW
275ARG *make_match();
276ARG *make_split();
a687059c 277ARG *rcatmaybe();
378cc40b 278ARG *listish();
a687059c 279ARG *maybelistish();
378cc40b 280ARG *localize();
a687059c
LW
281ARG *fixeval();
282ARG *jmaybe();
378cc40b 283ARG *l();
a687059c 284ARG *fixl();
378cc40b
LW
285ARG *mod_match();
286ARG *make_list();
287ARG *cmd_to_arg();
288ARG *addflags();
289ARG *hide_ary();
290ARG *cval_to_arg();
8d063cd8 291
8d063cd8
LW
292STR *str_new();
293STR *stab_str();
a687059c
LW
294
295int do_each();
296int do_subr();
297int do_match();
298int do_unpack();
299int eval(); /* this evaluates expressions */
300int do_eval(); /* this evaluates eval operator */
301int do_assign();
378cc40b
LW
302
303SUBR *make_sub();
8d063cd8
LW
304
305FCMD *load_format();
306
307char *scanpat();
308char *scansubst();
309char *scantrans();
310char *scanstr();
311char *scanreg();
8d063cd8
LW
312char *str_append_till();
313char *str_gets();
a687059c 314char *str_grow();
8d063cd8 315
8d063cd8
LW
316bool do_open();
317bool do_close();
318bool do_print();
378cc40b
LW
319bool do_aprint();
320bool do_exec();
321bool do_aexec();
8d063cd8
LW
322
323int do_subst();
378cc40b
LW
324int cando();
325int ingroup();
8d063cd8 326
378cc40b
LW
327void str_replace();
328void str_inc();
329void str_dec();
8d063cd8 330void str_free();
a687059c 331void stab_clear();
378cc40b 332void do_join();
378cc40b 333void do_sprintf();
a687059c
LW
334void do_accept();
335void do_vecset();
336void savelist();
337void saveitem();
338void saveint();
339void savelong();
340void savesptr();
341void savehptr();
342void restorelist();
343HASH *savehash();
344ARRAY *saveary();
378cc40b
LW
345
346EXT line_t line INIT(0);
a687059c
LW
347EXT line_t subline INIT(0);
348EXT STR *subname INIT(Nullstr);
8d063cd8
LW
349EXT int arybase INIT(0);
350
351struct outrec {
378cc40b
LW
352 line_t o_lines;
353 char *o_str;
354 int o_len;
8d063cd8
LW
355};
356
357EXT struct outrec outrec;
358EXT struct outrec toprec;
359
a687059c 360EXT STAB *stdinstab INIT(Nullstab);
8d063cd8
LW
361EXT STAB *last_in_stab INIT(Nullstab);
362EXT STAB *defstab INIT(Nullstab);
363EXT STAB *argvstab INIT(Nullstab);
364EXT STAB *envstab INIT(Nullstab);
365EXT STAB *sigstab INIT(Nullstab);
366EXT STAB *defoutstab INIT(Nullstab);
367EXT STAB *curoutstab INIT(Nullstab);
368EXT STAB *argvoutstab INIT(Nullstab);
378cc40b 369EXT STAB *incstab INIT(Nullstab);
a687059c
LW
370EXT STAB *leftstab INIT(Nullstab);
371EXT STAB *amperstab INIT(Nullstab);
372EXT STAB *rightstab INIT(Nullstab);
373EXT STAB *DBstab INIT(Nullstab);
374EXT STAB *DBsub INIT(Nullstab);
375
376EXT HASH *defstash; /* main symbol table */
377EXT HASH *curstash; /* symbol table for current package */
378EXT HASH *debstash; /* symbol table for perldb package */
379
380EXT STR *curstname; /* name of current package */
8d063cd8
LW
381
382EXT STR *freestrroot INIT(Nullstr);
378cc40b 383EXT STR *lastretstr INIT(Nullstr);
a687059c
LW
384EXT STR *DBsingle INIT(Nullstr);
385
386EXT int lastspbase;
387EXT int lastsize;
8d063cd8 388
378cc40b
LW
389EXT char *filename;
390EXT char *origfilename;
8d063cd8
LW
391EXT FILE *rsfp;
392EXT char buf[1024];
a687059c
LW
393EXT char *bufptr;
394EXT char *oldbufptr;
395EXT char *oldoldbufptr;
396EXT char *bufend;
8d063cd8
LW
397
398EXT STR *linestr INIT(Nullstr);
399
400EXT char record_separator INIT('\n');
a687059c 401EXT int rslen INIT(1);
8d063cd8 402EXT char *ofs INIT(Nullch);
a687059c 403EXT int ofslen INIT(0);
8d063cd8 404EXT char *ors INIT(Nullch);
a687059c 405EXT int orslen INIT(0);
8d063cd8
LW
406EXT char *ofmt INIT(Nullch);
407EXT char *inplace INIT(Nullch);
a687059c 408EXT char *nointrp INIT("");
8d063cd8 409
378cc40b
LW
410EXT bool preprocess INIT(FALSE);
411EXT bool minus_n INIT(FALSE);
412EXT bool minus_p INIT(FALSE);
413EXT bool minus_a INIT(FALSE);
414EXT bool doswitches INIT(FALSE);
415EXT bool dowarn INIT(FALSE);
416EXT bool allstabs INIT(FALSE); /* init all customary symbols in symbol table?*/
417EXT bool sawampersand INIT(FALSE); /* must save all match strings */
418EXT bool sawstudy INIT(FALSE); /* do fbminstr on all strings */
a687059c
LW
419EXT bool sawi INIT(FALSE); /* study must assume case insensitive */
420EXT bool sawvec INIT(FALSE);
421
422EXT int csh INIT(0); /* 1 if /bin/csh is there, -1 if not */
423
424#ifdef TAINT
425EXT bool tainted INIT(FALSE); /* using variables controlled by $< */
426#endif
378cc40b
LW
427
428#define TMPPATH "/tmp/perl-eXXXXXX"
429EXT char *e_tmpname;
430EXT FILE *e_fp INIT(Nullfp);
431
8d063cd8 432EXT char tokenbuf[256];
a687059c
LW
433EXT int expectterm INIT(TRUE); /* how to interpret ambiguous tokens */
434EXT int in_eval INIT(FALSE); /* trap fatal errors? */
435EXT int multiline INIT(0); /* $*--do strings hold >1 line? */
436EXT int forkprocess; /* so do_open |- can return proc# */
437EXT int do_undump INIT(0); /* -u or dump seen? */
438EXT int error_count INIT(0); /* how many errors so far, max 10 */
439EXT int multi_start INIT(0); /* 1st line of multi-line string */
440EXT int multi_end INIT(0); /* last line of multi-line string */
441EXT int multi_open INIT(0); /* delimiter of said string */
442EXT int multi_close INIT(0); /* delimiter of said string */
8d063cd8
LW
443
444FILE *popen();
445/* char *str_get(); */
446STR *interp();
447void free_arg();
448STIO *stio_new();
449
450EXT struct stat statbuf;
a687059c
LW
451EXT struct stat statcache;
452STAB *statstab INIT(Nullstab);
453STR *statname;
8d063cd8 454EXT struct tms timesbuf;
378cc40b
LW
455EXT int uid;
456EXT int euid;
a687059c
LW
457EXT int gid;
458EXT int egid;
378cc40b
LW
459UIDTYPE getuid();
460UIDTYPE geteuid();
461GIDTYPE getgid();
462GIDTYPE getegid();
463EXT int unsafe;
8d063cd8
LW
464
465#ifdef DEBUGGING
466EXT int debug INIT(0);
467EXT int dlevel INIT(0);
a687059c
LW
468EXT int dlmax INIT(128);
469EXT char *debname;
470EXT char *debdelim;
d96024cf 471#define YYDEBUG 1
8d063cd8
LW
472extern int yydebug;
473#endif
a687059c 474EXT int perldb INIT(0);
8d063cd8 475
378cc40b
LW
476EXT line_t cmdline INIT(NOLINE);
477
a687059c 478EXT STR str_undef;
8d063cd8
LW
479EXT STR str_no;
480EXT STR str_yes;
481
482/* runtime control stuff */
483
484EXT struct loop {
a687059c
LW
485 char *loop_label; /* what the loop was called, if anything */
486 int loop_sp; /* stack pointer to copy stuff down to */
8d063cd8 487 jmp_buf loop_env;
a687059c 488} *loop_stack;
8d063cd8
LW
489
490EXT int loop_ptr INIT(-1);
a687059c 491EXT int loop_max INIT(128);
8d063cd8
LW
492
493EXT jmp_buf top_env;
a559c259 494EXT jmp_buf eval_env;
8d063cd8
LW
495
496EXT char *goto_targ INIT(Nullch); /* cmd_exec gets strange when set */
497
a687059c
LW
498EXT ARRAY *stack; /* THE STACK */
499
378cc40b
LW
500EXT ARRAY *savestack; /* to save non-local values on */
501
502EXT ARRAY *tosave; /* strings to save on recursive subroutine */
503
a687059c
LW
504EXT ARRAY *lineary; /* lines of script for debugger */
505
506EXT ARRAY *pidstatary; /* keep pids and statuses by fd for mypopen */
507
8d063cd8 508double atof();
a687059c 509long time();
8d063cd8 510struct tm *gmtime(), *localtime();
378cc40b
LW
511char *mktemp();
512char *index(), *rindex();
513char *strcpy(), *strcat();
8d063cd8 514
8d063cd8 515#ifdef EUNICE
378cc40b
LW
516#define UNLINK unlnk
517int unlnk();
8d063cd8
LW
518#else
519#define UNLINK unlink
520#endif
a687059c
LW
521
522#ifndef SETREUID
523#ifdef SETRESUID
524#define setreuid(r,e) setresuid(r,e,-1)
525#define SETREUID
526#endif
527#endif
528#ifndef SETREGID
529#ifdef SETRESGID
530#define setregid(r,e) setresgid(r,e,-1)
531#define SETREGID
532#endif
533#endif