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