pjsip_add_use_callerid_contact: fixed alembic script
[asterisk/asterisk.git] / menuselect / menuselect.h
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2005-2006, Russell Bryant
5  *
6  * Russell Bryant <russell@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
19 /*!
20  * \file
21  *
22  * \brief public data structures and defaults for menuselect
23  *
24  */
25
26 #ifndef MENUSELECT_H
27 #define MENUSELECT_H
28
29 #include "linkedlists.h"
30
31 #define OUTPUT_MAKEOPTS_DEFAULT "menuselect.makeopts"
32 #define OUTPUT_MAKEDEPS_DEFAULT "menuselect.makedeps"
33 #define MENUSELECT_DEPS         "build_tools/menuselect-deps"
34
35 struct member;
36
37 struct reference {
38         /*! the name of the dependency */
39         const char *name;
40         /*! the display name of the dependency */
41         const char *displayname;
42         /*! if this dependency is a member, not an external object */
43         struct member *member;
44         /*! if this package was found */
45         unsigned char met:1;
46         /*! if this package should be autoselected */
47         unsigned char autoselect:1;
48         /*! for linking */
49         AST_LIST_ENTRY(reference) list;
50 };
51
52 enum failure_types {
53         NO_FAILURE = 0,
54         SOFT_FAILURE = 1,
55         HARD_FAILURE = 2,
56 };
57
58 AST_LIST_HEAD_NOLOCK(reference_list, reference);
59
60 struct member {
61         /*! What will be sent to the makeopts file */
62         const char *name;
63         /*! Display name if known */
64         const char *displayname;
65         /*! Default setting */
66         const char *defaultenabled;
67         /*! Delete these file(s) if this member changes */
68         const char *remove_on_change;
69         /*! Touch these file(s) if this member changes */
70         const char *touch_on_change;
71         const char *support_level;
72         const char *replacement;
73         /*! member_data is just an opaque, member-specific string */
74         const char *member_data;
75         /*! This module is currently selected */
76         unsigned int enabled:1;
77         /*! This module was enabled when the config was loaded */
78         unsigned int was_enabled:1;
79         /*! This module has failed dependencies */
80         unsigned int depsfailed:2;
81         /*! This module has failed conflicts */
82         unsigned int conflictsfailed:2;
83         /*! This module's 'enabled' flag was changed by a default only */
84         unsigned int was_defaulted:1;
85         /*! This module is a dependency, and if it is selected then
86           we have included it in the MENUSELECT_BUILD_DEPS line
87           in the output file */
88         unsigned int build_deps_output:1;
89         /*! This module should never be enabled automatically, but only
90          * when explicitly set. */
91         unsigned int explicitly_enabled_only:1;
92         /*! This isn't actually a module!  It's a separator, and it should
93          * be passed over for many of the usual purposes associated with members. */
94         unsigned int is_separator:1;
95         /*! dependencies of this module */
96         struct reference_list deps;
97         /*! conflicts of this module */
98         struct reference_list conflicts;
99         /*! optional packages used by this module */
100         struct reference_list uses;
101         /*! for making a list of modules */
102         AST_LIST_ENTRY(member) list;
103 };
104
105 enum support_level_values {
106         SUPPORT_CORE = 0,
107         SUPPORT_EXTENDED = 1,
108         SUPPORT_DEPRECATED = 2,
109         SUPPORT_UNSPECIFIED = 3,
110         SUPPORT_EXTERNAL = 4,
111         SUPPORT_OPTION = 5,
112         SUPPORT_COUNT = 6, /* Keep this item at the end of the list. Tracks total number of support levels. */
113 };
114
115 AST_LIST_HEAD_NOLOCK(support_level_bucket, member);
116
117 struct category {
118         /*! Workspace for building support levels */
119         struct support_level_bucket buckets[SUPPORT_COUNT];
120         /*! the Makefile variable */
121         const char *name;
122         /*! the name displayed in the menu */
123         const char *displayname;
124         /*! Delete these file(s) if anything in this category changes */
125         const char *remove_on_change;
126         /*! Touch these file(s) if anything in this category changes */
127         const char *touch_on_change;
128         /*! Output what is selected, as opposed to not selected */
129         unsigned int positive_output:1;
130         /*! All choices in this category are mutually exclusive */
131         unsigned int exclusive:1;
132         /*! the list of possible values to be set in this variable */
133         AST_LIST_HEAD_NOLOCK(, member) members;
134         /*! for linking */
135         AST_LIST_ENTRY(category) list;
136 };
137
138 extern AST_LIST_HEAD_NOLOCK(categories, category) categories;
139
140 extern const char *menu_name;
141
142 /*! This is implemented by the frontend */
143 int run_menu(void);
144
145 int count_categories(void);
146
147 int count_members(struct category *cat);
148
149 /*! \brief Toggle a member of a category at the specified index to enabled/disabled */
150 void toggle_enabled_index(struct category *cat, int index);
151
152 void toggle_enabled(struct member *mem);
153
154 /*! \brief Set a member of a category at the specified index to enabled */
155 void set_enabled(struct category *cat, int index);
156 /*! \brief Set a member of a category at the specified index to not enabled */
157 void clear_enabled(struct category *cat, int index);
158
159 /*! \brief Enable/Disable all members of a category as long as dependencies have been met and no conflicts are found */
160 void set_all(struct category *cat, int val);
161
162 /*! \brief returns non-zero if the string is not defined, or has zero length */
163 static inline int strlen_zero(const char *s)
164 {
165         return (!s || (*s == '\0'));
166 }
167
168 #if !defined(ast_strdupa) && defined(__GNUC__)
169 #define ast_strdupa(s)                                                    \
170         (__extension__                                                    \
171         ({                                                                \
172                 const char *__old = (s);                                  \
173                 size_t __len = strlen(__old) + 1;                         \
174                 char *__new = __builtin_alloca(__len);                    \
175                 memcpy (__new, __old, __len);                             \
176                 __new;                                                    \
177         }))
178 #endif
179
180 #endif /* MENUSELECT_H */