File: id.h

package info (click to toggle)
kamailio 4.2.0-2+deb8u3
  • links: PTS, VCS
  • area: main
  • in suites: jessie
  • size: 56,276 kB
  • sloc: ansic: 552,836; xml: 166,484; sh: 8,659; makefile: 7,676; sql: 6,235; perl: 3,487; yacc: 3,428; python: 1,457; cpp: 1,219; php: 1,047; java: 449; pascal: 194; cs: 40; awk: 27
file content (90 lines) | stat: -rw-r--r-- 2,951 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
/*
 * $Id$
 *
 * Copyright (C) 2005 iptelorg GmbH
 *
 * This file is part of ser, a free SIP server.
 *
 * ser 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
 *
 * For a license to use the ser software under conditions
 * other than those described here, or to purchase support for this
 * software, please contact iptel.org by e-mail at the following addresses:
 *    info@iptel.org
 *
 * ser 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  02110-1301  USA
 *
 */

#ifndef _ID_H
#define _ID_H

#include "str.h"
#include "usr_avp.h"
#include "parser/msg_parser.h"


/*
 * Set From UID
 */
int set_from_uid(str* uid);


/*
 * Get From UID
 */
int get_from_uid(str* uid, struct sip_msg* msg);

/*
 * Set To UID
 */
int set_to_uid(str* uid);


/*
 * Ge To UID
 */
int get_to_uid(str* uid, struct sip_msg* msg);


/** Retrieves the UID of the callee. This function retrieves the UID (unique
 * identifier) of the party being called. The function first searches the list
 * of available attributes and if it finds an attribute with name "uid" then
 * the value of the attribute is returned.  If no such attribute can be found
 * then the function retrieves the username from To header field of REGISTER
 * requests (because that is the party being registered), or the username from
 * the Reqeuest-URI of other requests. The username is then used as the UID
 * string identifying the callee. If no attribute with the UID was found and
 * the function successfully retrieved the UID from the SIP message then, in
 * addition to storing the result in the first parameter, the function will
 * also create the attribute named "uid" which will contain the UID. The
 * function is not reentrant because it uses an internal static buffer to
 * store the result.
 * @param uid A pointer to ::str variable where the result will be stored, the
 *            pointer in the variable will be updated to point to a static
 *            buffer in the function.  
 * @param msg The SIP message being processed.  
 * @return 1 is returned when the attribute with UID exists and it is used, 0
 *         is returned when the function retrieved the UID from the SIP
 *         message and created the attribute, -1 is returned on error.
 */
int get_to_did(str* did, struct sip_msg* msg);


/*
 * Return current From domain id
 */
int get_from_did(str* did, struct sip_msg* msg);


#endif /* _ID_H */