HGKeeper

/**

* @file buddy.h Buddy handlers

* purple

* Purple is the legal property of its developers, whose names are too numerous

* to list here. Please refer to the COPYRIGHT file distributed with this

* source distribution.

* 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., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA

#ifndef PURPLE_JABBER_BUDDY_H

#define PURPLE_JABBER_BUDDY_H

typedef struct _JabberBuddy JabberBuddy;

#include "action.h"

#include "jabber.h"

#include "caps.h"

#include "jutil.h"

struct _JabberBuddy {

/**

* A sorted list of resources in priority descending order.

* This means that the first resource in the list is the

* "most available" (see resource_compare_cb in buddy.c for

* details). Don't play with this yourself, let

* jabber_buddy_track_resource and jabber_buddy_remove_resource do it.

GList *resources;

char *error_msg;

enum {

JABBER_INVISIBLE_NONE = 0,

JABBER_INVISIBLE_SERVER = 1 << 1,

JABBER_INVIS_BUDDY = 1 << 2

} invisible;

enum {

JABBER_SUB_NONE = 0,

JABBER_SUB_PENDING = 1 << 1,

JABBER_SUB_TO = 1 << 2,

JABBER_SUB_FROM = 1 << 3,

JABBER_SUB_BOTH = (JABBER_SUB_TO | JABBER_SUB_FROM),

JABBER_SUB_REMOVE = 1 << 4

} subscription;

};

typedef struct {

char *jid;

char *node;

char *name;

} JabberAdHocCommands;

typedef struct {

JabberBuddy *jb;

char *name;

int priority;

JabberBuddyState state;

char *status;

time_t idle;

JabberCapabilities capabilities;

char *thread_id;

enum {

JABBER_CHAT_STATES_UNKNOWN,

JABBER_CHAT_STATES_UNSUPPORTED,

JABBER_CHAT_STATES_SUPPORTED

} chat_states;

struct {

char *version;

char *name;

char *os;

} client;

/* tz_off == PURPLE_NO_TZ_OFF when unset */

long tz_off;

struct {

JabberCapsClientInfo *info;

GList *exts;

} caps;

GList *commands;

gboolean commands_fetched;

} JabberBuddyResource;

void jabber_buddy_free(JabberBuddy *jb);

JabberBuddy *jabber_buddy_find(JabberStream *js, const char *name,

gboolean create);

JabberBuddyResource *jabber_buddy_find_resource(JabberBuddy *jb,

const char *resource);

JabberBuddyResource *jabber_buddy_track_resource(JabberBuddy *jb, const char *resource,

int priority, JabberBuddyState state, const char *status);

void jabber_buddy_remove_resource(JabberBuddy *jb, const char *resource);

void jabber_buddy_get_info(PurpleConnection *gc, const char *who);

GList *jabber_blist_node_menu(PurpleBlistNode *node);

void jabber_set_info(PurpleConnection *gc, const char *info);

void jabber_setup_set_info(PurpleProtocolAction *action);

void jabber_set_buddy_icon(PurpleConnection *gc, PurpleImage *img);

void jabber_user_search(JabberStream *js, const char *directory);

void jabber_user_search_begin(PurpleProtocolAction *);

void jabber_buddy_remove_all_pending_buddy_info_requests(JabberStream *js);

void jabber_vcard_fetch_mine(JabberStream *js);

gboolean jabber_resource_know_capabilities(const JabberBuddyResource *jbr);

gboolean jabber_resource_has_capability(const JabberBuddyResource *jbr,

const gchar *cap);

gboolean jabber_buddy_has_capability(const JabberBuddy *jb, const gchar *cap);

const gchar *

jabber_resource_get_identity_category_type(const JabberBuddyResource *jbr,

const gchar *category);

#endif /* PURPLE_JABBER_BUDDY_H */

pidgin/pidgin