pidgin/pidgin

Fix a crash when hovering over an exceptionally long URL (4074 characters,
release-2.x.y
2014-01-13, Mark Doliner
2bb66ef1475e
Fix a crash when hovering over an exceptionally long URL (4074 characters,
but it might be different for you) in a gtkimhtml widget (such as the IM
window).

This was reported on the support mailing list:
http://pidgin.im/pipermail/support/2013-March/012980.html
http://pidgin.im/pipermail/support/2013-March/012981.html

Repro steps:
1. "gdb pidgin"

2. "break gdk_x_error"
You'll probably need to type "y" to make breakpoint pending on future shared library load. (Or you could run first then add the breakpoint.)

3. "run --sync"
--sync probably isn't actually necessary. Theoretically it should make the backtrace more useful. Like, maybe it could actually show the Pidgin calls that trigger the problem? Or maybe the problem call starts from the gtk main loop, so there would never be Pidgin code in the backtrace? It's also possible we don't pass our args to the right places to make --sync work.

4. "cont"
I hit the breakpoint at startup for some reason. I've just been continuing past it. Doesn't seem to affect anything.

5. Open an IM window.

6. Paste a long URL.

7. Mouse over the long URL.

8. The breakpoint is hit.

9. "bt"

#0 gdk_x_error (display=0x740e30, error=0x7fffffffbc20)
at /build/buildd/gtk+2.0-2.24.13/gdk/x11/gdkmain-x11.c:458
#1 0x00007ffff73b94f6 in _XError () from /usr/lib/x86_64-linux-gnu/libX11.so.6
#2 0x00007ffff73b6741 in ?? () from /usr/lib/x86_64-linux-gnu/libX11.so.6
#3 0x00007ffff73b6785 in ?? () from /usr/lib/x86_64-linux-gnu/libX11.so.6
#4 0x00007ffff73b7378 in _XReply () from /usr/lib/x86_64-linux-gnu/libX11.so.6
#5 0x00007ffff73b2d3d in XSync () from /usr/lib/x86_64-linux-gnu/libX11.so.6
#6 0x00007ffff73b2dcb in ?? () from /usr/lib/x86_64-linux-gnu/libX11.so.6
#7 0x00007ffff73b9e2f in ?? () from /usr/lib/x86_64-linux-gnu/libX11.so.6
#8 0x00007ffff7395d14 in XCreatePixmap () from /usr/lib/x86_64-linux-gnu/libX11.so.6
#9 0x00007ffff62bd0d2 in _gdk_pixmap_new (drawable=0x186ec60, width=width@entry=32774, height=25, depth=24,
depth@entry=-1) at /build/buildd/gtk+2.0-2.24.13/gdk/x11/gdkpixmap-x11.c:175
#10 0x00007ffff6289617 in IA__gdk_pixmap_new (drawable=drawable@entry=0x186ec60, width=width@entry=32774,
height=, depth=depth@entry=-1) at /build/buildd/gtk+2.0-2.24.13/gdk/gdkpixmap.c:249
#11 0x00007ffff6297036 in gdk_window_begin_implicit_paint (rect=0x7fffffffbed0, window=0x186ec60)
at /build/buildd/gtk+2.0-2.24.13/gdk/gdkwindow.c:2779
#12 gdk_window_process_updates_internal (window=0x186ec60) at /build/buildd/gtk+2.0-2.24.13/gdk/gdkwindow.c:5574
#13 0x00007ffff6299201 in IA__gdk_window_process_all_updates ()
at /build/buildd/gtk+2.0-2.24.13/gdk/gdkwindow.c:5696
#14 0x00007ffff6299269 in gdk_window_update_idle (data=)
at /build/buildd/gtk+2.0-2.24.13/gdk/gdkwindow.c:5322
#15 0x00007ffff6276e77 in gdk_threads_dispatch (data=0x1a45c40) at /build/buildd/gtk+2.0-2.24.13/gdk/gdk.c:512
#16 0x00007ffff53d8ab5 in g_main_context_dispatch () from /lib/x86_64-linux-gnu/libglib-2.0.so.0
#17 0x00007ffff53d8de8 in ?? () from /lib/x86_64-linux-gnu/libglib-2.0.so.0
#18 0x00007ffff53d91e2 in g_main_loop_run () from /lib/x86_64-linux-gnu/libglib-2.0.so.0
#19 0x00007ffff663ec77 in IA__gtk_main () at /build/buildd/gtk+2.0-2.24.13/gtk/gtkmain.c:1271
#20 0x0000000000499950 in main (argc=1, argv=0x7fffffffe538) at gtkmain.c:933

This is the message it prints when it exits:
The program 'Pidgin' received an X Window System error.
This probably reflects a bug in the program.
The error was 'BadAlloc (insufficient resources for operation)'.
(Details: serial 14454 error_code 11 request_code 53 minor_code 0)
(Note to programmers: normally, X errors are reported asynchronously;
that is, you will receive the error a while after causing it.
To debug your program, run it with the --sync command line
option to change this behavior. You can then get a meaningful
backtrace from your debugger if you break on the gdk_x_error() function.)

I think it's kinda lame that gdk/gtk/xlib/whatever barfs when we give it a
ridiculously wide pango layout, but whatever. I'm assuming this problem is
gtkimhtml specific, and so I don't want to spend a whole lot of time fixing
it. As an easy fix I want to just truncate the URL displayed in the tooltip
to 200 characters.

Here's an example URL that I used to trigger the crash:
http://www.example.com/?%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%30123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789%3012345678901234567890123456789012345678901234567890123456789012345678
.\" Copyright (c) 2006, Sadrul Habib Chowdhury <sadrul@users.sf.net>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.TH finch 1
.SH NAME
Finch \- A Pimpin' Penguin console frontend to libpurple. Instant
Messaging client.
.SH SYNOPSIS
.TP 5
\fBfinch \fI[options]\fR
.SH DESCRIPTION
.PP
\fBfinch\fR is a console-based modular messaging client based on libpurple
which is capable of connecting to AIM, MSN, Yahoo!, XMPP, ICQ, IRC, SILC,
Novell GroupWise, Lotus Sametime, Zephyr, Gadu-Gadu, and QQ all at once. It has
many common features found in other clients, as well as many unique features.
Finch is not endorsed by or affiliated with America Online, ICQ, Microsoft, or
Yahoo.
.SH OPTIONS
The following options are provided by \fBfinch\fR using the standard GNU
command line syntax:
.TP
.B \-c, \-\-config=\fIDIR\fB
Use \fIDIR\fR as the directory for config files instead of \fI~/.purple\fR.
.TP
.B \-d, \-\-debug
Print debugging messages to stderr and start with the \fBDebug\fR window. The
messages shown in the \fBDebug\fR window are the same as the ones printed in
stderr.
.TP
.B \-h, \-\-help
Print this help and exit.
.TP
.B \-n, \-\-nologin
Don't automatically login when \fBfinch\fR starts. Sets all accounts to
Offline.
.TP
.B \-v, \-\-version
Display the version information window.
.SH GNT Shortcuts
You can use the following shortcuts (see the "Widget Actions" section for a more complete list):
.TP
.B Alt \+ a
Bring up a list of available actions. You can use this list to access the
accounts window, plugins window, preference window etc.
.TP
.B Alt \+ n
Go to the next window.
.TP
.B Alt \+ p
Go to the previous window.
.TP
.B Alt \+ w
Show the list of windows. You can select and jump to any window from the list.
.TP
.B Alt \+ c
Close the current window.
.TP
.B Alt \+ q
Quit.
.TP
.B Alt \+ m
Start moving a window. Press the cursor keys to move the window. When you are
done, press \fBEnter\fR or \fBEscape\fR.
.TP
.B Alt \+ r
Start resizing a window. Press the cursor keys to resize the window. When you
are done, press \fBEnter\fR or \fBEscape\fR.
.TP
.B Alt \+ D
Dump the contents of the screen in HTML format.
.TP
.B Alt \+ .
Move the position of the current window in the window list one place to the
right.
.TP
.B Alt \+ ,
Move the position of the current window in the window list one place to the
left.
.TP
.B Alt \+ l
Refresh the windows. This is useful after resizing the terminal window.
.TP
.B Alt \+ 1 2 ... 0
Jump to the 1st, 2nd ... 10th window.
.TP
.B Alt \+ Tab
Jump to the next URGENT (highlighted) window.
.TP
.B Alt \+ Shift \+ Tab
Jump to the previous URGENT (highlighted) window.
.TP
.B Ctrl \+ o \fR or \fB F10
Bring up the menu (if there is one) for a window.
.TP
.B F11 \fR or \fB Ctrl \+ x
Popup the context menu (if there is one) for the selected widget.
.TP
.B Alt \+ /
Show a list of available key-bindings for the current widget in focus.
.TP
.B Alt \+ \>
Switch to the next workspace
.TP
.B Alt \+ \<
Switch to the previous workspace
.TP
.B Alt \+ t
Tag (or untag) the current window
.TP
.B Alt \+ T
Attached all the tagged windows to the current workspace
.TP
.B Alt \+ s
Show the workspace list
.TP
.B F9
Create a new workspace and switch to it
.SH FILES
\fI~/.gntrc\fR: configuration file for gnt applications.
.br
.TP
A sample file looks like:
.br
[Finch]
.br
color-available = green; black
.br
color-away = blue; black
.br
color-idle = gray; black
.br
color-offline = red; black
.br
color-message-sent = cyan; default
.br
color-message-received = red; default
.br
color-message-highlight = black; green
.br
color-message-action = yellow; default
.br
color-timestamp = blue; default
.br
#See below for details on color
.br
[general]
.br
shadow = 0
.br
# There is experimental mouse support
.br
mouse = 1
.br
# To use some custom window-manager
.br
wm = /usr/local/lib/gnt/s.so
.br
# There's also a custom window manager called irssi.so
.br
# Remember window-positions based on the titles (on by default)
.br
remember_position = 1
.br
# Use borderless one-line high buttons
.br
small-button = true
.br
# Workspaces are created simply by adding Workspace-X groups as follows:
.br
[Workspace-1]
.br
name = blist
.br
# window-names specifies that windows with these semi-colon separated names are placed
into this workspace
.br
window-names = buddylist;debug-window
.br
.br
[Workspace-2]
.br
name = IM
.br
window-names = conversation-window
.br
# window-titles specifies that windows with these semi-colon separated titles are placed
into this workspace. These are matched as substrings. Window titles take precedence over
names.
.br
window-titles = Preferences;Pounce
.br
.br
[colors]
.br
# The RGB values range in [0, 1000]
.br
black = 0; 0; 0
.br
red = 1000; 0; 0
.br
green = 0; 1000; 0
.br
blue = 250; 250; 700
.br
white = 1000; 1000; 1000
.br
gray = 700; 700; 700
.br
darkgray = 256; 256; 256
.br
.br
[colorpairs]
.br
normal = white; black
.br
highlight = white; blue
.br
highlightd = black; gray
.br
shadow = black; darkgray
.br
title = white; blue
.br
titled = white; gray
.br
text = white; blue
.br
disabled = gray; black
.br
urgent = green; black
.br
.br
# Remap some keys for GntEntry
.br
[GntEntry::remap]
.br
# Remap the up-arrow to the left-arrow
.br
^[[A = ^[[D
.br
# Remap the down-arrow to the right-arrow
.br
^[[B = ^[[C
.br
# Remap 'a' to 'bcd'
.br
a = bcd
.br
# Completely ignore the key 'q'
.br
q =
.br
# But the following will NOT work
.br
#abc = bcd
.br
# Hitting 'space' will activate a button
.br
[GntButton::remap]
.br
\\ = \\r
.br
.SH Widget Actions
You can specifiy key-bindings for specific widgets. The following entries in
\fI~/.gntrc\fR correspond to the default keybindings for the actions:
.br
[GntBox::binding]
.br
tab = focus-next
.br
right = focus-next
.br
left = focus-prev
.br
[GntComboBox::binding]
.br
down = dropdown
.br
up = dropdown
.br
[GntEntry::binding]
.br
c-a = cursor-home
.br
home = cursor-home
.br
c-e = cursor-end
.br
end = cursor-end
.br
backspace = delete-prev
.br
del = delete-next
.br
c-d = delete-next
.br
c-u = delete-start
.br
c-k = delete-end
.br
c-b = cursor-prev
.br
left = cursor-prev
.br
c-f = cursor-next
.br
right = cursor-next
.br
tab = suggest-show
.br
down = suggest-next
.br
up = suggest-prev
.br
page-down = suggest-next-page
.br
page-up = suggest-prev-page
.br
c-w = delete-prev-word
.br
a-b = cursor-prev-word
.br
a-f = cursor-next-word
.br
a-d = delete-next-word
.br
c-v = clipboard-paste
.br
c-p = history-prev
.br
c-n = history-next
.br
c-r = history-search
.br
c-up = history-prev
.br
c-down = history-next
.br
[GntTree::binding]
.br
up = move-up
.br
down = move-down
.br
c-n = move-down
.br
c-p = move-up
.br
pageup = page-up
.br
pagedown = page-down
.br
backspace = move-parent
.br
home = move-first
.br
end = move-last
.br
# Following is the default binding for the context-menu
.br
menu = context-menu
.br
# The following will let you open the context-menu in the buddylist with c-b
.br
# c-b = context-menu
.br
[GntWidget::binding]
.br
f11 = context-menu
.br
c-x = context-menu
[GntWindow::binding]
.br
c-o = show-menu
.br
f10 = show-menu
The \fBc-\fR corresponds to the \fBControl\fR key. You can also use \fBctrl-\fR
or \fBctr-\fR or \fBctl-\fR to indicate a combination. For alt-keys, you can use
one of \fBa-\fR, \fBalt-\fR, \fBm-\fR or \fBmeta-\fR. You can also use
\fBhome\fR, \fBend\fR, \fBleft\fR, \fBright\fR etc. keys.
To unbind a key which has a default binding, you simply bind it to the empty string. For example, to unbind \fBAlt + q\fR from the Quit function, you would use:
[GntWM::binding]
.br
a-q =
.SH Menus
You can also specify key-bindings to trigger specific menuitems in windows. For example, the following entry in \fI~/.gntrc\fR will bind \fBCtrl + t\fR to the 'Send IM...' item in the buddylist:
[buddylist::menu]
.br
c-t = send-im
The following is the list of IDs of the current menuitems in the buddylist:
send-im
.br
join-chat
.br
show-empty-groups
.br
show-offline-buddies
.br
sort-status
.br
sort-alpha
.br
sort-log
.br
add-buddy
.br
add-chat
.br
add-group
.SH Mouse Support
There is experimental mouse support. You can focus windows, activate buttons,
select rows in a list, scroll using the wheel-scroll etc. Selecting text in a
text-view copies it to the gnt clipboard. Mouse support is disabled by default,
so you need to enable it in \fI~/.gntrc\fR (see the sample above).
.SH Window Management
The default window management is very limited. But it is possible to write
custom window managers to suit your needs. There is a sample window-manager
included (named \fIs.so\fR) which adds a little 'close-button' for the windows,
removes the borders from the buddylist and pops up new windows in the middle of
the screen, instead of at the upper-left corder. It is provided as a sample
simple manager, but it should be possible to write more complex managers, and
it's very possible that the window-manager API will need to be enhanced. Look at
the sample \fI~/.gntrc\fR file above to see how to select a window-manager.
It is also possible to rebind the window-manager actions in \fI~/.gntrc\fR, eg:
.br
[GntWM::binding]
.br
a-n = window-next
.br
a-p = window-prev
.br
a-c = window-close
.br
a-w = window-list
.br
a-d = dump-screen
.br
a-, = shift-left
.br
a-. = shift-right
.br
a-a = action-list
.br
a-m = start-move
.br
a-r = start-resize
.br
a-q = wm-quit
.br
a-l = refresh-screen
.br
a-s = workspace-list
.br
a-t = window-tag
.br
a-T = place-tagged
.br
a-C = toggle-clipboard
.br
a-/ = help-for-widget
.br
a-c-j = window-scroll-down
.br
a-c-k = window-scroll-up
.br
# The following action is still incomplete, and doesn't have a default binding
.br
# switch-window-n
.br
# Other actions: window-next-urgent, window-prev-urgent
# For the sample custom window manager
.br
[GntS::binding]
.br
a-b = toggle-buddylist
# For the irssi window manager
.br
[Irssi::binding]
.br
a-L = move-right
.br
a-H = move-left
.br
a-J = move-down
.br
a-K = move-up
.SH Conversation Commands
There are a few helpful commands in addition to the regular commands. You can
use these from any conversation to access other windows.
.TP
.B accounts
for the accounts window.
.TP
.B buddylist
for the buddylist.
.TP
.B debugwin
for the debug window.
.TP
.B plugins
for the plugins window.
.TP
.B prefs
for the preferences window.
.TP
.B status
for the status window.
.SH FAQ
FAQ for \fBfinch\fR is located at
.br
\fIhttp://developer.pidgin.im/wiki/Using%20Finch\fR
.SH BUGS
Known bugs are listed at
.br
\fIhttp://developer.pidgin.im/query?status=new&status=assigned&status=reopened&component=finch+%28gnt%2Fncurses%29&order=priority\fR
Before sending a bug report, please verify that you have the latest
version of \fBfinch\fR and libpurple. Many bugs (major and minor) are
fixed at each release, and if yours is out of date, the problem may already have
been solved.
.SH PATCHES
If you fix a bug in \fBfinch\fR (or otherwise enhance it), please submit a
patch (using \fBmtn diff > my.diff\fR against the latest version from the
Monotone repository) at \fIhttp://developer.pidgin.im/simpleticket\fR
You are also encouraged to drop by at \fB#pidgin\fR on \fIirc.freenode.net\fR
to discuss development.
.SH SEE ALSO
\fIhttp://pidgin.im/\fR
.br
\fIhttp://developer.pidgin.im/\fR
.br
\fBpurple-remote\fR(1)
.br
\fBpidgin\fR(1)
.SH LICENSE
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful, but
\fBWITHOUT ANY WARRANTY\fR; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
.SH AUTHORS
Sadrul Habib Chowdhury <\fIsadrul@users.sourceforge.net\fR>
.br
This manpage was written by Sadrul Habib Chowdhury
<\fIsadrul@users.sourceforge.net\fR> and Dennis Ristuccia
<\fIdennis@dennisr.net\fR>.