xref: /freebsd/crypto/heimdal/appl/telnet/telnet.state (revision cc68614da8232d8baaca0ae0d0dd8f890f06623e)
1
2   Three pieces of state need to be kept for each side of each option.
3   (You need the localside, sending WILL/WONT & receiving DO/DONT, and
4   the remoteside, sending DO/DONT and receiving WILL/WONT)
5
6	MY_STATE:	What state am I in?
7	WANT_STATE:	What state do I want?
8	WANT_RESP:	How many requests have I initiated?
9
10   Default values:
11	MY_STATE = WANT_STATE = DONT
12	WANT_RESP = 0
13
14   The local setup will change based on the state of the Telnet
15   variables.  When we are the originator, we can either make the
16   local setup changes at option request time (in which case if
17   the option is denied we need to change things back) or when
18   the option is acknowledged.
19
20   To initiate a switch to NEW_STATE:
21
22	if ((WANT_RESP == 0 && NEW_STATE == MY_STATE) ||
23			WANT_STATE == NEW_STATE) {
24	    do nothing;
25	} else {
26	    /*
27	     * This is where the logic goes to change the local setup
28	     * if we are doing so at request initiation
29	     */
30	    WANT_STATE = NEW_STATE;
31	    send NEW_STATE;
32	    WANT_RESP += 1;
33	}
34
35   When receiving NEW_STATE:
36
37	if (WANT_RESP) {
38	    --WANT_RESP;
39	    if (WANT_RESP && (NEW_STATE == MY_STATE))
40		--WANT_RESP;
41	}
42	if (WANT_RESP == 0) {
43	    if (NEW_STATE != WANT_STATE) {
44		/*
45		 * This is where the logic goes to decide if it is ok
46		 * to switch to NEW_STATE, and if so, do any necessary
47		 * local setup changes.
48		 */
49		if (ok_to_switch_to NEW_STATE)
50		    WANT_STATE = NEW_STATE;
51		else
52		    WANT_RESP++;
53*		if (MY_STATE != WANT_STATE)
54		    reply with WANT_STATE;
55	    } else {
56		/*
57		 * This is where the logic goes to change the local setup
58		 * if we are doing so at request acknowledgment
59		 */
60	    }
61	}
62	MY_STATE = NEW_STATE;
63
64* This if() line is not needed, it should be ok to always do the
65  "reply with WANT_STATE".  With the if() line, asking to turn on
66  an option that the other side doesn't understand is:
67		Send DO option
68		Recv WONT option
69  Without the if() line, it is:
70		Send DO option
71		Recv WONT option
72		Send DONT option
73  If the other side does not expect to receive the latter case,
74  but generates the latter case, then there is a potential for
75  option negotiation loops.  An implementation that does not expect
76  to get the second case should not generate it, an implementation
77  that does expect to get it may or may not generate it, and things
78  will still work.  Being conservative in what we send, we have the
79  if() statement in, but we expect the other side to generate the
80  last response.
81