old_trap.ps

来自「开放源码的编译器open watcom 1.6.0版的源代码」· PS 代码 · 共 1,127 行 · 第 1/5 页

 sd 7438 (a) sd 2500 9338 am (32-bit large model environment since the 32-bit \
flat model and all 16-bit memory models) shwd 2500 9171 am (are subsets.  The \
structure is defined as follows:) shwd 
@fs6 3350 8754 am (typedef struct {) shwd 3650 8615 am (unsigned_32    offset;)
 shwd 3650 8476 am (unsigned_16    segment;) shwd 3350 8337 am (} addr48_ptr;)
shwd 
@fs0 2500 8003 am (The) shwd 2761 () sd 
@fs6 (segment) shwd 
@fs0 3330 (field) sd 3631 (contains) sd 4141 (the) sd 4356 (segment) sd 4865 (\
of) sd 5026 (the) sd 5241 (address) sd 5704 (and) sd 5950 (the) sd 6165 () sd 
@fs6 (offset) shwd 
@fs0 6659 (field) sd 6960 (stores) sd 7329 (the) sd 2500 7836 am (offset of th\
e address.) shwd 
@fs2 1500 7502 am (bytes) shwd 
@fs0 2500 (The) sd 2775 (type) sd 3074 () sd 
@fs6 (bytes) shwd 
@fs0 3507 (is) sd 3657 (an) sd 3846 (array) sd 4191 (of) sd 4365 (unsigned_8.)
sd 5181 (The) sd 5455 (length) sd 5862 (is) sd 6012 (provided) sd 6567 (by) sd 
6764 (other) sd 7109 (means.) sd 2500 7335 am (Typically) shwd 3083 (a) sd 3192
 (field) sd 3496 (of) sd 3660 (type) sd 3948 () sd 
@fs6 (bytes) shwd 
@fs0 4370 (is) sd 4510 (the) sd 4728 (last) sd 4969 (one) sd 5218 (in) sd 5374 
(a) sd 5483 (request) sd 5933 (and) sd 6181 (the) sd 6398 (length) sd 6794 (is)
 sd 6933 (calculated) sd 2500 7168 am (from the total length of the request.)
shwd 
@fs2 1500 6834 am (string) shwd 
@fs0 2500 (The) sd 2767 (type) sd 3058 () sd 
@fs6 (string) shwd 
@fs0 3558 (is) sd 3700 (actually) sd 4192 (an) sd 4373 (array) sd 4710 (of) sd 
4876 (characters.) sd 5590 (The) sd 5856 (array) sd 6193 (is) sd 6335 (termina\
ted) sd 6982 (by) sd 7171 (a) sd 7282 (null) sd 2500 6667 am (\('\\0'\)) shwd 
2860 (character.) sd 3562 (The) sd 3842 (length) sd 4255 (is) sd 4411 (provide\
d) sd 4972 (by) sd 5175 (other) sd 5526 (means.) sd 6036 (Typically) sd 6635 (\
a) sd 6760 (field) sd 7080 (of) sd 7259 (type) sd 2500 6500 am () shwd 
@fs6 (string) shwd 
@fs0 2996 (is) sd 3135 (the) sd 3352 (last) sd 3592 (one) sd 3840 (in) sd 3995 
(a) sd 4103 (request) sd 4553 (and) sd 4800 (the) sd 5016 (length) sd 5411 (is)
 sd 5549 (calculated) sd 6161 (from) sd 6478 (the) sd 6694 (total) sd 6988 (le\
ngth) sd 7383 (of) sd 2500 6333 am (the request.) shwd 
@fs2 1500 5999 am (trap_error) shwd 
@fs0 2500 (Some) sd 2892 (trap) sd 3184 (file) sd 3445 (requests) sd 3976 (ret\
urn) sd 4384 (debuggee) sd 4993 (operating) sd 5595 (system) sd 6055 (error)
sd 6401 (codes,) sd 6836 (notably) sd 7329 (the) sd 2500 5832 am (requests)
shwd 3002 (to) sd 3155 (perform) sd 3650 (file) sd 3881 (I/O) sd 4112 (on) sd 
4296 (the) sd 4511 (remote) sd 4943 (system.) sd 5427 (These) sd 5804 (error)
sd 6121 (codes) sd 6483 (are) sd 6698 (returned) sd 7209 (as) sd 7368 (an) sd 
2500 5665 am (unsigned_32. The debugger considers the value zero to indicate n\
o error.) shwd 1500 1340 am (Introduction) shwd 7430 (2) sd 
pageobj restore
showpage
%%Page: # 8
/pageobj save def
.072 .072 scale
2 setlinecap
@fs0

@fs4 2000 9590 am (The Request Interface) shwd 
@fs3 1500 8923 am (1) shwd 
@fs2 ( Request Structure.) shwd 
@fs0 1500 8422 am (Each) shwd 1816 (request) sd 2257 (is) sd 2387 (a) sd 2486 
(composed) sd 3089 (of) sd 3243 (two) sd 3490 (sequences) sd 4093 (of) sd 4246 
(bytes) sd 4577 (provided) sd 5111 (by) sd 5287 (the) sd 5494 (debugger) sd 
6051 (called) sd 6421 (messages.) sd 7021 (The) sd 7274 (first) sd 1500 8255
am (set) shwd 1697 (contains) sd 2205 (the) sd 2418 (actual) sd 2794 (request)
sd 3240 (code) sd 3546 (and) sd 3789 (whatever) sd 4343 (parameters) sd 4997 (\
that) sd 5248 (are) sd 5460 (required) sd 5968 (by) sd 6149 (the) sd 6361 (req\
uest.) sd 6854 (The) sd 7112 (second) sd 1500 8088 am (sequence is where the r\
esult of the operation is to be stored by the trap file.) shwd 1500 7754 am (T\
he) shwd 1754 (two) sd 2001 (sequences) sd 2604 (need) sd 2905 (not) sd 3121 (\
be) sd 3290 (contiguous.) sd 3977 (The) sd 4230 (sequences) sd 4832 (are) sd 
5039 (described) sd 5611 (to) sd 5756 (the) sd 5963 (trap) sd 6217 (file) sd 
6440 (through) sd 6912 (two) sd 7158 (arrays) sd 1500 7587 am (of) shwd 1669 (\
message) sd 2193 (entry) sd 2533 (structures.) sd 3232 (This) sd 3532 (allows)
sd 3949 (the) sd 4172 (debugger) sd 4745 (to) sd 4906 (avoid) sd 5268 (unneces\
sary) sd 6002 (packing) sd 6496 (and) sd 6749 (unpacking) sd 7383 (of) sd 1500 
7420 am (messages, since mx_entry's can be set to point directly at parameter/\
result buffers.) shwd 1500 7086 am (Multiple) shwd 2056 (requests) sd 2587 (ar\
e) sd 2831 () sd 
@fs2 (not) shwd 
@fs0 3099 (allowed) sd 3615 (in) sd 3797 (a) sd 3932 (single) sd 4339 (message\
.) sd 4995 (The) sd 5285 (mx_entry's) sd 5995 (are) sd 6239 (only) sd 6561 (us\
ed) sd 6890 (to) sd 7072 (provide) sd 1500 6919 am (scatter/gather capabilitie\
s for one request at a time.) shwd 1500 6585 am (The message entry structure i\
s as follows:) shwd 
@fs6 2350 6168 am (typedef struct {) shwd 2650 6029 am (void FAR) shwd 4150 (*\
ptr;) sd 2650 5890 am (unsigned_16) shwd 4150 (len;) sd 2350 5751 am (} mx_ent\
ry;) shwd 
@fs0 1500 5417 am (The) shwd 1754 () sd 
@fs6 (ptr) shwd 
@fs0 2016 (is) sd 2146 (pointing) sd 2650 (to) sd 2796 (a) sd 2895 (block) sd 
3243 (of) sd 3397 (data) sd 3667 (for) sd 3868 (that) sd 4115 (message) sd 4624
 (entry.) sd 5023 (The) sd 5277 () sd 
@fs6 (len) shwd 
@fs0 5538 (field) sd 5831 (gives) sd 6162 (the) sd 6369 (length) sd 6755 (of)
sd 6908 (that) sd 7154 (block.) sd 1500 5250 am (One array of ) shwd 
@fs6 (mx_entry) shwd 
@fs0 ('s describes the request message. The second array describes the return \
message.) shwd 1500 4916 am (It) shwd 1629 (is) sd 1765 (not) sd 1987 (legal)
sd 2302 (to) sd 2454 (split) sd 2738 (a) sd 2842 (message) sd 3356 (into) sd 
3616 (arbitrary) sd 4141 (pieces) sd 4532 (with) sd 4823 (mx_entries.) sd 5570 
(Each) sd 5891 (request) sd 6337 (documents) sd 6984 (where) sd 7368 (an) sd 
1500 4749 am (mx_entry is allowed to start with a line of dashes.) shwd 
@fs3 1500 4248 am (2) shwd 
@fs2 ( The Interface Routines) shwd 
@fs0 1500 3747 am (The) shwd 1773 (trap) sd 2047 (file) sd 2290 (interface) sd 
2836 (must) sd 3162 (provide) sd 3645 (three) sd 3980 (routines:) sd 4565 ()
sd 
@fs6 (TrapInit) shwd 
@fs0 (,) shwd 
@fs6 5260 (TrapRequest) sd 
@fs0 (,) shwd 6180 (and) sd 6437 () sd 
@fs6 (TrapFini) shwd 
@fs0 (.) shwd 7167 (These) sd 1500 3580 am (routines) shwd 1991 (are) sd 2202 
(invoked) sd 2693 (with) sd 2981 (standard) sd 3494 (WATCOM) sd 4169 (register)
 sd 4628 (calling) sd 5048 (conventions.) sd 5806 (How) sd 6117 (the) sd 6327 
(debugger) sd 6887 (determines) sd 1500 3413 am (the address of these routines\
 after loading a trap file is system dependent and described later.) shwd 
@fs3 1500 2912 am (2.1 TrapInit) shwd 
@fs0 1500 2578 am (This function initializes the environment for proper operat\
ion of) shwd 
@fs6 5128 (TrapRequest) sd 
@fs0 (.) shwd 1500 1340 am (The Request Interface) shwd 7430 (3) sd 
pageobj restore
showpage
%%Page: # 9
/pageobj save def
.072 .072 scale
2 setlinecap
@fs0

@fs6 2350 10201 am (trap_version FAR TrapInit\( char  FAR    *parm,) shwd 4375 
10062 am (char  FAR    *error,) shwd 4375 9923 am (unsigned_8   remote) shwd 
2350 9784 am (\);) shwd 
@fs0 1500 9450 am (The) shwd 1757 () sd 
@fs6 (parm) shwd 
@fs0 2097 (is) sd 2230 (a) sd 2332 (string) sd 2691 (that) sd 2941 (the) sd 
3152 (user) sd 3425 (passes) sd 3821 (to) sd 3970 (the) sd 4181 (trap) sd 4439 
(file.) sd 4711 (Its) sd 4891 (interpretation) sd 5686 (is) sd 5819 (completel\
y) sd 6480 (up) sd 6660 (to) sd 6809 (the) sd 7020 (trap) sd 7278 (file.) sd 
1500 9283 am (In) shwd 1654 (the) sd 1862 (case) sd 2139 (of) sd 2293 (the) sd 
2501 (WATCOM) sd 3174 (debugger,) sd 3767 (all) sd 3943 (the) sd 4150 (charact\
ers) sd 4753 (following) sd 5334 (the) sd 5541 (semicolon) sd 6151 (in) sd 6296
 (the) sd 6503 (/TRAP) sd 6935 (option) sd 7329 (are) sd 1500 9116 am (passed \
as the ) shwd 
@fs6 (parm) shwd 
@fs0 (. For example:) shwd 
@fs6 2350 8699 am (wd /trap=nov;testing program) shwd 
@fs0 1500 8365 am (The) shwd 1755 () sd 
@fs6 (parm) shwd 
@fs0 2093 (would) sd 2481 (be) sd 2651 ("testing".) sd 3250 (Any) sd 3528 (err\
or) sd 3838 (message) sd 4347 (will) sd 4602 (be) sd 4771 (returned) sd 5275 (\
in) sd 5421 () sd 
@fs6 (error) shwd 
@fs0 (.) shwd 5872 (The) sd 6126 () sd 
@fs6 (remote) shwd 
@fs0 6613 (field) sd 6907 (is) sd 7037 (a) sd 7136 (zero) sd 7414 (if) sd 1500 
8198 am (the) shwd 1716 (WATCOM) sd 2397 (debugger) sd 2963 (is) sd 3101 (load\
ing) sd 3566 (the) sd 3782 (trap) sd 4045 (file) sd 4277 (and) sd 4523 (a) sd 
4629 (one) sd 4875 (if) sd 5005 (a) sd 5111 (remote) sd 5543 (server) sd 5929 
(is) sd 6066 (loading) sd 6530 (it.) sd 6741 (This) sd 7033 (function) sd 1500 
8031 am (returns a structure ) shwd 
@fs6 (trap_version) shwd 
@fs0 ( of the following form:) shwd 
@fs6 2350 7614 am (typedef struct {) shwd 2650 7475 am (unsigned_8  major;)
shwd 2650 7336 am (unsigned_8  minor;) shwd 2650 7197 am (unsigned_8  remote;)
shwd 2350 7058 am (} trap_version;) shwd 
@fs0 1500 6724 am (The) shwd 1762 () sd 
@fs6 (major) shwd 
@fs0 2182 (field) sd 2484 (contains) sd 2995 (the) sd 3211 (major) sd 3582 (ve\
rsion) sd 4039 (number) sd 4511 (of) sd 4673 (the) sd 4889 (trap) sd 5152 (fil\
e) sd 5384 (while) sd 5739 (the) sd 5954 () sd 
@fs6 (minor) shwd 
@fs0 6373 (field) sd 6674 (tells) sd 6951 (the) sd 7166 (minor) sd 1500 6557
am (version) shwd 1955 (number) sd 2425 (of) sd 2585 (the) sd 2799 (trap) sd 
3060 (file.) sd 
@fs6 3375 (Major) sd 
@fs0 3793 (is) sd 3929 (changed) sd 4438 (whenever) sd 5025 (there) sd 5348 (i\
s) sd 5484 (a) sd 5588 (modification) sd 6345 (made) sd 6689 (to) sd 6840 (the)
 sd 7053 (trap) sd 7313 (file) sd 1500 6390 am (that) shwd 1755 (is) sd 1893 (\
not) sd 2117 (upwardly) sd 2691 (compatable) sd 3380 (with) sd 3674 (previous)
sd 4201 (versions.) sd 4766 () sd 
@fs6 (Minor) shwd 
@fs0 5186 (increments) sd 5843 (by) sd 6027 (one) sd 6273 (whenever) sd 6861 (\
a) sd 6967 (change) sd 7407 (is) sd 1500 6223 am (made) shwd 1844 (to) sd 1995 
(the) sd 2208 (trap) sd 2468 (file) sd 2697 (that) sd 2949 (is) sd 3084 (upwar\
dly) sd 3655 (compatible) sd 4318 (with) sd 4609 (previous) sd 5133 (versions.)
 sd 5725 (The) sd 5984 (current) sd 6423 (major) sd 6791 (verion) sd 7191 (is)
sd 7325 (17,) sd 1500 6056 am (the) shwd 1707 (current) sd 2140 (minor) sd 2510
 (version) sd 2958 (is) sd 3087 (0.) sd 3264 (The) sd 3517 () sd 
@fs6 (remote) shwd 
@fs0 4003 (field informs the debugger whether the trap file communicates) sd 
1500 5889 am (with a remote machine.) shwd 
@fs6 1500 5555 am (TrapInit) shwd 
@fs0 2149 (must) sd 2469 (be) sd 2650 (called) sd 3033 (before) sd 3439 (using)
 sd 3790 () sd 
@fs6 (TrapRequest) shwd 
@fs0 4663 (to) sd 4820 (send) sd 5124 (a) sd 5234 (request.) sd 5782 (Failure)
sd 6227 (to) sd 6384 (do) sd 6572 (so) sd 6744 (may) sd 7032 (result) sd 7391 
(in) sd 1500 5388 am (unpredictable operation of ) shwd 
@fs6 (TrapRequest) shwd 
@fs0 (.) shwd 
@fs3 1500 4887 am (2.2 TrapRequest) shwd 
@fs0 1500 4553 am (All requests between the server and the remote trap file ar\
e handled by TrapRequest.) shwd 
@fs6 2350 4136 am (unsigned TrapRequest\( unsigned num_in_mx,) shwd 4000 3997
am (mx_entry *mx_in,) shwd 4000 3858 am (unsigned num_out_mx,) shwd 4000 3719
am (mx_entry *mx_out) shwd 2350 3580 am (\);) shwd 
@fs0 1500 3246 am (The) shwd 1779 () sd 
@fs6 (mx_in) shwd 
@fs0 2216 (points) sd 2620 (to) sd 2791 (an) sd 2985 (array) sd 3335 (of) sd 
3514 (request) sd 3980 (mx_entry's.) sd 4803 (The) sd 5082 () sd 
@fs6 (num_in_mx) shwd 
@fs0 5818 (field) sd 6136 (contains) sd 6663 (the) sd 6895 (number) sd 7383 (o\
f) sd 1500 3079 am (elements) shwd 2041 (of) sd 2203 (the) sd 2419 (array.) sd 
2806 (Similarly,) sd 3409 (the) sd 3625 () sd 
@fs6 (mx_out) shwd 
@fs0 4120 (will) sd 4383 (point) sd 4715 (to) sd 4868 (an) sd 5044 (array) sd 
5376 (of) sd 5537 (return) sd 5916 (mx_entry's.) sd 6651 (The) sd 6912 (number)
 sd 7383 (of) sd 1500 2912 am (elements) shwd 2036 (will) sd 2294 (be) sd 2466 
(given) sd 2817 (by) sd 2997 (the) sd 3208 () sd 
@fs6 (num_out_mx) shwd 
@fs0 3998 (field.) sd 4339 (The) sd 4596 (total) sd 4885 (number) sd 5352 (of)
sd 5508 (bytes) sd 5842 (actually) sd 6324 (filled) sd 6659 (in) sd 6807 (to)
sd 6955 (the) sd 7165 (return) sd 1500 2745 am (message) shwd 2033 (by) sd 2234
 (the) sd 2466 (trap) sd 2745 (file) sd 2992 (is) sd 3145 (returned) sd 3672 (\
by) sd 3872 (the) sd 4103 (function) sd 4630 (\(this) sd 4939 (may) sd 5239 (b\