Mercurial > pidgin
view src/protocols/msn/user.h @ 7431:643cbc9a6035
[gaim-migrate @ 8036]
This is good enough for CVS. This is new logging. It centers around the
highly modular "GaimLogLogger," which controls how to write the log. Currently
I only have the plain text logger. I wrote the beginning of an XML logger, but
decided I didn't think it was that great an idea. Plugins can implement loggers
themselves, so you can have, like, an SQL logger or something.
The default logger writes to a file unique to the conversation, and they're saved
on disk in a heirarchical fashion: ~/.gaim/logs/aim/seanegn/robflynn-date.log would
be a conversation I had with Rob on date.
What doesn't work:
System logging
The search button in the log viewer.
Oh, chats probably don't log either, I didn't test.
You can only log in plain text right now.
Obviously, it's not done yet. But you can play around with it, and give it
some love. I'll get back to it tomorrow after school, maybe.
committer: Tailor Script <tailor@pidgin.im>
author | Sean Egan <seanegan@gmail.com> |
---|---|
date | Wed, 05 Nov 2003 06:15:49 +0000 |
parents | 8f228a7d5076 |
children | 3a48ade4f510 |
line wrap: on
line source
/** * @file user.h User functions * * gaim * * Copyright (C) 2003 Christian Hammond <chipx86@gnupdate.org> * * 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 _MSN_USER_H_ #define _MSN_USER_H_ typedef struct _MsnUser MsnUser; typedef struct _MsnUsers MsnUsers; #include "session.h" #include "msnobject.h" /** * A user. */ struct _MsnUser { MsnSession *session; /**< The MSN session. */ char *passport; /**< The passport account. */ char *name; /**< The friendly name. */ struct { char *home; /**< Home phone number. */ char *work; /**< Work phone number. */ char *mobile; /**< Mobile phone number. */ } phone; gboolean authorized; /**< Authorized to add this user. */ gboolean mobile; /**< Signed up with MSN Mobile. */ GList *group_ids; /**< The group IDs. */ size_t ref_count; /**< The reference count. */ MsnObject *msnobj; /**< The user's MSN Object. */ GHashTable *clientcaps; /**< The client's capabilities. */ }; /** * A collection of users. */ struct _MsnUsers { size_t count; /**< The number of users. */ GList *users; /**< The list of users. */ }; /**************************************************************************/ /** @name User API */ /**************************************************************************/ /*@{*/ /** * Creates a new user structure. * * @param session The MSN session. * @param passport The initial passport. * @param name The initial friendly name. * * @return A new user structure. */ MsnUser *msn_user_new(MsnSession *session, const char *passport, const char *name); /** * Destroys a user structure. * * @param user The user to destroy. */ void msn_user_destroy(MsnUser *user); /** * Increments the reference count on a user. * * @param user The user. * * @return @a user */ MsnUser *msn_user_ref(MsnUser *user); /** * Decrements the reference count on a user. * * This will destroy the structure if the count hits 0. * * @param user The user. * * @return @a user, or @c NULL if the new count is 0. */ MsnUser *msn_user_unref(MsnUser *user); /** * Sets the passport account for a user. * * @param user The user. * @param passport The passport account. */ void msn_user_set_passport(MsnUser *user, const char *passport); /** * Sets the friendly name for a user. * * @param user The user. * @param name The friendly name. */ void msn_user_set_name(MsnUser *user, const char *name); /** * Sets the group ID list for a user. * * @param user The user. * @param ids The group ID list. */ void msn_user_set_group_ids(MsnUser *user, GList *ids); /** * Adds the group ID for a user. * * @param user The user. * @param id The group ID. */ void msn_user_add_group_id(MsnUser *user, int id); /** * Removes the group ID from a user. * * @param user The user. * @param id The group ID. */ void msn_user_remove_group_id(MsnUser *user, int id); /** * Sets the home phone number for a user. * * @param user The user. * @param number The home phone number. */ void msn_user_set_home_phone(MsnUser *user, const char *number); /** * Sets the work phone number for a user. * * @param user The user. * @param number The work phone number. */ void msn_user_set_work_phone(MsnUser *user, const char *number); /** * Sets the mobile phone number for a user. * * @param user The user. * @param number The mobile phone number. */ void msn_user_set_mobile_phone(MsnUser *user, const char *number); /** * Sets the MSNObject for a user. * * @param user The user. * @param obj The MSNObject. */ void msn_user_set_object(MsnUser *user, MsnObject *obj); /** * Sets the client information for a user. * * @param user The user. * @param info The client information. */ void msn_user_set_client_caps(MsnUser *user, GHashTable *info); /** * Returns the passport account for a user. * * @param user The user. * * @return The passport account. */ const char *msn_user_get_passport(const MsnUser *user); /** * Returns the friendly name for a user. * * @param user The user. * * @return The friendly name. */ const char *msn_user_get_name(const MsnUser *user); /** * Returns the group IDs for a user. * * @param user The user. * * @return The group IDs. */ GList *msn_user_get_group_ids(const MsnUser *user); /** * Returns the home phone number for a user. * * @param user The user. * * @return The user's home phone number. */ const char *msn_user_get_home_phone(const MsnUser *user); /** * Returns the work phone number for a user. * * @param user The user. * * @return The user's work phone number. */ const char *msn_user_get_work_phone(const MsnUser *user); /** * Returns the mobile phone number for a user. * * @param user The user. * * @return The user's mobile phone number. */ const char *msn_user_get_mobile_phone(const MsnUser *user); /** * Returns the MSNObject for a user. * * @param user The user. * * @return The MSNObject. */ MsnObject *msn_user_get_object(const MsnUser *user); /** * Returns the client information for a user. * * @param user The user. * * @return The client information. */ GHashTable *msn_user_get_client_caps(const MsnUser *user); /*@}*/ /**************************************************************************/ /** @name User List API */ /**************************************************************************/ /*@{*/ /** * Creates a new MsnUsers structure. * * @return A new MsnUsers structure. */ MsnUsers *msn_users_new(void); /** * Destroys a users list. * * @param users The users list. */ void msn_users_destroy(MsnUsers *users); /** * Adds a user to a users list. * * @param users The users list. * @param user The user. */ void msn_users_add(MsnUsers *users, MsnUser *user); /** * Removes a user from a users list. * * @param users The users list. * @param user The user. */ void msn_users_remove(MsnUsers *users, MsnUser *user); /** * Returns the number of users in a users list. * * @param users The users list. * * @return The number of users. */ size_t msn_users_get_count(const MsnUsers *users); /** * Finds a user with the specified passport. * * @param users A list of users. * @param passport The passport. * * @return The user if found, or @c NULL otherwise. */ MsnUser *msn_users_find_with_passport(MsnUsers *users, const char *passport); /*@}*/ #endif /* _MSN_USER_H_ */