annotate src/multi.h @ 4333:cc2f780c0505

[gaim-migrate @ 4597] I needed to make gc->login_time set before do_proto_menu was called, so I moved that line into account_online instead of serv_finish_login. serv_finish_login is called directly after account_online, and gc->login_time isn't used for anything anyway, so it shouldn't matter. I use gc->login_time to determine if a gc's protocol actions menu is ready to be drawn or not (should not be draw for accounts that are in the process of signing online). I made the "Show Buddies Awaiting Authorization" thing show something reasonable for when you aren't waiting for authorization from anyone. I swapped the ok and cancel buttons for the search for buddy by information and clear log file so they follow the HIG. I gave the right side of the log viewer a shadowed border. I Robot. I applied a patch from Ryan McCabe that doesn't really do anything for gaim (yet, anyway), but it allows clients using libfaim to call cleansnacs cleanly, which stops a potential build up of SNACs in memory when you don't send an IM for a long period of time. I applied another patch from Mr. McCabe that fixes a potential crash in ssi.c when your buddy list is a few lions short of a pride, if you know what I mean. I re-prettified an authorization dialog or two. The bold stuff and the non-bold stuff got backwardcised somehow. I added support for those messages from the ICQ server. Like the one that tells you not to give your password to anyone when you first signon. committer: Tailor Script <[e-mail]>

/*
 * gaim
 *
 * Copyright (C) 1998-1999, Mark Spencer <[e-mail]>
 * 
 * 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 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 program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 */

#ifndef _MULTI_H_
#define _MULTI_H_

#include "core.h"

/* ok. now the fun begins. first we create a connection structure */
struct gaim_connection {
	int edittype; /* XXX CUI: this is ui-specific and should be removed */

	/* we need to do either oscar or TOC */
	/* we make this as an int in case if we want to add more protocols later */
	int protocol;
	struct prpl *prpl;
	guint32 flags;

	/* erg. */
	char *checkbox;

	/* all connections need an input watcher */
	int inpa;

	/* buddy list stuff. there is still a global groups for the buddy list, but
	 * we need to maintain our own set of buddies, and our own permit/deny lists */
	GSList *groups;
	GSList *permit;
	GSList *deny;
	int permdeny;

	/* all connections need a list of chats, even if they don't have chat */
	GSList *buddy_chats;

	/* each connection then can have its own protocol-specific data */
	void *proto_data;

	struct aim_user *user;

	char username[64];
	char displayname[128];
	char password[32];
	guint keepalive;

	/* stuff needed for per-connection idle times */
	guint idle_timer;
	time_t login_time;
	time_t lastsent;
	int is_idle;
	time_t correction_time;

	char *away;		/* set by protos, is NULL when not away, or set *
				 * to "" or a custom message when away */
	char *away_state;	/* updated by serv_set_away, keeps the last set *
				 * away type */
	int is_auto_away;	/* used by idle.c */

	int evil;		/* warning level for AIM (why is this here?) */
	gboolean wants_to_die;	/* defaults to FALSE */
};

#define OPT_CONN_HTML		0x00000001
/* set this flag on a gc if you want serv_got_im to autoreply when away */
#define OPT_CONN_AUTO_RESP	0x00000002

struct proto_user_opt {
	char *label;
	char *def;
	int pos;
};

struct proto_actions_menu {
	char *label;
	void (*callback)(struct gaim_connection *);
	struct gaim_connection *gc;
};

struct proto_buddy_menu {
	char *label;
	void (*callback)(struct gaim_connection *, char *);
	struct gaim_connection *gc;
};

struct proto_chat_entry {
	char *label;
	char *def;
	gboolean is_int;
	int min;
	int max;
};

/* now that we have our struct, we're going to need lots of them. Maybe even a list of them. */
extern GSList *connections;

/* number of accounts that are currently in the process of connecting */
extern int connecting_count;

struct aim_user *new_user(const char *, int, int);
struct gaim_connection *new_gaim_conn(struct aim_user *);
void destroy_gaim_conn(struct gaim_connection *);

void regenerate_user_list();

void account_online(struct gaim_connection *);
void account_offline(struct gaim_connection *);

void auto_login();

void set_login_progress(struct gaim_connection *, float, char *);
void hide_login_progress(struct gaim_connection *, char *);
void hide_login_progress_notice(struct gaim_connection *, char *);
void hide_login_progress_error(struct gaim_connection *, char *);

#endif /* _MULTI_H_ */