doc/core-signals.dox

Sat, 25 Nov 2017 21:42:28 +0800

author
Tom Li <tomli@tomli.me>
date
Sat, 25 Nov 2017 21:42:28 +0800
branch
release-2.x.y
changeset 38792
fdb68b9b02b8
parent 28189
db6dce6fba36
permissions
-rw-r--r--

jabber.c: fix #17270, ignore STARTTLS when using BOSH.

Pidgin wants to establish a TLS connection with a STARTTLS request, but
it doesn't make any sense, since the XMPP stream is proxied by the BOSH
connection, which is already encrypted by HTTPS. It is impossible to
STARTTLS with BOSH.

According to XEP-0206: The client SHOULD ignore any Transport Layer Security
(TLS) feature since BOSH channel encryption SHOULD be negotiated at the HTTP
layer.

Failing to do it causes Pidgin fails to create any connection with BOSH to any
XMPP server with STARTTLS enabled.

https://developer.pidgin.im/ticket/17270

12053
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
1 /** @page core-signals Core Signals
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
2
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
3 @signals
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
4 @signal quitting
28189
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
5 @signal uri-handler
12053
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
6 @endsignals
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
7
20897
2608e9e07913 Add some links from signal documentation back to the documentation for the
Will Thompson <resiak@pidgin.im>
parents: 16257
diff changeset
8 @see core.h
2608e9e07913 Add some links from signal documentation back to the documentation for the
Will Thompson <resiak@pidgin.im>
parents: 16257
diff changeset
9
12053
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
10 <hr>
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
11
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
12 @signaldef quitting
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
13 @signalproto
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
14 void (*quitting)();
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
15 @endsignalproto
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
16 @signaldesc
16257
66f737e6b718 More renaming.
Richard Laager <rlaager@pidgin.im>
parents: 12053
diff changeset
17 Emitted when libpurple is quitting.
12053
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
18 @endsignaldef
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
19
28189
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
20 @signaldef uri-handler
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
21 @signalproto
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
22 gboolean (*uri_handler)(const gchar *proto, const gchar *cmd, GHashTable *params);
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
23 @endsignalproto
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
24 @signaldesc
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
25 Emitted when handling a registered URI.
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
26 @param proto The protocol of the URI.
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
27 @param cmd The 'command' of the URI.
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
28 @param params Any key/value parameters from the URI.
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
29 @endsignaldef
db6dce6fba36 Document the uri-handler signal. Did I get this right?
Etan Reisner <deryni@pidgin.im>
parents: 20897
diff changeset
30
12053
5aa634db0fc1 [gaim-migrate @ 14348]
Casey Harkins <charkins@pidgin.im>
parents:
diff changeset
31 */
20897
2608e9e07913 Add some links from signal documentation back to the documentation for the
Will Thompson <resiak@pidgin.im>
parents: 16257
diff changeset
32 // vim: syntax=c.doxygen tw=75 et

mercurial