src/sipmsg.h

   1 /**
   2  * @file sipmsg.h
   3  *
   4  * gaim
   5  *
   6  * Copyright (C) 2008 Novell, Inc.
   7  * Copyright (C) 2005, Thomas Butter <butter@uni-mannheim.de>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  22  */
  23
  24 #ifndef _PURPLE_SIPMSG_H
  25 #define _PURPLE_SIPMSG_H
  26
  27 #include <glib.h>
  28
  29 struct sipmsg {
  30         int response; /* 0 means request, otherwise response code */
  31         gchar *method;
  32         gchar *target;
  33         GSList *headers;
  34         int bodylen;
  35         gchar *body;
  36         gchar *signature;
  37         gchar *rand;
  38         gchar *num;
  39 };
  40
  41 struct siphdrelement {
  42         gchar *name;
  43         gchar *value;
  44 };
  45
  46
  47 struct sipmsg *sipmsg_parse_msg(const gchar *msg);
  48 struct sipmsg *sipmsg_parse_header(const gchar *header);
  49 void sipmsg_print(const struct sipmsg *msg);
  50 void sipmsg_add_header(struct sipmsg *msg, const gchar *name, const gchar *value);
  51 void sipmsg_add_header_pos(struct sipmsg *msg, const gchar *name, const gchar *value, int pos);
  52 void sipmsg_free(struct sipmsg *msg);
  53 gchar *sipmsg_find_header(struct sipmsg *msg, const gchar *name);
  54 gchar *sipmsg_find_header_instance(struct sipmsg *msg, const gchar *name, int which);
  55 gchar *sipmsg_find_part_of_header(const char *hdr, const char * before, const char * after, const char * def);
  56 gchar *sipmsg_find_auth_header(struct sipmsg *msg, const gchar *name);
  57 void sipmsg_remove_header(struct sipmsg *msg, const gchar *name);
  58 char *sipmsg_to_string(const struct sipmsg *msg);
  59
  60 /**
  61  * Formats message to html if not yet.
  62  * Either - keep as is if text/html, or escape text, or escape text and apply format string if any
  63  *
  64  * @param body in case of 'ms_text_format is Content-Type header' or NULL otherwise
  65  * @param ms_text_format either ms-text-format ot Content-Type header.
  66  *
  67  * Allocates memory. Must be feed when done.
  68  */
  69 gchar *get_html_message(const gchar *ms_text_format, const gchar *body);
  70
  71 /**
  72  * Parses headers-like 'msgr' attribute of INVITE's 'ms_text_format' header.
  73  * Then retrieves value of 'X-MMS-IM-Format'.
  74
  75  * 'msgr' typically looks like:
  76  * X-MMS-IM-Format: FN=Microsoft%20Sans%20Serif; EF=BI; CO=800000; CS=0; PF=22
  77  */
  78 gchar *sipmsg_get_x_mms_im_format(gchar *msgr);
  79
  80 /**
  81  * Returns UTF-16LE/'modified base64' encoded X-MMS-IM-Format
  82  * based on input x_mms_im_format.
  83  */
  84 gchar *sipmsg_get_msgr_string(gchar *x_mms_im_format);
  85
  86 /**
  87  * Translates X-MMS-IM format to HTML presentation.
  88  */
  89 gchar *sipmsg_apply_x_mms_im_format(const char *x_mms_im_format, gchar *body);
  90
  91 #define sipe_parse_html            msn_import_html
  92 /**
  93  * Parses the Purple message formatting (html) into the MSN format.
  94  *
  95  * @param html                  The html message to format.
  96  * @param attributes    The returned attributes string.
  97  * @param message               The returned message string.
  98  *
  99  * @return The new message.
 100  */
 101 void sipe_parse_html(const char *html, char **attributes, char **message);
 102
 103 void msn_parse_format(const char *mime, char **pre_ret, char **post_ret);
 104 void msn_import_html(const char *html, char **attributes, char **message);
 105 #endif /* _PURPLE_SIPMSG_H */