Mercurial > pidgin.yaz
view doc/gtkblist-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 | e0613cf8c493 |
children | d75813811637 |
line wrap: on
line source
/** @page gtkblist-signals GtkBlist Signals @signals @signal gtkblist-hiding @signal gtkblist-unhiding @signal gtkblist-created @signal drawing-tooltip @endsignals @see gtkblist.h <hr> @signaldef gtkblist-hiding @signalproto void (*gtkblist-hiding)(PurpleBuddyList *blist); @endsignalproto @signaldesc Emitted when the buddy list is about to be hidden. @param blist The buddy list. @endsignaldef @signaldef gtkblist-unhiding @signalproto void (*gtkblist-unhiding)(PurpleBuddyList *blist); @endsignalproto @signaldesc Emitted when the buddy list is about to be unhidden. @param blist The buddy list. @endsignaldef @signaldef gtkblist-created @signalproto void (*gtkblist-created)(PurpleBuddyList *blist); @endsignalproto @signaldesc Emitted when the buddy list is created. @param blist The buddy list. @endsignaldef @signaldef drawing-tooltip @signalproto void (*drawing-tooltip)(PurpleBlistNode *node, GString *text, gboolean full); @endsignalproto @signaldesc Emitted just before a tooltip is displayed. @a text is a standard GString, so the plugin can modify the text that will be displayed. @note Make sure to free @a *text before you replace it! @param node The blist node for the tooltip. @param text A pointer to the text that will be displayed. @param full Whether we're doing a full tooltip for the priority buddy or a compact tooltip for a non-priority buddy. @endsignaldef */ // vim: syntax=c.doxygen tw=75 et