annotate doc/sound-signals.dox @ 32797:aacfb71133cc

Fix a possible MSN remote crash Incoming messages with certain characters or character encodings can cause clients to crash. The fix is for the contents of all incoming plaintext messages are converted to UTF-8 and validated before used. This was reported to us by Fabian Yamaguchi and this patch was written by Elliott Sales de Andrade (maybe with small, insignificant changes by me)
author Mark Doliner <mark@kingant.net>
date Mon, 07 May 2012 03:18:08 +0000
parents e0613cf8c493
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12292
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
1 /** @page sound-signals Sound Signals
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
2
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
3 @signals
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
4 @signal playing-sound-event
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
5 @endsignals
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
6
20807
e0613cf8c493 Add some links from signal documentation back to the documentation for the
Will Thompson <will.thompson@collabora.co.uk>
parents: 16196
diff changeset
7 @see sound.h
e0613cf8c493 Add some links from signal documentation back to the documentation for the
Will Thompson <will.thompson@collabora.co.uk>
parents: 16196
diff changeset
8
12292
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
9 <hr>
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
10
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
11 @signaldef playing-sound-event
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
12 @signalproto
16183
8cf53d7a0887 Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents: 12292
diff changeset
13 gboolean (*playing_sound_event)(PurpleSoundEventID event, PurpleAccount *account);
12292
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
14 @endsignalproto
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
15 @signaldesc
16196
1414e0e01dc5 More renaming.
Richard Laager <rlaager@wiktel.com>
parents: 16183
diff changeset
16 Emitted when libpurple is going to play a sound event. This can be used to cancel playing sound by returning TRUE.
12292
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
17 @param event The event this sound represents.
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
18 @param account The account the sound is being played for.
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
19 @return @c TRUE if the sound should not be played, or @c FALSE otherwise.
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
20 @endsignaldef
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
21
b0582839cd6c [gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff changeset
22 */
20807
e0613cf8c493 Add some links from signal documentation back to the documentation for the
Will Thompson <will.thompson@collabora.co.uk>
parents: 16196
diff changeset
23 // vim: syntax=c.doxygen tw=75 et