]> git.ozlabs.org Git - petitboot/blob - discover/grub2/grub2.h
discover/grub2: Allow URL resources
[petitboot] / discover / grub2 / grub2.h
1 #ifndef GRUB2_H
2 #define GRUB2_H
3
4 #include <discover/device-handler.h>
5
6 #include <stdbool.h>
7 #include <list/list.h>
8
9 struct grub2_script;
10
11 struct grub2_word {
12         enum {
13                 GRUB2_WORD_TEXT,
14                 GRUB2_WORD_VAR,
15         } type;
16         union {
17                 char            *text;
18                 const char      *name;
19         };
20         bool                    split;
21         struct grub2_word       *next;
22         struct grub2_word       *last;
23         struct list_item        argv_list;
24 };
25
26 struct grub2_argv {
27         struct list             words;
28
29         /* postprocessing (with process_expansions) populates these to hand to
30          * the grub2_command callbacks */
31         char                    **argv;
32         int                     argc;
33 };
34
35 struct grub2_statements {
36         struct list             list;
37 };
38
39 struct grub2_statement {
40         struct list_item        list;
41         enum {
42                 STMT_TYPE_SIMPLE,
43                 STMT_TYPE_MENUENTRY,
44                 STMT_TYPE_IF,
45                 STMT_TYPE_BLOCK,
46                 STMT_TYPE_CONDITIONAL,
47         } type;
48         int                     (*exec)(struct grub2_script *,
49                                         struct grub2_statement *);
50 };
51
52 struct grub2_statement_simple {
53         struct grub2_statement  st;
54         struct grub2_argv       *argv;
55 };
56
57 struct grub2_statement_menuentry {
58         struct grub2_statement  st;
59         struct grub2_argv       *argv;
60         struct grub2_statements *statements;
61 };
62
63 struct grub2_statement_conditional {
64         struct grub2_statement  st;
65         struct grub2_statement  *condition;
66         struct grub2_statements *statements;
67 };
68
69 struct grub2_statement_if {
70         struct grub2_statement  st;
71         struct grub2_statements *conditionals;
72         struct grub2_statements *else_case;
73 };
74
75 struct grub2_statement_block {
76         struct grub2_statement  st;
77         struct grub2_statements *statements;
78 };
79
80 struct grub2_statement_function {
81         struct grub2_statement  st;
82         struct grub2_word       *name;
83         struct grub2_statements *body;
84 };
85
86 struct grub2_script {
87         struct grub2_statements         *statements;
88         struct list                     environment;
89         struct list                     symtab;
90         struct discover_context         *ctx;
91         struct discover_boot_option     *opt;
92         unsigned int                    n_options;
93 };
94
95 struct grub2_parser {
96         void                    *scanner;
97         struct grub2_script     *script;
98 };
99
100 /* type for builtin functions */
101 typedef int (*grub2_function)(struct grub2_script *script, void *data,
102                                 int argc, char *argv[]);
103
104 struct grub2_statements *create_statements(struct grub2_parser *parser);
105
106 struct grub2_statement *create_statement_simple(struct grub2_parser *parser,
107                 struct grub2_argv *argv);
108
109 struct grub2_statement *create_statement_menuentry(struct grub2_parser *parser,
110                 struct grub2_argv *argv, struct grub2_statements *stmts);
111
112 struct grub2_statement *create_statement_conditional(
113                 struct grub2_parser *parser, struct grub2_statement *condition,
114                 struct grub2_statements *statements);
115
116 struct grub2_statement *create_statement_if(struct grub2_parser *parser,
117                 struct grub2_statement *conditional,
118                 struct grub2_statements *elifs,
119                 struct grub2_statements *else_case);
120
121 struct grub2_statement *create_statement_block(struct grub2_parser *parser,
122                 struct grub2_statements *stmts);
123
124 struct grub2_statement *create_statement_function(struct grub2_parser *parser,
125                 struct grub2_word *name, struct grub2_statements *body);
126
127 struct grub2_word *create_word_text(struct grub2_parser *parser,
128                 const char *text);
129
130 struct grub2_word *create_word_var(struct grub2_parser *parser,
131                 const char *name, bool split);
132
133 struct grub2_argv *create_argv(struct grub2_parser *parser);
134
135 void statement_append(struct grub2_statements *stmts,
136                 struct grub2_statement *stmt);
137
138 void argv_append(struct grub2_argv *argv, struct grub2_word *word);
139
140 void word_append(struct grub2_word *w1, struct grub2_word *w2);
141
142 /* script interface */
143 void script_execute(struct grub2_script *script);
144
145 int statement_simple_execute(struct grub2_script *script,
146                 struct grub2_statement *statement);
147 int statement_block_execute(struct grub2_script *script,
148                 struct grub2_statement *statement);
149 int statement_if_execute(struct grub2_script *script,
150                 struct grub2_statement *statement);
151 int statement_menuentry_execute(struct grub2_script *script,
152                 struct grub2_statement *statement);
153 int statement_function_execute(struct grub2_script *script,
154                 struct grub2_statement *statement);
155
156 struct grub2_script *create_script(struct grub2_parser *parser,
157                 struct discover_context *ctx);
158
159 const char *script_env_get(struct grub2_script *script, const char *name);
160
161 void script_env_set(struct grub2_script *script,
162                 const char *name, const char *value);
163
164 void script_register_function(struct grub2_script *script,
165                 const char *name, grub2_function fn, void *data);
166
167 void register_builtins(struct grub2_script *script);
168
169 /* resources */
170 struct resource *create_grub2_resource(struct discover_boot_option *opt,
171                 struct discover_device *orig_device,
172                 const char *root, const char *path);
173
174 bool resolve_grub2_resource(struct device_handler *handler,
175                 struct resource *res);
176
177 /* external parser api */
178 struct grub2_parser *grub2_parser_create(struct discover_context *ctx);
179 void grub2_parser_parse(struct grub2_parser *parser, char *buf, int len);
180 #endif /* GRUB2_H */
181