Mercurial > pidgin.yaz
view doc/blist-signals.dox @ 23995:85bed17fe5c1
The variable we use to keep track of the watcher of the ssl connection
should be unsigned. This isn't really a problem in Pidgin, where we
use glib's mainloop and GIOChannels because glib starts assigning the
handle IDs sequentially starting from 1.
But if an eventloop implementation ever returns a handle ID greater
than the largest possible signed integer (2,147,483,647) then we
won't be able to remove the watcher because purple_ssl_close() in
sslconn.c only removes it if inpa > 0, and since it interprets inpa
as a signed value then handles over 2,147,483,647 appear as negative
numbers.
I stumbled upon this when playing around with libevent, which can
use epoll. My implementation generated a random handle ID which
was sometimes greater than 2,147,483,647.
I don't believe this breaks binary compatibility. And I don't think
it breaks source compatibility, but I guess it might depend on what
compiler you're using.
author | Mark Doliner <mark@kingant.net> |
---|---|
date | Thu, 04 Sep 2008 18:04:29 +0000 |
parents | ff00e91f962e |
children | 0924698e2362 |
line wrap: on
line source
/** @page blist-signals Buddy List Signals @signals @signal buddy-status-changed @signal buddy-idle-changed @signal buddy-signed-on @signal buddy-signed-off @signal update-idle @signal blist-node-extended-menu @signal buddy-added @signal buddy-removed @signal buddy-icon-changed @signal blist-node-aliased @endsignals @see blist.h <hr> @signaldef buddy-status-changed @signalproto void (*buddy_away)(PurpleBuddy *buddy, PurpleStatus *old_status, PurpleStatus *status); @endsignalproto @signaldesc Emitted when a buddy on your buddy list goes away. @param buddy The buddy whose status changed. @param old_status The status that the buddy just changed from. @param status The status that the buddy just changed to. @endsignaldef @signaldef buddy-idle-changed @signalproto void (*buddy_idle)(PurpleBuddy *buddy, gboolean old_idle, gboolean idle); @endsignalproto @signaldesc Emitted when a buddy on your buddy list becomes idle. @param buddy The buddy whose idle status changed. @param old_idle Whether the buddy was idle. @param idle Whether the buddy is currently idle. @endsignaldef @signaldef buddy-signed-on @signalproto void (*buddy_signed_on)(PurpleBuddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list signs on. @param buddy The buddy that signed on. @endsignaldef @signaldef buddy-signed-off @signalproto void (*buddy_signed_off)(PurpleBuddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list signs off. @param buddy The buddy that signed off. @endsignaldef @signaldef update-idle @signalproto void (*update_idle)(); @endsignalproto @signaldesc Emitted when the buddy list is refreshed and the idle times are updated. @endsignaldef @signaldef blist-node-extended-menu @signalproto void (*blist_node_extended_menu)(PurpleBlistNode *node, GList **menu) @endsignalproto @signaldesc Emitted when a buddlist menu is being constructed @a menu is a pointer to a GList of PurpleBlistNodeAction's allowing a plugin to add menu items @endsignaldef @signaldef buddy-added @signalproto void (*buddy_added)(PurpleBuddy *buddy) @endsignalproto @signaldesc Emitted when a new buddy is added to the buddy list. @endsignaldef @signaldef buddy-removed @signalproto void (*buddy_removed)(PurpleBuddy *buddy) @endsignalproto @signaldesc Emitted when a buddy is removed from the buddy list. @endsignaldef @signaldef buddy-icon-changed @signalproto void (*buddy_icon_changed)(PurpleBuddy *buddy) @endsignalproto @signaldesc Emitted when a buddy's icon is set. @endsignaldef @signaldef blist-node-aliased @signalproto void (*blist_node_aliased)(PurpleBlistNode *node, const char *old_alias) @endsignalproto @signaldesc Emitted when a blist node (buddy, chat, or contact) is aliased. @endsignaldef */ // vim: syntax=c.doxygen tw=75 et