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