src/core/sipe-ft.h

   1 /**
   2  * @file sipe-ft.h
   3  *
   4  * pidgin-sipe
   5  *
   6  * Copyright (C) 2010 Jakub Adam <jakub.adam@tieto.com>
   7  * Copyright (C) 2010 Tomáš Hrabčík <tomas.hrabcik@tieto.com>
   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 /*
  25  * Interface dependencies:
  26  *
  27  * <glib.h>
  28  */
  29
  30 /* Forward declarations */
  31 struct sipmsg;
  32 struct _PurpleAccount;
  33
  34 /**
  35  * Called when remote peer wants to send a file.
  36  *
  37  * Function initializes libpurple filetransfer API structure and calls
  38  * purple_xfer_request().
  39  *
  40  * @param account PurpleAccount corresponding to the request
  41  * @param msg     SIP message
  42  * @param body    parsed SIP message body as name-value pairs
  43  */
  44 void sipe_ft_incoming_transfer(struct _PurpleAccount *account, struct sipmsg *msg, const GSList *body);
  45 /**
  46  * Handles incoming filetransfer message with ACCEPT invitation command.
  47  *
  48  * This message is sent during the negotiation phase when parameters of the
  49  * transfer like IP address or TCP port are going to be set up.
  50  *
  51  * @param account PurpleAccount corresponding to the request
  52  * @param body    parsed SIP message body as name-value pairs
  53  */
  54 void sipe_ft_incoming_accept(struct _PurpleAccount *account, const GSList *body);
  55 /**
  56  * Called when remote peer cancels ongoing file transfer.
  57  *
  58  * Function dispatches the request to libpurple
  59  *
  60  * @param account PurpleAccount corresponding to the request
  61  * @param body    parsed SIP message body as name-value pairs
  62  */
  63 void sipe_ft_incoming_cancel(struct _PurpleAccount *account, GSList *body);
  64
  65 /**
  66  * Parses file transfer message body and creates a list with name-value pairs
  67  *
  68  * @param body file transfer SIP message body
  69  *
  70  * @return GSList of name-value pairs parsed from message body, NULL if body has
  71  * incorrect format
  72  */
  73 GSList * sipe_ft_parse_msg_body(const gchar *body);