Added basic infrastructure for manipulating settings.
[people/mcb30/gpxe.git] / src / core / settings.c
1 /*
2  * Copyright (C) 2006 Michael Brown <mbrown@fensystems.co.uk>.
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License as
6  * published by the Free Software Foundation; either version 2 of the
7  * License, or any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
17  */
18
19 #include <stdint.h>
20 #include <stdlib.h>
21 #include <string.h>
22 #include <errno.h>
23 #include <assert.h>
24 #include <gpxe/settings.h>
25
26 /** @file
27  *
28  * Configuration settings
29  *
30  */
31
32 /** Registered configuration setting types */
33 static struct config_setting_type
34 config_setting_types[0] __table_start ( config_setting_types );
35 static struct config_setting_type
36 config_setting_types_end[0] __table_end ( config_setting_types );
37
38 /** Registered configuration settings */
39 static struct config_setting
40 config_settings[0] __table_start ( config_settings );
41 static struct config_setting
42 config_settings_end[0] __table_end ( config_settings );
43
44 /**
45  * Find configuration setting type
46  *
47  * @v name              Name
48  * @ret type            Configuration setting type, or NULL
49  */
50 static struct config_setting_type *
51 find_config_setting_type ( const char *name ) {
52         struct config_setting_type *type;
53
54         for ( type = config_setting_types ; type < config_setting_types_end ;
55               type++ ) {
56                 if ( strcmp ( name, type->name ) == 0 )
57                         return type;
58         }
59         return NULL;
60 }
61
62 /**
63  * Find configuration setting
64  *
65  * @v name              Name
66  * @ret setting         Configuration setting, or NULL
67  */
68 static struct config_setting * find_config_setting ( const char *name ) {
69         struct config_setting *setting;
70
71         for ( setting = config_settings ; setting < config_settings_end ;
72               setting++ ) {
73                 if ( strcmp ( name, setting->name ) == 0 )
74                         return setting;
75         }
76         return NULL;
77 }
78
79 /**
80  * Find or build configuration setting
81  *
82  * @v name              Name
83  * @v tmp_setting       Temporary buffer for constructing a setting
84  * @ret setting         Configuration setting, or NULL
85  *
86  * Find setting if it exists.  If it doesn't exist, but the name is of
87  * the form "<num>.<type>" (e.g. "12.string"), then construct a
88  * setting for that tag and data type, and return it.  The constructed
89  * setting will be placed in the temporary buffer.
90  */
91 static struct config_setting *
92 find_or_build_config_setting ( const char *name,
93                                struct config_setting *tmp_setting ) {
94         struct config_setting *setting;
95         char *separator;
96
97         /* Look in the list of registered settings first */
98         setting = find_config_setting ( name );
99         if ( setting )
100                 return setting;
101
102         /* If name is of the form "<num>.<type>", try to construct a setting */
103         setting = tmp_setting;
104         memset ( setting, 0, sizeof ( *setting ) );
105         setting->name = name;
106         setting->tag = strtoul ( name, &separator, 10 );
107         if ( *separator != '.' )
108                 return NULL;
109         setting->type = find_config_setting_type ( separator + 1 );
110         if ( ! setting->type )
111                 return NULL;
112         return setting;
113 }
114
115 /** Show value of setting
116  *
117  * @v context           Configuration context
118  * @v name              Configuration setting name
119  * @ret value           Setting value (as a string), or NULL
120  */
121 const char * ( show_setting ) ( struct config_context *context,
122                                 const char *name ) {
123         struct config_setting *setting;
124         struct config_setting tmp_setting;
125
126         setting = find_or_build_config_setting ( name, &tmp_setting );
127         if ( ! setting )
128                 return NULL;
129         return setting->type->show ( context, setting );
130 }
131
132 /** Set value of setting
133  *
134  * @v context           Configuration context
135  * @v name              Configuration setting name
136  * @v value             Setting value (as a string)
137  * @ret rc              Return status code
138  */
139 int ( set_setting ) ( struct config_context *context, const char *name,
140                       const char *value ) {
141         struct config_setting *setting;
142         struct config_setting tmp_setting;
143
144         setting = find_or_build_config_setting ( name, &tmp_setting );
145         if ( ! setting )
146                 return -ENOENT;
147         return setting->type->set ( context, setting, value );
148 }