Commit | Line | Data |
---|---|---|
b5dc1377 CL |
1 | .\" Copyright (c) 1980, 1990 The Regents of the University of California. |
2 | .\" All rights reserved. | |
8970a365 | 3 | .\" |
af359dea C |
4 | .\" Redistribution and use in source and binary forms, with or without |
5 | .\" modification, are permitted provided that the following conditions | |
6 | .\" are met: | |
7 | .\" 1. Redistributions of source code must retain the above copyright | |
8 | .\" notice, this list of conditions and the following disclaimer. | |
9 | .\" 2. Redistributions in binary form must reproduce the above copyright | |
10 | .\" notice, this list of conditions and the following disclaimer in the | |
11 | .\" documentation and/or other materials provided with the distribution. | |
12 | .\" 3. All advertising materials mentioning features or use of this software | |
13 | .\" must display the following acknowledgement: | |
14 | .\" This product includes software developed by the University of | |
15 | .\" California, Berkeley and its contributors. | |
16 | .\" 4. Neither the name of the University nor the names of its contributors | |
17 | .\" may be used to endorse or promote products derived from this software | |
18 | .\" without specific prior written permission. | |
8970a365 | 19 | .\" |
af359dea C |
20 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND |
21 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
22 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
23 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
24 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
25 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
26 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
27 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
28 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
29 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
30 | .\" SUCH DAMAGE. | |
b5dc1377 | 31 | .\" |
af359dea C |
32 | .\" @(#)px.1 6.7 (Berkeley) 5/9/91 |
33 | .\" | |
34 | .Dd May 9, 1991 | |
b5dc1377 | 35 | .Dt PX 1 |
af359dea | 36 | .Os BSD 3.0 |
b5dc1377 | 37 | .Sh NAME |
af359dea | 38 | .Nm \&px |
b5dc1377 CL |
39 | .Nd Pascal interpreter |
40 | .Sh SYNOPSIS | |
af359dea | 41 | .Nm \&px |
b5dc1377 CL |
42 | .Op Ar obj Op Ar argument ... |
43 | .Sh DESCRIPTION | |
af359dea | 44 | .Nm \&Px |
8970a365 | 45 | interprets the abstract machine code generated by |
b5dc1377 | 46 | .Xr pi 1 . |
8970a365 KM |
47 | The first argument is the file to be interpreted, and defaults |
48 | to | |
b5dc1377 | 49 | .Ar obj ; |
8970a365 KM |
50 | remaining arguments are available to the Pascal program using the |
51 | built-ins | |
b5dc1377 | 52 | .Ar argv |
8970a365 | 53 | and |
b5dc1377 | 54 | .Ar argc . |
af359dea | 55 | .Nm \&Px |
8970a365 | 56 | is also invoked by |
b5dc1377 | 57 | .Nm pix |
8970a365 | 58 | when running `load and go'. |
b5dc1377 CL |
59 | .Pp |
60 | If the program terminates abnormally an error message and a | |
8970a365 KM |
61 | control flow backtrace are printed. |
62 | The number of statements executed and total execution time | |
63 | are printed after normal termination. | |
64 | The | |
b5dc1377 | 65 | .Cm p |
8970a365 | 66 | option of |
af359dea | 67 | .Nm \&pi |
8970a365 KM |
68 | suppresses all of this except the message indicating the cause |
69 | of abnormal termination. | |
b5dc1377 | 70 | .Sh FILES |
af359dea C |
71 | .Bl -tag -width pmon.out -compact |
72 | .It Pa obj | |
b5dc1377 | 73 | default object file |
af359dea | 74 | .It Pa pmon.out |
b5dc1377 | 75 | profile data file |
af359dea | 76 | .El |
b5dc1377 | 77 | .Sh SEE ALSO |
b5dc1377 CL |
78 | .Xr pi 1 , |
79 | .Xr pix 1 | |
af359dea C |
80 | .Rs |
81 | .%T "Berkeley Pascal User's Manual" | |
82 | .Re | |
b5dc1377 | 83 | .Sh DIAGNOSTICS |
8970a365 KM |
84 | Most run-time error messages are self-explanatory. |
85 | Some of the more unusual ones are: | |
af359dea C |
86 | .Bl -tag -width indent |
87 | .It Reference to an inactive file | |
8970a365 | 88 | A file other than |
b5dc1377 | 89 | .Ar input |
8970a365 | 90 | or |
b5dc1377 | 91 | .Ar output |
8970a365 | 92 | was used before a call to |
b5dc1377 | 93 | .Ar reset |
8970a365 | 94 | or |
b5dc1377 | 95 | .Ar rewrite . |
af359dea | 96 | .It Statement count limit exceeded |
8970a365 KM |
97 | The limit of 500,000 executed statements |
98 | (which prevents excessive looping or recursion) | |
99 | has been exceeded. | |
af359dea C |
100 | .It Bad data found on integer read |
101 | .It Bad data found on real read | |
8970a365 KM |
102 | Usually, non-numeric input was found for a number. |
103 | For reals, Pascal requires digits before and after the decimal | |
104 | point so that numbers like `.1' or `21.' evoke the second diagnostic. | |
af359dea | 105 | .It panic: Em Some message |
c33a908d | 106 | Indicates an internal inconsistency detected in |
af359dea | 107 | .Nm \&px |
8970a365 | 108 | probably due to a Pascal system bug. |
af359dea | 109 | .El |
b5dc1377 | 110 | .Sh HISTORY |
af359dea C |
111 | .Nm \&Px |
112 | appeared in | |
113 | .Bx 3.0 . | |
b5dc1377 | 114 | .Sh BUGS |
8970a365 KM |
115 | Post-mortem traceback is not limited; |
116 | infinite recursion leads to almost infinite traceback. |