source: variable.c @ 237d02c

release-1.10release-1.8release-1.9
Last change on this file since 237d02c was d4927a7, checked in by Anders Kaseorg <andersk@mit.edu>, 13 years ago
Replace owl_strdup with g_strdup. Signed-off-by: Anders Kaseorg <andersk@mit.edu> Reviewed-by: Karl Ramm <kcr@mit.edu>
  • Property mode set to 100644
File size: 36.7 KB
Line 
1#include <stdio.h>
2#include <stdlib.h>
3#include <string.h>
4#include <unistd.h>
5#include <ctype.h>
6#include "owl.h"
7
8#define OWLVAR_BOOL(name,default,summary,description) \
9        { name, OWL_VARIABLE_BOOL, NULL, default, "on,off", summary,description, NULL, \
10        NULL, NULL, NULL, NULL, NULL, NULL }
11
12#define OWLVAR_BOOL_FULL(name,default,summary,description,validate,set,get) \
13        { name, OWL_VARIABLE_BOOL, NULL, default, "on,off", summary,description, NULL, \
14        validate, set, NULL, get, NULL, NULL }
15
16#define OWLVAR_INT(name,default,summary,description) \
17        { name, OWL_VARIABLE_INT, NULL, default, "<int>", summary,description, NULL, \
18        NULL, NULL, NULL, NULL, NULL, NULL }
19
20#define OWLVAR_INT_FULL(name,default,summary,description,validset,validate,set,get) \
21        { name, OWL_VARIABLE_INT, NULL, default, validset, summary,description, NULL, \
22        validate, set, NULL, get, NULL, NULL }
23
24#define OWLVAR_PATH(name,default,summary,description) \
25        { name, OWL_VARIABLE_STRING, default, 0, "<path>", summary,description,  NULL, \
26        NULL, NULL, NULL, NULL, NULL, NULL }
27
28#define OWLVAR_STRING(name,default,summary,description) \
29        { name, OWL_VARIABLE_STRING, default, 0, "<string>", summary,description, NULL, \
30        NULL, NULL, NULL, NULL, NULL, NULL }
31
32#define OWLVAR_STRING_FULL(name,default,summary,description,validate,set,get) \
33        { name, OWL_VARIABLE_STRING, default, 0, "<string>", summary,description, NULL, \
34        validate, set, NULL, get, NULL, NULL }
35
36/* enums are really integers, but where validset is a comma-separated
37 * list of strings which can be specified.  The tokens, starting at 0,
38 * correspond to the values that may be specified. */
39#define OWLVAR_ENUM(name,default,summary,description,validset) \
40        { name, OWL_VARIABLE_INT, NULL, default, validset, summary,description, NULL, \
41        owl_variable_enum_validate, \
42        NULL, owl_variable_enum_set_fromstring, \
43        NULL, owl_variable_enum_get_tostring, \
44        NULL }
45
46#define OWLVAR_ENUM_FULL(name,default,summary,description,validset,validate, set, get) \
47        { name, OWL_VARIABLE_INT, NULL, default, validset, summary,description, NULL, \
48        validate, \
49        set, owl_variable_enum_set_fromstring, \
50        get, owl_variable_enum_get_tostring, \
51        NULL }
52
53static owl_variable variables_to_init[] = {
54
55  OWLVAR_STRING( "personalbell" /* %OwlVarStub */, "off",
56                 "ring the terminal bell when personal messages are received",
57                 "Can be set to 'on', 'off', or the name of a filter which\n"
58                 "messages need to match in order to ring the bell"),
59
60  OWLVAR_BOOL( "bell" /* %OwlVarStub */, 1,
61               "enable / disable the terminal bell", "" ),
62
63  OWLVAR_BOOL_FULL( "debug" /* %OwlVarStub */, OWL_DEBUG,
64                    "whether debugging is enabled",
65                    "If set to 'on', debugging messages are logged to the\n"
66                    "file specified by the debugfile variable.\n",
67                    NULL, owl_variable_debug_set, NULL),
68
69  OWLVAR_BOOL( "startuplogin" /* %OwlVarStub */, 1,
70               "send a login message when owl starts", "" ),
71
72  OWLVAR_BOOL( "shutdownlogout" /* %OwlVarStub */, 1,
73               "send a logout message when owl exits", "" ),
74
75  OWLVAR_BOOL( "rxping" /* %OwlVarStub */, 0,
76               "display received pings", "" ),
77
78  OWLVAR_BOOL( "txping" /* %OwlVarStub */, 1,
79               "send pings", "" ),
80
81  OWLVAR_BOOL( "sepbar_disable" /* %OwlVarStub */, 0,
82               "disable printing information in the separator bar", "" ),
83
84  OWLVAR_BOOL( "smartstrip" /* %OwlVarStub */, 1,
85               "strip kerberos instance for reply", ""),
86
87  OWLVAR_BOOL( "newlinestrip" /* %OwlVarStub */, 1,
88               "strip leading and trailing newlines", ""),
89
90  OWLVAR_BOOL( "displayoutgoing" /* %OwlVarStub */, 1,
91               "display outgoing messages", "" ),
92
93  OWLVAR_BOOL( "loginsubs" /* %OwlVarStub */, 1,
94               "load logins from .anyone on startup", "" ),
95
96  OWLVAR_BOOL( "logging" /* %OwlVarStub */, 0,
97               "turn personal logging on or off", 
98               "If this is set to on, personal messages are\n"
99               "logged in the directory specified\n"
100               "by the 'logpath' variable.  The filename in that\n"
101               "directory is derived from the sender of the message.\n" ),
102
103  OWLVAR_BOOL( "classlogging" /* %OwlVarStub */, 0,
104               "turn class logging on or off",
105               "If this is set to on, class messages are\n"
106               "logged in the directory specified\n"
107               "by the 'classlogpath' variable.\n" 
108               "The filename in that directory is derived from\n"
109               "the name of the class to which the message was sent.\n" ),
110
111  OWLVAR_ENUM( "loggingdirection" /* %OwlVarStub */, OWL_LOGGING_DIRECTION_BOTH,
112               "specifies which kind of messages should be logged",
113               "Can be one of 'both', 'in', or 'out'.  If 'in' is\n"
114               "selected, only incoming messages are logged, if 'out'\n"
115               "is selected only outgoing messages are logged.  If 'both'\n"
116               "is selected both incoming and outgoing messages are\n"
117               "logged.",
118               "both,in,out"),
119
120  OWLVAR_BOOL( "colorztext" /* %OwlVarStub */, 1,
121               "allow @color() in zephyrs to change color",
122               "Note that only messages received after this variable\n"
123               "is set will be affected." ),
124
125  OWLVAR_BOOL( "fancylines" /* %OwlVarStub */, 1,
126               "Use 'nice' line drawing on the terminal.",
127               "If turned off, dashes, pipes and pluses will be used\n"
128               "to draw lines on the screen.  Useful when the terminal\n"
129               "is causing problems" ),
130
131  OWLVAR_BOOL( "zcrypt" /* %OwlVarStub */, 1,
132               "Do automatic zcrypt processing",
133               "" ),
134
135  OWLVAR_BOOL_FULL( "pseudologins" /* %OwlVarStub */, 0,
136                    "Enable zephyr pseudo logins",
137                    "When this is enabled, Owl will periodically check the zephyr\n"
138                    "location of users in your .anyone file.  If a user is present\n"
139                    "but sent no login message, or a user is not present that sent no\n"
140                    "logout message, a pseudo login or logout message will be created\n",
141                    NULL, owl_variable_pseudologins_set, NULL),
142
143  OWLVAR_BOOL( "ignorelogins" /* %OwlVarStub */, 0,
144               "Enable printing of login notifications",
145               "When this is enabled, Owl will print login and logout notifications\n"
146               "for AIM, zephyr, or other protocols.  If disabled Owl will not print\n"
147               "login or logout notifications.\n"),
148
149  OWLVAR_STRING( "logfilter" /* %OwlVarStub */, "",
150                 "name of a filter controlling which messages to log",
151
152                 "If non empty, any messages matching the given filter will be logged.\n"
153                 "This is a completely separate mechanism from the other logging\n"
154                 "variables like logging, classlogging, loglogins, loggingdirection,\n"
155                 "etc.  If you want this variable to control all logging, make sure\n"
156                 "all other logging variables are in their default state.\n"),
157
158  OWLVAR_BOOL( "loglogins" /* %OwlVarStub */, 0,
159               "Enable logging of login notifications",
160               "When this is enabled, Owl will login login and logout notifications\n"
161               "for AIM, zephyr, or other protocols.  If disabled Owl will not print\n"
162               "login or logout notifications.\n"),
163
164  OWLVAR_ENUM_FULL( "disable-ctrl-d" /* %OwlVarStub:lockout_ctrld */, 1,
165                    "don't send zephyrs on C-d",
166                    "If set to 'off', C-d won't send a zephyr from the edit\n"
167                    "window.  If set to 'on', C-d will always send a zephyr\n"
168                    "being composed in the edit window.  If set to 'middle',\n"
169                    "C-d will only ever send a zephyr if the cursor is at\n"
170                    "the end of the message being composed.\n\n"
171                    "Note that this works by changing the C-d keybinding\n"
172                    "in the editmulti keymap.\n",
173                    "off,middle,on",
174                    NULL, owl_variable_disable_ctrl_d_set, NULL),
175
176  OWLVAR_PATH( "logpath" /* %OwlVarStub */, "~/zlog/people",
177               "path for logging personal zephyrs", 
178               "Specifies a directory which must exist.\n"
179               "Files will be created in the directory for each sender.\n"),
180
181  OWLVAR_PATH( "classlogpath" /* %OwlVarStub:classlogpath */, "~/zlog/class",
182               "path for logging class zephyrs",
183               "Specifies a directory which must exist.\n"
184               "Files will be created in the directory for each class.\n"),
185
186  OWLVAR_PATH( "debug_file" /* %OwlVarStub */, OWL_DEBUG_FILE,
187               "path for logging debug messages when debugging is enabled",
188               "This file will be logged to if 'debug' is set to 'on'.\n"
189               "BarnOwl will append a dot and the current process's pid to the filename."),
190 
191  OWLVAR_PATH( "zsigproc" /* %OwlVarStub:zsigproc */, NULL,
192               "name of a program to run that will generate zsigs",
193               "This program should produce a zsig on stdout when run.\n"
194               "Note that it is important that this program not block.\n\n"
195               "See the documentation for 'zsig' for more information about\n"
196               "how the outgoing zsig is chosen."
197               ),
198
199  OWLVAR_PATH( "newmsgproc" /* %OwlVarStub:newmsgproc */, NULL,
200               "name of a program to run when new messages are present",
201               "The named program will be run when owl receives new\n"
202               "messages.  It will not be run again until the first\n"
203               "instance exits"),
204
205  OWLVAR_STRING( "zsender" /* %OwlVarStub */, "",
206             "zephyr sender name",
207         "Allows you to customize the outgoing username in\n"
208         "zephyrs.  If this is unset, it will use your Kerberos\n"
209         "principal. Note that customizing the sender name will\n"
210         "cause your zephyrs to be sent unauthenticated."),
211
212  OWLVAR_STRING( "zsigfunc" /* %OwlVarStub */, "BarnOwl::default_zephyr_signature()",
213                 "zsig perl function",
214                 "Called every time you start a zephyrgram without an\n"
215                 "explicit zsig.  The default setting implements the policy\n"
216                 "described in the documentation for the 'zsig' variable.\n"
217                 "See also BarnOwl::random_zephyr_signature().\n"),
218
219  OWLVAR_STRING( "zsig" /* %OwlVarStub */, "",
220                 "zephyr signature",
221                 "The zsig to get on outgoing messages. If this variable is\n"
222                 "unset, 'zsigproc' will be run to generate a zsig. If that is\n"
223                 "also unset, the 'zwrite-signature' zephyr variable will be\n"
224                 "used instead.\n"),
225
226  OWLVAR_STRING( "appendtosepbar" /* %OwlVarStub */, "",
227                 "string to append to the end of the sepbar",
228                 "The sepbar is the bar separating the top and bottom\n"
229                 "of the owl screen.  Any string specified here will\n"
230                 "be displayed on the right of the sepbar\n"),
231
232  OWLVAR_BOOL( "zaway" /* %OwlVarStub */, 0,
233               "turn zaway on or off", "" ),
234
235  OWLVAR_STRING( "zaway_msg" /* %OwlVarStub */, 
236                 OWL_DEFAULT_ZAWAYMSG,
237                 "zaway msg for responding to zephyrs when away", "" ),
238
239  OWLVAR_STRING( "zaway_msg_default" /* %OwlVarStub */, 
240                 OWL_DEFAULT_ZAWAYMSG,
241                 "default zaway message", "" ),
242
243  OWLVAR_BOOL_FULL( "aaway" /* %OwlVarStub */, 0,
244                    "Set AIM away status",
245                    "",
246                    NULL, owl_variable_aaway_set, NULL),
247
248  OWLVAR_STRING( "aaway_msg" /* %OwlVarStub */, 
249                 OWL_DEFAULT_AAWAYMSG,
250                 "AIM away msg for responding when away", "" ),
251
252  OWLVAR_STRING( "aaway_msg_default" /* %OwlVarStub */, 
253                 OWL_DEFAULT_AAWAYMSG,
254                 "default AIM away message", "" ),
255
256  OWLVAR_STRING( "view_home" /* %OwlVarStub */, "all",
257                 "home view to switch to after 'X' and 'V'", 
258                 "SEE ALSO: view, filter\n" ),
259
260  OWLVAR_STRING( "alert_filter" /* %OwlVarStub */, "none",
261                 "filter on which to trigger alert actions",
262                 "" ),
263
264  OWLVAR_STRING( "alert_action" /* %OwlVarStub */, "nop",
265                 "owl command to execute for alert actions",
266                 "" ),
267
268  OWLVAR_STRING_FULL( "tty" /* %OwlVarStub */, "", "tty name for zephyr location", "",
269                      NULL, owl_variable_tty_set, NULL),
270
271  OWLVAR_STRING( "default_style" /* %OwlVarStub */, "default",
272                 "name of the default formatting style",
273                 "This sets the default message formatting style.\n"
274                 "Styles may be created with the 'style' command.\n"
275                 "Some built-in styles include:\n"
276                 "   default  - the default owl formatting\n"
277                 "   oneline  - one line per-message\n"
278                 "   perl     - legacy perl interface\n"
279                 "\nSEE ALSO: style, show styles, view -s <style>\n"
280                 ),
281
282
283  OWLVAR_INT(    "edit:maxfillcols" /* %OwlVarStub:edit_maxfillcols */, 70,
284                 "maximum number of columns for M-q (edit:fill-paragraph) to fill text to",
285                 "This specifies the maximum number of columns for M-q to fill text\n"
286                 "to.  If set to 0, M-q will wrap to the width of the window, and\n"
287                 "values less than 0 disable M-q entirely.\n"),
288
289  OWLVAR_INT(    "edit:maxwrapcols" /* %OwlVarStub:edit_maxwrapcols */, 70,
290                 "maximum number of columns for line-wrapping",
291                 "This specifies the maximum number of columns for\n"
292                 "auto-line-wrapping.  If set to 0, text will be wrapped at the\n"
293                 "window width. Values less than 0 disable automatic wrapping.\n"
294                 "\n"
295                 "As a courtesy to recipients, it is recommended that outgoing\n"
296                 "Zephyr messages be no wider than 70 columns.\n"),
297
298  OWLVAR_INT( "aim_ignorelogin_timer" /* %OwlVarStub */, 15,
299              "number of seconds after AIM login to ignore login messages",
300              "This specifies the number of seconds to wait after an\n"
301              "AIM login before allowing the receipt of AIM login notifications.\n"
302              "By default this is set to 15.  If you would like to view login\n"
303              "notifications of buddies as soon as you login, set it to 0 instead."),
304
305             
306  OWLVAR_INT_FULL( "typewinsize" /* %OwlVarStub:typwin_lines */, 
307                   OWL_TYPWIN_SIZE,
308                  "number of lines in the typing window", 
309                   "This specifies the height of the window at the\n"
310                   "bottom of the screen where commands are entered\n"
311                   "and where messages are composed.\n",
312                   "int > 0",
313                   owl_variable_int_validate_gt0,
314                   owl_variable_typewinsize_set,
315                   NULL /* use default for get */
316                   ),
317
318  OWLVAR_INT( "typewindelta" /* %OwlVarStub */, 0,
319                  "number of lines to add to the typing window when in use",
320                   "On small screens you may want the typing window to\n"
321                   "auto-hide when not entering a command or message.\n"
322                   "This variable is the number of lines to add to the\n"
323           "typing window when it is in use; you can then set\n"
324           "typewinsize to 1.\n\n"
325           "This works a lot better with a non-default scrollmode;\n"
326           "try :set scrollmode pagedcenter.\n"),
327
328  OWLVAR_ENUM( "scrollmode" /* %OwlVarStub */, OWL_SCROLLMODE_NORMAL,
329               "how to scroll up and down",
330               "This controls how the screen is scrolled as the\n"
331               "cursor moves between messages being displayed.\n"
332               "The following modes are supported:\n\n"
333               "   normal      - This is the owl default.  Scrolling happens\n"
334               "                 when it needs to, and an attempt is made to\n"
335               "                 keep the current message roughly near\n"
336               "                 the middle of the screen.\n"
337               "   top         - The current message will always be the\n"
338               "                 the top message displayed.\n"
339               "   neartop     - The current message will be one down\n"
340               "                 from the top message displayed,\n"
341               "                 where possible.\n"
342               "   center      - An attempt is made to keep the current\n"
343               "                 message near the center of the screen.\n"
344               "   paged       - The top message displayed only changes\n"
345               "                 when user moves the cursor to the top\n"
346               "                 or bottom of the screen.  When it moves,\n"
347               "                 the screen will be paged up or down and\n"
348               "                 the cursor will be near the top or\n"
349               "                 the bottom.\n"
350               "   pagedcenter - The top message displayed only changes\n"
351               "                 when user moves the cursor to the top\n"
352               "                 or bottom of the screen.  When it moves,\n"
353               "                 the screen will be paged up or down and\n"
354               "                 the cursor will be near the center.\n",
355               "normal,top,neartop,center,paged,pagedcenter" ),
356
357  OWLVAR_BOOL( "narrow-related" /* %OwlVarStub:narrow_related */, 1,
358               "Make smartnarrow use broader filters",
359               "Causes smartfiler to narrow to messages \"related\" to \n"
360               "the current message, as well as ones to the same place.\n\n"
361               "for Zephyr, this controls whether to narrow to e.g. class-help or\n"
362               "class-help.d alone, or to related-class-help, which includes\n"
363               "help, unhelp, help.d, etc.\n\nDefault is true (include unclasses, etc.).\n" ),
364
365  OWLVAR_BOOL( "_followlast" /* %OwlVarStub */, 0,
366               "enable automatic following of the last zephyr",
367               "If the cursor is at the last message, it will\n"
368               "continue to follow the last message if this is set.\n"
369               "Note that this is currently risky as you might accidentally\n"
370               "delete a message right as it came in.\n" ),
371
372  /* This MUST be last... */
373  { NULL, 0, NULL, 0, NULL, NULL, NULL, NULL,
374    NULL, NULL, NULL, NULL, NULL, NULL }
375
376};
377
378/**************************************************************************/
379/*********************** SPECIFIC TO VARIABLES ****************************/
380/**************************************************************************/
381
382
383/* commonly useful */
384
385int owl_variable_int_validate_gt0(const owl_variable *v, const void *newval)
386{
387  if (newval == NULL) return(0);
388  else if (*(const int*)newval < 1) return(0);
389  else return (1);
390}
391
392int owl_variable_int_validate_positive(const owl_variable *v, const void *newval)
393{
394  if (newval == NULL) return(0);
395  else if (*(const int*)newval < 0) return(0);
396  else return (1);
397}
398
399/* typewinsize */
400int owl_variable_typewinsize_set(owl_variable *v, const void *newval)
401{
402  int rv;
403  rv = owl_variable_int_set_default(v, newval);
404  if (0 == rv) owl_mainpanel_layout_contents(&g.mainpanel);
405  return(rv);
406}
407
408/* debug (cache value in g->debug) */
409int owl_variable_debug_set(owl_variable *v, const void *newval)
410{
411  if (newval && (*(const int*)newval == 1 || *(const int*)newval == 0)) {
412    g.debug = *(const int*)newval;
413  }
414  return owl_variable_bool_set_default(v, newval);
415}
416
417/* When 'aaway' is changed, need to notify the AIM server */
418int owl_variable_aaway_set(owl_variable *v, const void *newval)
419{
420  if (newval) {
421    if (*(const int*)newval == 1) {
422      owl_aim_set_awaymsg(owl_global_get_aaway_msg(&g));
423    } else if (*(const int*)newval == 0) {
424      owl_aim_set_awaymsg("");
425    }
426  }
427  return owl_variable_bool_set_default(v, newval);
428}
429
430int owl_variable_pseudologins_set(owl_variable *v, const void *newval)
431{
432  static owl_timer *timer = NULL;
433  if (newval) {
434    if (*(const int*)newval == 1) {
435      owl_function_zephyr_buddy_check(0);
436      if (timer == NULL) {
437        timer = owl_select_add_timer("owl_zephyr_buddycheck_timer",
438                                     180, 180, owl_zephyr_buddycheck_timer, NULL, NULL);
439      }
440    } else {
441      if (timer != NULL) {
442        owl_select_remove_timer(timer);
443        timer = NULL;
444      }
445    }
446  }
447  return owl_variable_bool_set_default(v, newval);
448}
449
450/* note that changing the value of this will clobber
451 * any user setting of this */
452int owl_variable_disable_ctrl_d_set(owl_variable *v, const void *newval)
453{
454  if (newval && !owl_context_is_startup(owl_global_get_context(&g))) {
455    if (*(const int*)newval == 2) {
456      owl_function_command_norv("bindkey editmulti C-d command edit:delete-next-char");
457    } else if (*(const int*)newval == 1) {
458      owl_function_command_norv("bindkey editmulti C-d command edit:done-or-delete");
459    } else {
460      owl_function_command_norv("bindkey editmulti C-d command edit:done");
461    }
462  } 
463  return owl_variable_int_set_default(v, newval); 
464}
465
466int owl_variable_tty_set(owl_variable *v, const void *newval)
467{
468  owl_zephyr_set_locationinfo(owl_global_get_hostname(&g), newval);
469  return(owl_variable_string_set_default(v, newval));
470}
471
472
473/**************************************************************************/
474/****************************** GENERAL ***********************************/
475/**************************************************************************/
476
477int owl_variable_dict_setup(owl_vardict *vd) {
478  owl_variable *var, *cur;
479  if (owl_dict_create(vd)) return(-1);
480  for (var = variables_to_init; var->name != NULL; var++) {
481    cur = g_new(owl_variable, 1);
482    *cur = *var;
483    /* strdup all the strings so we can delete them consistently. */
484    cur->name = g_strdup(var->name);
485    cur->summary = g_strdup(var->summary);
486    cur->description = g_strdup(var->description);
487    switch (cur->type) {
488    case OWL_VARIABLE_OTHER:
489      cur->set_fn(cur, cur->pval_default);
490      break;
491    case OWL_VARIABLE_STRING:
492      if (!cur->validate_fn) 
493        cur->validate_fn = owl_variable_string_validate_default;
494      if (!cur->set_fn) 
495        cur->set_fn = owl_variable_string_set_default;
496      if (!cur->set_fromstring_fn) 
497        cur->set_fromstring_fn = owl_variable_string_set_fromstring_default;
498      if (!cur->get_fn) 
499        cur->get_fn = owl_variable_get_default;
500      if (!cur->get_tostring_fn) 
501        cur->get_tostring_fn = owl_variable_string_get_tostring_default;     
502      if (!cur->delete_fn)
503        cur->delete_fn = owl_variable_delete_default;
504      cur->set_fn(cur, cur->pval_default);
505      break;
506    case OWL_VARIABLE_BOOL:
507      if (!cur->validate_fn) 
508        cur->validate_fn = owl_variable_bool_validate_default;
509      if (!cur->set_fn) 
510        cur->set_fn = owl_variable_bool_set_default;
511      if (!cur->set_fromstring_fn) 
512        cur->set_fromstring_fn = owl_variable_bool_set_fromstring_default;
513      if (!cur->get_fn) 
514        cur->get_fn = owl_variable_get_default;
515      if (!cur->get_tostring_fn) 
516        cur->get_tostring_fn = owl_variable_bool_get_tostring_default;     
517      if (!cur->delete_fn)
518        cur->delete_fn = owl_variable_delete_default;
519      cur->val = g_new(int, 1);
520      cur->set_fn(cur, &cur->ival_default);
521      break;
522    case OWL_VARIABLE_INT:
523      if (!cur->validate_fn) 
524        cur->validate_fn = owl_variable_int_validate_default;
525      if (!cur->set_fn) 
526        cur->set_fn = owl_variable_int_set_default;
527      if (!cur->set_fromstring_fn) 
528        cur->set_fromstring_fn = owl_variable_int_set_fromstring_default;
529      if (!cur->get_fn) 
530        cur->get_fn = owl_variable_get_default;
531      if (!cur->get_tostring_fn) 
532        cur->get_tostring_fn = owl_variable_int_get_tostring_default;     
533      if (!cur->delete_fn)
534        cur->delete_fn = owl_variable_delete_default;
535      cur->val = g_new(int, 1);
536      cur->set_fn(cur, &cur->ival_default);
537      break;
538    default:
539      fprintf(stderr, "owl_variable_setup: invalid variable type\n");
540      return(-2);
541    }
542    owl_dict_insert_element(vd, cur->name, cur, NULL);
543  }
544  return 0;
545}
546
547void owl_variable_dict_add_variable(owl_vardict * vardict,
548                                    owl_variable * var) {
549  owl_dict_insert_element(vardict, var->name, var, (void (*)(void *))owl_variable_delete);
550}
551
552owl_variable * owl_variable_newvar(const char *name, const char *summary, const char * description) {
553  owl_variable * var = g_new0(owl_variable, 1);
554  var->name = g_strdup(name);
555  var->summary = g_strdup(summary);
556  var->description = g_strdup(description);
557  return var;
558}
559
560void owl_variable_update(owl_variable *var, const char *summary, const char *desc) {
561  if(var->summary) g_free(var->summary);
562  var->summary = g_strdup(summary);
563  if(var->description) g_free(var->description);
564  var->description = g_strdup(desc);
565}
566
567void owl_variable_dict_newvar_string(owl_vardict * vd, const char *name, const char *summ, const char * desc, const char * initval) {
568  owl_variable *old = owl_variable_get_var(vd, name, OWL_VARIABLE_STRING);
569  if(old) {
570    owl_variable_update(old, summ, desc);
571    if(old->pval_default) g_free(old->pval_default);
572    old->pval_default = g_strdup(initval);
573  } else {
574    owl_variable * var = owl_variable_newvar(name, summ, desc);
575    var->type = OWL_VARIABLE_STRING;
576    var->pval_default = g_strdup(initval);
577    var->set_fn = owl_variable_string_set_default;
578    var->set_fromstring_fn = owl_variable_string_set_fromstring_default;
579    var->get_fn = owl_variable_get_default;
580    var->get_tostring_fn = owl_variable_string_get_tostring_default;
581    var->delete_fn = owl_variable_delete_default;
582    var->set_fn(var, initval);
583    owl_variable_dict_add_variable(vd, var);
584  }
585}
586
587void owl_variable_dict_newvar_int(owl_vardict * vd, const char *name, const char *summ, const char * desc, int initval) {
588  owl_variable *old = owl_variable_get_var(vd, name, OWL_VARIABLE_INT);
589  if(old) {
590    owl_variable_update(old, summ, desc);
591    old->ival_default = initval;
592  } else {
593    owl_variable * var = owl_variable_newvar(name, summ, desc);
594    var->type = OWL_VARIABLE_INT;
595    var->ival_default = initval;
596    var->validate_fn = owl_variable_int_validate_default;
597    var->set_fn = owl_variable_int_set_default;
598    var->set_fromstring_fn = owl_variable_int_set_fromstring_default;
599    var->get_fn = owl_variable_get_default;
600    var->get_tostring_fn = owl_variable_int_get_tostring_default;
601    var->delete_fn = owl_variable_delete_default;
602    var->val = g_new(int, 1);
603    var->set_fn(var, &initval);
604    owl_variable_dict_add_variable(vd, var);
605  }
606}
607
608void owl_variable_dict_newvar_bool(owl_vardict * vd, const char *name, const char *summ, const char * desc, int initval) {
609  owl_variable *old = owl_variable_get_var(vd, name, OWL_VARIABLE_BOOL);
610  if(old) {
611    owl_variable_update(old, summ, desc);
612    old->ival_default = initval;
613  } else {
614    owl_variable * var = owl_variable_newvar(name, summ, desc);
615    var->type = OWL_VARIABLE_BOOL;
616    var->ival_default = initval;
617    var->validate_fn = owl_variable_bool_validate_default;
618    var->set_fn = owl_variable_bool_set_default;
619    var->set_fromstring_fn = owl_variable_bool_set_fromstring_default;
620    var->get_fn = owl_variable_get_default;
621    var->get_tostring_fn = owl_variable_bool_get_tostring_default;
622    var->delete_fn = owl_variable_delete_default;
623    var->val = g_new(int, 1);
624    var->set_fn(var, &initval);
625    owl_variable_dict_add_variable(vd, var);
626  }
627}
628
629void owl_variable_dict_cleanup(owl_vardict *d)
630{
631  owl_dict_cleanup(d, (void (*)(void *))owl_variable_delete);
632}
633
634/* free the list with owl_variable_dict_namelist_cleanup */
635void owl_variable_dict_get_names(const owl_vardict *d, owl_list *l) {
636  owl_dict_get_keys(d, l);
637}
638
639void owl_variable_dict_namelist_cleanup(owl_list *l)
640{
641  owl_list_cleanup(l, g_free);
642}
643
644void owl_variable_delete(owl_variable *v)
645{
646  if (v->delete_fn) v->delete_fn(v);
647  g_free(v->name);
648  g_free(v->summary);
649  g_free(v->description);
650  g_free(v);
651}
652
653
654const char *owl_variable_get_description(const owl_variable *v) {
655  return v->description;
656}
657
658const char *owl_variable_get_summary(const owl_variable *v) {
659  return v->summary;
660}
661
662const char *owl_variable_get_validsettings(const owl_variable *v) {
663  if (v->validsettings) {
664    return v->validsettings;
665  } else {
666    return "";
667  }
668}
669
670/* functions for getting and setting variable values */
671
672/* returns 0 on success, prints a status msg if msg is true */
673int owl_variable_set_fromstring(owl_vardict *d, const char *name, const char *value, int msg, int requirebool) {
674  owl_variable *v;
675  char buff2[1024];
676  if (!name) return(-1);
677  v = owl_dict_find_element(d, name);
678  if (v == NULL) {
679    if (msg) owl_function_error("Unknown variable %s", name);
680    return -1;
681  }
682  if (!v->set_fromstring_fn) {
683    if (msg) owl_function_error("Variable %s is read-only", name);
684    return -1;   
685  }
686  if (requirebool && v->type!=OWL_VARIABLE_BOOL) {
687    if (msg) owl_function_error("Variable %s is not a boolean", name);
688    return -1;   
689  }
690  if (0 != v->set_fromstring_fn(v, value)) {
691    if (msg) owl_function_error("Unable to set %s (must be %s)", name, 
692                                  owl_variable_get_validsettings(v));
693    return -1;
694  }
695  if (msg && v->get_tostring_fn) {
696    v->get_tostring_fn(v, buff2, 1024, v->val);
697    owl_function_makemsg("%s = '%s'", name, buff2);
698  }   
699  return 0;
700}
701 
702int owl_variable_set_string(owl_vardict *d, const char *name, const char *newval) {
703  owl_variable *v;
704  if (!name) return(-1);
705  v = owl_dict_find_element(d, name);
706  if (v == NULL || !v->set_fn) return(-1);
707  if (v->type!=OWL_VARIABLE_STRING) return(-1);
708  return v->set_fn(v, newval);
709}
710 
711int owl_variable_set_int(owl_vardict *d, const char *name, int newval) {
712  owl_variable *v;
713  if (!name) return(-1);
714  v = owl_dict_find_element(d, name);
715  if (v == NULL || !v->set_fn) return(-1);
716  if (v->type!=OWL_VARIABLE_INT && v->type!=OWL_VARIABLE_BOOL) return(-1);
717  return v->set_fn(v, &newval);
718}
719 
720int owl_variable_set_bool_on(owl_vardict *d, const char *name) {
721  return owl_variable_set_int(d,name,1);
722}
723
724int owl_variable_set_bool_off(owl_vardict *d, const char *name) {
725  return owl_variable_set_int(d,name,0);
726}
727
728int owl_variable_get_tostring(const owl_vardict *d, const char *name, char *buf, int bufsize) {
729  owl_variable *v;
730  if (!name) return(-1);
731  v = owl_dict_find_element(d, name);
732  if (v == NULL || !v->get_tostring_fn) return(-1);
733  return v->get_tostring_fn(v, buf, bufsize, v->val);
734}
735
736int owl_variable_get_default_tostring(const owl_vardict *d, const char *name, char *buf, int bufsize) {
737  owl_variable *v;
738  if (!name) return(-1);
739  v = owl_dict_find_element(d, name);
740  if (v == NULL || !v->get_tostring_fn) return(-1);
741  if (v->type == OWL_VARIABLE_INT || v->type == OWL_VARIABLE_BOOL) {
742    return v->get_tostring_fn(v, buf, bufsize, &(v->ival_default));
743  } else {
744    return v->get_tostring_fn(v, buf, bufsize, v->pval_default);
745  }
746}
747
748owl_variable *owl_variable_get_var(const owl_vardict *d, const char *name, int require_type) {
749  owl_variable *v;
750  if (!name) return(NULL);
751  v = owl_dict_find_element(d, name);
752  if (v == NULL || !v->get_fn || v->type != require_type) return(NULL);
753  return v;
754}
755
756/* returns a reference */
757const void *owl_variable_get(const owl_vardict *d, const char *name, int require_type) {
758  owl_variable *v = owl_variable_get_var(d, name, require_type);
759  if(v == NULL) return NULL;
760  return v->get_fn(v);
761}
762
763/* returns a reference */
764const char *owl_variable_get_string(const owl_vardict *d, const char *name) {
765  return owl_variable_get(d,name, OWL_VARIABLE_STRING);
766}
767
768/* returns a reference */
769const void *owl_variable_get_other(const owl_vardict *d, const char *name) {
770  return owl_variable_get(d,name, OWL_VARIABLE_OTHER);
771}
772
773int owl_variable_get_int(const owl_vardict *d, const char *name) {
774  const int *pi;
775  pi = owl_variable_get(d,name,OWL_VARIABLE_INT);
776  if (!pi) return(-1);
777  return(*pi);
778}
779
780int owl_variable_get_bool(const owl_vardict *d, const char *name) {
781  const int *pi;
782  pi = owl_variable_get(d,name,OWL_VARIABLE_BOOL);
783  if (!pi) return(-1);
784  return(*pi);
785}
786
787void owl_variable_describe(const owl_vardict *d, const char *name, owl_fmtext *fm) {
788  char defaultbuf[50];
789  char buf[1024];
790  int buflen = 1023;
791  owl_variable *v;
792
793  if (!name
794      || (v = owl_dict_find_element(d, name)) == NULL 
795      || !v->get_fn) {
796    snprintf(buf, buflen, "     No such variable '%s'\n", name);     
797    owl_fmtext_append_normal(fm, buf);
798    return;
799  }
800  if (v->type == OWL_VARIABLE_INT || v->type == OWL_VARIABLE_BOOL) {
801    v->get_tostring_fn(v, defaultbuf, 50, &(v->ival_default));
802  } else {
803    v->get_tostring_fn(v, defaultbuf, 50, v->pval_default);
804  }
805  snprintf(buf, buflen, OWL_TABSTR "%-20s - %s (default: '%s')\n", 
806                  v->name, 
807                  owl_variable_get_summary(v), defaultbuf);
808  owl_fmtext_append_normal(fm, buf);
809}
810
811void owl_variable_get_help(const owl_vardict *d, const char *name, owl_fmtext *fm) {
812  char buff[1024];
813  int bufflen = 1023;
814  owl_variable *v;
815
816  if (!name
817      || (v = owl_dict_find_element(d, name)) == NULL 
818      || !v->get_fn) {
819    owl_fmtext_append_normal(fm, "No such variable...\n");
820    return;
821  }
822
823  owl_fmtext_append_bold(fm, "OWL VARIABLE\n\n");
824  owl_fmtext_append_normal(fm, OWL_TABSTR);
825  owl_fmtext_append_normal(fm, name);
826  owl_fmtext_append_normal(fm, " - ");
827  owl_fmtext_append_normal(fm, v->summary);
828  owl_fmtext_append_normal(fm, "\n\n");
829
830  owl_fmtext_append_normal(fm, "Current:        ");
831  owl_variable_get_tostring(d, name, buff, bufflen);
832  owl_fmtext_append_normal(fm, buff);
833  owl_fmtext_append_normal(fm, "\n\n");
834
835
836  if (v->type == OWL_VARIABLE_INT || v->type == OWL_VARIABLE_BOOL) {
837    v->get_tostring_fn(v, buff, bufflen, &(v->ival_default));
838  } else {
839    v->get_tostring_fn(v, buff, bufflen, v->pval_default);
840  }
841  owl_fmtext_append_normal(fm, "Default:        ");
842  owl_fmtext_append_normal(fm, buff);
843  owl_fmtext_append_normal(fm, "\n\n");
844
845  owl_fmtext_append_normal(fm, "Valid Settings: ");
846  owl_fmtext_append_normal(fm, owl_variable_get_validsettings(v));
847  owl_fmtext_append_normal(fm, "\n\n");
848
849  if (v->description && *v->description) {
850    owl_fmtext_append_normal(fm, "Description:\n");
851    owl_fmtext_append_normal(fm, owl_variable_get_description(v));
852    owl_fmtext_append_normal(fm, "\n\n");
853  }
854}
855
856
857
858
859/**************************************************************************/
860/*********************** GENERAL TYPE-SPECIFIC ****************************/
861/**************************************************************************/
862
863/* default common functions */
864
865const void *owl_variable_get_default(const owl_variable *v) {
866  return v->val;
867}
868
869void owl_variable_delete_default(owl_variable *v)
870{
871  if (v->val) g_free(v->val);
872}
873
874/* default functions for booleans */
875
876int owl_variable_bool_validate_default(const owl_variable *v, const void *newval) {
877  if (newval == NULL) return(0);
878  else if (*(const int*)newval==1 || *(const int*)newval==0) return(1);
879  else return (0);
880}
881
882int owl_variable_bool_set_default(owl_variable *v, const void *newval) {
883  if (v->validate_fn) {
884    if (!v->validate_fn(v, newval)) return(-1);
885  }
886  *(int*)v->val = *(const int*)newval;
887  return(0);
888}
889
890int owl_variable_bool_set_fromstring_default(owl_variable *v, const char *newval) {
891  int i;
892  if (!strcmp(newval, "on")) i=1;
893  else if (!strcmp(newval, "off")) i=0;
894  else return(-1);
895  return (v->set_fn(v, &i));
896}
897
898int owl_variable_bool_get_tostring_default(const owl_variable *v, char* buf, int bufsize, const void *val) {
899  if (val == NULL) {
900    snprintf(buf, bufsize, "<null>");
901    return -1;
902  } else if (*(const int*)val == 0) {
903    snprintf(buf, bufsize, "off");
904    return 0;
905  } else if (*(const int*)val == 1) {
906    snprintf(buf, bufsize, "on");
907    return 0;
908  } else {
909    snprintf(buf, bufsize, "<invalid>");
910    return -1;
911  }
912}
913
914/* default functions for integers */
915
916int owl_variable_int_validate_default(const owl_variable *v, const void *newval) {
917  if (newval == NULL) return(0);
918  else return (1);
919}
920
921int owl_variable_int_set_default(owl_variable *v, const void *newval) {
922  if (v->validate_fn) {
923    if (!v->validate_fn(v, newval)) return(-1);
924  }
925  *(int*)v->val = *(const int*)newval;
926  return(0);
927}
928
929int owl_variable_int_set_fromstring_default(owl_variable *v, const char *newval) {
930  int i;
931  char *ep;
932  i = strtol(newval, &ep, 10);
933  if (*ep || ep==newval) return(-1);
934  return (v->set_fn(v, &i));
935}
936
937int owl_variable_int_get_tostring_default(const owl_variable *v, char* buf, int bufsize, const void *val) {
938  if (val == NULL) {
939    snprintf(buf, bufsize, "<null>");
940    return -1;
941  } else {
942    snprintf(buf, bufsize, "%d", *(const int*)val);
943    return 0;
944  } 
945}
946
947/* default functions for enums (a variant of integers) */
948
949int owl_variable_enum_validate(const owl_variable *v, const void *newval) { 
950  char **enums;
951  int nenums, val;
952  if (newval == NULL) return(0);
953  enums = g_strsplit_set(v->validsettings, ",", 0);
954  nenums = g_strv_length(enums);
955  g_strfreev(enums);
956  val = *(const int*)newval;
957  if (val < 0 || val >= nenums) {
958    return(0);
959  }
960  return(1);
961}
962
963int owl_variable_enum_set_fromstring(owl_variable *v, const char *newval) {
964  char **enums;
965  int i, val=-1;
966  if (newval == NULL) return(-1);
967  enums = g_strsplit_set(v->validsettings, ",", 0);
968  for (i = 0; enums[i] != NULL; i++) {
969    if (0==strcmp(newval, enums[i])) {
970      val = i;
971    }
972  }
973  g_strfreev(enums);
974  if (val == -1) return(-1);
975  return (v->set_fn(v, &val));
976}
977
978int owl_variable_enum_get_tostring(const owl_variable *v, char* buf, int bufsize, const void *val) {
979  char **enums;
980  int nenums, i;
981
982  if (val == NULL) {
983    snprintf(buf, bufsize, "<null>");
984    return -1;
985  }
986  enums = g_strsplit_set(v->validsettings, ",", 0);
987  nenums = g_strv_length(enums);
988  i = *(const int*)val;
989  if (i<0 || i>=nenums) {
990    snprintf(buf, bufsize, "<invalid:%d>",i);
991    g_strfreev(enums);
992    return(-1);
993  }
994  snprintf(buf, bufsize, "%s", enums[i]);
995  g_strfreev(enums);
996  return 0;
997}
998
999/* default functions for stringeans */
1000
1001int owl_variable_string_validate_default(const struct _owl_variable *v, const void *newval) {
1002  if (newval == NULL) return(0);
1003  else return (1);
1004}
1005
1006int owl_variable_string_set_default(owl_variable *v, const void *newval) {
1007  if (v->validate_fn) {
1008    if (!v->validate_fn(v, newval)) return(-1);
1009  }
1010  if (v->val) g_free(v->val);
1011  v->val = g_strdup(newval);
1012  return(0);
1013}
1014
1015int owl_variable_string_set_fromstring_default(owl_variable *v, const char *newval) {
1016  return (v->set_fn(v, newval));
1017}
1018
1019int owl_variable_string_get_tostring_default(const owl_variable *v, char* buf, int bufsize, const void *val) {
1020  if (val == NULL) {
1021    snprintf(buf, bufsize, "<null>");
1022    return -1;
1023  } else {
1024    snprintf(buf, bufsize, "%s", (const char*)val);
1025    return 0;
1026  }
1027}
1028
Note: See TracBrowser for help on using the repository browser.