src/core/sipe.h

   1 /**
   2  * @file sipe.h
   3  *
   4  *****************************************************************************
   5  *** !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ***
   6  ***                                                                       ***
   7  ***                      THIS INTERFACE IS DEPECRATED                     ***
   8  ***                                                                       ***
   9  ***                    DO NOT INCLUDE IT IN ANY NEW CODE                  ***
  10  ***                                                                       ***
  11  *** !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ***
  12  *****************************************************************************
  13  *
  14  * pidgin-sipe
  15  *
  16  * Copyright (C) 2010-11 SIPE Project <http://sipe.sourceforge.net/>
  17  * Copyright (C) 2008 Novell, Inc.
  18  * Copyright (C) 2007 Anibal Avelar <avelar@gmail.com>
  19  * Copyright (C) 2005 Thomas Butter <butter@uni-mannheim.de>
  20  *
  21  * This program is free software; you can redistribute it and/or modify
  22  * it under the terms of the GNU General Public License as published by
  23  * the Free Software Foundation; either version 2 of the License, or
  24  * (at your option) any later version.
  25  *
  26  * This program is distributed in the hope that it will be useful,
  27  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  28  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  29  * GNU General Public License for more details.
  30  *
  31  * You should have received a copy of the GNU General Public License
  32  * along with this program; if not, write to the Free Software
  33  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  34  */
  35
  36 /*
  37  * Interface dependencies:
  38  *
  39  * <time.h>
  40  * <glib.h>
  41  */
  42
  43 /* Forward declarations */
  44 struct sipmsg;
  45 struct _PurpleAccount;
  46 struct _PurpleConnection;
  47 struct sipe_core_private;
  48 struct transaction;
  49 struct transaction_payload;
  50
  51 /** MS-PRES publication */
  52 struct sipe_publication {
  53         gchar *category;
  54         guint instance;
  55         guint container;
  56         guint version;
  57         /** for 'state' category */
  58         int availability;
  59         /** for 'state:calendarState' category */
  60         char *cal_event_hash;
  61         /** for 'note' category */
  62         gchar *note;
  63         /** for 'calendarData' category; 300(Team) container */
  64         char *working_hours_xml_str;
  65         char *fb_start_str;
  66         char *free_busy_base64;
  67 };
  68
  69 struct sipe_account_data {
  70         struct _PurpleConnection *gc;
  71         gchar *authdomain;
  72         gchar *authuser;
  73         gchar *password;
  74         /** Allowed server events to subscribe. From register OK response. */
  75         GSList *allow_events;
  76         struct sip_csta *csta; /* For RCC - Remote Call Control */
  77         gboolean subscribed_buddies; /* whether subscribed to buddies presence */
  78         gboolean access_level_set; /* whether basic access level set */
  79         gboolean initial_state_published; /* whether we published our initial state */
  80         GSList *our_publication_keys;           /* [MS-PRES] */
  81         GHashTable *our_publications;           /* [MS-PRES] */
  82         GHashTable *user_state_publications;    /* [MS-PRES] */
  83         int presence_method_version;
  84         time_t do_not_publish[SIPE_ACTIVITY_NUM_TYPES];
  85         gchar *status;
  86         gboolean is_oof_note;
  87         gchar *note;
  88         time_t note_since;
  89         time_t idle_switch;
  90         gboolean batched_support; /*if there is support for batched subscription*/
  91         GSList *containers; /* MS-PRES containers */
  92         struct _PurpleAccount *account;
  93         gchar *regcallid;
  94         GSList *groups;
  95         struct sipe_calendar *cal;
  96         gchar *email;
  97         /** 2005 Custom XML piece.
  98          * Possibly set by other point of presence or just other client at earlier time.
  99          * It should be preserved/modified, not overwritten. This implies subscription
 100          * to self-contasct.
 101          * This XML keeps OC2005:
 102          * - User note
 103          * - OOF flag
 104          * - User status
 105          */
 106         gchar *user_states;
 107 };
 108
 109 struct sipe_auth_job {
 110         gchar *who;
 111         struct sipe_core_private *sipe_private;
 112 };
 113
 114 struct group_user_context {
 115         gchar * group_name;
 116         gchar * user_name;
 117 };
 118
 119 GSList * slist_insert_unique_sorted(GSList *list, gpointer data, GCompareFunc func);
 120
 121 /**
 122  * Publishes self status
 123  * based on own calendar information,
 124  * our Calendar information - FreeBusy, WorkingHours,
 125  * OOF note.
 126  *
 127  * For 2007+
 128  */
 129 void
 130 publish_calendar_status_self(struct sipe_core_private *sipe_private,
 131                              void *unused);
 132
 133 /**
 134  * For 2005-
 135  */
 136 void
 137 send_presence_soap(struct sipe_core_private *sipe_private,
 138                    gboolean do_publish_calendar);
 139
 140 /**
 141  * THE BIG SPLIT - temporary interfaces
 142  *
 143  * Previously private functions in sipe.c that are
 144  *  - waiting to be factored out to an appropriate module
 145  *  - are needed by the already created new modules
 146  */
 147
 148 /* ??? module */
 149 void sipe_connection_cleanup(struct sipe_core_private *sipe_private);
 150 void sipe_buddy_free_all(struct sipe_core_private *sipe_private);
 151
 152 /* sipe-notify? */
 153 void process_incoming_notify(struct sipe_core_private *sipe_private,
 154                              struct sipmsg *msg,
 155                              gboolean request,
 156                              gboolean benotify);
 157
 158 /*** THE BIG SPLIT END ***/