xref: /csrg-svn/usr.bin/pascal/px/px.1 (revision 43083)
1*43083Scael.\" Copyright (c) 1980, 1990 The Regents of the University of California.
2*43083Scael.\" All rights reserved.
319273Smckusick.\"
4*43083Scael.\" %sccs.include.redist.man%
519273Smckusick.\"
6*43083Scael.\"     @(#)px.1	6.3 (Berkeley) 06/11/90
7*43083Scael.\"
8*43083Scael.Dd
9*43083Scael.Dt PX 1
1019273Smckusick.UC
11*43083Scael.Sh NAME
12*43083Scael.Nm px
13*43083Scael.Nd Pascal interpreter
14*43083Scael.Sh SYNOPSIS
15*43083Scael.Nm px
16*43083Scael.Op  Ar obj Op Ar argument ...
17*43083Scael.Sh DESCRIPTION
18*43083Scael.Nm Px
1919273Smckusickinterprets the abstract machine code generated by
20*43083Scael.Xr pi 1 .
2119273SmckusickThe first argument is the file to be interpreted, and defaults
2219273Smckusickto
23*43083Scael.Ar obj ;
2419273Smckusickremaining arguments are available to the Pascal program using the
2519273Smckusickbuilt-ins
26*43083Scael.Ar argv
2719273Smckusickand
28*43083Scael.Ar argc .
29*43083Scael.Nm Px
3019273Smckusickis also invoked by
31*43083Scael.Nm pix
3219273Smckusickwhen running `load and go'.
33*43083Scael.Pp
34*43083ScaelIf the program terminates abnormally an error message and a
3519273Smckusickcontrol flow backtrace are printed.
3619273SmckusickThe number of statements executed and total execution time
3719273Smckusickare printed after normal termination.
3819273SmckusickThe
39*43083Scael.Cm p
4019273Smckusickoption of
41*43083Scael.Nm pi
4219273Smckusicksuppresses all of this except the message indicating the cause
4319273Smckusickof abnormal termination.
44*43083Scael.Sh FILES
45*43083Scael.Dw pmon.out
46*43083Scael.Di L
47*43083Scael.Dp Pa obj
48*43083Scaeldefault object file
49*43083Scael.Dp Pa pmon.out
50*43083Scaelprofile data file
51*43083Scael.Dp
52*43083Scael.Sh SEE ALSO
53*43083Scael.Em Berkeley Pascal User's Manual
5419273Smckusick.br
55*43083Scael.Xr pi 1 ,
56*43083Scael.Xr pix 1
57*43083Scael.Sh DIAGNOSTICS
5819273SmckusickMost run-time error messages are self-explanatory.
5919273SmckusickSome of the more unusual ones are:
60*43083Scael.Tw Ds
61*43083Scael.Tp Reference to an inactive file
6219273SmckusickA file other than
63*43083Scael.Ar input
6419273Smckusickor
65*43083Scael.Ar output
6619273Smckusickwas used before a call to
67*43083Scael.Ar reset
6819273Smckusickor
69*43083Scael.Ar rewrite .
70*43083Scael.Tp Statement count limit exceeded
7119273SmckusickThe limit of 500,000 executed statements
7219273Smckusick(which prevents excessive looping or recursion)
7319273Smckusickhas been exceeded.
74*43083Scael.Tp Bad data found on integer read
75*43083Scael.Tp Bad data found on real read
7619273SmckusickUsually, non-numeric input was found for a number.
7719273SmckusickFor reals, Pascal requires digits before and after the decimal
7819273Smckusickpoint so that numbers like `.1' or `21.' evoke the second diagnostic.
79*43083Scael.Tp panic:
80*43083Scael.Em Some message
8127985SanneIndicates an internal inconsistency detected in
82*43083Scael.Nm px
8319273Smckusickprobably due to a Pascal system bug.
84*43083Scael.Tp
85*43083Scael.Sh AUTHORS
8619273SmckusickCharles B. Haley, William Joy, and Ken Thompson
8719273Smckusick.br
8819273SmckusickVAX-11 version by Kirk McKusick
89*43083Scael.Sh HISTORY
90*43083Scael.Nm Px
91*43083Scaelappeared in 3 BSD.
92*43083Scael.Sh BUGS
9319273SmckusickPost-mortem traceback is not limited;
9419273Smckusickinfinite recursion leads to almost infinite traceback.
95