/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume7 / dbug-man

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 4e 65 77 73 67 72 6f 75 | 70 73 3a 20 63 6f 6d 70 |Newsgrou|ps: comp|
|00000010| 2e 73 6f 75 72 63 65 73 | 2e 6d 69 73 63 0a 73 75 |.sources|.misc.su|
|00000020| 62 6a 65 63 74 3a 20 76 | 30 37 69 30 39 38 3a 20 |bject: v|07i098: |
|00000030| 4d 61 6e 20 70 61 67 65 | 73 20 66 6f 72 20 44 42 |Man page|s for DB|
|00000040| 55 47 20 70 61 63 6b 61 | 67 65 0a 66 72 6f 6d 3a |UG packa|ge.from:|
|00000050| 20 61 6c 6c 62 65 72 79 | 40 75 75 6e 65 74 2e 55 | allbery|@uunet.U|
|00000060| 55 2e 4e 45 54 20 28 42 | 72 61 6e 64 6f 6e 20 53 |U.NET (B|randon S|
|00000070| 2e 20 41 6c 6c 62 65 72 | 79 20 2d 20 63 6f 6d 70 |. Allber|y - comp|
|00000080| 2e 73 6f 75 72 63 65 73 | 2e 6d 69 73 63 29 0a 52 |.sources|.misc).R|
|00000090| 65 70 6c 79 2d 54 6f 3a | 20 6b 61 70 31 32 31 25 |eply-To:| kap121%|
|000000a0| 7a 74 69 76 61 78 40 7a | 74 69 76 61 78 2e 73 69 |ztivax@z|tivax.si|
|000000b0| 65 6d 65 6e 73 2e 63 6f | 6d 20 28 54 68 6f 6d 61 |emens.co|m (Thoma|
|000000c0| 73 20 4f 65 73 65 72 29 | 0a 0a 50 6f 73 74 69 6e |s Oeser)|..Postin|
|000000d0| 67 2d 6e 75 6d 62 65 72 | 3a 20 56 6f 6c 75 6d 65 |g-number|: Volume|
|000000e0| 20 37 2c 20 49 73 73 75 | 65 20 39 38 0a 53 75 62 | 7, Issu|e 98.Sub|
|000000f0| 6d 69 74 74 65 64 2d 62 | 79 3a 20 6b 61 70 31 32 |mitted-b|y: kap12|
|00000100| 31 25 7a 74 69 76 61 78 | 40 7a 74 69 76 61 78 2e |1%ztivax|@ztivax.|
|00000110| 73 69 65 6d 65 6e 73 2e | 63 6f 6d 20 28 54 68 6f |siemens.|com (Tho|
|00000120| 6d 61 73 20 4f 65 73 65 | 72 29 0a 41 72 63 68 69 |mas Oese|r).Archi|
|00000130| 76 65 2d 6e 61 6d 65 3a | 20 64 62 75 67 2d 6d 61 |ve-name:| dbug-ma|
|00000140| 6e 0a 0a 5b 5b 4e 6f 74 | 65 3a 20 20 74 68 65 73 |n..[[Not|e:  thes|
|00000150| 65 20 61 72 65 20 6e 65 | 69 74 68 65 72 20 61 20 |e are ne|ither a |
|00000160| 70 61 74 63 68 20 74 6f | 20 6e 6f 72 20 61 6e 20 |patch to| nor an |
|00000170| 6f 66 66 69 63 69 61 6c | 20 70 61 72 74 20 6f 66 |official| part of|
|00000180| 20 74 68 65 20 44 42 55 | 47 0a 20 20 70 61 63 6b | the DBU|G.  pack|
|00000190| 61 67 65 2e 20 20 2b 2b | 62 73 61 5d 5d 0a 0a 65 |age.  ++|bsa]]..e|
|000001a0| 6e 63 6c 6f 73 65 64 20 | 79 6f 75 20 66 69 6e 64 |nclosed |you find|
|000001b0| 20 74 77 6f 20 6d 61 6e | 20 70 61 67 65 73 20 66 | two man| pages f|
|000001c0| 6f 72 20 74 68 65 20 72 | 65 63 65 6e 74 6c 79 20 |or the r|ecently |
|000001d0| 64 69 73 74 72 69 62 75 | 74 65 64 20 44 42 55 47 |distribu|ted DBUG|
|000001e0| 20 70 61 63 6b 61 67 65 | 2e 0a 49 27 76 65 20 70 | package|..I've p|
|000001f0| 69 63 6b 65 64 20 75 70 | 20 73 6f 6d 65 20 69 6e |icked up| some in|
|00000200| 66 6f 72 6d 61 74 69 6f | 6e 20 66 6f 75 6e 64 20 |formatio|n found |
|00000210| 69 6e 20 74 68 65 20 73 | 6f 75 72 63 65 20 66 69 |in the s|ource fi|
|00000220| 6c 65 73 20 61 6e 64 20 | 75 73 65 72 27 73 0a 64 |les and |user's.d|
|00000230| 6f 63 75 6d 65 6e 74 61 | 74 69 6f 6e 20 61 6e 64 |ocumenta|tion and|
|00000240| 20 70 75 74 20 74 68 65 | 6d 20 74 6f 67 65 74 68 | put the|m togeth|
|00000250| 65 72 20 74 6f 20 74 68 | 65 20 6d 61 6e 20 70 61 |er to th|e man pa|
|00000260| 67 65 73 2e 0a 0a 49 20 | 68 6f 70 65 20 74 68 69 |ges...I |hope thi|
|00000270| 73 20 69 73 20 61 20 73 | 74 61 72 74 20 74 6f 20 |s is a s|tart to |
|00000280| 6d 61 6b 65 20 61 20 6d | 6f 72 65 20 63 6f 6d 70 |make a m|ore comp|
|00000290| 6c 65 74 65 20 61 6e 64 | 20 61 63 63 75 72 61 74 |lete and| accurat|
|000002a0| 65 20 76 65 72 73 69 6f | 6e 20 6f 66 20 74 68 65 |e versio|n of the|
|000002b0| 6d 2e 0a 0a 54 68 6f 6d | 61 73 20 4f 65 73 65 72 |m...Thom|as Oeser|
|000002c0| 0a 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |.-------|--------|
|000002d0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000002e0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000002f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000300| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 0a |--------|-------.|
|00000310| 41 52 50 41 3a 09 09 6b | 61 70 31 32 31 40 7a 74 |ARPA:..k|ap121@zt|
|00000320| 69 76 61 78 2e 73 69 65 | 6d 65 6e 73 2e 63 6f 6d |ivax.sie|mens.com|
|00000330| 0a 55 55 43 50 3a 09 09 | 6b 61 70 31 32 31 40 7a |.UUCP:..|kap121@z|
|00000340| 74 69 76 61 78 2e 75 75 | 63 70 20 28 6d 61 79 20 |tivax.uu|cp (may |
|00000350| 77 6f 72 6b 20 6f 6e 6c | 79 20 69 6e 20 45 75 72 |work onl|y in Eur|
|00000360| 6f 70 65 2e 2e 2e 29 0a | 50 6f 73 74 61 6c 20 6d |ope...).|Postal m|
|00000370| 61 69 6c 3a 09 53 69 65 | 6d 65 6e 73 20 41 47 2c |ail:.Sie|mens AG,|
|00000380| 20 4b 20 53 79 73 20 41 | 70 20 31 32 31 2c 20 4f | K Sys A|p 121, O|
|00000390| 74 74 6f 2d 48 61 68 6e | 2d 52 69 6e 67 20 36 2c |tto-Hahn|-Ring 6,|
|000003a0| 20 50 2e 4f 2e 20 42 6f | 78 20 38 33 30 39 35 31 | P.O. Bo|x 830951|
|000003b0| 2c 0a 09 09 44 2d 38 30 | 30 30 20 4d 75 6e 69 63 |,...D-80|00 Munic|
|000003c0| 68 20 38 33 2c 20 57 65 | 73 74 20 47 65 72 6d 61 |h 83, We|st Germa|
|000003d0| 6e 79 0a 50 68 6f 6e 65 | 3a 09 09 2b 20 34 39 20 |ny.Phone|:..+ 49 |
|000003e0| 28 38 39 29 20 36 33 36 | 2d 34 37 35 33 37 0a 46 |(89) 636|-47537.F|
|000003f0| 41 58 3a 09 09 2b 20 34 | 39 20 28 38 39 29 20 36 |AX:..+ 4|9 (89) 6|
|00000400| 33 36 2d 34 31 34 37 37 | 0a 0a 44 69 73 63 6c 61 |36-41477|..Discla|
|00000410| 69 6d 65 72 3a 0a 54 68 | 65 20 6f 70 69 6e 69 6f |imer:.Th|e opinio|
|00000420| 6e 73 20 65 78 70 72 65 | 73 73 65 64 20 61 72 65 |ns expre|ssed are|
|00000430| 20 6d 79 20 6f 77 6e 2c | 20 61 6e 64 20 73 68 6f | my own,| and sho|
|00000440| 75 6c 64 20 6e 6f 74 20 | 62 65 20 61 74 74 72 69 |uld not |be attri|
|00000450| 62 75 74 65 64 20 74 6f | 20 61 6e 79 6f 6e 65 20 |buted to| anyone |
|00000460| 65 6c 73 65 0a 6c 69 76 | 69 6e 67 20 6f 72 20 64 |else.liv|ing or d|
|00000470| 65 61 64 2e 0a 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |ead..---|--------|
|00000480| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000490| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000004a0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000004b0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000004c0| 2d 2d 2d 0a 0a 0a 23 2d | 2d 2d 2d 2d 2d 2d 2d 2d |---...#-|--------|
|000004d0| 2d 20 63 75 74 20 68 65 | 72 65 20 2d 2d 2d 2d 2d |- cut he|re -----|
|000004e0| 2d 2d 2d 2d 2d 20 63 75 | 74 20 68 65 72 65 20 2d |----- cu|t here -|
|000004f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 20 63 75 74 20 68 |--------|-- cut h|
|00000500| 65 72 65 20 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |ere ----|--------|
|00000510| 2d 2d 2d 2d 2d 0a 23 21 | 20 2f 62 69 6e 2f 73 68 |-----.#!| /bin/sh|
|00000520| 0a 23 20 54 68 69 73 20 | 69 73 20 61 20 73 68 65 |.# This |is a she|
|00000530| 6c 6c 20 61 72 63 68 69 | 76 65 2e 20 20 52 65 6d |ll archi|ve.  Rem|
|00000540| 6f 76 65 20 61 6e 79 74 | 68 69 6e 67 20 62 65 66 |ove anyt|hing bef|
|00000550| 6f 72 65 20 74 68 69 73 | 20 6c 69 6e 65 2c 20 74 |ore this| line, t|
|00000560| 68 65 6e 20 66 65 65 64 | 20 69 74 0a 23 20 69 6e |hen feed| it.# in|
|00000570| 74 6f 20 61 20 73 68 65 | 6c 6c 20 76 69 61 20 22 |to a she|ll via "|
|00000580| 73 68 20 66 69 6c 65 22 | 20 6f 72 20 73 69 6d 69 |sh file"| or simi|
|00000590| 6c 61 72 2e 20 20 54 6f | 20 6f 76 65 72 77 72 69 |lar.  To| overwri|
|000005a0| 74 65 20 65 78 69 73 74 | 69 6e 67 20 66 69 6c 65 |te exist|ing file|
|000005b0| 73 2c 0a 23 20 74 79 70 | 65 20 22 73 68 20 66 69 |s,.# typ|e "sh fi|
|000005c0| 6c 65 20 2d 63 22 2e 0a | 23 20 54 68 65 20 74 6f |le -c"..|# The to|
|000005d0| 6f 6c 20 74 68 61 74 20 | 67 65 6e 65 72 61 74 65 |ol that |generate|
|000005e0| 64 20 74 68 69 73 20 61 | 70 70 65 61 72 65 64 20 |d this a|ppeared |
|000005f0| 69 6e 20 74 68 65 20 63 | 6f 6d 70 2e 73 6f 75 72 |in the c|omp.sour|
|00000600| 63 65 73 2e 75 6e 69 78 | 20 6e 65 77 73 67 72 6f |ces.unix| newsgro|
|00000610| 75 70 3b 0a 23 20 73 65 | 6e 64 20 6d 61 69 6c 20 |up;.# se|nd mail |
|00000620| 74 6f 20 63 6f 6d 70 2d | 73 6f 75 72 63 65 73 2d |to comp-|sources-|
|00000630| 75 6e 69 78 40 75 75 6e | 65 74 2e 75 75 2e 6e 65 |unix@uun|et.uu.ne|
|00000640| 74 20 69 66 20 79 6f 75 | 20 77 61 6e 74 20 74 68 |t if you| want th|
|00000650| 61 74 20 74 6f 6f 6c 2e | 0a 23 20 49 66 20 74 68 |at tool.|.# If th|
|00000660| 69 73 20 61 72 63 68 69 | 76 65 20 69 73 20 63 6f |is archi|ve is co|
|00000670| 6d 70 6c 65 74 65 2c 20 | 79 6f 75 20 77 69 6c 6c |mplete, |you will|
|00000680| 20 73 65 65 20 74 68 65 | 20 66 6f 6c 6c 6f 77 69 | see the| followi|
|00000690| 6e 67 20 6d 65 73 73 61 | 67 65 20 61 74 20 74 68 |ng messa|ge at th|
|000006a0| 65 20 65 6e 64 3a 0a 23 | 09 09 22 45 6e 64 20 6f |e end:.#|.."End o|
|000006b0| 66 20 73 68 65 6c 6c 20 | 61 72 63 68 69 76 65 2e |f shell |archive.|
|000006c0| 22 0a 23 20 43 6f 6e 74 | 65 6e 74 73 3a 20 20 61 |".# Cont|ents:  a|
|000006d0| 6e 61 6c 79 7a 65 2e 6d | 61 6e 20 64 62 75 67 2e |nalyze.m|an dbug.|
|000006e0| 6d 61 6e 0a 23 20 57 72 | 61 70 70 65 64 20 62 79 |man.# Wr|apped by|
|000006f0| 20 65 6d 61 69 6c 40 70 | 65 72 6c 61 63 68 20 6f | email@p|erlach o|
|00000700| 6e 20 54 68 75 20 4a 75 | 6c 20 32 30 20 30 39 3a |n Thu Ju|l 20 09:|
|00000710| 31 30 3a 30 39 20 31 39 | 38 39 0a 50 41 54 48 3d |10:09 19|89.PATH=|
|00000720| 2f 62 69 6e 3a 2f 75 73 | 72 2f 62 69 6e 3a 2f 75 |/bin:/us|r/bin:/u|
|00000730| 73 72 2f 75 63 62 20 3b | 20 65 78 70 6f 72 74 20 |sr/ucb ;| export |
|00000740| 50 41 54 48 0a 69 66 20 | 74 65 73 74 20 2d 66 20 |PATH.if |test -f |
|00000750| 27 61 6e 61 6c 79 7a 65 | 2e 6d 61 6e 27 20 2d 61 |'analyze|.man' -a|
|00000760| 20 22 24 7b 31 7d 22 20 | 21 3d 20 22 2d 63 22 20 | "${1}" |!= "-c" |
|00000770| 3b 20 74 68 65 6e 20 0a | 20 20 65 63 68 6f 20 73 |; then .|  echo s|
|00000780| 68 61 72 3a 20 57 69 6c | 6c 20 6e 6f 74 20 63 6c |har: Wil|l not cl|
|00000790| 6f 62 62 65 72 20 65 78 | 69 73 74 69 6e 67 20 66 |obber ex|isting f|
|000007a0| 69 6c 65 20 5c 22 27 61 | 6e 61 6c 79 7a 65 2e 6d |ile \"'a|nalyze.m|
|000007b0| 61 6e 27 5c 22 0a 65 6c | 73 65 0a 65 63 68 6f 20 |an'\".el|se.echo |
|000007c0| 73 68 61 72 3a 20 45 78 | 74 72 61 63 74 69 6e 67 |shar: Ex|tracting|
|000007d0| 20 5c 22 27 61 6e 61 6c | 79 7a 65 2e 6d 61 6e 27 | \"'anal|yze.man'|
|000007e0| 5c 22 20 5c 28 31 37 31 | 34 20 63 68 61 72 61 63 |\" \(171|4 charac|
|000007f0| 74 65 72 73 5c 29 0a 73 | 65 64 20 22 73 2f 5e 58 |ters\).s|ed "s/^X|
|00000800| 2f 2f 22 20 3e 27 61 6e | 61 6c 79 7a 65 2e 6d 61 |//" >'an|alyze.ma|
|00000810| 6e 27 20 3c 3c 27 45 4e | 44 5f 4f 46 5f 46 49 4c |n' <<'EN|D_OF_FIL|
|00000820| 45 27 0a 58 2e 5c 22 20 | 53 43 43 53 49 44 20 3d |E'.X.\" |SCCSID =|
|00000830| 20 40 28 23 29 61 6e 61 | 6c 79 7a 65 2e 6d 61 6e | @(#)ana|lyze.man|
|00000840| 09 31 2e 31 0a 58 2e 5c | 22 0a 58 2e 54 48 20 41 |.1.1.X.\|".X.TH A|
|00000850| 4e 41 4c 59 5a 45 20 31 | 4c 20 22 38 39 2f 30 37 |NALYZE 1|L "89/07|
|00000860| 2f 32 30 22 20 22 4b 20 | 53 79 73 20 41 70 20 31 |/20" "K |Sys Ap 1|
|00000870| 32 31 22 0a 58 2e 53 48 | 20 4e 41 4d 45 0a 58 61 |21".X.SH| NAME.Xa|
|00000880| 6e 61 6c 79 7a 65 20 5c | 2d 20 61 6e 61 6c 79 7a |nalyze \|- analyz|
|00000890| 65 73 20 74 68 65 20 70 | 72 6f 66 69 6c 65 20 66 |es the p|rofile f|
|000008a0| 69 6c 65 20 77 72 69 74 | 74 65 6e 20 6f 75 74 20 |ile writ|ten out |
|000008b0| 62 79 20 74 68 65 20 64 | 62 75 67 0a 58 72 6f 75 |by the d|bug.Xrou|
|000008c0| 74 69 6e 65 73 20 77 69 | 74 68 20 70 72 6f 66 69 |tines wi|th profi|
|000008d0| 6c 69 6e 67 20 65 6e 61 | 62 6c 65 64 2e 0a 58 2e |ling ena|bled..X.|
|000008e0| 53 48 20 53 59 4e 4f 50 | 53 49 53 0a 58 5c 66 49 |SH SYNOP|SIS.X\fI|
|000008f0| 61 6e 61 6c 79 7a 65 5c | 66 50 20 5b 2d 76 5d 20 |analyze\|fP [-v] |
|00000900| 5b 70 72 6f 66 69 6c 65 | 46 69 6c 65 5d 0a 58 2e |[profile|File].X.|
|00000910| 61 64 0a 58 2e 53 48 20 | 44 45 53 43 52 49 50 54 |ad.X.SH |DESCRIPT|
|00000920| 49 4f 4e 0a 58 5c 66 49 | 41 6e 61 6c 79 7a 65 5c |ION.X\fI|Analyze\|
|00000930| 66 50 20 77 69 6c 6c 20 | 72 65 61 64 20 61 6e 20 |fP will |read an |
|00000940| 74 72 61 63 65 20 66 69 | 6c 65 20 63 72 65 61 74 |trace fi|le creat|
|00000950| 65 64 20 62 79 20 74 68 | 65 20 64 62 75 67 20 70 |ed by th|e dbug p|
|00000960| 61 63 6b 61 67 65 0a 58 | 28 77 68 65 6e 20 72 75 |ackage.X|(when ru|
|00000970| 6e 20 77 69 74 68 20 74 | 72 61 63 65 69 6e 67 20 |n with t|raceing |
|00000980| 65 6e 61 62 6c 65 64 29 | 2e 20 20 49 74 20 77 69 |enabled)|.  It wi|
|00000990| 6c 6c 20 74 68 65 6e 20 | 70 72 6f 64 75 63 65 20 |ll then |produce |
|000009a0| 61 0a 58 73 75 6d 6d 61 | 72 79 20 6f 6e 20 73 74 |a.Xsumma|ry on st|
|000009b0| 61 6e 64 61 72 64 20 6f | 75 74 70 75 74 20 6c 69 |andard o|utput li|
|000009c0| 73 74 69 6e 67 20 74 68 | 65 20 6e 61 6d 65 20 6f |sting th|e name o|
|000009d0| 66 20 65 61 63 68 20 74 | 72 61 63 65 64 0a 58 66 |f each t|raced.Xf|
|000009e0| 75 6e 63 74 69 6f 6e 2c | 20 74 68 65 20 6e 75 6d |unction,| the num|
|000009f0| 62 65 72 20 6f 66 20 74 | 69 6d 65 73 20 69 74 20 |ber of t|imes it |
|00000a00| 77 61 73 20 63 61 6c 6c | 65 64 2c 20 74 68 65 20 |was call|ed, the |
|00000a10| 70 65 72 63 65 6e 74 61 | 67 65 0a 58 6f 66 20 74 |percenta|ge.Xof t|
|00000a20| 6f 74 61 6c 20 63 61 6c | 6c 73 2c 20 74 68 65 20 |otal cal|ls, the |
|00000a30| 74 69 6d 65 20 73 70 65 | 6e 74 20 65 78 65 63 75 |time spe|nt execu|
|00000a40| 74 69 6e 67 20 74 68 65 | 20 66 75 6e 63 74 69 6f |ting the| functio|
|00000a50| 6e 2c 20 74 68 65 0a 58 | 70 72 6f 70 6f 72 74 69 |n, the.X|proporti|
|00000a60| 6f 6e 20 6f 66 20 74 68 | 65 20 74 6f 74 61 6c 20 |on of th|e total |
|00000a70| 74 69 6d 65 20 61 6e 64 | 20 74 68 65 20 27 69 6d |time and| the 'im|
|00000a80| 70 6f 72 74 61 6e 63 65 | 27 2e 20 20 54 68 65 20 |portance|'.  The |
|00000a90| 6c 61 73 74 0a 58 69 73 | 20 61 20 6d 65 74 72 69 |last.Xis| a metri|
|00000aa0| 63 20 77 68 69 63 68 20 | 69 73 20 6f 62 74 61 69 |c which |is obtai|
|00000ab0| 6e 65 64 20 62 79 20 6d | 75 6c 74 69 70 6c 79 69 |ned by m|ultiplyi|
|00000ac0| 6e 67 20 74 68 65 20 70 | 72 6f 70 6f 72 74 69 6f |ng the p|roportio|
|00000ad0| 6e 73 0a 58 6f 66 20 63 | 61 6c 6c 73 20 61 6e 64 |ns.Xof c|alls and|
|00000ae0| 20 74 68 65 20 70 72 6f | 70 6f 72 74 69 6f 6e 73 | the pro|portions|
|00000af0| 20 6f 66 20 74 69 6d 65 | 20 66 6f 72 20 65 61 63 | of time| for eac|
|00000b00| 68 20 66 75 6e 63 74 69 | 6f 6e 2e 20 20 54 68 65 |h functi|on.  The|
|00000b10| 0a 58 67 72 65 61 74 65 | 72 20 74 68 65 20 69 6d |.Xgreate|r the im|
|00000b20| 70 6f 72 74 61 6e 63 65 | 2c 20 74 68 65 20 6d 6f |portance|, the mo|
|00000b30| 72 65 20 6c 69 6b 65 6c | 79 20 69 74 20 69 73 20 |re likel|y it is |
|00000b40| 74 68 61 74 20 61 20 73 | 70 65 65 64 75 70 0a 58 |that a s|peedup.X|
|00000b50| 63 6f 75 6c 64 20 62 65 | 20 6f 62 74 61 69 6e 65 |could be| obtaine|
|00000b60| 64 20 62 79 20 72 65 64 | 75 63 69 6e 67 20 74 68 |d by red|ucing th|
|00000b70| 65 20 74 69 6d 65 20 74 | 61 6b 65 6e 20 62 79 20 |e time t|aken by |
|00000b80| 74 68 61 74 20 66 75 6e | 63 74 69 6f 6e 2e 0a 58 |that fun|ction..X|
|00000b90| 2e 50 50 0a 58 4e 6f 74 | 65 20 74 68 61 74 20 74 |.PP.XNot|e that t|
|00000ba0| 68 65 20 74 69 6d 69 6e | 67 20 76 61 6c 75 65 73 |he timin|g values|
|00000bb0| 20 74 68 61 74 20 79 6f | 75 20 6f 62 74 61 69 6e | that yo|u obtain|
|00000bc0| 20 61 72 65 20 6f 6e 6c | 79 20 72 6f 75 67 68 0a | are onl|y rough.|
|00000bd0| 58 6d 65 61 73 75 72 65 | 73 2e 20 20 54 68 65 20 |Xmeasure|s.  The |
|00000be0| 6f 76 65 72 68 65 61 64 | 20 6f 66 20 74 68 65 20 |overhead| of the |
|00000bf0| 64 62 75 67 20 70 61 63 | 6b 61 67 65 20 69 73 20 |dbug pac|kage is |
|00000c00| 69 6e 63 6c 75 64 65 64 | 0a 58 77 69 74 68 69 6e |included|.Xwithin|
|00000c10| 2e 20 20 48 6f 77 65 76 | 65 72 2c 20 74 68 65 72 |.  Howev|er, ther|
|00000c20| 65 20 69 73 20 6e 6f 20 | 6e 65 65 64 20 74 6f 20 |e is no |need to |
|00000c30| 6c 69 6e 6b 20 69 6e 20 | 73 70 65 63 69 61 6c 20 |link in |special |
|00000c40| 70 72 6f 66 69 6c 65 64 | 0a 58 6c 69 62 72 61 72 |profiled|.Xlibrar|
|00000c50| 69 65 73 20 61 6e 64 20 | 74 68 65 20 6c 69 6b 65 |ies and |the like|
|00000c60| 2e 0a 58 2e 53 48 20 4f | 50 54 49 4f 4e 53 0a 58 |..X.SH O|PTIONS.X|
|00000c70| 5c 66 49 41 6e 6e 61 6c | 69 7a 65 5c 66 50 20 61 |\fIAnnal|ize\fP a|
|00000c80| 63 63 65 70 74 73 20 74 | 68 65 20 66 6f 6c 6c 6f |ccepts t|he follo|
|00000c90| 77 69 6e 67 20 63 6f 6d | 6d 61 6e 64 20 6c 69 6e |wing com|mand lin|
|00000ca0| 65 20 6f 70 74 69 6f 6e | 73 3a 0a 58 2e 54 50 20 |e option|s:.X.TP |
|00000cb0| 31 36 0a 58 2d 76 0a 58 | 49 66 20 74 68 69 73 20 |16.X-v.X|If this |
|00000cc0| 6f 70 74 69 6f 6e 20 69 | 73 20 73 70 65 63 69 66 |option i|s specif|
|00000cd0| 69 65 64 2c 20 74 68 65 | 20 6f 75 74 70 75 74 20 |ied, the| output |
|00000ce0| 6f 66 20 74 68 69 73 20 | 70 72 6f 67 72 61 6d 20 |of this |program |
|00000cf0| 77 69 6c 6c 20 62 65 20 | 61 20 76 65 72 62 6f 73 |will be |a verbos|
|00000d00| 65 0a 58 74 61 62 6c 65 | 2e 20 42 79 20 64 65 66 |e.Xtable|. By def|
|00000d10| 61 75 6c 74 2c 20 74 68 | 65 20 6f 75 74 70 75 74 |ault, th|e output|
|00000d20| 20 6f 66 20 74 68 69 73 | 20 70 72 6f 67 72 61 6d | of this| program|
|00000d30| 20 77 69 6c 6c 20 6c 6f | 6f 6b 20 76 65 72 79 20 | will lo|ok very |
|00000d40| 73 69 6d 69 6c 61 72 20 | 74 6f 0a 58 55 6e 69 78 |similar |to.XUnix|
|00000d50| 20 70 72 6f 66 69 6c 65 | 72 2e 0a 58 2e 54 50 20 | profile|r..X.TP |
|00000d60| 31 36 0a 58 70 72 6f 66 | 69 6c 65 46 69 6c 65 0a |16.Xprof|ileFile.|
|00000d70| 58 53 70 65 63 69 66 69 | 65 73 20 74 68 65 20 74 |XSpecifi|es the t|
|00000d80| 68 65 20 6e 61 6d 65 20 | 6f 66 20 66 69 6c 65 20 |he name |of file |
|00000d90| 63 6f 6e 74 61 69 6e 69 | 6e 67 20 74 68 65 20 69 |containi|ng the i|
|00000da0| 6e 70 75 74 20 64 61 74 | 61 20 74 6f 20 62 65 20 |nput dat|a to be |
|00000db0| 65 78 61 6d 69 6e 65 64 | 0a 58 28 64 65 66 61 75 |examined|.X(defau|
|00000dc0| 6c 74 3a 20 64 62 75 67 | 6d 6f 6e 2e 6f 75 74 29 |lt: dbug|mon.out)|
|00000dd0| 2e 0a 58 2e 53 48 20 55 | 53 41 47 45 0a 58 54 68 |..X.SH U|SAGE.XTh|
|00000de0| 69 73 20 73 68 6f 75 6c | 64 20 62 65 20 65 61 73 |is shoul|d be eas|
|00000df0| 79 20 3a 2d 29 2e 0a 58 | 2e 53 48 20 46 49 4c 45 |y :-)..X|.SH FILE|
|00000e00| 53 0a 58 64 62 75 67 6d | 6f 6e 2e 6f 75 74 0a 58 |S.Xdbugm|on.out.X|
|00000e10| 2e 53 48 20 22 53 45 45 | 20 41 4c 53 4f 22 0a 58 |.SH "SEE| ALSO".X|
|00000e20| 64 62 75 67 28 33 4c 29 | 0a 58 2e 53 48 20 45 4e |dbug(3L)|.X.SH EN|
|00000e30| 56 49 52 4f 4e 4d 45 4e | 54 0a 58 6e 6f 6e 65 0a |VIRONMEN|T.Xnone.|
|00000e40| 58 2e 53 48 20 42 55 47 | 53 0a 58 54 68 65 72 65 |X.SH BUG|S.XThere|
|00000e50| 20 73 74 69 6c 6c 20 61 | 72 65 20 73 6f 6d 65 2e | still a|re some.|
|00000e60| 0a 58 2e 53 48 20 43 4f | 50 59 52 49 47 48 54 0a |.X.SH CO|PYRIGHT.|
|00000e70| 58 6e 6f 6e 65 0a 58 2e | 53 48 20 41 55 54 48 4f |Xnone.X.|SH AUTHO|
|00000e80| 52 53 0a 58 46 72 65 64 | 20 46 69 73 68 2c 20 42 |RS.XFred| Fish, B|
|00000e90| 69 6e 61 79 61 6b 20 42 | 61 6e 65 72 6a 65 65 0a |inayak B|anerjee.|
|00000ea0| 58 2e 62 72 0a 58 45 6e | 68 61 6e 63 65 64 20 53 |X.br.XEn|hanced S|
|00000eb0| 6f 66 74 77 61 72 65 20 | 54 65 63 68 6e 6f 6c 6f |oftware |Technolo|
|00000ec0| 67 69 65 73 2c 20 54 65 | 6d 70 65 2c 20 41 5a 0a |gies, Te|mpe, AZ.|
|00000ed0| 58 2e 62 72 0a 58 61 73 | 75 76 61 78 21 6d 63 64 |X.br.Xas|uvax!mcd|
|00000ee0| 70 68 78 21 65 73 74 69 | 6e 63 21 66 6e 66 2c 20 |phx!esti|nc!fnf, |
|00000ef0| 73 65 69 73 6d 6f 21 62 | 70 61 21 73 6a 75 76 61 |seismo!b|pa!sjuva|
|00000f00| 78 21 62 62 61 6e 65 72 | 6a 65 0a 0a 45 4e 44 5f |x!bbaner|je..END_|
|00000f10| 4f 46 5f 46 49 4c 45 0a | 65 63 68 6f 20 73 68 61 |OF_FILE.|echo sha|
|00000f20| 72 3a 20 4e 45 57 4c 49 | 4e 45 20 61 70 70 65 6e |r: NEWLI|NE appen|
|00000f30| 64 65 64 20 74 6f 20 5c | 22 27 61 6e 61 6c 79 7a |ded to \|"'analyz|
|00000f40| 65 2e 6d 61 6e 27 5c 22 | 0a 69 66 20 74 65 73 74 |e.man'\"|.if test|
|00000f50| 20 31 37 31 35 20 2d 6e | 65 20 60 77 63 20 2d 63 | 1715 -n|e `wc -c|
|00000f60| 20 3c 27 61 6e 61 6c 79 | 7a 65 2e 6d 61 6e 27 60 | <'analy|ze.man'`|
|00000f70| 3b 20 74 68 65 6e 0a 20 | 20 20 20 65 63 68 6f 20 |; then. |   echo |
|00000f80| 73 68 61 72 3a 20 5c 22 | 27 61 6e 61 6c 79 7a 65 |shar: \"|'analyze|
|00000f90| 2e 6d 61 6e 27 5c 22 20 | 75 6e 70 61 63 6b 65 64 |.man'\" |unpacked|
|00000fa0| 20 77 69 74 68 20 77 72 | 6f 6e 67 20 73 69 7a 65 | with wr|ong size|
|00000fb0| 21 0a 66 69 0a 23 20 65 | 6e 64 20 6f 66 20 27 61 |!.fi.# e|nd of 'a|
|00000fc0| 6e 61 6c 79 7a 65 2e 6d | 61 6e 27 0a 66 69 0a 69 |nalyze.m|an'.fi.i|
|00000fd0| 66 20 74 65 73 74 20 2d | 66 20 27 64 62 75 67 2e |f test -|f 'dbug.|
|00000fe0| 6d 61 6e 27 20 2d 61 20 | 22 24 7b 31 7d 22 20 21 |man' -a |"${1}" !|
|00000ff0| 3d 20 22 2d 63 22 20 3b | 20 74 68 65 6e 20 0a 20 |= "-c" ;| then . |
|00001000| 20 65 63 68 6f 20 73 68 | 61 72 3a 20 57 69 6c 6c | echo sh|ar: Will|
|00001010| 20 6e 6f 74 20 63 6c 6f | 62 62 65 72 20 65 78 69 | not clo|bber exi|
|00001020| 73 74 69 6e 67 20 66 69 | 6c 65 20 5c 22 27 64 62 |sting fi|le \"'db|
|00001030| 75 67 2e 6d 61 6e 27 5c | 22 0a 65 6c 73 65 0a 65 |ug.man'\|".else.e|
|00001040| 63 68 6f 20 73 68 61 72 | 3a 20 45 78 74 72 61 63 |cho shar|: Extrac|
|00001050| 74 69 6e 67 20 5c 22 27 | 64 62 75 67 2e 6d 61 6e |ting \"'|dbug.man|
|00001060| 27 5c 22 20 5c 28 31 32 | 35 38 30 20 63 68 61 72 |'\" \(12|580 char|
|00001070| 61 63 74 65 72 73 5c 29 | 0a 73 65 64 20 22 73 2f |acters\)|.sed "s/|
|00001080| 5e 58 2f 2f 22 20 3e 27 | 64 62 75 67 2e 6d 61 6e |^X//" >'|dbug.man|
|00001090| 27 20 3c 3c 27 45 4e 44 | 5f 4f 46 5f 46 49 4c 45 |' <<'END|_OF_FILE|
|000010a0| 27 0a 58 2e 5c 22 20 53 | 43 43 53 49 44 20 3d 20 |'.X.\" S|CCSID = |
|000010b0| 40 28 23 29 64 62 75 67 | 2e 6d 61 6e 09 31 2e 31 |@(#)dbug|.man.1.1|
|000010c0| 0a 58 2e 5c 22 0a 58 2e | 54 48 20 44 42 55 47 20 |.X.\".X.|TH DBUG |
|000010d0| 33 4c 20 22 38 39 2f 30 | 37 2f 32 30 22 20 22 4b |3L "89/0|7/20" "K|
|000010e0| 20 53 79 73 20 41 70 20 | 31 32 31 22 0a 58 2e 53 | Sys Ap |121".X.S|
|000010f0| 48 20 4e 41 4d 45 0a 58 | 64 62 75 67 20 5c 2d 20 |H NAME.X|dbug \- |
|00001100| 61 20 74 6f 6f 6c 73 65 | 74 20 66 6f 72 20 69 6e |a toolse|t for in|
|00001110| 74 65 72 6e 61 6c 20 64 | 65 62 75 67 67 69 6e 67 |ternal d|ebugging|
|00001120| 20 6f 66 20 43 20 70 72 | 6f 67 72 61 6d 73 2e 0a | of C pr|ograms..|
|00001130| 58 2e 61 64 0a 58 2e 53 | 48 20 53 59 4e 4f 50 53 |X.ad.X.S|H SYNOPS|
|00001140| 49 53 0a 58 4e 6f 74 65 | 2c 20 74 68 65 20 66 6f |IS.XNote|, the fo|
|00001150| 6c 6c 6f 77 69 6e 67 20 | 22 66 75 6e 63 74 69 6f |llowing |"functio|
|00001160| 6e 73 22 20 61 72 65 20 | 43 20 6d 61 63 72 6f 73 |ns" are |C macros|
|00001170| 2e 20 54 68 65 72 65 66 | 6f 72 65 2c 20 74 68 65 |. Theref|ore, the|
|00001180| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 20 6f 66 0a | descrip|tion of.|
|00001190| 58 74 68 65 20 70 61 72 | 61 6d 65 74 65 72 73 20 |Xthe par|ameters |
|000011a0| 61 72 65 20 6e 6f 74 20 | 6e 65 63 65 73 73 61 72 |are not |necessar|
|000011b0| 69 6c 79 20 63 6f 72 72 | 65 63 74 20 43 2e 20 54 |ily corr|ect C. T|
|000011c0| 68 65 20 69 6e 74 65 6e | 74 69 6f 6e 20 69 73 2c |he inten|tion is,|
|000011d0| 20 74 6f 20 64 65 73 63 | 72 69 62 65 20 61 73 0a | to desc|ribe as.|
|000011e0| 58 63 6c 6f 73 65 20 61 | 73 20 70 6f 73 73 69 62 |Xclose a|s possib|
|000011f0| 6c 65 20 62 75 74 20 73 | 68 6f 72 74 6c 79 20 77 |le but s|hortly w|
|00001200| 68 61 74 20 74 79 70 65 | 20 6f 66 20 22 64 61 74 |hat type| of "dat|
|00001210| 61 22 20 63 61 6e 20 62 | 65 20 75 73 65 64 20 66 |a" can b|e used f|
|00001220| 6f 72 20 74 68 65 0a 58 | 70 61 72 61 6d 65 74 65 |or the.X|paramete|
|00001230| 72 73 20 6f 66 20 74 68 | 65 20 6d 61 63 72 6f 73 |rs of th|e macros|
|00001240| 2e 0a 58 2e 50 50 0a 58 | 23 69 6e 63 6c 75 64 65 |..X.PP.X|#include|
|00001250| 20 3c 64 62 75 67 2e 68 | 3e 0a 58 2e 50 50 0a 58 | <dbug.h|>.X.PP.X|
|00001260| 5c 66 49 44 42 55 47 5f | 45 4e 54 45 52 5c 66 50 |\fIDBUG_|ENTER\fP|
|00001270| 20 28 20 61 4e 61 6d 65 | 20 29 0a 58 2e 52 53 20 | ( aName| ).X.RS |
|00001280| 36 0a 58 63 68 61 72 20 | 2a 09 61 4e 61 6d 65 3b |6.Xchar |*.aName;|
|00001290| 0a 58 2e 52 53 20 2d 36 | 0a 58 2e 50 50 0a 58 5c |.X.RS -6|.X.PP.X\|
|000012a0| 66 49 44 42 55 47 5f 52 | 45 54 55 52 4e 5c 66 50 |fIDBUG_R|ETURN\fP|
|000012b0| 20 28 20 61 56 61 6c 75 | 65 20 29 0a 58 2e 52 53 | ( aValu|e ).X.RS|
|000012c0| 20 36 0a 58 69 6e 74 09 | 61 56 61 6c 75 65 3b 0a | 6.Xint.|aValue;.|
|000012d0| 58 2e 52 53 20 2d 36 0a | 58 2e 50 50 0a 58 5c 66 |X.RS -6.|X.PP.X\f|
|000012e0| 49 44 42 55 47 5f 56 4f | 49 44 5f 52 45 54 55 52 |IDBUG_VO|ID_RETUR|
|000012f0| 4e 5c 66 50 0a 58 2e 50 | 50 0a 58 5c 66 49 44 42 |N\fP.X.P|P.X\fIDB|
|00001300| 55 47 5f 50 52 49 4e 54 | 5c 66 50 20 28 20 61 4c |UG_PRINT|\fP ( aL|
|00001310| 61 62 65 6c 53 74 72 69 | 6e 67 2c 20 28 74 68 65 |abelStri|ng, (the|
|00001320| 50 72 69 6e 74 66 50 61 | 72 61 6d 65 74 65 72 73 |PrintfPa|rameters|
|00001330| 29 20 29 0a 58 2e 52 53 | 20 36 0a 58 63 68 61 72 |) ).X.RS| 6.Xchar|
|00001340| 20 2a 09 61 4c 61 62 65 | 6c 53 74 72 69 6e 67 3b | *.aLabe|lString;|
|00001350| 0a 58 2e 62 72 0a 58 50 | 61 72 61 6d 65 74 65 72 |.X.br.XP|arameter|
|00001360| 4c 69 73 74 20 74 68 65 | 50 72 69 6e 74 66 50 61 |List the|PrintfPa|
|00001370| 72 61 6d 65 74 65 72 73 | 3b 0a 58 2e 52 53 20 2d |rameters|;.X.RS -|
|00001380| 36 0a 58 2e 50 50 0a 58 | 5c 66 49 44 42 55 47 5f |6.X.PP.X|\fIDBUG_|
|00001390| 50 52 4f 43 45 53 53 5c | 66 50 20 28 20 61 4e 61 |PROCESS\|fP ( aNa|
|000013a0| 6d 65 20 29 0a 58 2e 52 | 53 20 36 0a 58 63 68 61 |me ).X.R|S 6.Xcha|
|000013b0| 72 20 2a 09 61 4e 61 6d | 65 3b 0a 58 2e 52 53 20 |r *.aNam|e;.X.RS |
|000013c0| 2d 36 0a 58 2e 50 50 0a | 58 5c 66 49 44 42 55 47 |-6.X.PP.|X\fIDBUG|
|000013d0| 5f 50 55 53 48 5c 66 50 | 20 28 20 61 44 62 75 67 |_PUSH\fP| ( aDbug|
|000013e0| 4f 70 74 69 6f 6e 53 74 | 72 69 6e 67 20 29 0a 58 |OptionSt|ring ).X|
|000013f0| 2e 52 53 20 36 0a 58 63 | 68 61 72 20 2a 09 61 44 |.RS 6.Xc|har *.aD|
|00001400| 62 75 67 4f 70 74 69 6f | 6e 53 74 72 69 6e 67 3b |bugOptio|nString;|
|00001410| 0a 58 2e 52 53 20 2d 36 | 0a 58 2e 50 50 0a 58 5c |.X.RS -6|.X.PP.X\|
|00001420| 66 49 44 42 55 47 5f 50 | 4f 50 5c 66 50 20 28 29 |fIDBUG_P|OP\fP ()|
|00001430| 0a 58 2e 50 50 0a 58 5c | 66 49 44 42 55 47 5f 46 |.X.PP.X\|fIDBUG_F|
|00001440| 49 4c 45 5c 66 50 0a 58 | 2e 50 50 0a 58 5c 66 49 |ILE\fP.X|.PP.X\fI|
|00001450| 44 42 55 47 5f 45 58 45 | 43 55 54 45 5c 66 50 20 |DBUG_EXE|CUTE\fP |
|00001460| 28 20 61 4c 61 62 65 6c | 53 74 72 69 6e 67 2c 20 |( aLabel|String, |
|00001470| 73 6f 6d 65 43 6f 64 65 | 20 29 0a 58 2e 52 53 20 |someCode| ).X.RS |
|00001480| 36 0a 58 63 68 61 72 20 | 2a 09 61 4c 61 62 65 6c |6.Xchar |*.aLabel|
|00001490| 53 74 72 69 6e 67 3b 0a | 58 2e 62 72 0a 58 43 2d |String;.|X.br.XC-|
|000014a0| 43 6f 64 65 09 73 6f 6d | 65 43 6f 64 65 3b 0a 58 |Code.som|eCode;.X|
|000014b0| 2e 52 53 20 2d 36 0a 58 | 2e 50 50 0a 58 5c 66 49 |.RS -6.X|.PP.X\fI|
|000014c0| 44 42 55 47 5f 53 45 54 | 4a 4d 50 5c 66 50 20 28 |DBUG_SET|JMP\fP (|
|000014d0| 20 65 6e 76 20 29 0a 58 | 2e 52 53 20 36 0a 58 6a | env ).X|.RS 6.Xj|
|000014e0| 6d 70 5f 62 75 66 09 65 | 6e 76 3b 0a 58 2e 52 53 |mp_buf.e|nv;.X.RS|
|000014f0| 20 2d 36 0a 58 2e 50 50 | 0a 58 5c 66 49 44 42 55 | -6.X.PP|.X\fIDBU|
|00001500| 47 5f 4c 4f 4e 47 4a 4d | 50 5c 66 50 20 28 20 65 |G_LONGJM|P\fP ( e|
|00001510| 6e 76 2c 20 76 61 6c 20 | 29 0a 58 2e 52 53 20 36 |nv, val |).X.RS 6|
|00001520| 0a 58 6a 6d 70 5f 62 75 | 66 09 65 6e 76 3b 0a 58 |.Xjmp_bu|f.env;.X|
|00001530| 2e 62 72 0a 58 69 6e 74 | 09 76 61 6c 3b 0a 58 2e |.br.Xint|.val;.X.|
|00001540| 52 53 20 2d 36 0a 58 2e | 53 48 20 44 45 53 43 52 |RS -6.X.|SH DESCR|
|00001550| 49 50 54 49 4f 4e 0a 58 | 5c 66 49 44 62 75 67 5c |IPTION.X|\fIDbug\|
|00001560| 66 50 20 69 73 0a 58 61 | 20 6d 61 63 72 6f 20 62 |fP is.Xa| macro b|
|00001570| 61 73 65 64 20 43 20 69 | 6e 74 65 72 6e 61 6c 20 |ased C i|nternal |
|00001580| 64 65 62 75 67 67 69 6e | 67 0a 58 70 61 63 6b 61 |debuggin|g.Xpacka|
|00001590| 67 65 20 77 68 69 63 68 | 20 68 61 73 20 70 72 6f |ge which| has pro|
|000015a0| 76 65 6e 20 74 6f 20 62 | 65 20 61 20 76 65 72 79 |ven to b|e a very|
|000015b0| 20 66 6c 65 78 69 62 6c | 65 20 61 6e 64 20 75 73 | flexibl|e and us|
|000015c0| 65 66 75 6c 20 74 6f 6f | 6c 0a 58 66 6f 72 20 64 |eful too|l.Xfor d|
|000015d0| 65 62 75 67 67 69 6e 67 | 2c 20 74 65 73 74 69 6e |ebugging|, testin|
|000015e0| 67 2c 20 61 6e 64 20 70 | 6f 72 74 69 6e 67 20 43 |g, and p|orting C|
|000015f0| 20 70 72 6f 67 72 61 6d | 73 2e 0a 58 2e 50 50 0a | program|s..X.PP.|
|00001600| 58 49 6e 74 65 72 6e 61 | 6c 20 64 65 62 75 67 67 |XInterna|l debugg|
|00001610| 69 6e 67 20 61 72 65 20 | 74 79 70 69 63 61 6c 6c |ing are |typicall|
|00001620| 79 20 22 70 72 69 6e 74 | 20 73 74 61 74 65 6d 65 |y "print| stateme|
|00001630| 6e 74 73 22 20 69 6e 63 | 6c 75 64 65 64 20 69 6e |nts" inc|luded in|
|00001640| 74 6f 20 74 68 65 20 70 | 72 6f 67 72 61 6d 0a 58 |to the p|rogram.X|
|00001650| 73 6f 75 72 63 65 2e 20 | 5c 66 49 44 62 75 67 5c |source. |\fIDbug\|
|00001660| 66 50 20 70 72 6f 76 69 | 64 65 73 20 66 6f 72 20 |fP provi|des for |
|00001670| 65 6e 68 61 6e 63 65 64 | 20 63 61 70 61 62 69 6c |enhanced| capabil|
|00001680| 69 74 69 65 73 20 74 6f | 20 64 6f 20 73 6f 2e 20 |ities to| do so. |
|00001690| 49 6e 20 61 64 64 69 74 | 69 6f 6e 0a 58 65 61 63 |In addit|ion.Xeac|
|000016a0| 68 20 63 61 70 61 62 69 | 6c 69 74 79 20 63 61 6e |h capabi|lity can|
|000016b0| 20 62 65 20 69 6e 64 69 | 76 69 64 75 61 6c 6c 79 | be indi|vidually|
|000016c0| 20 65 6e 61 62 6c 65 64 | 20 6f 72 20 64 69 73 61 | enabled| or disa|
|000016d0| 62 6c 65 64 20 61 74 20 | 74 68 65 20 74 69 6d 65 |bled at |the time|
|000016e0| 20 61 20 70 72 6f 67 72 | 61 6d 0a 58 69 73 20 69 | a progr|am.Xis i|
|000016f0| 6e 76 6f 6b 65 64 20 62 | 79 20 73 70 65 63 69 66 |nvoked b|y specif|
|00001700| 79 69 6e 67 20 74 68 65 | 20 61 70 70 72 6f 70 72 |ying the| appropr|
|00001710| 69 61 74 65 20 63 6f 6d | 6d 61 6e 64 20 6c 69 6e |iate com|mand lin|
|00001720| 65 20 61 72 67 75 6d 65 | 6e 74 73 2e 0a 58 2e 50 |e argume|nts..X.P|
|00001730| 50 0a 58 53 6f 2c 20 61 | 6c 6c 20 6f 66 20 74 68 |P.XSo, a|ll of th|
|00001740| 65 20 66 65 61 74 75 72 | 65 73 20 6f 66 20 74 68 |e featur|es of th|
|00001750| 65 0a 58 2e 49 20 64 62 | 75 67 0a 58 70 61 63 6b |e.X.I db|ug.Xpack|
|00001760| 61 67 65 20 63 61 6e 20 | 62 65 20 65 6e 61 62 6c |age can |be enabl|
|00001770| 65 64 20 6f 72 20 64 69 | 73 61 62 6c 65 64 20 64 |ed or di|sabled d|
|00001780| 79 6e 61 6d 69 63 61 6c | 6c 79 20 61 74 20 65 78 |ynamical|ly at ex|
|00001790| 65 63 75 74 69 6f 6e 20 | 74 69 6d 65 2e 0a 58 54 |ecution |time..XT|
|000017a0| 68 69 73 20 6d 65 61 6e | 73 20 74 68 61 74 20 70 |his mean|s that p|
|000017b0| 72 6f 64 75 63 74 69 6f | 6e 20 70 72 6f 67 72 61 |roductio|n progra|
|000017c0| 6d 73 20 77 69 6c 6c 20 | 72 75 6e 20 6e 6f 72 6d |ms will |run norm|
|000017d0| 61 6c 6c 79 20 77 68 65 | 6e 0a 58 64 65 62 75 67 |ally whe|n.Xdebug|
|000017e0| 67 69 6e 67 20 69 73 20 | 6e 6f 74 20 65 6e 61 62 |ging is |not enab|
|000017f0| 6c 65 64 2c 20 61 6e 64 | 20 65 6c 69 6d 69 6e 61 |led, and| elimina|
|00001800| 74 65 73 20 74 68 65 20 | 6e 65 65 64 20 74 6f 20 |tes the |need to |
|00001810| 6d 61 69 6e 74 61 69 6e | 20 74 77 6f 0a 58 73 65 |maintain| two.Xse|
|00001820| 70 61 72 61 74 65 20 76 | 65 72 73 69 6f 6e 73 20 |parate v|ersions |
|00001830| 6f 66 20 61 20 70 72 6f | 67 72 61 6d 2e 0a 58 2e |of a pro|gram..X.|
|00001840| 50 50 0a 58 54 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |PP.XThe |followin|
|00001850| 67 20 73 70 65 63 69 66 | 69 65 73 20 61 20 73 75 |g specif|ies a su|
|00001860| 6d 6d 61 72 79 20 6f 66 | 20 74 68 65 20 5c 66 49 |mmary of| the \fI|
|00001870| 64 62 75 67 5c 66 50 20 | 63 61 70 61 62 69 6c 69 |dbug\fP |capabili|
|00001880| 74 69 65 73 3a 0a 58 2e | 54 50 20 33 0a 58 2d 0a |ties:.X.|TP 3.X-.|
|00001890| 58 45 78 65 63 75 74 69 | 6f 6e 20 74 72 61 63 65 |XExecuti|on trace|
|000018a0| 20 73 68 6f 77 69 6e 67 | 20 66 75 6e 63 74 69 6f | showing| functio|
|000018b0| 6e 20 6c 65 76 65 6c 20 | 63 6f 6e 74 72 6f 6c 20 |n level |control |
|000018c0| 66 6c 6f 77 20 69 6e 20 | 61 0a 58 73 65 6d 69 2d |flow in |a.Xsemi-|
|000018d0| 67 72 61 70 68 69 63 61 | 6c 6c 79 20 6d 61 6e 6e |graphica|lly mann|
|000018e0| 65 72 20 75 73 69 6e 67 | 20 69 6e 64 65 6e 74 61 |er using| indenta|
|000018f0| 74 69 6f 6e 20 74 6f 20 | 69 6e 64 69 63 61 74 65 |tion to |indicate|
|00001900| 20 6e 65 73 74 69 6e 67 | 0a 58 64 65 70 74 68 2e | nesting|.Xdepth.|
|00001910| 0a 58 2e 54 50 20 33 0a | 58 2d 0a 58 4f 75 74 70 |.X.TP 3.|X-.XOutp|
|00001920| 75 74 20 74 68 65 20 76 | 61 6c 75 65 73 20 6f 66 |ut the v|alues of|
|00001930| 20 61 6c 6c 2c 20 6f 72 | 20 61 6e 79 20 73 75 62 | all, or| any sub|
|00001940| 73 65 74 20 6f 66 2c 20 | 6b 65 79 20 69 6e 74 65 |set of, |key inte|
|00001950| 72 6e 61 6c 20 76 61 72 | 69 61 62 6c 65 73 2e 0a |rnal var|iables..|
|00001960| 58 2e 54 50 20 33 0a 58 | 2d 0a 58 4c 69 6d 69 74 |X.TP 3.X|-.XLimit|
|00001970| 20 61 63 74 69 6f 6e 73 | 20 74 6f 20 61 20 73 70 | actions| to a sp|
|00001980| 65 63 69 66 69 63 20 73 | 65 74 20 6f 66 20 6e 61 |ecific s|et of na|
|00001990| 6d 65 64 20 66 75 6e 63 | 74 69 6f 6e 73 2e 0a 58 |med func|tions..X|
|000019a0| 2e 54 50 20 33 0a 58 2d | 0a 58 4c 69 6d 69 74 20 |.TP 3.X-|.XLimit |
|000019b0| 66 75 6e 63 74 69 6f 6e | 20 74 72 61 63 65 20 74 |function| trace t|
|000019c0| 6f 20 61 20 73 70 65 63 | 69 66 69 65 64 20 6e 65 |o a spec|ified ne|
|000019d0| 73 74 69 6e 67 20 64 65 | 70 74 68 2e 0a 58 2e 54 |sting de|pth..X.T|
|000019e0| 50 20 33 0a 58 2d 0a 58 | 4c 61 62 65 6c 20 65 61 |P 3.X-.X|Label ea|
|000019f0| 63 68 20 6f 75 74 70 75 | 74 20 6c 69 6e 65 20 77 |ch outpu|t line w|
|00001a00| 69 74 68 20 73 6f 75 72 | 63 65 20 66 69 6c 65 20 |ith sour|ce file |
|00001a10| 6e 61 6d 65 20 61 6e 64 | 20 6c 69 6e 65 20 6e 75 |name and| line nu|
|00001a20| 6d 62 65 72 2e 0a 58 2e | 54 50 20 33 0a 58 2d 0a |mber..X.|TP 3.X-.|
|00001a30| 58 4c 61 62 65 6c 20 65 | 61 63 68 20 6f 75 74 70 |XLabel e|ach outp|
|00001a40| 75 74 20 6c 69 6e 65 20 | 77 69 74 68 20 6e 61 6d |ut line |with nam|
|00001a50| 65 20 6f 66 20 63 75 72 | 72 65 6e 74 20 70 72 6f |e of cur|rent pro|
|00001a60| 63 65 73 73 2e 0a 58 2e | 54 50 20 33 0a 58 2d 0a |cess..X.|TP 3.X-.|
|00001a70| 58 50 75 73 68 20 6f 72 | 20 70 6f 70 20 69 6e 74 |XPush or| pop int|
|00001a80| 65 72 6e 61 6c 20 64 65 | 62 75 67 67 69 6e 67 20 |ernal de|bugging |
|00001a90| 73 74 61 74 65 20 74 6f | 20 61 6c 6c 6f 77 20 65 |state to| allow e|
|00001aa0| 78 65 63 75 74 69 6f 6e | 20 77 69 74 68 0a 58 62 |xecution| with.Xb|
|00001ab0| 75 69 6c 74 20 69 6e 20 | 64 65 62 75 67 67 69 6e |uilt in |debuggin|
|00001ac0| 67 20 64 65 66 61 75 6c | 74 73 2e 0a 58 2e 54 50 |g defaul|ts..X.TP|
|00001ad0| 20 33 0a 58 2d 0a 58 52 | 65 64 69 72 65 63 74 20 | 3.X-.XR|edirect |
|00001ae0| 74 68 65 20 64 65 62 75 | 67 20 6f 75 74 70 75 74 |the debu|g output|
|00001af0| 20 73 74 72 65 61 6d 20 | 74 6f 20 73 74 61 6e 64 | stream |to stand|
|00001b00| 61 72 64 20 6f 75 74 70 | 75 74 20 28 73 74 64 6f |ard outp|ut (stdo|
|00001b10| 75 74 29 0a 58 6f 72 20 | 61 20 6e 61 6d 65 64 20 |ut).Xor |a named |
|00001b20| 66 69 6c 65 2e 0a 58 54 | 68 65 20 64 65 66 61 75 |file..XT|he defau|
|00001b30| 6c 74 20 6f 75 74 70 75 | 74 20 73 74 72 65 61 6d |lt outpu|t stream|
|00001b40| 20 69 73 20 73 74 61 6e | 64 61 72 64 20 65 72 72 | is stan|dard err|
|00001b50| 6f 72 20 28 73 74 64 65 | 72 72 29 2e 0a 58 2e 50 |or (stde|rr)..X.P|
|00001b60| 50 0a 58 4d 61 6e 79 20 | 6f 66 20 74 68 65 20 74 |P.XMany |of the t|
|00001b70| 68 69 6e 67 73 20 65 61 | 73 69 6c 79 20 61 63 63 |hings ea|sily acc|
|00001b80| 6f 6d 70 6c 69 73 68 65 | 64 20 77 69 74 68 20 63 |omplishe|d with c|
|00001b90| 6f 6e 76 65 6e 74 69 6f | 6e 61 6c 20 64 65 62 75 |onventio|nal debu|
|00001ba0| 67 67 69 6e 67 0a 58 74 | 6f 6f 6c 73 2c 20 73 75 |gging.Xt|ools, su|
|00001bb0| 63 68 20 61 73 20 73 79 | 6d 62 6f 6c 69 63 20 64 |ch as sy|mbolic d|
|00001bc0| 65 62 75 67 67 65 72 73 | 2c 20 61 72 65 20 64 69 |ebuggers|, are di|
|00001bd0| 66 66 69 63 75 6c 74 20 | 6f 72 20 69 6d 70 6f 73 |fficult |or impos|
|00001be0| 73 69 62 6c 65 20 77 69 | 74 68 20 74 68 69 73 0a |sible wi|th this.|
|00001bf0| 58 70 61 63 6b 61 67 65 | 2c 20 61 6e 64 20 76 69 |Xpackage|, and vi|
|00001c00| 63 65 20 76 65 72 73 61 | 2e 0a 58 54 68 75 73 20 |ce versa|..XThus |
|00001c10| 74 68 65 0a 58 2e 49 20 | 64 62 75 67 0a 58 70 61 |the.X.I |dbug.Xpa|
|00001c20| 63 6b 61 67 65 20 73 68 | 6f 75 6c 64 20 0a 58 2e |ckage sh|ould .X.|
|00001c30| 49 20 6e 6f 74 0a 58 62 | 65 20 74 68 6f 75 67 68 |I not.Xb|e though|
|00001c40| 74 20 6f 66 20 61 73 20 | 61 20 72 65 70 6c 61 63 |t of as |a replac|
|00001c50| 65 6d 65 6e 74 20 6f 72 | 20 73 75 62 73 74 69 74 |ement or| substit|
|00001c60| 75 74 65 20 66 6f 72 0a | 58 6f 74 68 65 72 20 64 |ute for.|Xother d|
|00001c70| 65 62 75 67 67 69 6e 67 | 20 74 6f 6f 6c 73 2c 20 |ebugging| tools, |
|00001c80| 62 75 74 20 73 69 6d 70 | 6c 79 20 61 73 20 61 20 |but simp|ly as a |
|00001c90| 75 73 65 66 75 6c 0a 58 | 2e 49 20 61 64 64 69 74 |useful.X|.I addit|
|00001ca0| 69 6f 6e 0a 58 74 6f 20 | 74 68 65 0a 58 70 72 6f |ion.Xto |the.Xpro|
|00001cb0| 67 72 61 6d 20 64 65 76 | 65 6c 6f 70 6d 65 6e 74 |gram dev|elopment|
|00001cc0| 20 61 6e 64 20 6d 61 69 | 6e 74 65 6e 61 6e 63 65 | and mai|ntenance|
|00001cd0| 20 65 6e 76 69 72 6f 6e | 6d 65 6e 74 2e 0a 58 2e | environ|ment..X.|
|00001ce0| 50 50 0a 58 54 68 65 0a | 58 2e 49 20 64 62 75 67 |PP.XThe.|X.I dbug|
|00001cf0| 0a 58 70 61 63 6b 61 67 | 65 20 69 6d 70 6f 73 65 |.Xpackag|e impose|
|00001d00| 73 20 6f 6e 6c 79 20 61 | 20 73 6c 69 67 68 74 20 |s only a| slight |
|00001d10| 73 70 65 65 64 20 70 65 | 6e 61 6c 74 79 20 6f 6e |speed pe|nalty on|
|00001d20| 20 65 78 65 63 75 74 69 | 6e 67 0a 58 70 72 6f 67 | executi|ng.Xprog|
|00001d30| 72 61 6d 73 2c 20 74 79 | 70 69 63 61 6c 6c 79 20 |rams, ty|pically |
|00001d40| 6d 75 63 68 20 6c 65 73 | 73 20 74 68 61 6e 20 31 |much les|s than 1|
|00001d50| 30 20 70 65 72 63 65 6e | 74 2c 20 61 6e 64 20 61 |0 percen|t, and a|
|00001d60| 20 6d 6f 64 65 73 74 20 | 73 69 7a 65 0a 58 70 65 | modest |size.Xpe|
|00001d70| 6e 61 6c 74 79 2c 20 74 | 79 70 69 63 61 6c 6c 79 |nalty, t|ypically|
|00001d80| 20 31 30 20 74 6f 20 32 | 30 20 70 65 72 63 65 6e | 10 to 2|0 percen|
|00001d90| 74 2e 0a 58 42 79 20 64 | 65 66 69 6e 69 6e 67 20 |t..XBy d|efining |
|00001da0| 61 20 73 70 65 63 69 66 | 69 63 20 43 20 70 72 65 |a specif|ic C pre|
|00001db0| 70 72 6f 63 65 73 73 6f | 72 20 73 79 6d 62 6f 6c |processo|r symbol|
|00001dc0| 20 62 6f 74 68 20 6f 66 | 20 74 68 65 73 65 0a 58 | both of| these.X|
|00001dd0| 63 61 6e 20 62 65 20 72 | 65 64 75 63 65 64 20 74 |can be r|educed t|
|00001de0| 6f 20 7a 65 72 6f 20 77 | 69 74 68 20 6e 6f 20 63 |o zero w|ith no c|
|00001df0| 68 61 6e 67 65 73 20 72 | 65 71 75 69 72 65 64 20 |hanges r|equired |
|00001e00| 74 6f 20 74 68 65 0a 58 | 73 6f 75 72 63 65 20 63 |to the.X|source c|
|00001e10| 6f 64 65 2e 0a 58 2e 50 | 50 0a 58 4e 6f 74 69 63 |ode..X.P|P.XNotic|
|00001e20| 65 2c 20 74 68 61 74 20 | 61 6c 6c 20 6f 66 20 74 |e, that |all of t|
|00001e30| 68 65 20 64 65 62 75 67 | 67 65 72 20 66 75 6e 63 |he debug|ger func|
|00001e40| 74 69 6f 6e 73 20 61 72 | 65 20 69 6d 70 6c 65 6d |tions ar|e implem|
|00001e50| 65 6e 74 65 64 0a 58 76 | 69 61 20 70 72 65 70 72 |ented.Xv|ia prepr|
|00001e60| 6f 63 65 73 73 6f 72 20 | 6d 61 63 72 6f 73 2e 0a |ocessor |macros..|
|00001e70| 58 54 68 69 73 20 64 6f | 65 73 20 6e 6f 74 20 64 |XThis do|es not d|
|00001e80| 65 74 72 61 63 74 20 66 | 72 6f 6d 20 74 68 65 20 |etract f|rom the |
|00001e90| 72 65 61 64 61 62 69 6c | 69 74 79 20 6f 66 20 74 |readabil|ity of t|
|00001ea0| 68 65 20 63 6f 64 65 20 | 61 6e 64 20 6d 61 6b 65 |he code |and make|
|00001eb0| 73 20 64 69 73 61 62 6c | 69 6e 67 0a 58 61 6c 6c |s disabl|ing.Xall|
|00001ec0| 20 64 65 62 75 67 20 63 | 6f 6d 70 69 6c 61 74 69 | debug c|ompilati|
|00001ed0| 6f 6e 20 74 72 69 76 69 | 61 6c 20 28 61 20 73 69 |on trivi|al (a si|
|00001ee0| 6e 67 6c 65 20 70 72 65 | 70 72 6f 63 65 73 73 6f |ngle pre|processo|
|00001ef0| 72 20 73 79 6d 62 6f 6c | 2c 20 0a 58 2e 42 20 44 |r symbol|, .X.B D|
|00001f00| 42 55 47 5f 4f 46 46 20 | 2c 0a 58 66 6f 72 63 65 |BUG_OFF |,.Xforce|
|00001f10| 73 20 74 68 65 20 6d 61 | 63 72 6f 20 65 78 70 61 |s the ma|cro expa|
|00001f20| 6e 73 69 6f 6e 73 20 74 | 6f 20 62 65 20 6e 75 6c |nsions t|o be nul|
|00001f30| 6c 29 2e 0a 58 2e 53 48 | 20 22 53 55 4d 4d 41 52 |l)..X.SH| "SUMMAR|
|00001f40| 59 20 4f 46 20 4d 41 43 | 52 4f 53 22 0a 58 54 68 |Y OF MAC|ROS".XTh|
|00001f50| 69 73 20 73 75 6d 6d 61 | 72 69 7a 65 73 20 74 68 |is summa|rizes th|
|00001f60| 65 20 75 73 61 67 65 20 | 6f 66 20 61 6c 6c 20 63 |e usage |of all c|
|00001f70| 75 72 72 65 6e 74 6c 79 | 20 64 65 66 69 6e 65 64 |urrently| defined|
|00001f80| 20 6d 61 63 72 6f 73 0a | 58 69 6e 20 74 68 65 20 | macros.|Xin the |
|00001f90| 0a 58 2e 49 20 64 62 75 | 67 0a 58 70 61 63 6b 61 |.X.I dbu|g.Xpacka|
|00001fa0| 67 65 2e 0a 58 54 68 65 | 20 6d 61 63 72 6f 73 20 |ge..XThe| macros |
|00001fb0| 64 65 66 69 6e 69 74 69 | 6f 6e 73 20 61 72 65 20 |definiti|ons are |
|00001fc0| 66 6f 75 6e 64 20 69 6e | 20 74 68 65 20 75 73 65 |found in| the use|
|00001fd0| 72 20 69 6e 63 6c 75 64 | 65 20 66 69 6c 65 0a 58 |r includ|e file.X|
|00001fe0| 2e 42 20 64 62 75 67 2e | 68 0a 58 66 72 6f 6d 20 |.B dbug.|h.Xfrom |
|00001ff0| 74 68 65 20 73 74 61 6e | 64 61 72 64 20 69 6e 63 |the stan|dard inc|
|00002000| 6c 75 64 65 20 64 69 72 | 65 63 74 6f 72 79 2e 0a |lude dir|ectory..|
|00002010| 58 2e 54 50 20 31 35 0a | 58 44 42 55 47 5f 45 4e |X.TP 15.|XDBUG_EN|
|00002020| 54 45 52 20 0a 58 55 73 | 65 64 20 74 6f 20 74 65 |TER .XUs|ed to te|
|00002030| 6c 6c 20 74 68 65 20 72 | 75 6e 74 69 6d 65 20 73 |ll the r|untime s|
|00002040| 75 70 70 6f 72 74 20 6d | 6f 64 75 6c 65 20 74 68 |upport m|odule th|
|00002050| 65 20 6e 61 6d 65 20 6f | 66 20 74 68 65 20 66 75 |e name o|f the fu|
|00002060| 6e 63 74 69 6f 6e 0a 58 | 62 65 69 6e 67 20 65 6e |nction.X|being en|
|00002070| 74 65 72 65 64 2e 0a 58 | 54 68 65 20 61 72 67 75 |tered..X|The argu|
|00002080| 6d 65 6e 74 20 6d 75 73 | 74 20 62 65 20 6f 66 20 |ment mus|t be of |
|00002090| 74 79 70 65 20 22 70 6f | 69 6e 74 65 72 20 74 6f |type "po|inter to|
|000020a0| 20 63 68 61 72 61 63 74 | 65 72 22 2e 0a 58 54 68 | charact|er"..XTh|
|000020b0| 65 20 0a 58 44 42 55 47 | 5f 45 4e 54 45 52 0a 58 |e .XDBUG|_ENTER.X|
|000020c0| 6d 61 63 72 6f 20 6d 75 | 73 74 20 70 72 65 63 65 |macro mu|st prece|
|000020d0| 64 65 20 61 6c 6c 20 65 | 78 65 63 75 74 61 62 6c |de all e|xecutabl|
|000020e0| 65 20 6c 69 6e 65 73 20 | 69 6e 20 74 68 65 0a 58 |e lines |in the.X|
|000020f0| 66 75 6e 63 74 69 6f 6e | 20 6a 75 73 74 20 65 6e |function| just en|
|00002100| 74 65 72 65 64 2c 20 61 | 6e 64 20 6d 75 73 74 20 |tered, a|nd must |
|00002110| 63 6f 6d 65 20 61 66 74 | 65 72 20 61 6c 6c 20 6c |come aft|er all l|
|00002120| 6f 63 61 6c 20 64 65 63 | 6c 61 72 61 74 69 6f 6e |ocal dec|laration|
|00002130| 73 2e 0a 58 45 61 63 68 | 20 0a 58 44 42 55 47 5f |s..XEach| .XDBUG_|
|00002140| 45 4e 54 45 52 0a 58 6d | 61 63 72 6f 20 6d 75 73 |ENTER.Xm|acro mus|
|00002150| 74 20 68 61 76 65 20 61 | 20 6d 61 74 63 68 69 6e |t have a| matchin|
|00002160| 67 20 0a 58 44 42 55 47 | 5f 52 45 54 55 52 4e 20 |g .XDBUG|_RETURN |
|00002170| 0a 58 6f 72 0a 58 44 42 | 55 47 5f 56 4f 49 44 5f |.Xor.XDB|UG_VOID_|
|00002180| 52 45 54 55 52 4e 0a 58 | 6d 61 63 72 6f 20 0a 58 |RETURN.X|macro .X|
|00002190| 61 74 20 74 68 65 20 66 | 75 6e 63 74 69 6f 6e 20 |at the f|unction |
|000021a0| 65 78 69 74 20 70 6f 69 | 6e 74 73 2e 0a 58 44 42 |exit poi|nts..XDB|
|000021b0| 55 47 5f 45 4e 54 45 52 | 20 0a 58 6d 61 63 72 6f |UG_ENTER| .Xmacro|
|000021c0| 73 20 75 73 65 64 20 77 | 69 74 68 6f 75 74 20 61 |s used w|ithout a|
|000021d0| 20 6d 61 74 63 68 69 6e | 67 20 0a 58 44 42 55 47 | matchin|g .XDBUG|
|000021e0| 5f 52 45 54 55 52 4e 20 | 0a 58 6f 72 20 0a 58 44 |_RETURN |.Xor .XD|
|000021f0| 42 55 47 5f 56 4f 49 44 | 5f 52 45 54 55 52 4e 0a |BUG_VOID|_RETURN.|
|00002200| 58 6d 61 63 72 6f 20 0a | 58 77 69 6c 6c 20 63 61 |Xmacro .|Xwill ca|
|00002210| 75 73 65 20 77 61 72 6e | 69 6e 67 20 6d 65 73 73 |use warn|ing mess|
|00002220| 61 67 65 73 20 66 72 6f | 6d 20 74 68 65 20 0a 58 |ages fro|m the .X|
|00002230| 2e 49 20 64 62 75 67 0a | 58 70 61 63 6b 61 67 65 |.I dbug.|Xpackage|
|00002240| 20 72 75 6e 74 69 6d 65 | 20 73 75 70 70 6f 72 74 | runtime| support|
|00002250| 20 6d 6f 64 75 6c 65 2e | 0a 58 2e 62 72 0a 58 2e | module.|.X.br.X.|
|00002260| 73 70 0a 58 45 58 3a 5c | 20 44 42 55 47 5f 45 4e |sp.XEX:\| DBUG_EN|
|00002270| 54 45 52 5c 20 28 22 6d | 61 69 6e 22 29 3b 0a 58 |TER\ ("m|ain");.X|
|00002280| 2e 54 50 20 31 35 0a 58 | 44 42 55 47 5f 52 45 54 |.TP 15.X|DBUG_RET|
|00002290| 55 52 4e 20 0a 58 55 73 | 65 64 20 61 74 20 65 61 |URN .XUs|ed at ea|
|000022a0| 63 68 20 65 78 69 74 20 | 70 6f 69 6e 74 20 6f 66 |ch exit |point of|
|000022b0| 20 61 20 66 75 6e 63 74 | 69 6f 6e 20 63 6f 6e 74 | a funct|ion cont|
|000022c0| 61 69 6e 69 6e 67 20 61 | 20 0a 58 44 42 55 47 5f |aining a| .XDBUG_|
|000022d0| 45 4e 54 45 52 20 0a 58 | 6d 61 63 72 6f 0a 58 61 |ENTER .X|macro.Xa|
|000022e0| 74 20 74 68 65 20 65 6e | 74 72 79 20 70 6f 69 6e |t the en|try poin|
|000022f0| 74 2e 0a 58 54 68 65 20 | 61 72 67 75 6d 65 6e 74 |t..XThe |argument|
|00002300| 20 69 73 20 74 68 65 20 | 76 61 6c 75 65 20 74 6f | is the |value to|
|00002310| 20 72 65 74 75 72 6e 2e | 0a 58 46 75 6e 63 74 69 | return.|.XFuncti|
|00002320| 6f 6e 73 20 77 68 69 63 | 68 20 72 65 74 75 72 6e |ons whic|h return|
|00002330| 20 6e 6f 20 76 61 6c 75 | 65 20 28 76 6f 69 64 29 | no valu|e (void)|
|00002340| 20 73 68 6f 75 6c 64 20 | 75 73 65 20 74 68 65 20 | should |use the |
|00002350| 0a 58 44 42 55 47 5f 56 | 4f 49 44 5f 52 45 54 55 |.XDBUG_V|OID_RETU|
|00002360| 52 4e 0a 58 6d 61 63 72 | 6f 2e 0a 58 49 74 20 0a |RN.Xmacr|o..XIt .|
|00002370| 58 69 73 20 61 6e 20 65 | 72 72 6f 72 20 74 6f 20 |Xis an e|rror to |
|00002380| 68 61 76 65 20 61 20 0a | 58 44 42 55 47 5f 52 45 |have a .|XDBUG_RE|
|00002390| 54 55 52 4e 20 0a 58 6f | 72 20 0a 58 44 42 55 47 |TURN .Xo|r .XDBUG|
|000023a0| 5f 56 4f 49 44 5f 52 45 | 54 55 52 4e 20 0a 58 6d |_VOID_RE|TURN .Xm|
|000023b0| 61 63 72 6f 20 69 6e 20 | 61 20 66 75 6e 63 74 69 |acro in |a functi|
|000023c0| 6f 6e 0a 58 77 68 69 63 | 68 20 68 61 73 20 6e 6f |on.Xwhic|h has no|
|000023d0| 20 6d 61 74 63 68 69 6e | 67 20 0a 58 44 42 55 47 | matchin|g .XDBUG|
|000023e0| 5f 45 4e 54 45 52 20 0a | 58 6d 61 63 72 6f 2c 20 |_ENTER .|Xmacro, |
|000023f0| 61 6e 64 20 74 68 65 20 | 63 6f 6d 70 69 6c 65 72 |and the |compiler|
|00002400| 20 77 69 6c 6c 20 63 6f | 6d 70 6c 61 69 6e 0a 58 | will co|mplain.X|
|00002410| 69 66 20 74 68 65 20 6d | 61 63 72 6f 73 20 61 72 |if the m|acros ar|
|00002420| 65 20 61 63 74 75 61 6c | 6c 79 20 75 73 65 64 20 |e actual|ly used |
|00002430| 28 65 78 70 61 6e 64 65 | 64 29 2e 0a 58 2e 62 72 |(expande|d)..X.br|
|00002440| 0a 58 2e 73 70 0a 58 45 | 58 3a 5c 20 44 42 55 47 |.X.sp.XE|X:\ DBUG|
|00002450| 5f 52 45 54 55 52 4e 5c | 20 28 76 61 6c 75 65 29 |_RETURN\| (value)|
|00002460| 3b 0a 58 2e 62 72 0a 58 | 45 58 3a 5c 20 44 42 55 |;.X.br.X|EX:\ DBU|
|00002470| 47 5f 56 4f 49 44 5f 52 | 45 54 55 52 4e 3b 0a 58 |G_VOID_R|ETURN;.X|
|00002480| 2e 54 50 20 31 35 0a 58 | 44 42 55 47 5f 50 52 4f |.TP 15.X|DBUG_PRO|
|00002490| 43 45 53 53 20 0a 58 55 | 73 65 64 20 74 6f 20 6e |CESS .XU|sed to n|
|000024a0| 61 6d 65 20 74 68 65 20 | 63 75 72 72 65 6e 74 20 |ame the |current |
|000024b0| 70 72 6f 63 65 73 73 20 | 62 65 69 6e 67 20 65 78 |process |being ex|
|000024c0| 65 63 75 74 65 64 2e 0a | 58 41 20 74 79 70 69 63 |ecuted..|XA typic|
|000024d0| 61 6c 20 61 72 67 75 6d | 65 6e 74 20 66 6f 72 20 |al argum|ent for |
|000024e0| 74 68 69 73 20 6d 61 63 | 72 6f 20 69 73 20 22 61 |this mac|ro is "a|
|000024f0| 72 67 76 5b 30 5d 22 2c | 20 74 68 6f 75 67 68 0a |rgv[0]",| though.|
|00002500| 58 69 74 20 77 69 6c 6c | 20 62 65 20 70 65 72 66 |Xit will| be perf|
|00002510| 65 63 74 6c 79 20 68 61 | 70 70 79 20 77 69 74 68 |ectly ha|ppy with|
|00002520| 20 61 6e 79 20 6f 74 68 | 65 72 20 73 74 72 69 6e | any oth|er strin|
|00002530| 67 2e 0a 58 2e 62 72 0a | 58 2e 73 70 0a 58 45 58 |g..X.br.|X.sp.XEX|
|00002540| 3a 5c 20 44 42 55 47 5f | 50 52 4f 43 45 53 53 5c |:\ DBUG_|PROCESS\|
|00002550| 20 28 61 72 67 76 5b 30 | 5d 29 3b 0a 58 2e 54 50 | (argv[0|]);.X.TP|
|00002560| 20 31 35 0a 58 44 42 55 | 47 5f 50 55 53 48 20 0a | 15.XDBU|G_PUSH .|
|00002570| 58 53 65 74 73 20 61 20 | 6e 65 77 20 64 65 62 75 |XSets a |new debu|
|00002580| 67 67 65 72 20 73 74 61 | 74 65 20 62 79 20 70 75 |gger sta|te by pu|
|00002590| 73 68 69 6e 67 20 74 68 | 65 20 63 75 72 72 65 6e |shing th|e curren|
|000025a0| 74 0a 58 2e 42 20 64 62 | 75 67 0a 58 73 74 61 74 |t.X.B db|ug.Xstat|
|000025b0| 65 20 6f 6e 74 6f 20 61 | 6e 0a 58 69 6e 74 65 72 |e onto a|n.Xinter|
|000025c0| 6e 61 6c 20 73 74 61 63 | 6b 20 61 6e 64 20 73 65 |nal stac|k and se|
|000025d0| 74 74 69 6e 67 20 75 70 | 20 74 68 65 20 6e 65 77 |tting up| the new|
|000025e0| 20 73 74 61 74 65 20 75 | 73 69 6e 67 20 74 68 65 | state u|sing the|
|000025f0| 20 64 65 62 75 67 20 63 | 6f 6e 74 72 6f 6c 0a 58 | debug c|ontrol.X|
|00002600| 73 74 72 69 6e 67 20 70 | 61 73 73 65 64 20 61 73 |string p|assed as|
|00002610| 20 74 68 65 20 6d 61 63 | 72 6f 20 61 72 67 75 6d | the mac|ro argum|
|00002620| 65 6e 74 2e 0a 58 54 68 | 65 20 6d 6f 73 74 20 63 |ent..XTh|e most c|
|00002630| 6f 6d 6d 6f 6e 20 75 73 | 61 67 65 20 69 73 20 74 |ommon us|age is t|
|00002640| 6f 20 73 65 74 20 74 68 | 65 20 73 74 61 74 65 20 |o set th|e state |
|00002650| 73 70 65 63 69 66 69 65 | 64 20 62 79 20 61 20 64 |specifie|d by a d|
|00002660| 65 62 75 67 0a 58 63 6f | 6e 74 72 6f 6c 20 73 74 |ebug.Xco|ntrol st|
|00002670| 72 69 6e 67 20 72 65 74 | 72 69 65 76 65 64 20 66 |ring ret|rieved f|
|00002680| 72 6f 6d 20 74 68 65 20 | 61 72 67 75 6d 65 6e 74 |rom the |argument|
|00002690| 20 6c 69 73 74 2e 0a 58 | 4e 6f 74 65 20 74 68 61 | list..X|Note tha|
|000026a0| 74 20 74 68 65 20 6c 65 | 61 64 69 6e 67 20 22 5c |t the le|ading "\|
|000026b0| 2d 23 22 20 69 6e 20 61 | 20 64 65 62 75 67 20 63 |-#" in a| debug c|
|000026c0| 6f 6e 74 72 6f 6c 20 73 | 74 72 69 6e 67 20 73 70 |ontrol s|tring sp|
|000026d0| 65 63 69 66 69 65 64 0a | 58 61 73 20 61 20 63 6f |ecified.|Xas a co|
|000026e0| 6d 6d 61 6e 64 20 6c 69 | 6e 65 20 61 72 67 75 6d |mmand li|ne argum|
|000026f0| 65 6e 74 20 6d 75 73 74 | 0a 58 2e 42 20 6e 6f 74 |ent must|.X.B not|
|00002700| 0a 58 62 65 20 70 61 73 | 73 65 64 20 61 73 20 70 |.Xbe pas|sed as p|
|00002710| 61 72 74 20 6f 66 20 74 | 68 65 20 6d 61 63 72 6f |art of t|he macro|
|00002720| 20 61 72 67 75 6d 65 6e | 74 2e 0a 58 54 68 65 20 | argumen|t..XThe |
|00002730| 70 72 6f 70 65 72 20 75 | 73 61 67 65 20 69 73 20 |proper u|sage is |
|00002740| 74 6f 20 70 61 73 73 20 | 61 20 70 6f 69 6e 74 65 |to pass |a pointe|
|00002750| 72 20 74 6f 20 74 68 65 | 20 66 69 72 73 74 20 63 |r to the| first c|
|00002760| 68 61 72 61 63 74 65 72 | 0a 58 2e 42 20 61 66 74 |haracter|.X.B aft|
|00002770| 65 72 0a 58 74 68 65 20 | 22 5c 2d 23 22 20 73 74 |er.Xthe |"\-#" st|
|00002780| 72 69 6e 67 2e 0a 58 2e | 62 72 0a 58 2e 73 70 0a |ring..X.|br.X.sp.|
|00002790| 58 45 58 3a 5c 20 44 42 | 55 47 5f 50 55 53 48 5c |XEX:\ DB|UG_PUSH\|
|000027a0| 20 28 5c 26 28 61 72 67 | 76 5b 69 5d 5b 32 5d 29 | (\&(arg|v[i][2])|
|000027b0| 29 3b 0a 58 2e 62 72 0a | 58 45 58 3a 5c 20 44 42 |);.X.br.|XEX:\ DB|
|000027c0| 55 47 5f 50 55 53 48 5c | 20 28 22 64 3a 74 22 29 |UG_PUSH\| ("d:t")|
|000027d0| 3b 0a 58 2e 62 72 0a 58 | 45 58 3a 5c 20 44 42 55 |;.X.br.X|EX:\ DBU|
|000027e0| 47 5f 50 55 53 48 5c 20 | 28 22 20 22 29 3b 0a 58 |G_PUSH\ |(" ");.X|
|000027f0| 2e 54 50 20 31 35 0a 58 | 44 42 55 47 5f 50 4f 50 |.TP 15.X|DBUG_POP|
|00002800| 20 0a 58 52 65 73 74 6f | 72 65 73 20 74 68 65 20 | .XResto|res the |
|00002810| 70 72 65 76 69 6f 75 73 | 20 64 65 62 75 67 67 65 |previous| debugge|
|00002820| 72 20 73 74 61 74 65 20 | 62 79 20 70 6f 70 70 69 |r state |by poppi|
|00002830| 6e 67 20 74 68 65 20 73 | 74 61 74 65 20 73 74 61 |ng the s|tate sta|
|00002840| 63 6b 2e 0a 58 41 74 74 | 65 6d 70 74 69 6e 67 20 |ck..XAtt|empting |
|00002850| 74 6f 20 70 6f 70 20 6d | 6f 72 65 20 73 74 61 74 |to pop m|ore stat|
|00002860| 65 73 20 74 68 61 6e 20 | 70 75 73 68 65 64 20 77 |es than |pushed w|
|00002870| 69 6c 6c 20 62 65 20 69 | 67 6e 6f 72 65 64 20 61 |ill be i|gnored a|
|00002880| 6e 64 20 6e 6f 0a 58 77 | 61 72 6e 69 6e 67 20 77 |nd no.Xw|arning w|
|00002890| 69 6c 6c 20 62 65 20 67 | 69 76 65 6e 2e 0a 58 54 |ill be g|iven..XT|
|000028a0| 68 65 20 0a 58 44 42 55 | 47 5f 50 4f 50 20 0a 58 |he .XDBU|G_POP .X|
|000028b0| 6d 61 63 72 6f 20 68 61 | 73 20 6e 6f 20 61 72 67 |macro ha|s no arg|
|000028c0| 75 6d 65 6e 74 73 2e 0a | 58 2e 62 72 0a 58 2e 73 |uments..|X.br.X.s|
|000028d0| 70 0a 58 45 58 3a 5c 20 | 44 42 55 47 5f 50 4f 50 |p.XEX:\ |DBUG_POP|
|000028e0| 5c 20 28 29 3b 0a 58 2e | 54 50 20 31 35 0a 58 44 |\ ();.X.|TP 15.XD|
|000028f0| 42 55 47 5f 46 49 4c 45 | 20 0a 58 54 68 65 20 0a |BUG_FILE| .XThe .|
|00002900| 58 44 42 55 47 5f 46 49 | 4c 45 20 0a 58 6d 61 63 |XDBUG_FI|LE .Xmac|
|00002910| 72 6f 20 69 73 20 75 73 | 65 64 20 74 6f 20 64 6f |ro is us|ed to do|
|00002920| 20 65 78 70 6c 69 63 69 | 74 20 49 2f 4f 20 6f 6e | explici|t I/O on|
|00002930| 20 74 68 65 20 64 65 62 | 75 67 20 6f 75 74 70 75 | the deb|ug outpu|
|00002940| 74 0a 58 73 74 72 65 61 | 6d 2e 0a 58 49 74 20 69 |t.Xstrea|m..XIt i|
|00002950| 73 20 75 73 65 64 20 69 | 6e 20 74 68 65 20 73 61 |s used i|n the sa|
|00002960| 6d 65 20 6d 61 6e 6e 65 | 72 20 61 73 20 74 68 65 |me manne|r as the|
|00002970| 20 73 79 6d 62 6f 6c 73 | 20 22 73 74 64 6f 75 74 | symbols| "stdout|
|00002980| 22 20 61 6e 64 20 22 73 | 74 64 65 72 72 22 0a 58 |" and "s|tderr".X|
|00002990| 69 6e 20 74 68 65 20 73 | 74 61 6e 64 61 72 64 20 |in the s|tandard |
|000029a0| 49 2f 4f 20 70 61 63 6b | 61 67 65 2e 0a 58 2e 62 |I/O pack|age..X.b|
|000029b0| 72 0a 58 2e 73 70 0a 58 | 45 58 3a 5c 20 66 70 72 |r.X.sp.X|EX:\ fpr|
|000029c0| 69 6e 74 66 5c 20 28 44 | 42 55 47 5f 46 49 4c 45 |intf\ (D|BUG_FILE|
|000029d0| 2c 5c 20 22 44 6f 69 6e | 67 5c 20 6d 79 5c 20 6f |,\ "Doin|g\ my\ o|
|000029e0| 77 6e 5c 20 49 2f 4f 21 | 5c 5c 6e 22 29 3b 0a 58 |wn\ I/O!|\\n");.X|
|000029f0| 2e 54 50 20 31 35 0a 58 | 44 42 55 47 5f 45 58 45 |.TP 15.X|DBUG_EXE|
|00002a00| 43 55 54 45 20 0a 58 54 | 68 65 20 44 42 55 47 5f |CUTE .XT|he DBUG_|
|00002a10| 45 58 45 43 55 54 45 20 | 6d 61 63 72 6f 20 69 73 |EXECUTE |macro is|
|00002a20| 20 75 73 65 64 20 74 6f | 20 65 78 65 63 75 74 65 | used to| execute|
|00002a30| 20 61 6e 79 20 61 72 62 | 69 74 72 61 72 79 20 43 | any arb|itrary C|
|00002a40| 20 63 6f 64 65 2e 0a 58 | 54 68 65 20 66 69 72 73 | code..X|The firs|
|00002a50| 74 20 61 72 67 75 6d 65 | 6e 74 20 69 73 20 74 68 |t argume|nt is th|
|00002a60| 65 20 64 65 62 75 67 20 | 6b 65 79 77 6f 72 64 2c |e debug |keyword,|
|00002a70| 20 75 73 65 64 20 74 6f | 20 74 72 69 67 67 65 72 | used to| trigger|
|00002a80| 20 65 78 65 63 75 74 69 | 6f 6e 0a 58 6f 66 20 74 | executi|on.Xof t|
|00002a90| 68 65 20 63 6f 64 65 20 | 73 70 65 63 69 66 69 65 |he code |specifie|
|00002aa0| 64 20 61 73 20 74 68 65 | 20 73 65 63 6f 6e 64 20 |d as the| second |
|00002ab0| 61 72 67 75 6d 65 6e 74 | 2e 0a 58 54 68 69 73 20 |argument|..XThis |
|00002ac0| 6d 61 63 72 6f 20 6d 75 | 73 74 20 62 65 20 75 73 |macro mu|st be us|
|00002ad0| 65 64 20 63 61 75 74 69 | 6f 75 73 6c 79 20 62 65 |ed cauti|ously be|
|00002ae0| 63 61 75 73 65 2c 20 6c | 69 6b 65 20 74 68 65 20 |cause, l|ike the |
|00002af0| 0a 58 44 42 55 47 5f 50 | 52 49 4e 54 20 0a 58 6d |.XDBUG_P|RINT .Xm|
|00002b00| 61 63 72 6f 2c 0a 58 69 | 74 20 69 73 20 61 75 74 |acro,.Xi|t is aut|
|00002b10| 6f 6d 61 74 69 63 61 6c | 6c 79 20 73 65 6c 65 63 |omatical|ly selec|
|00002b20| 74 65 64 20 62 79 20 64 | 65 66 61 75 6c 74 20 77 |ted by d|efault w|
|00002b30| 68 65 6e 65 76 65 72 20 | 74 68 65 20 27 64 27 20 |henever |the 'd' |
|00002b40| 66 6c 61 67 20 68 61 73 | 0a 58 6e 6f 20 61 72 67 |flag has|.Xno arg|
|00002b50| 75 6d 65 6e 74 20 6c 69 | 73 74 20 28 49 2e 45 2e |ument li|st (I.E.|
|00002b60| 2c 20 61 20 22 5c 2d 23 | 64 3a 74 22 20 63 6f 6e |, a "\-#|d:t" con|
|00002b70| 74 72 6f 6c 20 73 74 72 | 69 6e 67 29 2e 0a 58 2e |trol str|ing)..X.|
|00002b80| 62 72 0a 58 2e 73 70 0a | 58 45 58 3a 5c 20 44 42 |br.X.sp.|XEX:\ DB|
|00002b90| 55 47 5f 45 58 45 43 55 | 54 45 5c 20 28 22 61 62 |UG_EXECU|TE\ ("ab|
|00002ba0| 6f 72 74 22 2c 5c 20 61 | 62 6f 72 74 5c 20 28 29 |ort",\ a|bort\ ()|
|00002bb0| 29 3b 0a 58 2e 54 50 20 | 31 35 0a 58 44 42 55 47 |);.X.TP |15.XDBUG|
|00002bc0| 5f 4e 0a 58 54 68 65 73 | 65 20 6d 61 63 72 6f 73 |_N.XThes|e macros|
|00002bd0| 2c 20 77 68 65 72 65 20 | 4e 20 69 73 20 69 6e 20 |, where |N is in |
|00002be0| 74 68 65 20 72 61 6e 67 | 65 20 32 5c 2d 35 2c 20 |the rang|e 2\-5, |
|00002bf0| 61 72 65 20 63 75 72 72 | 65 6e 74 6c 79 20 6f 62 |are curr|ently ob|
|00002c00| 73 6f 6c 65 74 65 0a 58 | 61 6e 64 20 77 69 6c 6c |solete.X|and will|
|00002c10| 20 62 65 20 72 65 6d 6f | 76 65 64 20 69 6e 20 61 | be remo|ved in a|
|00002c20| 20 66 75 74 75 72 65 20 | 72 65 6c 65 61 73 65 2e | future |release.|
|00002c30| 0a 58 55 73 65 20 74 68 | 65 20 6e 65 77 20 44 42 |.XUse th|e new DB|
|00002c40| 55 47 5f 50 52 49 4e 54 | 20 6d 61 63 72 6f 2e 0a |UG_PRINT| macro..|
|00002c50| 58 2e 54 50 20 31 35 0a | 58 44 42 55 47 5f 50 52 |X.TP 15.|XDBUG_PR|
|00002c60| 49 4e 54 0a 58 55 73 65 | 64 20 74 6f 20 64 6f 20 |INT.XUse|d to do |
|00002c70| 70 72 69 6e 74 69 6e 67 | 20 76 69 61 20 74 68 65 |printing| via the|
|00002c80| 20 22 66 70 72 69 6e 74 | 66 22 20 6c 69 62 72 61 | "fprint|f" libra|
|00002c90| 72 79 20 66 75 6e 63 74 | 69 6f 6e 20 6f 6e 20 74 |ry funct|ion on t|
|00002ca0| 68 65 0a 58 63 75 72 72 | 65 6e 74 20 64 65 62 75 |he.Xcurr|ent debu|
|00002cb0| 67 20 73 74 72 65 61 6d | 2c 0a 58 44 42 55 47 5f |g stream|,.XDBUG_|
|00002cc0| 46 49 4c 45 2e 0a 58 54 | 68 65 20 66 69 72 73 74 |FILE..XT|he first|
|00002cd0| 20 61 72 67 75 6d 65 6e | 74 20 69 73 20 61 20 64 | argumen|t is a d|
|00002ce0| 65 62 75 67 20 6b 65 79 | 77 6f 72 64 2c 20 74 68 |ebug key|word, th|
|00002cf0| 65 20 73 65 63 6f 6e 64 | 20 69 73 20 61 20 66 6f |e second| is a fo|
|00002d00| 72 6d 61 74 20 73 74 72 | 69 6e 67 0a 58 61 6e 64 |rmat str|ing.Xand|
|00002d10| 20 74 68 65 20 63 6f 72 | 72 65 73 70 6f 6e 64 69 | the cor|respondi|
|00002d20| 6e 67 20 61 72 67 75 6d | 65 6e 74 20 6c 69 73 74 |ng argum|ent list|
|00002d30| 2e 0a 58 4e 6f 74 65 20 | 74 68 61 74 20 74 68 65 |..XNote |that the|
|00002d40| 20 66 6f 72 6d 61 74 20 | 73 74 72 69 6e 67 20 61 | format |string a|
|00002d50| 6e 64 20 61 72 67 75 6d | 65 6e 74 20 6c 69 73 74 |nd argum|ent list|
|00002d60| 20 61 72 65 20 61 6c 6c | 20 6f 6e 65 20 6d 61 63 | are all| one mac|
|00002d70| 72 6f 20 61 72 67 75 6d | 65 6e 74 0a 58 61 6e 64 |ro argum|ent.Xand|
|00002d80| 0a 58 2e 42 20 6d 75 73 | 74 0a 58 62 65 20 65 6e |.X.B mus|t.Xbe en|
|00002d90| 63 6c 6f 73 65 64 20 69 | 6e 20 70 61 72 65 6e 74 |closed i|n parent|
|00002da0| 68 65 73 69 73 2e 0a 58 | 2e 62 72 0a 58 2e 73 70 |hesis..X|.br.X.sp|
|00002db0| 0a 58 45 58 3a 5c 20 44 | 42 55 47 5f 50 52 49 4e |.XEX:\ D|BUG_PRIN|
|00002dc0| 54 5c 20 28 22 65 6f 66 | 22 2c 5c 20 28 22 65 6e |T\ ("eof|",\ ("en|
|00002dd0| 64 5c 20 6f 66 5c 20 66 | 69 6c 65 5c 20 66 6f 75 |d\ of\ f|ile\ fou|
|00002de0| 6e 64 22 29 29 3b 0a 58 | 2e 62 72 0a 58 45 58 3a |nd"));.X|.br.XEX:|
|00002df0| 5c 20 44 42 55 47 5f 50 | 52 49 4e 54 5c 20 28 22 |\ DBUG_P|RINT\ ("|
|00002e00| 74 79 70 65 22 2c 5c 20 | 28 22 74 79 70 65 5c 20 |type",\ |("type\ |
|00002e10| 69 73 5c 20 25 78 22 2c | 5c 20 74 79 70 65 29 29 |is\ %x",|\ type))|
|00002e20| 3b 0a 58 2e 62 72 0a 58 | 45 58 3a 5c 20 44 42 55 |;.X.br.X|EX:\ DBU|
|00002e30| 47 5f 50 52 49 4e 54 5c | 20 28 22 73 74 70 22 2c |G_PRINT\| ("stp",|
|00002e40| 5c 20 28 22 25 78 5c 20 | 5c 2d 3e 5c 20 25 73 22 |\ ("%x\ |\->\ %s"|
|00002e50| 2c 5c 20 73 74 70 2c 5c | 20 73 74 70 5c 20 5c 2d |,\ stp,\| stp\ \-|
|00002e60| 3e 5c 20 6e 61 6d 65 29 | 29 3b 0a 58 2e 54 50 20 |>\ name)|);.X.TP |
|00002e70| 31 35 0a 58 44 42 55 47 | 5f 53 45 54 4a 4d 50 0a |15.XDBUG|_SETJMP.|
|00002e80| 58 55 73 65 64 20 69 6e | 20 70 6c 61 63 65 20 6f |XUsed in| place o|
|00002e90| 66 20 74 68 65 20 73 65 | 74 6a 6d 70 28 29 20 66 |f the se|tjmp() f|
|00002ea0| 75 6e 63 74 69 6f 6e 20 | 74 6f 20 66 69 72 73 74 |unction |to first|
|00002eb0| 20 73 61 76 65 20 74 68 | 65 20 63 75 72 72 65 6e | save th|e curren|
|00002ec0| 74 0a 58 64 65 62 75 67 | 67 65 72 20 73 74 61 74 |t.Xdebug|ger stat|
|00002ed0| 65 20 61 6e 64 20 74 68 | 65 6e 20 65 78 65 63 75 |e and th|en execu|
|00002ee0| 74 65 20 74 68 65 20 73 | 74 61 6e 64 61 72 64 20 |te the s|tandard |
|00002ef0| 73 65 74 6a 6d 70 20 63 | 61 6c 6c 2e 0a 58 54 68 |setjmp c|all..XTh|
|00002f00| 69 73 20 61 6c 6c 6f 77 | 73 20 74 68 65 20 64 65 |is allow|s the de|
|00002f10| 62 75 67 67 65 72 20 74 | 6f 20 72 65 73 74 6f 72 |bugger t|o restor|
|00002f20| 65 20 69 74 73 20 73 74 | 61 74 65 20 77 68 65 6e |e its st|ate when|
|00002f30| 20 74 68 65 0a 58 44 42 | 55 47 5f 4c 4f 4e 47 4a | the.XDB|UG_LONGJ|
|00002f40| 4d 50 20 6d 61 63 72 6f | 20 69 73 20 75 73 65 64 |MP macro| is used|
|00002f50| 20 74 6f 20 69 6e 76 6f | 6b 65 20 74 68 65 20 73 | to invo|ke the s|
|00002f60| 74 61 6e 64 61 72 64 20 | 6c 6f 6e 67 6a 6d 70 28 |tandard |longjmp(|
|00002f70| 29 20 63 61 6c 6c 2e 0a | 58 43 75 72 72 65 6e 74 |) call..|XCurrent|
|00002f80| 6c 79 20 61 6c 6c 20 69 | 6e 73 74 61 6e 63 65 73 |ly all i|nstances|
|00002f90| 20 6f 66 20 44 42 55 47 | 5f 53 45 54 4a 4d 50 20 | of DBUG|_SETJMP |
|00002fa0| 6d 75 73 74 20 6f 63 63 | 75 72 20 77 69 74 68 69 |must occ|ur withi|
|00002fb0| 6e 20 74 68 65 0a 58 73 | 61 6d 65 20 66 75 6e 63 |n the.Xs|ame func|
|00002fc0| 74 69 6f 6e 20 61 6e 64 | 20 61 74 20 74 68 65 20 |tion and| at the |
|00002fd0| 73 61 6d 65 20 66 75 6e | 63 74 69 6f 6e 20 6e 65 |same fun|ction ne|
|00002fe0| 73 74 69 6e 67 20 6c 65 | 76 65 6c 2e 0a 58 2e 62 |sting le|vel..X.b|
|00002ff0| 72 0a 58 2e 73 70 0a 58 | 45 58 3a 5c 20 44 42 55 |r.X.sp.X|EX:\ DBU|
|00003000| 47 5f 53 45 54 4a 4d 50 | 5c 20 28 65 6e 76 29 3b |G_SETJMP|\ (env);|
|00003010| 0a 58 2e 54 50 20 31 35 | 0a 58 44 42 55 47 5f 4c |.X.TP 15|.XDBUG_L|
|00003020| 4f 4e 47 4a 4d 50 0a 58 | 55 73 65 64 20 69 6e 20 |ONGJMP.X|Used in |
|00003030| 70 6c 61 63 65 20 6f 66 | 20 74 68 65 20 6c 6f 6e |place of| the lon|
|00003040| 67 6a 6d 70 28 29 20 66 | 75 6e 63 74 69 6f 6e 20 |gjmp() f|unction |
|00003050| 74 6f 20 66 69 72 73 74 | 20 72 65 73 74 6f 72 65 |to first| restore|
|00003060| 20 74 68 65 0a 58 70 72 | 65 76 69 6f 75 73 20 64 | the.Xpr|evious d|
|00003070| 65 62 75 67 67 65 72 20 | 73 74 61 74 65 20 61 74 |ebugger |state at|
|00003080| 20 74 68 65 20 74 69 6d | 65 20 6f 66 20 74 68 65 | the tim|e of the|
|00003090| 20 6c 61 73 74 20 44 42 | 55 47 5f 53 45 54 4a 4d | last DB|UG_SETJM|
|000030a0| 50 0a 58 61 6e 64 20 74 | 68 65 6e 20 65 78 65 63 |P.Xand t|hen exec|
|000030b0| 75 74 65 20 74 68 65 20 | 73 74 61 6e 64 61 72 64 |ute the |standard|
|000030c0| 20 6c 6f 6e 67 6a 6d 70 | 28 29 20 63 61 6c 6c 2e | longjmp|() call.|
|000030d0| 0a 58 4e 6f 74 65 20 74 | 68 61 74 20 63 75 72 72 |.XNote t|hat curr|
|000030e0| 65 6e 74 6c 79 20 61 6c | 6c 20 44 42 55 47 5f 4c |ently al|l DBUG_L|
|000030f0| 4f 4e 47 4a 4d 50 20 6d | 61 63 72 6f 73 20 72 65 |ONGJMP m|acros re|
|00003100| 73 74 6f 72 65 20 74 68 | 65 20 73 74 61 74 65 0a |store th|e state.|
|00003110| 58 61 74 20 74 68 65 20 | 74 69 6d 65 20 6f 66 20 |Xat the |time of |
|00003120| 74 68 65 20 6c 61 73 74 | 20 44 42 55 47 5f 53 45 |the last| DBUG_SE|
|00003130| 54 4a 4d 50 2e 0a 58 49 | 74 20 77 6f 75 6c 64 20 |TJMP..XI|t would |
|00003140| 62 65 20 70 6f 73 73 69 | 62 6c 65 20 74 6f 20 6d |be possi|ble to m|
|00003150| 61 69 6e 74 61 69 6e 20 | 73 65 70 61 72 61 74 65 |aintain |separate|
|00003160| 20 44 42 55 47 5f 53 45 | 54 4a 4d 50 20 61 6e 64 | DBUG_SE|TJMP and|
|00003170| 20 44 42 55 47 5f 4c 4f | 4e 47 4a 4d 50 0a 58 70 | DBUG_LO|NGJMP.Xp|
|00003180| 61 69 72 73 20 62 79 20 | 68 61 76 69 6e 67 20 74 |airs by |having t|
|00003190| 68 65 20 64 65 62 75 67 | 67 65 72 20 72 75 6e 74 |he debug|ger runt|
|000031a0| 69 6d 65 20 73 75 70 70 | 6f 72 74 20 6d 6f 64 75 |ime supp|ort modu|
|000031b0| 6c 65 20 75 73 65 20 74 | 68 65 20 66 69 72 73 74 |le use t|he first|
|000031c0| 0a 58 61 72 67 75 6d 65 | 6e 74 20 74 6f 20 64 69 |.Xargume|nt to di|
|000031d0| 66 66 65 72 65 6e 74 69 | 61 74 65 20 74 68 65 20 |fferenti|ate the |
|000031e0| 70 61 69 72 73 2e 0a 58 | 2e 62 72 0a 58 2e 73 70 |pairs..X|.br.X.sp|
|000031f0| 0a 58 45 58 3a 5c 20 44 | 42 55 47 5f 4c 4f 4e 47 |.XEX:\ D|BUG_LONG|
|00003200| 4a 4d 50 5c 20 28 65 6e | 76 2c 76 61 6c 29 3b 0a |JMP\ (en|v,val);.|
|00003210| 58 2e 53 48 20 22 44 45 | 42 55 47 20 43 4f 4e 54 |X.SH "DE|BUG CONT|
|00003220| 52 4f 4c 20 53 54 52 49 | 4e 47 22 0a 58 54 68 65 |ROL STRI|NG".XThe|
|00003230| 20 64 65 62 75 67 20 63 | 6f 6e 74 72 6f 6c 20 73 | debug c|ontrol s|
|00003240| 74 72 69 6e 67 20 69 73 | 20 75 73 65 64 20 74 6f |tring is| used to|
|00003250| 20 63 6f 6e 74 72 6f 6c | 20 74 68 65 20 22 62 65 | control| the "be|
|00003260| 68 61 76 69 6f 75 72 22 | 20 6f 66 20 74 68 65 20 |haviour"| of the |
|00003270| 64 62 75 67 20 6d 61 63 | 72 6f 73 2c 0a 58 77 68 |dbug mac|ros,.Xwh|
|00003280| 65 6e 20 72 75 6e 6e 69 | 6e 67 20 74 68 65 20 61 |en runni|ng the a|
|00003290| 70 70 6c 69 63 61 74 69 | 6f 6e 2e 20 54 68 65 20 |pplicati|on. The |
|000032a0| 5c 66 49 64 65 62 75 67 | 20 63 6f 6e 74 72 6f 6c |\fIdebug| control|
|000032b0| 20 73 74 72 69 6e 67 5c | 66 50 20 69 73 20 70 61 | string\|fP is pa|
|000032c0| 73 73 65 64 20 74 6f 20 | 74 68 65 0a 58 5c 66 49 |ssed to |the.X\fI|
|000032d0| 64 62 75 67 5c 66 50 20 | 70 61 63 6b 61 67 65 20 |dbug\fP |package |
|000032e0| 76 69 61 20 74 68 65 20 | 5c 66 49 44 42 55 47 5f |via the |\fIDBUG_|
|000032f0| 50 55 53 48 28 29 5c 66 | 50 20 6d 61 63 72 6f 20 |PUSH()\f|P macro |
|00003300| 28 6e 6f 74 65 2c 20 74 | 68 61 74 20 74 68 65 20 |(note, t|hat the |
|00003310| 70 61 72 61 6d 65 74 65 | 72 20 6f 66 0a 58 74 68 |paramete|r of.Xth|
|00003320| 69 73 20 6d 61 63 72 6f | 20 6d 61 79 20 62 65 20 |is macro| may be |
|00003330| 74 68 65 20 76 61 6c 75 | 65 20 6f 66 20 61 20 70 |the valu|e of a p|
|00003340| 72 6f 67 72 61 6d 20 61 | 72 67 75 6d 65 6e 74 3b |rogram a|rgument;|
|00003350| 20 73 65 65 20 65 78 61 | 6d 70 6c 65 20 61 62 6f | see exa|mple abo|
|00003360| 76 65 29 2e 0a 58 2e 50 | 50 0a 58 54 68 65 20 66 |ve)..X.P|P.XThe f|
|00003370| 6f 6c 6c 6f 77 69 6e 67 | 20 6c 69 73 74 20 73 75 |ollowing| list su|
|00003380| 6d 6d 61 72 69 7a 65 73 | 20 74 68 65 20 63 75 72 |mmarizes| the cur|
|00003390| 72 65 6e 74 6c 79 20 61 | 76 61 69 6c 61 62 6c 65 |rently a|vailable|
|000033a0| 20 64 65 62 75 67 67 65 | 72 20 6f 70 74 69 6f 6e | debugge|r option|
|000033b0| 73 0a 58 61 6e 64 20 74 | 68 65 20 66 6c 61 67 20 |s.Xand t|he flag |
|000033c0| 63 68 61 72 61 63 74 65 | 72 73 20 77 68 69 63 68 |characte|rs which|
|000033d0| 20 65 6e 61 62 6c 65 20 | 6f 72 20 64 69 73 61 62 | enable |or disab|
|000033e0| 6c 65 20 74 68 65 6d 2e | 20 44 65 62 75 67 67 65 |le them.| Debugge|
|000033f0| 72 20 6f 70 74 69 6f 6e | 73 20 6d 61 79 20 62 65 |r option|s may be|
|00003400| 0a 58 63 6f 6e 63 61 74 | 65 6e 61 74 65 64 20 74 |.Xconcat|enated t|
|00003410| 6f 20 61 20 5c 66 49 64 | 65 62 75 67 20 63 6f 6e |o a \fId|ebug con|
|00003420| 74 72 6f 6c 20 73 74 72 | 69 6e 67 5c 66 50 20 75 |trol str|ing\fP u|
|00003430| 73 69 6e 67 20 74 68 65 | 20 22 3a 22 20 28 63 6f |sing the| ":" (co|
|00003440| 6c 6f 6e 29 20 61 73 20 | 61 0a 58 73 65 70 65 72 |lon) as |a.Xseper|
|00003450| 61 74 6f 72 20 28 65 2e | 67 2e 2c 20 3c 6f 70 74 |ator (e.|g., <opt|
|00003460| 69 6f 6e 31 3e 3a 3c 6f | 70 74 69 6f 6e 32 3e 3a |ion1>:<o|ption2>:|
|00003470| 2e 2e 2e 3a 3c 6f 70 74 | 69 6f 6e 4e 3e 29 2e 0a |...:<opt|ionN>)..|
|00003480| 58 2e 50 50 0a 58 41 72 | 67 75 6d 65 6e 74 20 6c |X.PP.XAr|gument l|
|00003490| 69 73 74 73 20 65 6e 63 | 6c 6f 73 65 64 20 69 6e |ists enc|losed in|
|000034a0| 20 27 5b 27 20 61 6e 64 | 20 27 5d 27 20 61 72 65 | '[' and| ']' are|
|000034b0| 20 6f 70 74 69 6f 6e 61 | 6c 2e 0a 58 2e 54 50 20 | optiona|l..X.TP |
|000034c0| 31 35 0a 58 64 5b 2c 6b | 65 79 77 6f 72 64 73 5d |15.Xd[,k|eywords]|
|000034d0| 0a 58 45 6e 61 62 6c 65 | 20 6f 75 74 70 75 74 20 |.XEnable| output |
|000034e0| 66 72 6f 6d 20 6d 61 63 | 72 6f 73 20 77 69 74 68 |from mac|ros with|
|000034f0| 20 73 70 65 63 69 66 69 | 65 64 20 6b 65 79 77 6f | specifi|ed keywo|
|00003500| 72 64 73 2e 0a 58 41 20 | 6e 75 6c 6c 20 6c 69 73 |rds..XA |null lis|
|00003510| 74 20 6f 66 20 6b 65 79 | 77 6f 72 64 73 20 69 6d |t of key|words im|
|00003520| 70 6c 69 65 73 20 74 68 | 61 74 20 61 6c 6c 20 6b |plies th|at all k|
|00003530| 65 79 77 6f 72 64 73 20 | 61 72 65 20 73 65 6c 65 |eywords |are sele|
|00003540| 63 74 65 64 2e 0a 58 2e | 54 50 20 31 35 0a 58 44 |cted..X.|TP 15.XD|
|00003550| 5b 2c 74 69 6d 65 5d 0a | 58 44 65 6c 61 79 20 66 |[,time].|XDelay f|
|00003560| 6f 72 20 73 70 65 63 69 | 66 69 65 64 20 74 69 6d |or speci|fied tim|
|00003570| 65 20 61 66 74 65 72 20 | 65 61 63 68 20 6f 75 74 |e after |each out|
|00003580| 70 75 74 20 6c 69 6e 65 | 2c 20 74 6f 20 6c 65 74 |put line|, to let|
|00003590| 20 6f 75 74 70 75 74 20 | 64 72 61 69 6e 2e 0a 58 | output |drain..X|
|000035a0| 54 69 6d 65 20 69 73 20 | 67 69 76 65 6e 20 69 6e |Time is |given in|
|000035b0| 20 74 65 6e 74 68 73 20 | 6f 66 20 61 20 73 65 63 | tenths |of a sec|
|000035c0| 6f 6e 64 20 28 76 61 6c | 75 65 20 6f 66 20 31 30 |ond (val|ue of 10|
|000035d0| 20 69 73 20 6f 6e 65 20 | 73 65 63 6f 6e 64 29 2e | is one |second).|
|000035e0| 0a 58 44 65 66 61 75 6c | 74 20 69 73 20 7a 65 72 |.XDefaul|t is zer|
|000035f0| 6f 2e 0a 58 2e 54 50 20 | 31 35 0a 58 66 5b 2c 66 |o..X.TP |15.Xf[,f|
|00003600| 75 6e 63 74 69 6f 6e 73 | 5d 0a 58 4c 69 6d 69 74 |unctions|].XLimit|
|00003610| 20 64 65 62 75 67 67 65 | 72 20 61 63 74 69 6f 6e | debugge|r action|
|00003620| 73 20 74 6f 20 74 68 65 | 20 73 70 65 63 69 66 69 |s to the| specifi|
|00003630| 65 64 20 6c 69 73 74 20 | 6f 66 20 66 75 6e 63 74 |ed list |of funct|
|00003640| 69 6f 6e 73 2e 0a 58 41 | 20 6e 75 6c 6c 20 6c 69 |ions..XA| null li|
|00003650| 73 74 20 6f 66 20 66 75 | 6e 63 74 69 6f 6e 73 20 |st of fu|nctions |
|00003660| 69 6d 70 6c 69 65 73 20 | 74 68 61 74 20 61 6c 6c |implies |that all|
|00003670| 20 66 75 6e 63 74 69 6f | 6e 73 20 61 72 65 20 73 | functio|ns are s|
|00003680| 65 6c 65 63 74 65 64 2e | 0a 58 2e 54 50 20 31 35 |elected.|.X.TP 15|
|00003690| 0a 58 46 0a 58 4d 61 72 | 6b 20 65 61 63 68 20 64 |.XF.XMar|k each d|
|000036a0| 65 62 75 67 67 65 72 20 | 6f 75 74 70 75 74 20 6c |ebugger |output l|
|000036b0| 69 6e 65 20 77 69 74 68 | 20 74 68 65 20 6e 61 6d |ine with| the nam|
|000036c0| 65 20 6f 66 20 74 68 65 | 20 73 6f 75 72 63 65 20 |e of the| source |
|000036d0| 66 69 6c 65 0a 58 63 6f | 6e 74 61 69 6e 69 6e 67 |file.Xco|ntaining|
|000036e0| 20 74 68 65 20 6d 61 63 | 72 6f 20 63 61 75 73 69 | the mac|ro causi|
|000036f0| 6e 67 20 74 68 65 20 6f | 75 74 70 75 74 2e 0a 58 |ng the o|utput..X|
|00003700| 2e 54 50 20 31 35 0a 58 | 67 0a 58 54 75 72 6e 20 |.TP 15.X|g.XTurn |
|00003710| 6f 6e 20 6d 61 63 68 69 | 6e 65 20 69 6e 64 65 70 |on machi|ne indep|
|00003720| 65 6e 64 65 6e 74 20 70 | 72 6f 66 69 6c 69 6e 67 |endent p|rofiling|
|00003730| 2e 0a 58 41 20 70 72 6f | 66 69 6c 69 6e 67 20 64 |..XA pro|filing d|
|00003740| 61 74 61 20 63 6f 6c 6c | 65 63 74 69 6f 6e 20 66 |ata coll|ection f|
|00003750| 69 6c 65 2c 20 6e 61 6d | 65 64 20 64 62 75 67 6d |ile, nam|ed dbugm|
|00003760| 6f 6e 2e 6f 75 74 2c 20 | 77 69 6c 6c 20 62 65 20 |on.out, |will be |
|00003770| 77 72 69 74 74 65 6e 0a | 58 66 6f 72 20 70 6f 73 |written.|Xfor pos|
|00003780| 74 70 72 6f 63 65 73 73 | 69 6e 67 20 62 79 20 74 |tprocess|ing by t|
|00003790| 68 65 20 22 61 6e 61 6c | 79 7a 65 28 31 4c 29 22 |he "anal|yze(1L)"|
|000037a0| 20 70 72 6f 67 72 61 6d | 2e 0a 58 54 68 65 20 61 | program|..XThe a|
|000037b0| 63 63 75 72 61 63 79 20 | 6f 66 20 74 68 69 73 20 |ccuracy |of this |
|000037c0| 66 65 61 74 75 72 65 20 | 69 73 20 72 65 6c 61 74 |feature |is relat|
|000037d0| 69 76 65 6c 79 20 75 6e | 6b 6e 6f 77 6e 20 61 74 |ively un|known at|
|000037e0| 20 74 68 69 73 20 74 69 | 6d 65 2e 0a 58 2e 54 50 | this ti|me..X.TP|
|000037f0| 20 31 35 0a 58 69 0a 58 | 49 64 65 6e 74 69 66 79 | 15.Xi.X|Identify|
|00003800| 20 74 68 65 20 70 72 6f | 63 65 73 73 20 65 6d 69 | the pro|cess emi|
|00003810| 74 74 69 6e 67 20 65 61 | 63 68 20 6c 69 6e 65 20 |tting ea|ch line |
|00003820| 6f 66 20 64 65 62 75 67 | 20 6f 72 20 74 72 61 63 |of debug| or trac|
|00003830| 65 20 6f 75 74 70 75 74 | 0a 58 77 69 74 68 20 74 |e output|.Xwith t|
|00003840| 68 65 20 70 72 6f 63 65 | 73 73 20 69 64 20 66 6f |he proce|ss id fo|
|00003850| 72 20 74 68 61 74 20 70 | 72 6f 63 65 73 73 2e 0a |r that p|rocess..|
|00003860| 58 2e 54 50 20 31 35 0a | 58 4c 0a 58 4d 61 72 6b |X.TP 15.|XL.XMark|
|00003870| 20 65 61 63 68 20 64 65 | 62 75 67 67 65 72 20 6f | each de|bugger o|
|00003880| 75 74 70 75 74 20 6c 69 | 6e 65 20 77 69 74 68 20 |utput li|ne with |
|00003890| 74 68 65 20 73 6f 75 72 | 63 65 20 66 69 6c 65 20 |the sour|ce file |
|000038a0| 6c 69 6e 65 20 6e 75 6d | 62 65 72 20 6f 66 0a 58 |line num|ber of.X|
|000038b0| 74 68 65 20 6d 61 63 72 | 6f 20 63 61 75 73 69 6e |the macr|o causin|
|000038c0| 67 20 74 68 65 20 6f 75 | 74 70 75 74 2e 0a 58 2e |g the ou|tput..X.|
|000038d0| 54 50 20 31 35 0a 58 6e | 0a 58 4d 61 72 6b 20 65 |TP 15.Xn|.XMark e|
|000038e0| 61 63 68 20 64 65 62 75 | 67 67 65 72 20 6f 75 74 |ach debu|gger out|
|000038f0| 70 75 74 20 6c 69 6e 65 | 20 77 69 74 68 20 74 68 |put line| with th|
|00003900| 65 20 63 75 72 72 65 6e | 74 20 66 75 6e 63 74 69 |e curren|t functi|
|00003910| 6f 6e 20 6e 65 73 74 69 | 6e 67 20 64 65 70 74 68 |on nesti|ng depth|
|00003920| 2e 0a 58 2e 54 50 20 31 | 35 0a 58 4e 0a 58 53 65 |..X.TP 1|5.XN.XSe|
|00003930| 71 75 65 6e 74 69 61 6c | 6c 79 20 6e 75 6d 62 65 |quential|ly numbe|
|00003940| 72 20 65 61 63 68 20 64 | 65 62 75 67 67 65 72 20 |r each d|ebugger |
|00003950| 6f 75 74 70 75 74 20 6c | 69 6e 65 20 73 74 61 72 |output l|ine star|
|00003960| 74 69 6e 67 20 61 74 20 | 31 2e 0a 58 54 68 69 73 |ting at |1..XThis|
|00003970| 20 69 73 20 75 73 65 66 | 75 6c 20 66 6f 72 20 72 | is usef|ul for r|
|00003980| 65 66 65 72 65 6e 63 65 | 20 70 75 72 70 6f 73 65 |eference| purpose|
|00003990| 73 20 77 68 65 6e 20 64 | 65 62 75 67 67 65 72 20 |s when d|ebugger |
|000039a0| 6f 75 74 70 75 74 20 69 | 73 0a 58 69 6e 74 65 72 |output i|s.Xinter|
|000039b0| 73 70 65 72 73 65 64 20 | 77 69 74 68 20 70 72 6f |spersed |with pro|
|000039c0| 67 72 61 6d 20 6f 75 74 | 70 75 74 2e 0a 58 2e 54 |gram out|put..X.T|
|000039d0| 50 20 31 35 0a 58 6f 5b | 2c 66 69 6c 65 5d 0a 58 |P 15.Xo[|,file].X|
|000039e0| 52 65 64 69 72 65 63 74 | 20 74 68 65 20 64 65 62 |Redirect| the deb|
|000039f0| 75 67 67 65 72 20 6f 75 | 74 70 75 74 20 73 74 72 |ugger ou|tput str|
|00003a00| 65 61 6d 20 74 6f 20 74 | 68 65 20 73 70 65 63 69 |eam to t|he speci|
|00003a10| 66 69 65 64 20 66 69 6c | 65 2e 0a 58 54 68 65 20 |fied fil|e..XThe |
|00003a20| 64 65 66 61 75 6c 74 20 | 6f 75 74 70 75 74 20 73 |default |output s|
|00003a30| 74 72 65 61 6d 20 69 73 | 20 73 74 64 65 72 72 2e |tream is| stderr.|
|00003a40| 0a 58 41 20 6e 75 6c 6c | 20 61 72 67 75 6d 65 6e |.XA null| argumen|
|00003a50| 74 20 6c 69 73 74 20 63 | 61 75 73 65 73 20 6f 75 |t list c|auses ou|
|00003a60| 74 70 75 74 20 74 6f 20 | 62 65 20 72 65 64 69 72 |tput to |be redir|
|00003a70| 65 63 74 65 64 20 74 6f | 20 73 74 64 6f 75 74 2e |ected to| stdout.|
|00003a80| 0a 58 2e 54 50 20 31 35 | 0a 58 70 5b 2c 70 72 6f |.X.TP 15|.Xp[,pro|
|00003a90| 63 65 73 73 65 73 5d 0a | 58 4c 69 6d 69 74 20 64 |cesses].|XLimit d|
|00003aa0| 65 62 75 67 67 65 72 20 | 61 63 74 69 6f 6e 73 20 |ebugger |actions |
|00003ab0| 74 6f 20 74 68 65 20 73 | 70 65 63 69 66 69 65 64 |to the s|pecified|
|00003ac0| 20 70 72 6f 63 65 73 73 | 65 73 2e 0a 58 41 20 6e | process|es..XA n|
|00003ad0| 75 6c 6c 20 6c 69 73 74 | 20 69 6d 70 6c 69 65 73 |ull list| implies|
|00003ae0| 20 61 6c 6c 20 70 72 6f | 63 65 73 73 65 73 2e 0a | all pro|cesses..|
|00003af0| 58 54 68 69 73 20 69 73 | 20 75 73 65 66 75 6c 20 |XThis is| useful |
|00003b00| 66 6f 72 20 70 72 6f 63 | 65 73 73 65 73 20 77 68 |for proc|esses wh|
|00003b10| 69 63 68 20 72 75 6e 20 | 63 68 69 6c 64 20 70 72 |ich run |child pr|
|00003b20| 6f 63 65 73 73 65 73 2e | 0a 58 4e 6f 74 65 20 74 |ocesses.|.XNote t|
|00003b30| 68 61 74 20 65 61 63 68 | 20 64 65 62 75 67 67 65 |hat each| debugge|
|00003b40| 72 20 6f 75 74 70 75 74 | 20 6c 69 6e 65 20 63 61 |r output| line ca|
|00003b50| 6e 20 62 65 20 6d 61 72 | 6b 65 64 20 77 69 74 68 |n be mar|ked with|
|00003b60| 20 74 68 65 20 6e 61 6d | 65 20 6f 66 0a 58 74 68 | the nam|e of.Xth|
|00003b70| 65 20 63 75 72 72 65 6e | 74 20 70 72 6f 63 65 73 |e curren|t proces|
|00003b80| 73 20 76 69 61 20 74 68 | 65 20 27 50 27 20 66 6c |s via th|e 'P' fl|
|00003b90| 61 67 2e 0a 58 54 68 65 | 20 70 72 6f 63 65 73 73 |ag..XThe| process|
|00003ba0| 20 6e 61 6d 65 20 6d 75 | 73 74 20 6d 61 74 63 68 | name mu|st match|
|00003bb0| 20 74 68 65 20 61 72 67 | 75 6d 65 6e 74 20 70 61 | the arg|ument pa|
|00003bc0| 73 73 65 64 20 74 6f 20 | 74 68 65 0a 58 2e 42 20 |ssed to |the.X.B |
|00003bd0| 44 42 55 47 5f 50 52 4f | 43 45 53 53 0a 58 6d 61 |DBUG_PRO|CESS.Xma|
|00003be0| 63 72 6f 2e 0a 58 2e 54 | 50 20 31 35 0a 58 50 0a |cro..X.T|P 15.XP.|
|00003bf0| 58 4d 61 72 6b 20 65 61 | 63 68 20 64 65 62 75 67 |XMark ea|ch debug|
|00003c00| 67 65 72 20 6f 75 74 70 | 75 74 20 6c 69 6e 65 20 |ger outp|ut line |
|00003c10| 77 69 74 68 20 74 68 65 | 20 6e 61 6d 65 20 6f 66 |with the| name of|
|00003c20| 20 74 68 65 20 63 75 72 | 72 65 6e 74 20 70 72 6f | the cur|rent pro|
|00003c30| 63 65 73 73 0a 58 66 72 | 6f 6d 20 61 72 67 76 5b |cess.Xfr|om argv[|
|00003c40| 30 5d 2e 0a 58 4d 6f 73 | 74 20 75 73 65 66 75 6c |0]..XMos|t useful|
|00003c50| 20 77 68 65 6e 20 75 73 | 65 64 20 77 69 74 68 20 | when us|ed with |
|00003c60| 61 20 70 72 6f 63 65 73 | 73 20 77 68 69 63 68 20 |a proces|s which |
|00003c70| 72 75 6e 73 20 63 68 69 | 6c 64 20 70 72 6f 63 65 |runs chi|ld proce|
|00003c80| 73 73 65 73 20 74 68 61 | 74 0a 58 61 72 65 20 61 |sses tha|t.Xare a|
|00003c90| 6c 73 6f 20 62 65 69 6e | 67 20 64 65 62 75 67 67 |lso bein|g debugg|
|00003ca0| 65 64 2e 0a 58 4e 6f 74 | 65 20 74 68 61 74 20 74 |ed..XNot|e that t|
|00003cb0| 68 65 20 70 61 72 65 6e | 74 20 70 72 6f 63 65 73 |he paren|t proces|
|00003cc0| 73 20 6d 75 73 74 20 61 | 72 72 61 6e 67 65 20 66 |s must a|rrange f|
|00003cd0| 6f 72 20 74 68 65 20 64 | 65 62 75 67 67 65 72 20 |or the d|ebugger |
|00003ce0| 63 6f 6e 74 72 6f 6c 0a | 58 73 74 72 69 6e 67 20 |control.|Xstring |
|00003cf0| 74 6f 20 62 65 20 70 61 | 73 73 65 64 20 74 6f 20 |to be pa|ssed to |
|00003d00| 74 68 65 20 63 68 69 6c | 64 20 70 72 6f 63 65 73 |the chil|d proces|
|00003d10| 73 65 73 2e 0a 58 2e 54 | 50 20 31 35 0a 58 72 0a |ses..X.T|P 15.Xr.|
|00003d20| 58 55 73 65 64 20 69 6e | 20 63 6f 6e 6a 75 6e 63 |XUsed in| conjunc|
|00003d30| 74 69 6f 6e 20 77 69 74 | 68 20 74 68 65 20 0a 58 |tion wit|h the .X|
|00003d40| 2e 42 20 44 42 55 47 5f | 50 55 53 48 20 0a 58 6d |.B DBUG_|PUSH .Xm|
|00003d50| 61 63 72 6f 20 74 6f 20 | 72 65 73 65 74 20 74 68 |acro to |reset th|
|00003d60| 65 20 63 75 72 72 65 6e | 74 0a 58 69 6e 64 65 6e |e curren|t.Xinden|
|00003d70| 74 61 74 69 6f 6e 20 6c | 65 76 65 6c 20 62 61 63 |tation l|evel bac|
|00003d80| 6b 20 74 6f 20 7a 65 72 | 6f 2e 0a 58 4d 6f 73 74 |k to zer|o..XMost|
|00003d90| 20 75 73 65 66 75 6c 20 | 77 69 74 68 20 0a 58 2e | useful |with .X.|
|00003da0| 42 20 44 42 55 47 5f 50 | 55 53 48 20 0a 58 6d 61 |B DBUG_P|USH .Xma|
|00003db0| 63 72 6f 73 20 75 73 65 | 64 20 74 6f 20 74 65 6d |cros use|d to tem|
|00003dc0| 70 6f 72 61 72 69 6c 79 | 20 61 6c 74 65 72 20 74 |porarily| alter t|
|00003dd0| 68 65 0a 58 64 65 62 75 | 67 67 65 72 20 73 74 61 |he.Xdebu|gger sta|
|00003de0| 74 65 2e 0a 58 2e 54 50 | 20 31 35 0a 58 74 5b 2c |te..X.TP| 15.Xt[,|
|00003df0| 4e 5d 0a 58 45 6e 61 62 | 6c 65 20 66 75 6e 63 74 |N].XEnab|le funct|
|00003e00| 69 6f 6e 20 63 6f 6e 74 | 72 6f 6c 20 66 6c 6f 77 |ion cont|rol flow|
|00003e10| 20 74 72 61 63 69 6e 67 | 2e 0a 58 54 68 65 20 6d | tracing|..XThe m|
|00003e20| 61 78 69 6d 75 6d 20 6e | 65 73 74 69 6e 67 20 64 |aximum n|esting d|
|00003e30| 65 70 74 68 20 69 73 20 | 73 70 65 63 69 66 69 65 |epth is |specifie|
|00003e40| 64 20 62 79 20 4e 2c 20 | 61 6e 64 20 64 65 66 61 |d by N, |and defa|
|00003e50| 75 6c 74 73 20 74 6f 0a | 58 32 30 30 2e 0a 58 2e |ults to.|X200..X.|
|00003e60| 53 48 20 55 53 41 47 45 | 0a 58 54 68 65 20 66 6f |SH USAGE|.XThe fo|
|00003e70| 6c 6c 6f 77 69 6e 67 20 | 65 78 61 6d 70 6c 65 20 |llowing |example |
|00003e80| 73 68 6f 77 73 20 61 20 | 76 65 72 79 20 73 69 6d |shows a |very sim|
|00003e90| 70 6c 65 20 75 73 65 20 | 6f 66 20 74 68 65 20 5c |ple use |of the \|
|00003ea0| 66 49 64 62 75 67 5c 66 | 50 20 66 61 63 69 6c 69 |fIdbug\f|P facili|
|00003eb0| 74 69 65 73 2e 0a 58 2e | 50 50 0a 58 46 69 72 73 |ties..X.|PP.XFirs|
|00003ec0| 74 2c 20 74 68 65 20 73 | 6f 75 72 63 65 20 63 6f |t, the s|ource co|
|00003ed0| 64 65 20 69 6e 63 6c 75 | 64 69 6e 67 20 73 6f 6d |de inclu|ding som|
|00003ee0| 65 20 5c 66 49 64 62 75 | 67 5c 66 50 20 73 74 61 |e \fIdbu|g\fP sta|
|00003ef0| 74 65 6d 65 6e 74 73 20 | 69 73 20 67 69 76 65 6e |tements |is given|
|00003f00| 3a 0a 58 2e 52 53 20 31 | 32 0a 58 2e 73 70 0a 58 |:.X.RS 1|2.X.sp.X|
|00003f10| 2e 6e 66 0a 58 23 69 6e | 63 6c 75 64 65 20 3c 73 |.nf.X#in|clude <s|
|00003f20| 74 64 69 6f 2e 68 3e 0a | 58 23 69 6e 63 6c 75 64 |tdio.h>.|X#includ|
|00003f30| 65 20 3c 64 62 75 67 2e | 68 3e 0a 58 0a 58 6d 61 |e <dbug.|h>.X.Xma|
|00003f40| 69 6e 20 28 61 72 67 63 | 2c 20 61 72 67 76 29 0a |in (argc|, argv).|
|00003f50| 58 69 6e 74 20 61 72 67 | 63 3b 0a 58 63 68 61 72 |Xint arg|c;.Xchar|
|00003f60| 20 2a 61 72 67 76 5b 5d | 3b 0a 58 7b 0a 58 20 20 | *argv[]|;.X{.X  |
|00003f70| 20 20 69 6e 74 20 69 3b | 0a 58 20 20 20 20 69 6e |  int i;|.X    in|
|00003f80| 74 20 61 74 6f 69 28 29 | 3b 0a 58 0a 58 20 20 20 |t atoi()|;.X.X   |
|00003f90| 20 44 42 55 47 5f 45 4e | 54 45 52 20 28 22 6d 61 | DBUG_EN|TER ("ma|
|00003fa0| 69 6e 22 29 3b 0a 58 20 | 20 20 20 44 42 55 47 5f |in");.X |   DBUG_|
|00003fb0| 50 52 4f 43 45 53 53 20 | 28 61 72 67 76 5b 30 5d |PROCESS |(argv[0]|
|00003fc0| 29 3b 0a 58 0a 58 20 20 | 20 20 66 6f 72 20 28 69 |);.X.X  |  for (i|
|00003fd0| 20 3d 20 31 3b 20 69 20 | 3c 20 61 72 67 63 20 26 | = 1; i |< argc &|
|00003fe0| 26 20 61 72 67 76 5b 69 | 5d 5b 30 5d 20 3d 3d 20 |& argv[i|][0] == |
|00003ff0| 27 2d 27 3b 20 69 2b 2b | 29 20 7b 0a 58 09 73 77 |'-'; i++|) {.X.sw|
|00004000| 69 74 63 68 20 28 61 72 | 67 76 5b 69 5d 5b 31 5d |itch (ar|gv[i][1]|
|00004010| 29 20 7b 0a 58 09 20 20 | 20 20 63 61 73 65 20 27 |) {.X.  |  case '|
|00004020| 23 27 3a 0a 58 09 09 44 | 42 55 47 5f 50 55 53 48 |#':.X..D|BUG_PUSH|
|00004030| 20 28 26 28 61 72 67 76 | 5b 69 5d 5b 32 5d 29 29 | (&(argv|[i][2]))|
|00004040| 3b 0a 58 09 09 62 72 65 | 61 6b 3b 0a 58 09 7d 0a |;.X..bre|ak;.X.}.|
|00004050| 58 20 20 20 20 7d 0a 58 | 0a 58 20 20 20 20 66 6f |X    }.X|.X    fo|
|00004060| 72 20 28 3b 20 69 20 3c | 20 61 72 67 63 3b 20 69 |r (; i <| argc; i|
|00004070| 2b 2b 29 20 7b 0a 58 09 | 44 42 55 47 5f 50 52 49 |++) {.X.|DBUG_PRI|
|00004080| 4e 54 20 28 22 61 72 67 | 73 22 2c 20 28 22 61 72 |NT ("arg|s", ("ar|
|00004090| 67 76 5b 25 64 5d 20 3d | 20 25 73 22 2c 20 69 2c |gv[%d] =| %s", i,|
|000040a0| 20 61 72 67 76 5b 69 5d | 29 29 3b 0a 58 09 70 72 | argv[i]|));.X.pr|
|000040b0| 69 6e 74 66 20 28 22 25 | 46 5c 5c 6e 22 2c 20 31 |intf ("%|F\\n", 1|
|000040c0| 2e 30 2f 61 74 6f 69 28 | 61 72 67 76 5b 69 5d 29 |.0/atoi(|argv[i])|
|000040d0| 29 3b 0a 58 20 20 20 20 | 7d 0a 58 0a 58 20 20 20 |);.X    |}.X.X   |
|000040e0| 20 44 42 55 47 5f 52 45 | 54 55 52 4e 20 28 30 29 | DBUG_RE|TURN (0)|
|000040f0| 3b 0a 58 7d 0a 58 2e 66 | 69 0a 58 2e 73 70 0a 58 |;.X}.X.f|i.X.sp.X|
|00004100| 2e 52 53 20 2d 31 32 0a | 58 2e 50 50 0a 58 54 68 |.RS -12.|X.PP.XTh|
|00004110| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 69 6e 76 6f |e follow|ing invo|
|00004120| 63 61 74 69 6f 6e 20 6f | 66 20 74 68 65 20 70 72 |cation o|f the pr|
|00004130| 6f 67 72 61 6d 20 22 69 | 6e 76 65 72 73 65 22 20 |ogram "i|nverse" |
|00004140| 63 6f 6d 70 69 6c 65 64 | 20 66 72 6f 6d 20 74 68 |compiled| from th|
|00004150| 65 20 73 6f 75 72 63 65 | 0a 58 61 62 6f 76 65 20 |e source|.Xabove |
|00004160| 77 6f 75 6c 64 20 63 61 | 75 73 65 20 74 68 65 20 |would ca|use the |
|00004170| 63 6f 72 72 65 73 70 6f | 6e 64 69 6e 67 20 6f 75 |correspo|nding ou|
|00004180| 74 70 75 74 73 3a 0a 58 | 2e 52 53 20 31 32 0a 58 |tputs:.X|.RS 12.X|
|00004190| 2e 73 70 0a 58 2e 6e 66 | 0a 58 24 20 69 6e 76 65 |.sp.X.nf|.X$ inve|
|000041a0| 72 73 65 5c 20 5c 20 32 | 20 34 0a 58 30 2e 35 0a |rse\ \ 2| 4.X0.5.|
|000041b0| 58 30 2e 32 35 0a 58 0a | 58 24 20 69 6e 76 65 72 |X0.25.X.|X$ inver|
|000041c0| 73 65 20 2d 23 74 5c 20 | 5c 20 32 20 34 0a 58 7c |se -#t\ |\ 2 4.X||
|000041d0| 0a 58 30 2e 35 0a 58 30 | 2e 32 35 0a 58 3c 20 6d |.X0.5.X0|.25.X< m|
|000041e0| 61 69 6e 0a 58 0a 58 69 | 6e 76 65 72 73 65 20 2d |ain.X.Xi|nverse -|
|000041f0| 23 64 3a 74 5c 20 5c 20 | 32 20 34 0a 58 7c 20 61 |#d:t\ \ |2 4.X| a|
|00004200| 72 67 73 3a 20 61 72 67 | 76 5b 32 5d 20 3d 20 32 |rgs: arg|v[2] = 2|
|00004210| 0a 58 30 2e 35 0a 58 7c | 20 61 72 67 73 3a 20 61 |.X0.5.X|| args: a|
|00004220| 72 67 76 5b 33 5d 20 3d | 20 34 0a 58 30 2e 32 35 |rgv[3] =| 4.X0.25|
|00004230| 0a 58 3c 20 6d 61 69 6e | 0a 58 2e 66 69 0a 58 2e |.X< main|.X.fi.X.|
|00004240| 73 70 0a 58 2e 52 53 20 | 2d 31 32 0a 58 2e 53 48 |sp.X.RS |-12.X.SH|
|00004250| 20 46 49 4c 45 53 0a 58 | 2f 4c 6f 63 61 6c 54 6f | FILES.X|/LocalTo|
|00004260| 6f 6c 73 2f 6c 69 62 2f | 6c 6f 63 61 6c 2f 6c 69 |ols/lib/|local/li|
|00004270| 62 64 62 75 67 2e 61 0a | 58 2f 4c 6f 63 61 6c 54 |bdbug.a.|X/LocalT|
|00004280| 6f 6f 6c 73 2f 69 6e 63 | 6c 75 64 65 2f 6c 6f 63 |ools/inc|lude/loc|
|00004290| 61 6c 2f 64 62 75 67 2e | 68 0a 58 2e 53 48 20 22 |al/dbug.|h.X.SH "|
|000042a0| 53 45 45 20 41 4c 53 4f | 22 0a 58 44 42 55 47 20 |SEE ALSO|".XDBUG |
|000042b0| 55 73 65 72 73 20 4d 61 | 6e 75 61 6c 2c 20 61 6e |Users Ma|nual, an|
|000042c0| 61 6c 79 7a 65 28 31 4c | 29 0a 58 2e 53 48 20 45 |alyze(1L|).X.SH E|
|000042d0| 4e 56 49 52 4f 4e 4d 45 | 4e 54 0a 58 6e 6f 6e 65 |NVIRONME|NT.Xnone|
|000042e0| 0a 58 2e 53 48 20 42 55 | 47 53 0a 58 54 68 65 72 |.X.SH BU|GS.XTher|
|000042f0| 65 20 73 74 69 6c 6c 20 | 61 72 65 20 73 6f 6d 65 |e still |are some|
|00004300| 2e 0a 58 2e 53 48 20 43 | 4f 50 59 52 49 47 48 54 |..X.SH C|OPYRIGHT|
|00004310| 0a 58 6e 6f 6e 65 0a 58 | 2e 53 48 20 41 55 54 48 |.Xnone.X|.SH AUTH|
|00004320| 4f 52 53 0a 58 46 72 65 | 64 20 46 69 73 68 2c 20 |ORS.XFre|d Fish, |
|00004330| 42 69 6e 61 79 61 6b 20 | 42 61 6e 65 72 6a 65 65 |Binayak |Banerjee|
|00004340| 0a 58 2e 62 72 0a 58 45 | 6e 68 61 6e 63 65 64 20 |.X.br.XE|nhanced |
|00004350| 53 6f 66 74 77 61 72 65 | 20 54 65 63 68 6e 6f 6c |Software| Technol|
|00004360| 6f 67 69 65 73 2c 20 54 | 65 6d 70 65 2c 20 41 5a |ogies, T|empe, AZ|
|00004370| 0a 58 2e 62 72 0a 58 61 | 73 75 76 61 78 21 6d 63 |.X.br.Xa|suvax!mc|
|00004380| 64 70 68 78 21 65 73 74 | 69 6e 63 21 66 6e 66 2c |dphx!est|inc!fnf,|
|00004390| 20 73 65 69 73 6d 6f 21 | 62 70 61 21 73 6a 75 76 | seismo!|bpa!sjuv|
|000043a0| 61 78 21 62 62 61 6e 65 | 72 6a 65 0a 0a 45 4e 44 |ax!bbane|rje..END|
|000043b0| 5f 4f 46 5f 46 49 4c 45 | 0a 65 63 68 6f 20 73 68 |_OF_FILE|.echo sh|
|000043c0| 61 72 3a 20 4e 45 57 4c | 49 4e 45 20 61 70 70 65 |ar: NEWL|INE appe|
|000043d0| 6e 64 65 64 20 74 6f 20 | 5c 22 27 64 62 75 67 2e |nded to |\"'dbug.|
|000043e0| 6d 61 6e 27 5c 22 0a 69 | 66 20 74 65 73 74 20 31 |man'\".i|f test 1|
|000043f0| 32 35 38 31 20 2d 6e 65 | 20 60 77 63 20 2d 63 20 |2581 -ne| `wc -c |
|00004400| 3c 27 64 62 75 67 2e 6d | 61 6e 27 60 3b 20 74 68 |<'dbug.m|an'`; th|
|00004410| 65 6e 0a 20 20 20 20 65 | 63 68 6f 20 73 68 61 72 |en.    e|cho shar|
|00004420| 3a 20 5c 22 27 64 62 75 | 67 2e 6d 61 6e 27 5c 22 |: \"'dbu|g.man'\"|
|00004430| 20 75 6e 70 61 63 6b 65 | 64 20 77 69 74 68 20 77 | unpacke|d with w|
|00004440| 72 6f 6e 67 20 73 69 7a | 65 21 0a 66 69 0a 23 20 |rong siz|e!.fi.# |
|00004450| 65 6e 64 20 6f 66 20 27 | 64 62 75 67 2e 6d 61 6e |end of '|dbug.man|
|00004460| 27 0a 66 69 0a 65 63 68 | 6f 20 73 68 61 72 3a 20 |'.fi.ech|o shar: |
|00004470| 45 6e 64 20 6f 66 20 73 | 68 65 6c 6c 20 61 72 63 |End of s|hell arc|
|00004480| 68 69 76 65 2e 0a 65 78 | 69 74 20 30 0a 0a       |hive..ex|it 0..  |
+--------+-------------------------+-------------------------+--------+--------+