annotate src/protocols/toc/PROTOCOL @ 2285:8573faeb9298

[gaim-migrate @ 2295] it's easier to do things with them in the right directories committer: Tailor Script <tailor@pidgin.im>
author Eric Warmenhoven <eric@warmenhoven.org>
date Sat, 15 Sep 2001 21:15:36 +0000
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2285
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
1 # Copyright (c) 1998-9 America Online, Inc. All Rights Reserved.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
2 #
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
3 # This program is free software; you can redistribute it and/or
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
4 # modify it under the terms of the GNU General Public License
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
5 # as published by the Free Software Foundation; either version 2
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
6 # of the License, or (at your option) any later version.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
7 #
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
8 # This program is distributed in the hope that it will be useful,
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
9 # but WITHOUT ANY WARRANTY; without even the implied warranty of
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
10 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
11 # GNU General Public License for more details.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
12 #
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
13 # You should have received a copy of the GNU General Public License
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
14 # along with this program; if not, write to the Free Software
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
15 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
16
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
17 # Note from Jim Duchek, gaim maintainer -- this may not be the latest
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
18 # version of this document, I provide it as a service. Download a copy
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
19 # of TiK (http://www.aim.aol.com/tik/) for the latest version of this
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
20 # doc.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
21
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
22 # Note from Eric Warmenhoven, random guy -- this appears to be the last
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
23 # published version of the protocol, and AOL has stopped hosting the TiK
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
24 # program. TiK is still being maintained and is hosted on sourceforge.net;
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
25 # this appears to be the same version of the protocol they're using.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
26
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
27 Version: TOC1.0
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
28
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
29 This document describes the protocol between TOC and TOC clients.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
30 The protocol is built on TCP. Framing is done by SFLAP,
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
31 described at the bottom of this document. Inside each
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
32 SFLAP frame is a TOC command.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
33
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
34 The TOC protocol is ASCII based, and special attention
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
35 must be placed argument separation. The separator and
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
36 the rules of separation are different for messages inbound
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
37 to TOC and outbound to the client. The rules of separation
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
38 are described in sections below.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
39
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
40 The TOC server is built mainly to service the TIC and TiK clients. Since
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
41 the TIC client is a Java applet, and downloadable, TOC will NOT support
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
42 multiple TOC protocol versions at the same time. Therefore, TiK
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
43 users will be forced to upgrade if the protocol version changes.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
44 TOC sends down the protocol version it expects the client
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
45 to speak and understand. Note, the protocol version is a string.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
46
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
47 Important Notes
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
48 ===============
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
49 * TOC will drop the connection if a command exceeds the maximum
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
50 length, which is currently 2048 bytes. So the client needs to
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
51 spend special attention to im, chat, and config message lengths.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
52 There is an 8k length maximum from TOC to the client.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
53
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
54 * No commands should be sent to TOC (besides toc_signon) before
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
55 a SIGN_ON is received. If you do send a command before SIGN_ON
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
56 the command will be ignored, and in some case the connection
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
57 will be dropped.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
58
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
59 * Initial permit/deny items should be sent after receiving SIGN_ON
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
60 but before sending toc_init_done, otherwise the user will flash
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
61 on peoples buddylist who the user has denied. You will probably
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
62 want to send the toc_add_buddies at this time also.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
63
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
64 * After TOC sends the PAUSE message to a client, all messages sent
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
65 to TOC will be ignored, and in some cases the connection will
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
66 be dropped. Another SIGN_ON message will be sent to the client
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
67 when it is online again. The buddy list and permit/deny items must
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
68 be sent again, followed by the toc_init_done. In most cases the
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
69 SIGN_ON message will be sent between 1-2 seconds after the
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
70 PAUSE message. Therefore a client could choose to ignore the
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
71 PAUSE message and hope nothing bad happens.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
72
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
73
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
74 Client -> TOC
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
75 ==============
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
76 The commands and the arguments are usually separated by whitespaces. Arguments
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
77 with whitespace characters should be enclosed in quotes. Dollar signs,
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
78 curly brackets, square brackets, parentheses, quotes, and backslashes
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
79 must all be backslashed whether in quotes or not. It is usually
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
80 a good idea just to use quotes no matter what. All user names from clients
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
81 to TOC should be normalized (spaces removed and lowercased), and therefore
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
82 are the one exception to the always use quotes rule.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
83
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
84 When sending commands to the server you will not get a response
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
85 back confirming that the command format was correct or not! However
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
86 in some cases if the command format was incorrect the connection
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
87 will be dropped.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
88
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
89
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
90 RoastingString="Tic/Toc"
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
91
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
92 toc_signon <authorizer host> <authorizer port> <User Name> <Password>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
93 <language> <version>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
94 The password needs to be roasted with the Roasting String if
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
95 coming over a FLAP connection, CP connections don't use
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
96 roasted passwords. The language specified will be used
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
97 when generating web pages, such as the get info pages.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
98 Currently the only supported language is "english".
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
99 If the language sent isn't found, the default "english"
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
100 language will be used. The version string will be used
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
101 for the client identity, and must be less then 50
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
102 characters.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
103
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
104 Passwords are roasted when sent to the host. This is done so they
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
105 aren't sent in "clear text" over the wire, although they are still
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
106 trivial to decode. Roasting is performed by first xoring each byte
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
107 in the password with the equivalent modulo byte in the roasting
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
108 string. The result is then converted to ascii hex, and prepended
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
109 with "0x". So for example the password "password" roasts to
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
110 "0x2408105c23001130"
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
111
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
112 toc_init_done
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
113 Tells TOC that we are ready to go online. TOC clients should first
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
114 send TOC the buddy list and any permit/deny lists. However toc_init_done
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
115 must be called within 30 seconds after toc_signon, or the connection
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
116 will be dropped. Remember, it can't be called until after the SIGN_ON
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
117 message is received. Calling this before or multiple times after a
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
118 SIGN_ON will cause the connection to be dropped.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
119
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
120 toc_send_im <Destination User> <Message> [auto]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
121 Send a message to a remote user. Remember to quote and encode the
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
122 message. If the optional string "auto" is the last argument, then the
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
123 auto response flag will be turned on for the im.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
124
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
125 toc_add_buddy <Buddy User 1> [<Buddy User2> [<Buddy User 3> [...]]]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
126 Add buddies to your buddy list. This does not change your
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
127 saved config.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
128
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
129 toc_remove_buddy <Buddy User 1> [<Buddy User2> [<Buddy User 3> [...]]]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
130 Remove buddies from your buddy list. This does not change your
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
131 saved config.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
132
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
133 toc_set_config <Config Info>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
134 Set the config information for this user. The config information
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
135 is line oriented with the first character being the item type,
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
136 followed by a space, with the rest of the line being the item
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
137 value. Only letters, numbers, and spaces should be used. Remember
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
138 you will have to enclose the entire config in quotes.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
139
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
140 Item Types:
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
141 g - Buddy Group (All Buddies until the next g or the end of config
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
142 are in this group.)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
143 b - A Buddy
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
144 p - Person on permit list
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
145 d - Person on deny list
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
146 m - Permit/Deny Mode. Possible values are
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
147 1 - Permit All
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
148 2 - Deny All
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
149 3 - Permit Some
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
150 4 - Deny Some
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
151
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
152 toc_evil <User> <norm|anon>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
153 Evil/Warn someone else. The 2nd argument is either the string
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
154 "norm" for a normal warning, or "anon" for an anonymous
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
155 warning. You can only evil people who have recently sent you
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
156 ims. The higher someones evil level, the slower they can
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
157 send message.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
158
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
159 toc_add_permit [ <User 1> [<User 2> [...]]]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
160 ADD the following people to your permit mode. If
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
161 you are in deny mode it will switch you to permit
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
162 mode first. With no arguments and in deny mode
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
163 this will switch you to permit none. If already
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
164 in permit mode, no arguments does nothing
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
165 and your permit list remains the same.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
166
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
167 toc_add_deny [ <User 1> [<User 2> [...]]]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
168 ADD the following people to your deny mode. If
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
169 you are in permit mode it will switch you to
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
170 deny mode first. With no arguments and in permit
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
171 mode, this will switch you to deny none. If
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
172 already in deny mode, no arguments does nothing
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
173 and your deny list remains unchanged.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
174
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
175 toc_chat_join <Exchange> <Chat Room Name>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
176 Join a chat room in the given exchange. Exchange is
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
177 an integer that represents a group of chat rooms.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
178 Different exchanges have different properties. For
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
179 example some exchanges might have room replication (ie
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
180 a room never fills up, there are just multiple
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
181 instances.) and some exchanges might have navigational
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
182 information, and some exchanges might have ... Currently
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
183 exchange should always be 4, however this may
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
184 change in the future. You will either
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
185 receive an ERROR if the room couldn't be joined
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
186 or a CHAT_JOIN message. The Chat Room Name
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
187 is case insensitive and consecutive spaces
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
188 are removed.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
189
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
190 toc_chat_send <Chat Room ID> <Message>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
191 Send a message in a chat room using the chat room
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
192 id from CHAT_JOIN. Since reflection is always on in
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
193 TOC, you do not need to add the message to your chat UI,
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
194 since you will get a CHAT_IN with the message.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
195 Remember to quote and encode the message.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
196
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
197 toc_chat_whisper <Chat Room ID> <dst_user> <Message>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
198 Send a message in a chat room using the chat room
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
199 id from CHAT_JOIN. This message is directed at
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
200 only one person. (Currently you DO need to add this to
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
201 your UI.) Remember to quote and encode the message.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
202 Chat whispering is different from IMs since it is linked
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
203 to a chat room, and should usually be displayed in the chat
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
204 room UI.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
205
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
206 toc_chat_evil <Chat Room ID> <User> <norm|anon>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
207 Evil/Warn someone else inside a chat room. The 3rd argument is either
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
208 the string "norm" for a normal warning, or "anon" for an anonymous
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
209 warning. Currently chat evil is not turned on in the chat complex.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
210
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
211 toc_chat_invite <Chat Room ID> <Invite Msg> <buddy1> [<buddy2> [<buddy3> [...]]]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
212 Once you are inside a chat room you can invite other people into
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
213 that room. Remember to quote and encode the invite message.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
214
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
215 toc_chat_leave <Chat Room ID>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
216 Leave the chat room.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
217
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
218 toc_chat_accept <Chat Room ID>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
219 Accept a CHAT_INVITE message from TOC. The server will send a
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
220 CHAT_JOIN in response.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
221
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
222 toc_get_info <username>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
223 Gets a user's info a GOTO_URL or ERROR message will be sent back to the
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
224 client.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
225
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
226 toc_set_info <info information>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
227 Set the LOCATE user information. This is basic HTML.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
228 Remember to encode the info.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
229
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
230 toc_set_away [<away message>]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
231 if the away message is present, then the unavailable
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
232 status flag is set for the user. If the away message
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
233 is not present, then the unavailable status flag is
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
234 unset. The away message is basic HTML, remember to
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
235 encode the information.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
236
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
237 toc_get_dir <username>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
238 Gets a user's dir info a GOTO_URL or ERROR message will be sent back to the
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
239 client.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
240
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
241 toc_set_dir <info information>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
242 Set the DIR user information. This is a colon separated fields as in:
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
243 "first name":"middle name":"last name":"maiden name":"city":"state":"country":"email":"allow web searches"
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
244 Should return a DIR_STATUS msg. Having anything in the "allow web searches"
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
245 field allows people to use web-searches to find your directory info.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
246 Otherwise, they'd have to use the client.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
247
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
248 toc_dir_search <info information>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
249 Perform a search of the Oscar Directory, using colon separated fields as in:
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
250 "first name":"middle name":"last name":"maiden name":"city":"state":"country":"email"
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
251 Returns either a GOTO_URL or ERROR msg.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
252
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
253 toc_set_idle <idle secs>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
254 Set idle information. If <idle secs> is 0 then the user isn't idle at all.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
255 If <idle secs> is greater then 0 then the user has already been idle
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
256 for <idle secs> number of seconds. The server will automatically
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
257 keep incrementing this number, so do not repeatedly call with new
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
258 idle times.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
259
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
260 toc_set_caps [ <Capability 1> [<Capability 2> [...]]]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
261 Set my capabilities. All capabilities that we support need to
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
262 be sent at the same time. Capabilities are represented by
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
263 UUIDs.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
264
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
265 toc_rvous_propose - Not Implemented Yet
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
266
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
267 toc_rvous_accept <nick> <cookie> <service> <tlvlist>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
268 Accept a rendezvous proposal from the user <nick>.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
269 <cookie> is the cookie from the RVOUS_PROPOSE
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
270 message. <service> is the UUID the proposal was
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
271 for. <tlvlist> contains a list of tlv tags followed by
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
272 base64 encoded values.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
273
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
274 toc_rvous_cancel <nick> <cookie> <service> <tlvlist>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
275 Cancel a rendezvous proposal from the user <nick>.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
276 <cookie> is the cookie from the RVOUS_PROPOSE
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
277 message. <service> is the UUID the proposal was
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
278 for. <tlvlist> contains a list of tlv tags followed by
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
279 base64 encoded values.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
280
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
281 toc_format_nickname <new_format>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
282 Reformat a user's nickname. An ADMIN_NICK_STATUS or ERROR message will
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
283 be sent back to the client.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
284
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
285 toc_change_passwd <existing_passwd new_passwd>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
286 Change a user's password. An ADMIN_PASSWD_STATUS or ERROR message will
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
287 be sent back to the client.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
288
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
289
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
290 TOC -> Client
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
291 ==============
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
292 All user names from TOC to client are NOT normalized, and are
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
293 sent as they should be displayed. String are NOT encoded, instead
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
294 we use colons as separators. So that you can have colons inside
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
295 of messages, everything after the colon before :<Message> should
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
296 be considered part of the message (ie don't just "split" on colons,
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
297 instead split with a max number of results.)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
298
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
299
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
300 SIGN_ON:<Client Version Supported>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
301 This is sent after a successful toc_signon command is sent to TOC.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
302 If the command was unsuccessful either the FLAP connection will
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
303 be dropped or you will receive a ERROR message.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
304
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
305 CONFIG:<config>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
306 A user's config. Config can be empty in which case the host was not able to
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
307 retrieve it, or a config didn't exist for the user. See toc_set_config
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
308 above for the format.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
309
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
310 NICK:<Nickname>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
311 Tells you your correct nickname (ie how it should be capitalized and
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
312 spacing)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
313
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
314 IM_IN:<Source User>:<Auto Response T/F?>:<Message>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
315 Receive an IM from some one. Everything after the third colon is
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
316 the incoming message, including other colons.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
317
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
318 UPDATE_BUDDY:<Buddy User>:<Online? T/F>:<Evil Amount>:<Signon Time>:<IdleTime>:<UC>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
319 This one command handles arrival/depart/updates. Evil Amount is
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
320 a percentage, Signon Time is UNIX epoc, idle time is in minutes, UC (User Class)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
321 is a two/three character string.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
322 uc[0]:
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
323 ' ' - Ignore
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
324 'A' - On AOL
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
325 uc[1]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
326 ' ' - Ignore
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
327 'A' - Oscar Admin
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
328 'U' - Oscar Unconfirmed
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
329 'O' - Oscar Normal
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
330 uc[2]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
331 '\0' - Ignore
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
332 ' ' - Ignore
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
333 'U' - The user has set their unavailable flag.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
334
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
335
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
336
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
337 ERROR:<Error Code>:Var args
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
338 * General Errors *
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
339 901 - $1 not currently available
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
340 902 - Warning of $1 not currently available
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
341 903 - A message has been dropped, you are exceeding
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
342 the server speed limit
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
343
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
344 * Admin Errors *
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
345 911 - Error validating input
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
346 912 - Invalid account
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
347 913 - Error encountered while processing request
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
348 914 - Service unavailable
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
349
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
350 * Chat Errors *
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
351 950 - Chat in $1 is unavailable.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
352
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
353 * IM & Info Errors *
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
354 960 - You are sending message too fast to $1
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
355 961 - You missed an im from $1 because it was too big.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
356 962 - You missed an im from $1 because it was sent too fast.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
357
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
358 * Dir Errors *
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
359 970 - Failure
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
360 971 - Too many matches
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
361 972 - Need more qualifiers
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
362 973 - Dir service temporarily unavailable
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
363 974 - Email lookup restricted
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
364 975 - Keyword Ignored
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
365 976 - No Keywords
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
366 977 - Language not supported
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
367 978 - Country not supported
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
368 979 - Failure unknown $1
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
369
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
370 * Auth errors *
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
371 980 - Incorrect nickname or password.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
372 981 - The service is temporarily unavailable.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
373 982 - Your warning level is currently too high to sign on.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
374 983 - You have been connecting and
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
375 disconnecting too frequently. Wait 10 minutes and try again.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
376 If you continue to try, you will need to wait even longer.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
377 989 - An unknown signon error has occurred $1
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
378
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
379
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
380 EVILED:<new evil>:<name of eviler, blank if anonymous>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
381 The user was just eviled.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
382
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
383 CHAT_JOIN:<Chat Room Id>:<Chat Room Name>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
384 We were able to join this chat room. The Chat Room Id is
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
385 internal to TOC.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
386
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
387 CHAT_IN:<Chat Room Id>:<Source User>:<Whisper? T/F>:<Message>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
388 A chat message was sent in a chat room.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
389
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
390 CHAT_UPDATE_BUDDY:<Chat Room Id>:<Inside? T/F>:<User 1>:<User 2>...
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
391 This one command handles arrival/departs from a chat room. The
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
392 very first message of this type for each chat room contains the
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
393 users already in the room.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
394
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
395 CHAT_INVITE:<Chat Room Name>:<Chat Room Id>:<Invite Sender>:<Message>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
396 We are being invited to a chat room.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
397
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
398 CHAT_LEFT:<Chat Room Id>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
399 Tells tic connection to chat room has been dropped
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
400
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
401 GOTO_URL:<Window Name>:<Url>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
402 Goto a URL. Window Name is the suggested internal name of the window
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
403 to use. (Java supports this.)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
404
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
405 DIR_STATUS:<Return Code>:<Optional args>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
406 <Return Code> is always 0 for success status.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
407
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
408 ADMIN_NICK_STATUS:<Return Code>:<Optional args>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
409 <Return Code> is always 0 for success status.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
410
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
411 ADMIN_PASSWD_STATUS:<Return Code>:<Optional args>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
412 <Return Code> is always 0 for success status.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
413
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
414
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
415 PAUSE
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
416 Tells TIC to pause so we can do migration
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
417
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
418 RVOUS_PROPOSE:<user>:<uuid>:<cookie>:<seq>:<rip>:<pip>:<vip>:<port>
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
419 [:tlv tag1:tlv value1[:tlv tag2:tlv value2[:...]]]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
420 Another user has proposed that we rendezvous with them to
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
421 perform the service specified by <uuid>. They want us
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
422 to connect to them, we have their rendezvous ip, their
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
423 proposer_ip, and their verified_ip. The tlv values are
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
424 base64 encoded.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
425
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
426 Typical Signon Process
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
427 ======================
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
428 Except for the section marked optional this is an sequential
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
429 process. Each line MUST occur before the following line.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
430
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
431 * Client connects to TOC
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
432 * Client sends "FLAPON\r\n\r\n"
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
433 * TOC sends Client FLAP SIGNON
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
434 * Client sends TOC FLAP SIGNON
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
435 * Client sends TOC "toc_signon" message
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
436 * if login fails TOC drops client's connection
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
437 else TOC sends client SIGN_ON reply
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
438 * if Client doesn't support version it drops the connection
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
439
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
440 [BEGIN OPTIONAL]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
441 * TOC sends Client CONFIG
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
442 * Client sends TOC permit/deny stuff
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
443 * Client sends TOC toc_add_buddy message
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
444 [END OPTIONAL]
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
445
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
446 * Client sends TOC toc_init_done message
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
447
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
448
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
449 SFLAP Documentation
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
450 ===================
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
451 SFLAP is pretty much a FLAP connection except the DATA frame payload is a null
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
452 terminated string when traveling from client to host, it is NOT null
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
453 terminated when traveling from host to client. The FLAP Header is binary
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
454 data, and is in network byte order. The data portion is at offset 6, after the
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
455 header. The sequence number is sequential in each direction. So
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
456 packets from the server to client have one sequence number, while
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
457 the packets from the client to server have an independent
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
458 increasing number.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
459
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
460 FLAP Header (6 bytes)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
461 -----------
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
462 Offset Size Type
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
463 0 1 ASTERISK (literal ASCII '*')
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
464 1 1 Frame Type
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
465 2 2 Sequence Number
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
466 4 2 Data Length
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
467
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
468
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
469 Valid Frame Type Values
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
470 -----------------------
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
471 1 SIGNON
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
472 2 DATA
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
473 3 ERROR (Not used by TOC)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
474 4 SIGNOFF (Not used by TOC)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
475 5 KEEP_ALIVE
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
476
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
477
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
478 TOC SIGNON FRAME TYPE
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
479 ---------------------
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
480 Sequence Number contains the initial sequence number used in each direction.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
481 Data Length contains the payload length, with the payload described
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
482 below. The payload area is NOT null terminated.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
483
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
484 Host To Client:
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
485 4 byte FLAP version (1)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
486
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
487 Client To Host:
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
488 4 byte FLAP version (1)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
489 2 byte TLV Tag (1)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
490 2 byte Normalized User Name Length
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
491 N byte Normalized User Name (NOT null terminated)
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
492
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
493
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
494 TOC DATA FRAME TYPE
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
495 -------------------
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
496 Sequence Number contains the next sequence number.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
497 Data Length is the length of the payload, including the null termination
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
498 from client to host.
8573faeb9298 [gaim-migrate @ 2295]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
499