![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to pdx.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / pgrm / pascal / pdx|
Return to pdx.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / pgrm / pascal / pdx |
1.1 root 1: .\" Copyright (c) 1983, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)pdx.1 6.2 (Berkeley) 6/11/90
19: .\"
20: .Dd June 11, 1990
21: .Dt PDX 1
22: .Os BSD 4.2
23: .Sh NAME
24: .Nm pdx
25: .Nd pascal debugger
26: .Sh SYNOPSIS
27: .Nm pdx
28: .Op Fl r
29: .Op Ar objfile
30: .Sh DESCRIPTION
31: .Nm Pdx
32: is a tool for source level debugging and execution of
33: Pascal programs.
34: The
35: .Ar objfile
36: is an object file produced by the Pascal translator
37: .Xr pi 1 .
38: If no
39: .Ar objfile
40: is specified,
41: .Nm pdx
42: looks
43: for a file named ``obj'' in the current directory.
44: The object file contains a symbol table which includes the name of the
45: all the source files translated by
46: .Xr pi 1
47: to create it.
48: These files are available for perusal while using the debugger.
49: .Pp
50: If the file
51: .Dq Pa .pdxinit
52: exists in the current directory, then the
53: debugger commands in it are executed.
54: .Pp
55: .Tp Fl r
56: The
57: .Fl r
58: option causes the
59: .Ar objfile
60: to be executed immediately;
61: if it terminates successfully
62: .Nm pdx
63: exits.
64: Otherwise it reports the reason for termination
65: and offers the user the option of entering the debugger
66: or simply letting
67: .Xr px
68: continue with a traceback.
69: If
70: .Fl r
71: is not specified,
72: .Nm pdx
73: just prompts and waits for a command.
74: .Tp
75: .Pp
76: The commands are:
77: .Dw Fl
78: .Di L
79: .Dp Cx Ic run
80: .Cx \&\ \&
81: .Op Ar args
82: .Cx \&\ \&
83: .Op Ic \&< Ar filename
84: .Cx \&\ \&
85: .Op Ic \&> Ar filename
86: .Cx
87: Start executing
88: .Ar objfile ,
89: passing
90: .Ar args
91: as command line arguments;
92: .Ic \&<
93: or
94: .Ic \&>
95: can be used to redirect input or output in the usual manner.
96: .Pp
97: .Dp Cx Ic trace
98: .Pp
99: .Cx \&\ \&
100: .Op Ic in Ar procedure/function
101: .Cx \&\ \&
102: .Op Ic if Ar condition
103: .Cx
104: .Dp Cx Ic trace
105: .Cx \&\ \&
106: .Ar source-line-number
107: .Op Ic if Ar condition
108: .Cx \&\ \&
109: .Cx
110: .Dp Cx Ic trace
111: .Cx \&\ \&
112: .Ar procedure/function
113: .Cx \&\ \&
114: .Op Ic in Ar procedure/function
115: .Cx \&\ \&
116: .Op Ic if Ar condition
117: .Cx
118: .Dp Cx Ic trace
119: .Cx \&\ \&
120: .Ar expression
121: .Cx \&\ \&
122: .Ic at
123: .Cx \&\ \&
124: .Ar source-line-number
125: .Cx \&\ \&
126: .Op Ic if Ar condition
127: .Cx
128: .Dp Cx Ic trace
129: .Cx \&\ \&
130: .Ar variable
131: .Cx \&\ \&
132: .Op Ic in Ar procedure/function
133: .Cx \&\ \&
134: .Op Ic if Ar condition
135: .Cx
136: Have tracing information printed when the program is executed.
137: A number is associated with the command that is used
138: to turn the tracing off (see the
139: .Ic delete
140: command).
141: .Pp
142: The first argument describes what is to be traced.
143: If it is a
144: .Ar source-line-number ,
145: then the line is printed
146: immediately prior to being executed.
147: Source line numbers in a file other than the current one
148: must be preceded by the name of the file and a colon, e.g.
149: ``mumble.p:17''.
150: .Pp
151: If the argument is a procedure or function name then
152: every time it is called, information is printed telling
153: what routine called it, from what source line it was called,
154: and what parameters were passed to it.
155: In addition, its return is noted, and if it's a function
156: then the value it is returning is also printed.
157: .Pp
158: If the argument is an
159: .Ar expression
160: with an
161: .Ic at
162: clause
163: then the value of the expression is printed whenever the
164: identified source line is reached.
165: .Pp
166: If the argument is a variable then the name and value of the variable
167: is printed whenever it changes.
168: Execution is substantially slower during this form of tracing.
169: .Pp
170: If no argument is specified then all source lines are printed
171: before they are executed.
172: Execution is substantially slower during this form of tracing.
173: .Pp
174: The clause
175: .Dq Cx Ic in
176: .Cx \&\ \&
177: .Ar procedure/function
178: .Cx
179: restricts tracing information
180: to be printed only while executing inside the given procedure
181: or function.
182: .Pp
183: .Ar Condition
184: is a Pascal boolean expression and is
185: evaluated prior to printing the tracing information;
186: if it is false then the information is not printed.
187: .Pp
188: There is no restriction on the amount of information
189: that can be traced.
190: .Pp
191: .ne 10
192: .Dp Cx Ic stop
193: .Cx \&\ \&
194: .Ic if
195: .Cx \&\ \&
196: .Ar condition
197: .Cx
198: .Dp Cx Ic stop
199: .Cx \&\ \&
200: .Ic at
201: .Cx \&\ \&
202: .Ar source-line-number
203: .Cx \&\ \&
204: .Op Ic if Ar condition
205: .Cx
206: .Dp Cx Ic stop
207: .Cx \&\ \&
208: .Ic in
209: .Cx \&\ \&
210: .Ar procedure /function
211: .Cx \&\ \&
212: .Op Ic if Ar condition
213: .Cx
214: .Dp Cx Ic stop
215: .Cx \&\ \&
216: .Ar variable
217: .Cx \&\ \&
218: .Op Ic if Ar condition
219: .Cx
220: Stop execution when the given line is reached, procedure or function
221: called, variable changed, or condition true.
222: .Pp
223: .Dp Cx Ic delete
224: .Cx \&\ \&
225: .Ar command-number
226: .Cx
227: The trace or stop corresponding to the given number is removed.
228: The numbers associated with traces and stops are printed by
229: the
230: .Ic status
231: command.
232: .Pp
233: .Dp Cx Ic status
234: .Cx \&\ \&
235: .Op Ic \&> Ar filename
236: .Cx
237: Print out
238: the currently active
239: .Ic trace
240: and
241: .Ic stop
242: commands.
243: .Pp
244: .Dp Ic cont
245: Continue execution from where it stopped.
246: This can only be
247: done when the program was stopped by an interrupt
248: or through use of the
249: .Ic stop
250: command.
251: .Pp
252: .Dp Ic step
253: Execute one source line.
254: .Pp
255: .Dp Ic next
256: Execute up to the next source line.
257: The difference between this and
258: .Ic step
259: is that
260: if the line contains a call to a procedure or function
261: the
262: .Ic step
263: command will stop at the beginning of that
264: block, while the
265: .Ic next
266: command will not.
267: .Pp
268: .Dp Cx Ic print
269: .Cx \&\ \&
270: .Ar expression
271: .Cx \&\ \&
272: .Op Ic \&, Ar expression ...
273: .Cx
274: Print out the values of the Pascal expressions.
275: Variables declared in an outer block but having
276: the same identifier as one in the current block may be
277: referenced as
278: .Dq Ar block-name \&. variable
279: .Pp
280: .Dp Cx Ic whatis
281: .Cx \&\ \&
282: .Ar identifier
283: .Cx
284: Print the declaration of the given identifier.
285: .Pp
286: .Dp Cx Ic which
287: .Cx \&\ \&
288: .Ar identifier
289: .Cx
290: Print the full qualification of the given identifer, i.e.
291: the outer blocks that the identifier is associated with.
292: .Pp
293: .Dp Cx Ic assign
294: .Cx \&\ \&
295: .Ar variable
296: .Cx \&\ \&
297: .Ar expression
298: .Cx
299: Assign the value of the expression to the variable.
300: .Pp
301: .Dp Cx Ic call
302: .Cx \&\ \&
303: .Ar procedure (parameters)
304: .Cx
305: Execute the object code associated with the named procedure or function.
306: .Pp
307: .Dp Ic help
308: Print out a synopsis of
309: .Nm pdx
310: commands.
311: .Pp
312: .Dp Ic gripe
313: Invokes a mail program to send a message to the person in charge of
314: .Nm pdx .
315: .Pp
316: .Dp Ic where
317: Print out
318: a list of the active procedures and functions and the respective source
319: line where they are called.
320: .Pp
321: .Dp Cx Ic source
322: .Cx \&\ \&
323: .Ar filename
324: .Cx
325: Read
326: .Nm pdx
327: commands from the given
328: .Ar filename .
329: Especially useful when the
330: .Ar filename
331: has been created by redirecting
332: a
333: .Ic status
334: command from an earlier debugging session.
335: .Pp
336: .Dp Cx Ic dump
337: .Cx \&\ \&
338: .Op Ic \&> Ar filename
339: .Cx
340: Print the names and values of all active
341: data.
342: .Pp
343: .Dp Cx Ic list
344: .Cx \&\ \&[
345: .Ar source-line-number
346: .Cx \&\ \&
347: .Op \&, Ar source-line-number
348: .Cx \&]
349: .Cx
350: .Dp Cx Ic list
351: .Cx \&\ \&
352: .Ar procedure/function
353: .Cx
354: List the lines in the current source file from the first line number to
355: the second inclusive.
356: As in the editor
357: ``$'' can be used to refer to the last line.
358: If no lines are specified, the entire file is listed.
359: If the name of a procedure or function is given
360: lines
361: .Ar n-k
362: to
363: .Ar n+k
364: are listed where
365: .Ar n
366: is the first statement
367: in the procedure or function and
368: .Ar k
369: is small.
370: .Pp
371: .Dp Cx Ic file
372: .Cx \&\ \&
373: .Op Ar filename
374: .Cx
375: Change the current source file name to
376: .Ar filename .
377: If none is specified then the current source file name is printed.
378: .Pp
379: .Dp Cx Ic edit
380: .Cx \&\ \&
381: .Op Ar filename
382: .Cx
383: .Dp Cx Ic edit
384: .Cx \&\ \&
385: .Ar procedure/function-name
386: .Cx
387: Invoke an editor on
388: .Ar filename
389: or the current source file if none
390: is specified.
391: If a
392: .Ar procedure
393: or
394: .Ar function
395: name is specified,
396: the editor is invoked on the file that contains it.
397: Which editor is invoked by default depends on the installation.
398: The default can be overridden by setting the environment variable
399: EDITOR to the name of the desired editor.
400: .Pp
401: .Dp Ic pi
402: Recompile the program and read in the new symbol table information.
403: .Pp
404: .Dp Cx Ic sh
405: .Cx \&\ \&
406: .Ar command-line
407: .Cx
408: Pass the command line to the shell for execution.
409: The SHELL environment variable determines which shell is used.
410: .Pp
411: .Dp Cx Ic alias
412: .Cx \&\ \&
413: .Ar new-command-name
414: .Cx \&\ \&
415: .Ar old-command-name
416: .Cx
417: This command makes
418: .Nm pdx
419: respond to
420: .Ar new-command-name
421: the way it used to respond to
422: .Ar old-command-name .
423: .Pp
424: .Dp Ic quit
425: Exit
426: .Nm pdx .
427: .Dp
428: .Pp
429: The following commands deal with the program at the
430: .Ar px
431: instruction
432: level rather than source level.
433: They are not intended for general use.
434: .Dw Fl
435: .Di L
436: .Dp Cx Ic tracei
437: .Cx \&\ \&
438: .Op Ar address
439: .Cx \&\ \&
440: .Op Ic if Ar cond
441: .Cx
442: .Dp Cx Ic tracei
443: .Cx \&\ \&
444: .Op Ar variable
445: .Cx \&\ \&
446: .Op Ic at Ar address
447: .Cx \&\ \&
448: .Op Ic if Ar cond
449: .Cx
450: .Dp Cx Ic stopi
451: .Cx \&\ \&
452: .Op Ar address
453: .Cx \&\ \&
454: .Op Ic if Ar cond
455: .Cx
456: .Dp Cx Ic stopi
457: .Cx \&\ \&
458: .Op Ic at
459: .Cx \&\ \&
460: .Op Ar address
461: .Cx \&\ \&
462: .Op Ic if Ar cond
463: .Cx
464: Turn on tracing or set a stop using a
465: .Ic px
466: machine
467: instruction addresses.
468: .Pp
469: .Dp Cx Ic xi
470: .Cx \&\ \&
471: .Ar address
472: .Cx \&\ \&
473: .Op Ic \&, Ar address
474: .Cx
475: Print the instructions starting at the first
476: .Ar address .
477: Instructions up to
478: the second
479: .Ar address
480: are printed.
481: .Pp
482: .Dp Cx Ic xd
483: .Cx \&\ \&
484: .Ar address
485: .Cx \&\ \&
486: .Op Ic \&, Ar address
487: .Cx
488: Print in octal the specified data location(s).
489: .Dp
490: .Sh ENVIRONMENT
491: .Tw Ar
492: .Tp Ev EDITOR
493: The
494: .Ic edit
495: function uses the
496: .Ev EDITOR
497: environment variable to see what editor to use.
498: .Tp Ev SHELL
499: The function
500: .Ic sh
501: checks the
502: .Ev SHELL
503: variable to see which shell to
504: execute.
505: .Tp
506: .Sh FILES
507: .Dw .pdxinit
508: .Di L
509: .Dp Pa \&obj
510: Pascal object file
511: .Dp Pa \&.pdxinit
512: .Nm Pdx
513: initialization file
514: .Dp
515: .Sh SEE ALSO
516: .Xr pi 1 ,
517: .Xr px 1
518: .br
519: .Em Ar An Introduction to Pdx
520: .Sh HISTORY
521: .Nm Pdx
522: appeared in 4.2 BSD.
523: .Sh BUGS
524: .Nm Pdx
525: does not understand sets,
526: and provides no information about files.
527: .Pp
528: The
529: .Ic whatis
530: command doesn't quite work for variant records.
531: .Pp
532: Bad things will happen if a procedure invoked with
533: the
534: .Ic call
535: command does a non-local goto.
536: .Pp
537: The commands
538: .Ic step
539: and
540: .Ic next
541: should be able to take a
542: .Ar count
543: that specifies how many lines to execute.
544: .Pp
545: There should be commands
546: .Ic stepi
547: and
548: .Ic nexti
549: that correspond
550: to
551: .Ic step
552: and
553: .Ic next
554: but work at the instruction level.
555: .Pp
556: There should be a way to get an address associated with
557: a line number, procedure or function, and variable.
558: .Pp
559: Most of the command names are too long.
560: .Pp
561: The alias facility is quite weak.
562: .Pp
563: A
564: .Xr csh 1
565: \- like history capability would improve the situation.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.