usr/src/usr.bin/pascal/px/px.1

.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)px.1	6.5 (Berkeley) %G%
.\"
.Dd
.Dt PX 1
.Sh NAME
.Nm px
.Nd Pascal interpreter
.Sh SYNOPSIS
.Nm px
.Op  Ar obj Op Ar argument ...
.Sh DESCRIPTION
.Nm Px
interprets the abstract machine code generated by
.Xr pi 1 .
The first argument is the file to be interpreted, and defaults
to
.Ar obj ;
remaining arguments are available to the Pascal program using the
built-ins
.Ar argv
and
.Ar argc .
.Nm Px
is also invoked by
.Nm pix
when running `load and go'.
.Pp
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
.Cm p
option of
.Nm pi
suppresses all of this except the message indicating the cause
of abnormal termination.
.Sh FILES
.Dw pmon.out
.Di L
.Dp Pa obj
default object file
.Dp Pa pmon.out
profile data file
.Dp
.Sh SEE ALSO
.Em Berkeley Pascal User's Manual
.br
.Xr pi 1 ,
.Xr pix 1
.Sh DIAGNOSTICS
Most run-time error messages are self-explanatory.
Some of the more unusual ones are:
.Tw Ds
.Tp Reference to an inactive file
A file other than
.Ar input
or
.Ar output
was used before a call to
.Ar reset
or
.Ar rewrite .
.Tp Statement count limit exceeded
The limit of 500,000 executed statements
(which prevents excessive looping or recursion)
has been exceeded.
.Tp Bad data found on integer read
.Tp Bad data found on real read
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.
.Tp panic:
.Em Some message
Indicates an internal inconsistency detected in
.Nm px
probably due to a Pascal system bug.
.Tp
.Sh AUTHORS
Charles B. Haley, William Joy, and Ken Thompson
.br
VAX-11 version by Kirk McKusick
.Sh HISTORY
.Nm Px
appeared in 3 BSD.
.Sh BUGS
Post-mortem traceback is not limited;
infinite recursion leads to almost infinite traceback.
Commit	Line	Data
	1	.\" Copyright (c) 1980, 1990 The Regents of the University of California.
	2	.\" All rights reserved.
	3	.\"
	4	.\" %sccs.include.redist.man%
	5	.\"
	6	.\" @(#)px.1 6.5 (Berkeley) %G%
	7	.\"
	8	.Dd
	9	.Dt PX 1
	10	.Sh NAME
	11	.Nm px
	12	.Nd Pascal interpreter
	13	.Sh SYNOPSIS
	14	.Nm px
	15	.Op Ar obj Op Ar argument ...
	16	.Sh DESCRIPTION
	17	.Nm Px
	18	interprets the abstract machine code generated by
	19	.Xr pi 1 .
	20	The first argument is the file to be interpreted, and defaults
	21	to
	22	.Ar obj ;
	23	remaining arguments are available to the Pascal program using the
	24	built-ins
	25	.Ar argv
	26	and
	27	.Ar argc .
	28	.Nm Px
	29	is also invoked by
	30	.Nm pix
	31	when running `load and go'.
	32	.Pp
	33	If the program terminates abnormally an error message and a
	34	control flow backtrace are printed.
	35	The number of statements executed and total execution time
	36	are printed after normal termination.
	37	The
	38	.Cm p
	39	option of
	40	.Nm pi
	41	suppresses all of this except the message indicating the cause
	42	of abnormal termination.
	43	.Sh FILES
	44	.Dw pmon.out
	45	.Di L
	46	.Dp Pa obj
	47	default object file
	48	.Dp Pa pmon.out
	49	profile data file
	50	.Dp
	51	.Sh SEE ALSO
	52	.Em Berkeley Pascal User's Manual
	53	.br
	54	.Xr pi 1 ,
	55	.Xr pix 1
	56	.Sh DIAGNOSTICS
	57	Most run-time error messages are self-explanatory.
	58	Some of the more unusual ones are:
	59	.Tw Ds
	60	.Tp Reference to an inactive file
	61	A file other than
	62	.Ar input
	63	or
	64	.Ar output
	65	was used before a call to
	66	.Ar reset
	67	or
	68	.Ar rewrite .
	69	.Tp Statement count limit exceeded
	70	The limit of 500,000 executed statements
	71	(which prevents excessive looping or recursion)
	72	has been exceeded.
	73	.Tp Bad data found on integer read
	74	.Tp Bad data found on real read
	75	Usually, non-numeric input was found for a number.
	76	For reals, Pascal requires digits before and after the decimal
	77	point so that numbers like `.1' or `21.' evoke the second diagnostic.
	78	.Tp panic:
	79	.Em Some message
	80	Indicates an internal inconsistency detected in
	81	.Nm px
	82	probably due to a Pascal system bug.
	83	.Tp
	84	.Sh AUTHORS
	85	Charles B. Haley, William Joy, and Ken Thompson
	86	.br
	87	VAX-11 version by Kirk McKusick
	88	.Sh HISTORY
	89	.Nm Px
	90	appeared in 3 BSD.
	91	.Sh BUGS
	92	Post-mortem traceback is not limited;
	93	infinite recursion leads to almost infinite traceback.