libpurple/protocols/msn/tlv.h

Mon, 28 Feb 2011 07:12:27 +0000

author
Mark Doliner <markdoliner@pidgin.im>
date
Mon, 28 Feb 2011 07:12:27 +0000
changeset 31482
a189fa1292c9
parent 31250
cf0af85538c0
child 31523
3a58442e7b62
permissions
-rw-r--r--

Fix a memleak in the MSN prpl when removing a buddy from your buddy list.
We needed to call msn_user_unref() after calling msn_userlist_remove_user()

I chose to fix this by changing msn_userlist_add_user() and
msn_userlist_remove_user() to incremend and decrement the reference counter
themselves--after all, they ARE the ones who add/remove a reference to
the MsnUser struct. Conceptually I thought this made the most sense.

/**
 * @file tlv.h MSN TLV functions
 *
 * 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 MSN_TLV_H
#define MSN_TLV_H

#include "msn.h"

/* TLV structure */
typedef struct msn_tlv_s
{
	guint8 type;
	guint8 length;
	guint8 *value;
} msn_tlv_t;

/* TLV handling functions */
char *msn_tlv_getvalue_as_string(msn_tlv_t *tlv);

msn_tlv_t *msn_tlv_gettlv(GSList *list, const guint16 type, const int nth);
int msn_tlv_getlength(GSList *list, const guint16 type, const int nth);
char *msn_tlv_getstr(GSList *list, const guint16 type, const int nth);
guint8 msn_tlv_get8(GSList *list, const guint16 type, const int nth);
guint16 msn_tlv_get16(GSList *list, const guint16 type, const int nth);
guint32 msn_tlv_get32(GSList *list, const guint16 type, const int nth);

/* TLV list handling functions */
GSList *msn_tlvlist_read(char *bs, size_t bs_len);
GSList *msn_tlvlist_copy(GSList *orig);

int msn_tlvlist_count(GSList *list);
size_t msn_tlvlist_size(GSList *list);
gboolean msn_tlvlist_equal(GSList *one, GSList *two);
int msn_tlvlist_write(char *bs, size_t bs_len, GSList **list);
void msn_tlvlist_free(GSList *list);

int msn_tlvlist_add_raw(GSList **list, const guint16 type, const guint16 length, const char *value);
int msn_tlvlist_add_empty(GSList **list, const guint16 type);
int msn_tlvlist_add_8(GSList **list, const guint16 type, const guint8 value);
int msn_tlvlist_add_16(GSList **list, const guint16 type, const guint16 value);
int msn_tlvlist_add_32(GSList **list, const guint16 type, const guint32 value);
int msn_tlvlist_add_str(GSList **list, const guint16 type, const char *value);

int msn_tlvlist_replace_raw(GSList **list, const guint16 type, const guint16 lenth, const char *value);
int msn_tlvlist_replace_str(GSList **list, const guint16 type, const char *str);
int msn_tlvlist_replace_empty(GSList **list, const guint16 type);
int msn_tlvlist_replace_8(GSList **list, const guint16 type, const guint8 value);
int msn_tlvlist_replace_16(GSList **list, const guint16 type, const guint16 value);
int msn_tlvlist_replace_32(GSList **list, const guint16 type, const guint32 value);

void msn_tlvlist_remove(GSList **list, const guint16 type);

#endif /* MSN_TLV_H */

mercurial