src/gaim-socket.h

Thu, 07 Apr 2005 14:55:02 +0000

author
Richard Laager <rlaager@pidgin.im>
date
Thu, 07 Apr 2005 14:55:02 +0000
changeset 10789
cabd145237d8
parent 9713
bb37562302a1
permissions
-rw-r--r--

[gaim-migrate @ 12431]
" The following log snippets should explain it: " --rlaager

(20:24:00) rlaager: Regarding the signal handling
conversation the other day... I've written a patch to stop
calling signal handlers and return as soon as we find one
signal handler that returns TRUE to indicate that it's
handled the signal. Is this the right approach?

(20:24:22) Ethan Blanton (Paco-Paco): the trouble is that it's
documented to behave exactly the way it does
(20:24:31) Ethan Blanton (Paco-Paco): so changing it is
notbackwards compatible
(20:24:31) rlaager: I'm talking for HEAD.
(20:24:41) Ethan Blanton (Paco-Paco): oh, I think that's a
good approach, yes
(20:24:53) rlaager: The way I've described is how I
*expected* it to work, having not read the documentation.
(20:25:09) Ethan Blanton (Paco-Paco): I'm convinced
(20:27:04) Stu Tomlinson (nosnilmot): rlaager: this, I
assume, breaks the generic-ness of signals, by assuming
that any that return values return booleans?
(20:27:26) Ethan Blanton (Paco-Paco): please break it
(20:27:33) Ethan Blanton (Paco-Paco): we already have
out-parameters
(20:27:42) rlaager: nosnilmot: from what I can see, the
return type is handled as a (void *)... so I'm checking that
ret_value != NULL
(20:27:57) rlaager: nosnilmot: that's the correct way to do it,
right?
...
(20:29:01) Ethan Blanton (Paco-Paco): allowing a
meaningful return value is an over-engineering
(20:30:07) rlaager: even after this patch, you should be able
to return meaningful return values
(20:30:15) rlaager: it'll just short-circuit on the first handler
that does

committer: Luke Schierer <lschiere@pidgin.im>

3478
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
1 /*
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
2 * gaim-remote
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
3 *
8046
c581b20a47d6 [gaim-migrate @ 8730]
Sean Egan <seanegan@pidgin.im>
parents: 3478
diff changeset
4 * Gaim is the legal property of its developers, whose names are too numerous
c581b20a47d6 [gaim-migrate @ 8730]
Sean Egan <seanegan@pidgin.im>
parents: 3478
diff changeset
5 * to list here. Please refer to the COPYRIGHT file distributed with this
c581b20a47d6 [gaim-migrate @ 8730]
Sean Egan <seanegan@pidgin.im>
parents: 3478
diff changeset
6 * source distribution.
3478
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
7 *
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
8 * This program is free software; you can redistribute it and/or modify
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
9 * it under the terms of the GNU General Public License as published by
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
10 * the Free Software Foundation; either version 2 of the License, or
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
11 * (at your option) any later version.
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
12 *
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
13 * This program is distributed in the hope that it will be useful,
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
16 * GNU General Public License for more details.
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
17 *
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
18 * You should have received a copy of the GNU General Public License
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
19 * along with this program; if not, write to the Free Software
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
21 *
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
22 */
9713
bb37562302a1 [gaim-migrate @ 10574]
Mark Doliner <markdoliner@pidgin.im>
parents: 8046
diff changeset
23 #ifndef _GAIM_GAIM_SOCKET_H_
bb37562302a1 [gaim-migrate @ 10574]
Mark Doliner <markdoliner@pidgin.im>
parents: 8046
diff changeset
24 #define _GAIM_GAIM_SOCKET_H_
3478
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
25
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
26 struct gaim_cui_packet {
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
27 guchar type;
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
28 guchar subtype;
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
29 guint32 length;
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
30 char *data;
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
31 };
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
32
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
33
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
34 void cui_send_packet (int fd, struct gaim_cui_packet *p);
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
35 gint gaim_connect_to_session(gint session);
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
36 gboolean gaim_session_exists(int sess);
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
37
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
38 struct gaim_cui_packet *cui_packet_new(guchar type, guchar subtype);
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
39 void cui_packet_free(struct gaim_cui_packet *p);
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
40 void cui_packet_append_string(struct gaim_cui_packet *p, char *str);
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
41 void cui_packet_append_char(struct gaim_cui_packet *p, char c);
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
42 void cui_packet_append_raw(struct gaim_cui_packet *p, char *str, int len);
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
43
28a897f24a35 [gaim-migrate @ 3532]
Sean Egan <seanegan@pidgin.im>
parents:
diff changeset
44
9713
bb37562302a1 [gaim-migrate @ 10574]
Mark Doliner <markdoliner@pidgin.im>
parents: 8046
diff changeset
45 #endif /* _GAIM_GAIM_SOCKET_H_ */

mercurial