Fix documentation replication issues
[asterisk/asterisk.git] / apps / confbridge / conf_state_multi.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2012, Terry Wilson
5  *
6  * Terry Wilson <twilson@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  *
18  * Please follow coding guidelines
19  * http://svn.digium.com/view/asterisk/trunk/doc/CODING-GUIDELINES
20  */
21
22 /*! \file
23  *
24  * \brief Confbridge state handling for the MULTI state
25  *
26  * \author\verbatim Terry Wilson <twilson@digium.com> \endverbatim
27  *
28  * \ingroup applications
29  */
30
31 /*** MODULEINFO
32         <support_level>core</support_level>
33  ***/
34
35 #include "include/confbridge.h"
36 #include "include/conf_state.h"
37
38 static void join_unmarked(struct confbridge_user *user);
39 static void join_marked(struct confbridge_user *user);
40 static void leave_unmarked(struct confbridge_user *user);
41 void transition_to_multi(struct confbridge_user *user);
42
43 struct confbridge_state STATE_MULTI = {
44         .name = "MULTI",
45         .join_unmarked = join_unmarked,
46         .join_waitmarked = conf_default_join_waitmarked,
47         .join_marked = join_marked,
48         .leave_unmarked = leave_unmarked,
49         .leave_waitmarked = conf_default_leave_waitmarked,
50         .entry = transition_to_multi,
51 };
52 struct confbridge_state *CONF_STATE_MULTI = &STATE_MULTI;
53
54 static void join_unmarked(struct confbridge_user *user)
55 {
56         conf_add_user_active(user->conference, user);
57 }
58
59 static void join_marked(struct confbridge_user *user)
60 {
61         conf_add_user_marked(user->conference, user);
62
63         conf_change_state(user, CONF_STATE_MULTI_MARKED);
64 }
65
66 static void leave_unmarked(struct confbridge_user *user)
67 {
68         conf_remove_user_active(user->conference, user);
69         if (user->conference->activeusers == 1) {
70                 conf_change_state(user, CONF_STATE_SINGLE);
71         }
72 }
73
74 void transition_to_multi(struct confbridge_user *user)
75 {
76         return;
77 }