[unix-history] / man6 / px.6

.th PX VI 9/10/77
.sh NAME
px \- Pascal interpreter
.sh SYNOPSIS
.bd px
[ obj [ argument ... ] ]
.sh DESCRIPTION
.it Px
interprets the abstract machine code generated by
.it pi.
The first argument is the file to be interpreted, and defaults
to
\fIobj\fR\|;
remaining arguments are available to the Pascal program using the
built-ins
.it argv
and
.it argc.
.it Px
is also invoked by
.it pix
when running ``load and go''.
.s3
If the program terminates abnormally an error message and a 
control flow backtrace are printed.
The number of statements executed and total execution time
are printed after normal termination.
The
.bd p
option of
.it pi
suppresses all of this except the message indicating the cause
of abnormal termination.
.sh FILES
.dt
obj		default object file
.br
pmon.out	profile data file
.sh "SEE ALSO"
UNIX Pascal User's Manual
.br
pi (VI), pix (VI)
.sh DIAGNOSTICS
Most run-time error messages are self-explanatory.
Some of the more unusual ones are:
.s3
.lp +6 3
Reference to an inactive file
.br
A file other than
.it input
or
.it output
was used before a call to
.it reset
or
.it rewrite.
.s3
.lp +6 3
Statement count limit exceeded
.br
The limit of 500,000 executed statements
(which prevents excessive looping or recursion)
has been exceeded.
.s3
.lp +6 3
Bad data found on integer read
.lp +6 3
Bad data found on real read
.br
Usually, non-numeric input was found for a number.
For reals, Pascal requires digits before and after the decimal
point so that numbers like `.1' or `21.' evoke the second diagnostic.
.s3
.lp +6 3
panic: \fISome message\fP
.br
Indicates a internal inconsistency detected in
.it px
probably due to a Pascal system bug.
.i0
.sh AUTHORS
Charles B. Haley, William N. Joy, and Ken Thompson
.sh BUGS
Calls to the procedures
.it dispose
and
.it linelimit
are ignored.
.s3
Post-mortem traceback is not limited;
infinite recursion leads to almost infinite traceback.
.s3
Because interrupts sometimes find the system in the middle of a
.bd procedure
or
.bd function
entry or exit,
the error backtrace on an interrupt is occasionally meaningless.
The current line is, however, always correct;
only the call backtrace and the name of the current routine may be lost.
Commit	Line	Data
c2210feb BJ	1	.th PX VI 9/10/77
	2	.sh NAME
	3	px \- Pascal interpreter
	4	.sh SYNOPSIS
	5	.bd px
	6	[ obj [ argument ... ] ]
	7	.sh DESCRIPTION
	8	.it Px
	9	interprets the abstract machine code generated by
	10	.it pi.
	11	The first argument is the file to be interpreted, and defaults
	12	to
	13	\fIobj\fR\\|;
	14	remaining arguments are available to the Pascal program using the
	15	built-ins
	16	.it argv
	17	and
	18	.it argc.
	19	.it Px
	20	is also invoked by
	21	.it pix
	22	when running ``load and go''.
	23	.s3
	24	If the program terminates abnormally an error message and a
	25	control flow backtrace are printed.
	26	The number of statements executed and total execution time
	27	are printed after normal termination.
	28	The
	29	.bd p
	30	option of
	31	.it pi
	32	suppresses all of this except the message indicating the cause
	33	of abnormal termination.
	34	.sh FILES
	35	.dt
	36	obj default object file
	37	.br
	38	pmon.out profile data file
	39	.sh "SEE ALSO"
	40	UNIX Pascal User's Manual
	41	.br
	42	pi (VI), pix (VI)
	43	.sh DIAGNOSTICS
	44	Most run-time error messages are self-explanatory.
	45	Some of the more unusual ones are:
	46	.s3
	47	.lp +6 3
	48	Reference to an inactive file
	49	.br
	50	A file other than
	51	.it input
	52	or
	53	.it output
	54	was used before a call to
	55	.it reset
	56	or
	57	.it rewrite.
	58	.s3
	59	.lp +6 3
	60	Statement count limit exceeded
	61	.br
	62	The limit of 500,000 executed statements
	63	(which prevents excessive looping or recursion)
	64	has been exceeded.
65	.s3
66	.lp +6 3
67	Bad data found on integer read
68	.lp +6 3
69	Bad data found on real read
70	.br
71	Usually, non-numeric input was found for a number.
72	For reals, Pascal requires digits before and after the decimal
73	point so that numbers like `.1' or `21.' evoke the second diagnostic.
74	.s3
75	.lp +6 3
76	panic: \fISome message\fP
77	.br
78	Indicates a internal inconsistency detected in
79	.it px
80	probably due to a Pascal system bug.
81	.i0
82	.sh AUTHORS
83	Charles B. Haley, William N. Joy, and Ken Thompson
84	.sh BUGS
85	Calls to the procedures
86	.it dispose
87	and
88	.it linelimit
89	are ignored.
90	.s3
91	Post-mortem traceback is not limited;
92	infinite recursion leads to almost infinite traceback.
93	.s3
94	Because interrupts sometimes find the system in the middle of a
95	.bd procedure
96	or
97	.bd function
98	entry or exit,
99	the error backtrace on an interrupt is occasionally meaningless.
100	The current line is, however, always correct;
101	only the call backtrace and the name of the current routine may be lost.