Mercurial > 510ConnectbotMonitor
annotate xml/510connectbotmonitor.in @ 21:665324c9716e
enable some debug logging
| author | Carl Byington <carl@five-ten-sg.com> |
|---|---|
| date | Tue, 08 Jul 2014 09:25:54 -0700 |
| parents | a94ca5a89fe8 |
| children | 2586a4f5c8c3 |
| rev | line source |
|---|---|
| 1 | 1 <reference> |
| 2 <title>@PACKAGE@ - Version @VERSION@</title> | |
| 3 <partintro> | |
| 4 <title>Packages</title> | |
| 5 | |
| 6 <para>The various source and binary packages are available at <ulink | |
| 7 url="http://www.five-ten-sg.com/@PACKAGE@/packages/">http://www.five-ten-sg.com/@PACKAGE@/packages/</ulink>. | |
| 8 The most recent documentation is available at <ulink | |
| 9 url="http://www.five-ten-sg.com/@PACKAGE@/">http://www.five-ten-sg.com/@PACKAGE@/</ulink>. | |
| 10 </para> | |
| 11 | |
| 12 <para>A <ulink | |
| 13 url="http://www.selenic.com/mercurial/wiki/">Mercurial</ulink> source | |
| 14 code repository for this project is available at <ulink | |
| 15 url="http://hg.five-ten-sg.com/@PACKAGE@/">http://hg.five-ten-sg.com/@PACKAGE@/</ulink>. | |
| 16 </para> | |
| 17 | |
| 18 </partintro> | |
| 19 | |
| 20 <refentry id="x@PACKAGE@.1"> | |
| 21 <refentryinfo> | |
|
16
a481d8fb5571
add switch session command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
13
diff
changeset
|
22 <date>2014-07-01</date> |
| 1 | 23 <author> |
| 24 <firstname>Carl</firstname> | |
| 25 <surname>Byington</surname> | |
| 26 <affiliation><orgname>510 Software Group</orgname></affiliation> | |
| 27 </author> | |
| 28 </refentryinfo> | |
| 29 | |
| 30 <refmeta> | |
| 31 <refentrytitle>@PACKAGE@</refentrytitle> | |
| 32 <manvolnum>1</manvolnum> | |
| 33 <refmiscinfo>@PACKAGE@ @VERSION@</refmiscinfo> | |
| 34 </refmeta> | |
| 35 | |
| 36 <refnamediv id='name.1'> | |
| 37 <refname>@PACKAGE@</refname> | |
| 38 <refpurpose>a monitoring package for the android terminal emulator</refpurpose> | |
| 39 </refnamediv> | |
| 40 | |
| 41 <refsect1 id='build.1'> | |
| 42 <title>Build method</title> | |
| 43 <para> | |
| 44 This is an android project with no native code, so | |
| 45 "android update project -p . -t android-16; ant debug" | |
| 46 should build cleanly. | |
| 47 </para> | |
| 48 </refsect1> | |
| 49 | |
| 50 <refsect1 id='introduction.1'> | |
| 51 <title>Introduction</title> | |
| 52 <para> | |
| 53 This is a stub monitoring application for the related | |
| 54 510 Connectbot android terminal emulator package. | |
| 55 </para> | |
| 56 </refsect1> | |
| 57 | |
| 58 <refsect1 id='monitor.1'> | |
| 59 <title>Terminal Monitor</title> | |
| 60 <para> | |
| 2 | 61 For every terminal session (local, telnet, ssh or tn5250), the |
| 1 | 62 terminal emulator also makes a connection to a terminal monitor |
| 2 | 63 process, which can see cursor movement and screen contents, and can |
| 1 | 64 inject characters to send to the host. |
| 65 </para> | |
| 66 | |
| 67 <para> | |
| 68 The terminal monitor is invoked by calling an android Intent | |
| 69 named "com.five_ten_sg.connectbot.monitor.MonitorService". That | |
| 70 ensures that the monitor process is running, and should then | |
| 71 be listening on TCP port 6000 for incoming connections. The terminal | |
| 72 emulator then connects to the terminal monitor on port 6000. | |
| 73 The native android Intent and Service communication mechanisms | |
| 74 are not used. | |
| 75 </para> | |
| 76 | |
| 77 <para> | |
| 78 The messages exchanged between the terminal emulator and the | |
| 79 terminal monitor are arrays of uint16 values in network byte | |
| 80 order. Each message starts with a uint16 message byte length, | |
| 81 followed by that many bytes of data. Note that the message length | |
| 82 will always be even. The next uint16 contains the message | |
| 83 command value, and the remaining uint16 values are the arguments | |
| 84 if any for that command. | |
| 85 </para> | |
| 86 | |
| 87 <para> | |
| 88 Any arguments that are keystrokes or characters are represented | |
| 89 as 16 bit unicode. Note that the first 256 such characters are | |
| 90 identical to the ISO-8859-1 latin character set. | |
| 91 </para> | |
| 92 | |
| 93 <para> | |
| 94 INIT = 0 (TE -> Monitor). The argument is a string of uint16 | |
| 95 characters. The meaning of these characters is defined by the | |
| 96 monitor. It might be a fully qualified path name, or some other | |
| 97 data used by the monitor to drive the monitoring of this | |
| 98 connection. | |
| 99 </para> | |
| 100 | |
| 101 <para> | |
| 102 ACTIVATE = 1 (TE -> Monitor). The first argument is the | |
| 103 number of lines. The second argument is the number of columns. | |
| 104 That is followed by lines*columns uint16 character codes. | |
| 105 This connection is now the active connection. It is the | |
| 106 topmost (or only) window visible to the user - typed keystrokes | |
| 107 will be sent to the host on the other end of this connection. | |
| 108 </para> | |
| 109 | |
| 110 <para> | |
| 2 | 111 KEYSTATE = 2 (TE -> Monitor). The argument is a single uint16 |
| 112 value, 1 for key down, 0 for key up. The TE tracks a single special | |
| 113 key for the monitor, and reports key up/down state when it changes. | |
| 114 The actual key is configurable. | |
| 1 | 115 </para> |
| 116 | |
| 117 <para> | |
| 118 CURSORMOVE = 3 (TE -> Monitor). | |
| 119 The first argument is the line number (0..23) | |
| 120 and the second argument is the column number (0..79). | |
| 121 </para> | |
| 122 | |
| 123 <para> | |
| 124 SCREENCHANGE = 4 (TE -> Monitor). The first argument is the | |
| 125 number of lines. The second argument is the number of columns. | |
| 126 That is followed by lines*columns uint16 character codes. | |
| 127 </para> | |
| 128 | |
| 129 <para> | |
| 130 FIELDVALUE = 5 (TE -> Monitor). | |
| 131 SETFIELD = 5 (Monitor -> TE). | |
| 132 The first argument is the line number (0..23) | |
| 133 and the second argument is the column number (0..79). | |
| 134 That is followed by the field value, a sequence of uint16 | |
| 135 character codes from the screen buffer. The field | |
| 136 covers N columns, where N = (message length - 4) / 2. | |
| 137 When sent from the monitor to the emulator, this causes | |
|
18
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
138 the emulator to send the field codes to the host (for async |
|
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
139 modes) or to set the specified field contents (for block modes). |
|
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
140 This is also used as the reply message from the emulator to the |
| 1 | 141 monitor for a previous GETFIELD from the monitor. |
| 142 </para> | |
| 143 | |
| 144 <para> | |
| 145 GETFIELD = 6 (Monitor -> TE). | |
| 146 The first argument is the line number (0..23) | |
| 147 and the second argument is the starting column number (0..79), | |
| 148 and the third argument is the field length in columns. | |
| 149 This command causes the emulator to send a FIELDVALUE message | |
| 150 back to the monitor. | |
| 151 </para> | |
| 152 | |
| 153 <para> | |
| 154 SCREENWATCH = 7 (Monitor -> TE). | |
| 155 The first argument is the line number (0..23) | |
| 156 and the second argument is the starting column number (0..79), | |
| 157 and the third argument is the field length in columns. | |
| 158 This command causes the emulator to watch the specified | |
| 159 part of the screen for changes. When that part of the screen | |
| 160 changes, the emulator will send a SCREENCHANGE message back | |
| 161 to the monitor. | |
| 162 </para> | |
| 2 | 163 |
| 164 <para> | |
| 13 | 165 DEPRESS = 8 (Monitor -> TE). The argument is a single uint16 |
| 166 value containing the vk_key value. This command causes the emulator | |
| 167 to simulate a keypress for that key. The codes are defined | |
| 168 <ulink url="http://msdn.microsoft.com/en-us/library/windows/desktop/dd375731">here</ulink>. | |
| 169 </para> | |
| 170 | |
| 171 <para> | |
| 172 SHOWURL = 9 (Monitor -> TE). The single argument is a sequence | |
| 173 of uint16 character codes forming a URL to be displayed. | |
| 2 | 174 </para> |
|
16
a481d8fb5571
add switch session command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
13
diff
changeset
|
175 |
|
a481d8fb5571
add switch session command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
13
diff
changeset
|
176 <para> |
|
a481d8fb5571
add switch session command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
13
diff
changeset
|
177 SWITCHSESSION = 10 (Monitor -> TE). There are no arguments. The TE |
|
a481d8fb5571
add switch session command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
13
diff
changeset
|
178 should display this session. |
|
a481d8fb5571
add switch session command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
13
diff
changeset
|
179 </para> |
|
18
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
180 |
|
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
181 <para> |
|
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
182 CURSORREQUEST = 11 (Monitor -> TE). There are no arguments. The TE |
|
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
183 should send a CURSORMOVE update to the monitor. Cursor movement caused |
|
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
184 by SETFIELD or DEPRESS commands does not trigger CURSORMOVE updates |
|
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
185 in block mode (tn5250) sessions. Those commands do trigger CURSORMOVE |
|
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
186 updates in async mode (telnet, ssh) sessions. |
|
a94ca5a89fe8
add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents:
16
diff
changeset
|
187 </para> |
| 1 | 188 </refsect1> |
| 189 | |
| 190 <refsect1 id='todo.1'> | |
| 191 <title>TODO</title> | |
| 192 <para> | |
| 193 Nothing. | |
| 194 </para> | |
| 195 </refsect1> | |
| 196 | |
| 197 <refsect1 id='copyright.1'> | |
| 198 <title>Copyright</title> | |
| 199 <para> | |
| 200 Copyright (C) 2014 by 510 Software Group <carl@five-ten-sg.com> | |
| 201 </para> | |
| 202 <para> | |
| 203 This program is free software; you can redistribute it and/or modify it | |
| 204 under the terms of the GNU General Public License as published by the | |
| 205 Free Software Foundation; either version 3, or (at your option) any | |
| 206 later version. | |
| 207 </para> | |
| 208 <para> | |
| 209 You should have received a copy of the GNU General Public License along | |
| 210 with this program; see the file COPYING. If not, please write to the | |
| 211 Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. | |
| 212 </para> | |
| 213 </refsect1> | |
| 214 | |
| 215 <refsect1 id='version.1'> | |
| 216 <title>Version</title> | |
| 217 <para> | |
| 218 @VERSION@ | |
| 219 </para> | |
| 220 </refsect1> | |
| 221 </refentry> | |
| 222 | |
| 223 </reference> |