old_trap.ps

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

e) sd 5431 (less) sd 5700 (than) sd 6001 (the) sd 6232 (total) sd 6541 (number)
 sd 7028 (of) sd 7205 (bytes) sd 1500 2578 am (described by the ) shwd 
@fs6 (mx_out) shwd 
@fs0 ( array\).) shwd 1500 2244 am (Since) shwd 1856 (every) sd 2212 (request)
sd 2661 (must) sd 2977 (start) sd 3263 (with) sd 3557 (an) sd 3734 () sd 
@fs6 (access_req) shwd 
@fs0 4529 (field,) sd 4868 (the) sd 5083 (minimum) sd 5669 (size) sd 5930 (of)
sd 6091 (a) sd 6197 (request) sd 6645 (message) sd 7161 (is) sd 7298 (one) sd 
1500 2077 am (byte.) shwd 1500 1340 am (The Request Interface) shwd 7430 (4)
sd 
pageobj restore
showpage
%%Page: # 10
/pageobj save def
.072 .072 scale
2 setlinecap
@fs0
1500 10173 am (Some) shwd 1857 (requests) sd 2354 (do) sd 2533 (not) sd 2751 (\
require) sd 3186 (a) sd 3286 (return) sd 3659 (message.) sd 4210 (In) sd 4365 
(this) sd 4605 (case,) sd 4918 (the) sd 5127 (program) sd 5639 (invoking) sd 
6175 (TrapRequest) sd 6927 () sd 
@fs2 (must) shwd 
@fs0 7260 (pass) sd 1500 10006 am (zero for ) shwd 
@fs6 (num_out_mx) shwd 
@fs0 ( and NULL for) shwd 
@fs6 3603 (mx_out) sd 
@fs0 (.) shwd 
@fs3 1500 9505 am (2.2.1 Request Example) shwd 
@fs0 1500 9004 am (The) shwd 1753 (request) sd 2193 (REQ_READ_MEM) sd 3361 (ne\
eds) sd 3715 (the) sd 3922 (memory) sd 4423 (address and length of memory to r\
ead as input and will) sd 1500 8837 am (return) shwd 1872 (the) sd 2080 (memor\
y) sd 2582 (block) sd 2930 (in) sd 3076 (the) sd 3284 (output) sd 3679 (messag\
e.) sd 4227 (To) sd 4419 (read) sd 4697 (30) sd 4873 (bytes) sd 5204 (of) sd 
5357 (memory) sd 5858 (from) sd 6166 (address) sd 6621 (0x0010:0x8000) sd 1500 
8670 am (into a buffer, we can write:) shwd 
@fs6 2350 8253 am (mx_entry        in[1];) shwd 2350 8114 am (mx_entry        \
out[1];) shwd 2350 7975 am (unsigned char   buffer[30];) shwd 2350 7836 am (st\
ruct in_msg_def {) shwd 2650 7697 am (access_req) shwd 4150 (req;) sd 2650 7558
 am (addr48_ptr) shwd 4150 (addr;) sd 2650 7419 am (unsigned_16 ) shwd 3599 (l\
en;) sd 2350 7280 am (} in_msg = { REQ_READ_MEM, { 0x8000, 0x0010 }, sizeof\( \
buffer \) };) shwd 2350 6975 am (unsigned_16     mem_blk_len;) shwd 2350 6670
am (in[0].ptr = &in_msg;) shwd 2350 6531 am (in[0].len = sizeof\( in_msg \);)
shwd 2350 6392 am (out[0].ptr = &buffer;) shwd 2350 6253 am (out[0].len = size\
of\( buffer \);) shwd 2350 5948 am (mem_blk_len = TrapRequest\( 1, in, 2, out \
\);) shwd 2350 5643 am (if\( mem_blk_length != sizeof\( buffer \) \) {) shwd 
2650 5504 am (printf\( "Error in reading memory\\n" \);) shwd 2350 5365 am (} \
else {) shwd 2650 5226 am (printf\( "OK\\n" \);) shwd 2350 5087 am (}) shwd 
@fs0 1500 4753 am (The) shwd 1753 (program) sd 2263 (will) sd 2517 (print) sd 
2818 ("OK") sd 3170 (if) sd 3292 (it) sd 3406 (has) sd 3628 (transferred) sd 
4271 (30) sd 4447 (bytes) sd 4778 (of) sd 4931 (data) sd 5200 (from) sd 5508 (\
the debuggee's address space to the) sd 1500 4586 am () shwd 
@fs6 (buffer) shwd 
@fs0 ( variable. If less than 30 bytes is transfered, an error message is prin\
ted out.) shwd 
@fs3 1500 4085 am (2.3 TrapFini) shwd 
@fs0 1500 3751 am (The) shwd 1756 (function) sd 2262 (terminates) sd 2883 (the)
 sd 3093 (link) sd 3350 (between) sd 3855 (the) sd 4064 (debugger) sd 4623 (an\
d) sd 4863 (the) sd 5072 (trap) sd 5328 (file.) sd 5630 (It) sd 5754 (should)
sd 6165 (be) sd 6335 (called) sd 6707 (after) sd 7002 (finishing) sd 1500 3584
am (all access requests.) shwd 
@fs6 2350 3167 am (void FAR TrapFini\(void\);) shwd 
@fs0 1500 2833 am (After calling ) shwd 
@fs6 (TrapFini) shwd 
@fs0 (, it is illegal to call ) shwd 
@fs6 (TrapRequest) shwd 
@fs0 ( without calling ) shwd 
@fs6 (TrapInit) shwd 
@fs0 ( again.) shwd 1500 1340 am (The Request Interface) shwd 7430 (5) sd 
pageobj restore
showpage
%%Page: # 11
/pageobj save def
.072 .072 scale
2 setlinecap
@fs0

@fs4 2000 9590 am (The Requests) shwd 
@fs0 1500 8923 am (This) shwd 1797 (section) sd 2242 (descibes) sd 2764 (the)
sd 2984 (individual) sd 3601 (requests,) sd 4146 (their) sd 4452 (parameters,)
sd 5151 (and) sd 5401 (their) sd 5706 (return) sd 6089 (values.) sd 6556 (A)
sd 6705 (line) sd 6963 (of) sd 7128 (dashes) sd 1500 8756 am (indicates) shwd 
2083 (where) sd 2511 (an) sd 2729 (mx_entry) sd 3351 (is) sd 3530 (allowed) sd 
4059 (\(but) sd 4370 (not) sd 4634 (required\)) sd 5233 (to) sd 5427 (start.)
sd 5924 (The) sd 6226 (debugger) sd 6832 (allows) sd 7282 (\(via) sd 1500 8589
am (REQ_GET_SUPPLEMENTARY_SERVICE/REQ_PERFORM_SUPPLEMENTARY_SERVICE\)) shwd 
1500 8422 am (optional components to be implemented only on specific systems.)
shwd 1500 8088 am (The) shwd 1791 (numeric) sd 2323 (value) sd 2700 (of) sd 
2891 (the) sd 3136 (request) sd 3614 (which) sd 4030 (is) sd 4197 (placed) sd 
4636 (in) sd 4819 (the) sd 5064 () sd 
@fs6 (req) shwd 
@fs0 5363 (field) sd 5694 (follows) sd 6187 (the) sd 6431 (symbolic) sd 7016 (\
name) sd 7391 (in) sd 1500 7921 am (parentheses.) shwd 
@fs3 1500 7420 am (1) shwd 
@fs2 ( Core Requests) shwd 
@fs0 1500 6919 am (These) shwd 1872 (requests) sd 2369 (need) sd 2672 (to) sd 
2820 (be) sd 2991 (implemented) sd 3759 (in) sd 3907 (all) sd 4086 (versions)
sd 4590 (of) sd 4745 (the) sd 4954 (trap) sd 5210 (file,) sd 5471 (although)
sd 5999 (some) sd 6331 (of) sd 6486 (them) sd 6803 (may) sd 7081 (only) sd 7368
 (be) sd 1500 6752 am (stub implementations in some environments.) shwd 
@fs3 1500 6251 am (1.1 REQ_CONNECT \(0\)) shwd 
@fs0 1500 5917 am (Request to connect to the remote machine. This must be the \
first request made.) shwd 1500 5583 am (Request message:) shwd 
@fs6 2350 5166 am (access_req      req) shwd 2350 5027 am (unsigned_8      maj\
or;   <-+- struct trap_version) shwd 2350 4888 am (unsigned_8      minor;     \
|) shwd 2350 4749 am (unsigned_8      remote;  <-+) shwd 
@fs0 1500 4415 am (The) shwd 1756 () sd 
@fs6 (req) shwd 
@fs0 2020 (field) sd 2316 (contains) sd 2821 (the) sd 3031 (request.) sd 3551 
(The) sd 3807 () sd 
@fs6 (trap_version) shwd 
@fs0 4746 (structure) sd 5275 (tells) sd 5546 (the) sd 5755 (version) sd 6205 
(of) sd 6360 (the) sd 6569 (program) sd 7081 (making) sd 1500 4248 am (the)
shwd 1710 (request.) sd 2195 (The) sd 2451 () sd 
@fs6 (major) shwd 
@fs0 2865 (field) sd 3161 (contains) sd 3666 (the) sd 3876 (major) sd 4241 (ve\
rsion) sd 4691 (number) sd 5156 (of) sd 5311 (the) sd 5520 (trap) sd 5776 (fil\
e) sd 6001 (while) sd 6350 (the) sd 6559 () sd 
@fs6 (minor) shwd 
@fs0 6972 (field) sd 7267 (tells) sd 1500 4081 am (the) shwd 1709 (minor) sd 
2081 (version) sd 2530 (number) sd 2994 (of) sd 3148 (the) sd 3356 (trap) sd 
3611 (file.) sd 3874 (The) sd 4128 () sd 
@fs6 (major) shwd 
@fs0 4540 (is) sd 4670 (changed) sd 5173 (whenever) sd 5754 (there) sd 6071 (i\
s) sd 6201 (a) sd 6300 (modification) sd 7052 (made) sd 7391 (to) sd 1500 3914
am (the) shwd 1734 (trap) sd 2015 (file) sd 2265 (that) sd 2538 (is) sd 2694 (\
not) sd 2935 (upwardly) sd 3526 (compatable) sd 4232 (with) sd 4543 (previous)
sd 5087 (versions.) sd 5705 (The) sd 5984 () sd 
@fs6 (minor) shwd 
@fs0 6421 (increments) sd 7096 (by) sd 7298 (one) sd 1500 3747 am (whenever)
shwd 2080 (a change is made to the trap file that is upwardly compatable with \
previous versions. The current) sd 1500 3580 am (major) shwd 1880 (version) sd 
2346 (is) sd 2493 (17,) sd 2726 (the) sd 2951 (current) sd 3401 (minor) sd 3788
 (version) sd 4253 (is) sd 4399 (0.) sd 4628 (The) sd 4898 () sd 
@fs6 (remote) shwd 
@fs0 5401 (field) sd 5711 (informs) sd 6199 (the) sd 6423 (trap) sd 6694 (file)
 sd 6934 (whether) sd 7438 (a) sd 1500 3413 am (remote server is between the W\
ATCOM debugger and the trap file.) shwd 1500 3079 am (Return message:) shwd 
@fs6 2350 2662 am (unsigned_16     max_msg_size) shwd 2350 2523 am (----------\
------------------) shwd 2350 2384 am (string) shwd 3550 (err_msg) sd 
@fs0 1500 2050 am (If) shwd 1660 (error) sd 1999 (has) sd 2251 (occurred,) sd 
2849 (the) sd 3086 () sd 
@fs6 (err_msg) shwd 
@fs0 3676 (field) sd 3998 (will) sd 4281 (returns) sd 4735 (the) sd 4971 (erro\
r) sd 5309 (message) sd 5846 (string.) sd 6325 (If) sd 6484 (there) sd 6829 (i\
s) sd 6987 (no) sd 7192 (error,) sd 1500 1883 am () shwd 
@fs6 (error_msg) shwd 
@fs0 2217 (returns) sd 2648 (a) sd 2752 (null) sd 3012 (character) sd 3567 (an\
d) sd 3811 (the) sd 4024 (field) sd 
@fs6 4323 (max_msg_size) sd 
@fs0 5265 (will) sd 5525 (contain) sd 5979 (the) sd 6192 (allowed) sd 6677 (ma\
ximum) sd 7283 (size) sd 1500 1340 am (The Requests) shwd 7430 (6) sd 
pageobj restore
showpage
%%Page: # 12
/pageobj save def
.072 .072 scale
2 setlinecap
@fs0
1500 10173 am (of) shwd 1654 (a) sd 1753 (message) sd 2262 (in) sd 2408 (bytes\
.) sd 2778 (Any) sd 3056 (message) sd 3565 (\(typically) sd 4138 (reading/writ\
ing) sd 5038 (memory) sd 5539 (or) sd 5692 (files\)) sd 6016 (which) sd 6394 (\
would) sd 6780 (require) sd 7213 (more) sd 1500 10006 am (than) shwd 1784 (the)
 sd 1998 (maximum) sd 2606 (number) sd 3076 (of) sd 3236 (bytes) sd 3574 (to)
sd 3725 (transmit) sd 4225 (or) sd 4384 (receive) sd 4830 (must) sd 5143 (be)
sd 5317 (broken) sd 5748 (up) sd 5930 (into) sd 6190 (multiple) sd 6698 (reque\
sts.) sd 7283 (The) sd 1500 9839 am (minimum acceptable value for this field i\
s 256.) shwd 
@fs3 1500 9338 am (1.2 REQ_DISCONNECT \(1\)) shwd 
@fs0 1500 9004 am (Request) shwd 2047 (to) sd 2253 (terminate) sd 2877 (the)
sd 3144 (link) sd 3458 (between) sd 4020 (the) sd 4287 (local) sd 4655 (and)
sd 4953 (remote) sd 5437 (machine.) sd 6198 (After) sd 6590 (this) sd 6888 (re\
quest,) sd 7438 (a) sd 1500 8837 am (REQ_CONNECT must be the next one made.)
shwd 1500 8503 am (Request message:) shwd 
@fs6 2350 8086 am (access_req      req) shwd 
@fs0 1500 7752 am (The ) shwd 
@fs6 (req) shwd 
@fs0 ( field contains the request.) shwd 1500 7418 am (Return message:) shwd 
@fs6 2350 7001 am (NONE) shwd 
@fs3 1500 6500 am (1.3 REQ_SUSPEND \(2\)) shwd 
@fs0 1500 6166 am (Request) shwd 1988 (to) sd 2135 (suspend) sd 2623 (the) sd 
2832 (link) sd 3088 (between) sd 3592 (the) sd 3801 (server) sd 4181 (and) sd 
4420 (the) sd 4628 (remote) sd 5053 (trap) sd 5308 (file.) sd 5607 (The) sd 
5861 (debugger) sd 6419 (issues) sd 6789 (this) sd 7028 (message) sd 1500 5999
am (just) shwd 1755 (before) sd 2166 (it) sd 2297 (spawns) sd 2760 (a) sd 2874 
(sub-shell) sd 3431 (\(the) sd 3701 ("system") sd 4254 (command\).) sd 4972 (T\
his) sd 5272 (allows) sd 5689 (a) sd 5803 (remote) sd 6243 (server) sd 6637 (t\
o) sd 6798 (enter) sd 7130 (a) sd 7244 (state) sd 1500 5832 am (where) shwd 
1879 (it) sd 1994 (allows) sd 2396 (other) sd 2721 (trap) sd 2976 (files) sd 
3254 (to) sd 3400 (connect) sd 3872 (to) sd 4018 (it) sd 4133 (\(normally,) sd 
4756 (once) sd 5056 (a) sd 5154 (remote) sd 5578 (server) sd 5956 (has) sd 6178
 (connected) sd 6781 (to) sd 6926 (a) sd 7024 (trap) sd 7278 (file,) sd 1500 
5665 am (the) shwd 1726 (remote) sd 2169 (link) sd 2442 (will) sd 2715 (fail)
sd 2957 (any) sd 3214 (other) sd 3557 (attempts) sd 4085 (to) sd 4249 (connect)
 sd 4739 (to) sd 4903 (it\).) sd 5157 (This) sd 5459 (allows) sd 5878 (the) sd 
6103 (user) sd 6390 (to) sd 6553 (start) sd 6848 (up) sd 7042 (an) sd 7228 (RF\
X) sd 1500 5498 am (process and transfer any missing files to the remote machi\
ne before continuing the debugging process.) shwd 1500 5164 am (Request messag\
e:) shwd 
@fs6 2350 4747 am (access_req      req) shwd 
@fs0 1500 4413 am (The ) shwd 
@fs6 (req) shwd 
@fs0 ( field contains the request.) shwd 1500 4079 am (Return message:) shwd 
@fs6 2350 3662 am (NONE) shwd 
@fs3 1500 3161 am (1.4 REQ_RESUME \(3\)) shwd 
@fs0 1500 2827 am (Request) shwd 1994 (to) sd 2147 (resume) sd 2594 (the) sd 
2809 (link) sd 3071 (between) sd 3581 (the) sd 3796 (server) sd 4182 (and) sd 
4428 (the) sd 4642 (remote) sd 5073 (trap) sd 5334 (file.) sd 5651 (The) sd 
5911 (debugger) sd 6475 (issues) sd 6851 (this) sd 7096 (request) sd 1500 2660
am (when the spawned sub-shell exits.) shwd 1500 2326 am (Request message:)
shwd 
@fs6 2350 1909 am (access_req      req) shwd 
@fs0 1500 1340 am (The Requests) shwd 7430 (7) sd 
pageobj restore
showpage
%%Page: # 13
/pageobj save def
.072 .072 scale
2 setlinecap
@fs0
1500 10173 am (The ) shwd 
@fs6 (req) shwd 
@fs0 ( field contains the request.) shwd 1500 9839 am (Return message:) shwd 
@fs6 2350 9422 am (NONE) shwd 
@fs3 1500 8921 am (1.5 REQ_GET_SUPPLEMENTARY_SERVICE \(4\)) shwd 
@fs0 1500 8587 am (Request to obtain a supplementary service id.) shwd 1500 
8253 am (Request message:) shwd