6 * Copyright (C) 2009 SIPE Project <http://sipe.sourceforge.net/>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 /* Helper macros to iterate over dialog list in a SIP session */
24 #define SIPE_DIALOG_FOREACH { \
25 GSList *entry = session->dialogs; \
27 struct sip_dialog *dialog = entry->data; \
29 #define SIPE_DIALOG_FOREACH_END }}
31 /* dialog is the new term for call-leg */
33 gchar
*with
; /* URI */
38 * 0 - didn't participate
47 GSList
*supported
; /* counterparty capabilities */
49 gboolean is_established
;
50 struct transaction
*outgoing_invite
;
53 /* Forward declaration */
57 * Free dialog structure
59 * @param dialog (in) Dialog to be freed. May be NULL.
61 void sipe_dialog_free(struct sip_dialog
*dialog
);
64 * Add a new, empty dialog to a session
68 * @return dialog the new dialog structure
70 struct sip_dialog
*sipe_dialog_add(struct sip_session
*session
);
73 * Find a dialog in a session
75 * @param session (in) may be NULL
76 * @param who (in) dialog identifier. May be NULL
78 * @return dialog the requested dialog or NULL
80 struct sip_dialog
*sipe_dialog_find(struct sip_session
*session
,
84 * Remove a dialog from a session
86 * @param session (in) may be NULL
87 * @param who (in) dialog identifier. May be NULL
89 void sipe_dialog_remove(struct sip_session
*session
, const gchar
*who
);
92 * Remove all dialogs frome a session
96 void sipe_dialog_remove_all(struct sip_session
*session
);
99 * Does a session have any dialogs?
101 * @param session (in)
103 #define sipe_dialog_any(session) (session->dialogs != NULL)
106 * Return first dialog of a session
108 * @param session (in)
110 #define sipe_dialog_first(session) ((struct sip_dialog *)session->dialogs->data)
113 * Fill dialog structure from SIP message
115 * @param msg (in) mesage
116 * @param dialog (in,out) dialog to fill
117 * @param outgoing (in) outgoing or incoming message
119 void sipe_dialog_parse(struct sip_dialog
*dialog
,
120 const struct sipmsg
*msg
,