nhyatt/putty-source
1
0
Fork 0
mirror of https://git.tartarus.org/simon/putty.git synced 2025-05-19 10:55:35 -05:00
Code Issues Projects Releases Wiki Activity

udp: Coroutines are used in more than just SSH.

Browse Source
This commit is contained in:
Jacob Nevins 2022-01-11 23:10:45 +00:00
parent 39d1515ea6
commit c78226a711
1 changed files with 5 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/udp.but
View File

@ -333,12 +333,11 @@ on a 640\u00D7{x}480 display. If you're adding controls to either of
these boxes and you find yourself wanting to increase the size of these boxes and you find yourself wanting to increase the size of
the whole box, \e{don't}. Split it into more panels instead. the whole box, \e{don't}. Split it into more panels instead.
\H{udp-ssh-coroutines} Coroutines in the SSH code \H{udp-ssh-coroutines} Coroutines in protocol code
Large parts of the code in the various SSH modules (in fact most of Large parts of the code in modules implementing wire protocols
the protocol layers) are structured using a set of macros that (mainly SSH) are structured using a set of macros that implement
implement (something close to) Donald Knuth's \q{coroutines} concept (something close to) Donald Knuth's \q{coroutines} concept in C.
in C.
Essentially, the purpose of these macros are to arrange that a Essentially, the purpose of these macros are to arrange that a
function can call \cw{crReturn()} to return to its caller, and the function can call \cw{crReturn()} to return to its caller, and the
@ -349,7 +348,7 @@ This means that any local (automatic) variables declared in such a
function will be corrupted every time you call \cw{crReturn}. If you function will be corrupted every time you call \cw{crReturn}. If you
need a variable to persist for longer than that, you \e{must} make it need a variable to persist for longer than that, you \e{must} make it
a field in some appropriate structure containing the persistent state a field in some appropriate structure containing the persistent state
of the coroutine \dash typically the main state structure for an SSH of the coroutine \dash typically the main state structure for a
protocol layer. protocol layer.
See See