2 * This file is part of DisOrder.
3 * Copyright (C) 2004-2008 Richard Kettlewell
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
20 /** @file server/options.c
23 * Options represent an additional configuration system private to the
27 #include "disorder-cgi.h"
34 struct read_options_state {
42 static void option__readfile(const char *name);
44 static void option__label(int attribute((unused)) nvec,
46 option_set(vec[0], vec[1]);
49 static void option__include(int attribute((unused)) nvec,
51 option__readfile(vec[0]);
54 static void option__columns(int nvec,
58 c.ncolumns = nvec - 1;
60 hash_add(columns, vec[0], &c, HASH_INSERT_OR_REPLACE);
63 static struct option {
66 void (*handler)(int nvec, char **vec);
68 { "columns", 1, INT_MAX, option__columns },
69 { "include", 1, 1, option__include },
70 { "label", 2, 2, option__label },
73 static void option__split_error(const char *msg,
75 struct read_options_state *cs = u;
77 error(0, "%s:%d: %s", cs->name, cs->line, msg);
80 static void option__readfile(const char *name) {
84 struct read_options_state cs;
86 if(!(cs.name = mx_find(name, 1/*report*/)))
88 if(!(fp = fopen(cs.name, "r")))
89 fatal(errno, "error opening %s", cs.name);
91 while(!inputline(cs.name, fp, &buffer, '\n')) {
93 if(!(vec = split(buffer, &n, SPLIT_COMMENTS|SPLIT_QUOTES,
94 option__split_error, &cs)))
98 if((i = TABLE_FIND(options, name, vec[0])) == -1) {
99 error(0, "%s:%d: unknown option '%s'", cs.name, cs.line, vec[0]);
104 if(n < options[i].minargs) {
105 error(0, "%s:%d: too few arguments to '%s'", cs.name, cs.line, vec[-1]);
108 if(n > options[i].maxargs) {
109 error(0, "%s:%d: too many arguments to '%s'", cs.name, cs.line, vec[-1]);
112 options[i].handler(n, vec);
117 static void option__init(void) {
118 static int have_read_options;
120 if(!have_read_options) {
121 have_read_options = 1;
122 labels = hash_new(sizeof (char *));
123 columns = hash_new(sizeof (struct column));
124 option__readfile("options");
128 /** @brief Set an option
129 * @param name Option name
130 * @param value Option value
132 * If the option was already set its value is replaced.
134 * @p name and @p value are copied.
136 void option_set(const char *name, const char *value) {
137 char *v = xstrdup(value);
140 hash_add(labels, name, &v, HASH_INSERT_OR_REPLACE);
143 /** @brief Get a label
144 * @param key Name of label
145 * @return Value of label (never NULL)
147 * If label images.X isn't found then the return value is
148 * <url.static>X.png, allowing url.static to be used to provide a base
149 * for all images with per-image overrides.
151 * Otherwise undefined labels expand to their last (dot-separated)
154 const char *option_label(const char *key) {
159 lptr = hash_find(labels, key);
163 if(!strncmp(key, "images.", 7)) {
164 static const char *url_static;
165 /* images.X defaults to <url.static>X.png */
168 url_static = option_label("url.static");
169 byte_xasprintf((char **)&label, "%s%s.png", url_static, key + 7);
170 } else if((label = strrchr(key, '.')))
171 /* X.Y defaults to Y */
174 /* otherwise default to label name */
179 /** @brief Test whether a label exists
180 * @param key Name of label
181 * @return 1 if label exists, otherwise 0
183 * Labels that don't exist still have an expansion (per option_label()
184 * documentation), and possibly not even a placeholder one.
186 int option_label_exists(const char *key) {
188 return !!hash_find(labels, key);
191 /** @brief Return a column list
192 * @param name Context (playing/recent/etc)
193 * @param ncolumns Where to store column count or NULL
194 * @return Pointer to column list
196 char **option_columns(const char *name, int *ncolumns) {
200 c = hash_find(columns, name);
203 *ncolumns = c->ncolumns;