1
2
3
4
5
6
7
8
9
10#ifndef __COMMAND_H
11#define __COMMAND_H
12
13#include <env.h>
14#include <linker_lists.h>
15
16#ifndef NULL
17#define NULL 0
18#endif
19
20
21#ifndef CONFIG_SYS_HELP_CMD_WIDTH
22#define CONFIG_SYS_HELP_CMD_WIDTH 10
23#endif
24
25#ifndef __ASSEMBLY__
26
27
28
29
30struct cmd_tbl {
31 char *name;
32 int maxargs;
33
34
35
36
37
38
39
40
41 int (*cmd_rep)(struct cmd_tbl *cmd, int flags, int argc,
42 char *const argv[], int *repeatable);
43
44 int (*cmd)(struct cmd_tbl *cmd, int flags, int argc,
45 char *const argv[]);
46 char *usage;
47#ifdef CONFIG_SYS_LONGHELP
48 char *help;
49#endif
50#ifdef CONFIG_AUTO_COMPLETE
51
52 int (*complete)(int argc, char *const argv[],
53 char last_char, int maxv, char *cmdv[]);
54#endif
55};
56
57#if defined(CONFIG_CMD_RUN)
58int do_run(struct cmd_tbl *cmdtp, int flag, int argc,
59 char *const argv[]);
60#endif
61
62
63int _do_help(struct cmd_tbl *cmd_start, int cmd_items, struct cmd_tbl *cmdtp,
64 int flag, int argc, char *const argv[]);
65struct cmd_tbl *find_cmd(const char *cmd);
66struct cmd_tbl *find_cmd_tbl(const char *cmd, struct cmd_tbl *table,
67 int table_len);
68int complete_subcmdv(struct cmd_tbl *cmdtp, int count, int argc,
69 char *const argv[], char last_char, int maxv,
70 char *cmdv[]);
71
72int cmd_usage(const struct cmd_tbl *cmdtp);
73
74
75int cmd_always_repeatable(struct cmd_tbl *cmdtp, int flag, int argc,
76 char *const argv[], int *repeatable);
77int cmd_never_repeatable(struct cmd_tbl *cmdtp, int flag, int argc,
78 char *const argv[], int *repeatable);
79int cmd_discard_repeatable(struct cmd_tbl *cmdtp, int flag, int argc,
80 char *const argv[]);
81
82static inline bool cmd_is_repeatable(struct cmd_tbl *cmdtp)
83{
84 return cmdtp->cmd_rep == cmd_always_repeatable;
85}
86
87#ifdef CONFIG_AUTO_COMPLETE
88int var_complete(int argc, char *const argv[], char last_char, int maxv,
89 char *cmdv[]);
90int cmd_auto_complete(const char *const prompt, char *buf, int *np,
91 int *colp);
92#endif
93
94
95
96
97
98
99
100
101
102
103int cmd_process_error(struct cmd_tbl *cmdtp, int err);
104
105
106
107
108
109
110
111
112
113
114#if defined(CONFIG_CMD_MEMORY) || \
115 defined(CONFIG_CMD_I2C) || \
116 defined(CONFIG_CMD_ITEST) || \
117 defined(CONFIG_CMD_PCI) || \
118 defined(CONFIG_CMD_SETEXPR)
119#define CMD_DATA_SIZE
120#define CMD_DATA_SIZE_ERR (-1)
121#define CMD_DATA_SIZE_STR (-2)
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144int cmd_get_data_size(char *arg, int default_size);
145#endif
146
147#ifdef CONFIG_CMD_BOOTD
148int do_bootd(struct cmd_tbl *cmdtp, int flag, int argc,
149 char *const argv[]);
150#endif
151#ifdef CONFIG_CMD_BOOTM
152int do_bootm(struct cmd_tbl *cmdtp, int flag, int argc,
153 char *const argv[]);
154int bootm_maybe_autostart(struct cmd_tbl *cmdtp, const char *cmd);
155#else
156static inline int bootm_maybe_autostart(struct cmd_tbl *cmdtp, const char *cmd)
157{
158 return 0;
159}
160#endif
161
162int do_bootz(struct cmd_tbl *cmdtp, int flag, int argc,
163 char *const argv[]);
164
165int do_booti(struct cmd_tbl *cmdtp, int flag, int argc,
166 char *const argv[]);
167
168int do_zboot_parent(struct cmd_tbl *cmdtp, int flag, int argc,
169 char *const argv[], int *repeatable);
170
171int common_diskboot(struct cmd_tbl *cmdtp, const char *intf, int argc,
172 char *const argv[]);
173
174int do_reset(struct cmd_tbl *cmdtp, int flag, int argc,
175 char *const argv[]);
176int do_poweroff(struct cmd_tbl *cmdtp, int flag, int argc,
177 char *const argv[]);
178
179unsigned long do_go_exec(ulong (*entry)(int, char * const []), int argc,
180 char *const argv[]);
181
182#if defined(CONFIG_CMD_NVEDIT_EFI)
183int do_env_print_efi(struct cmd_tbl *cmdtp, int flag, int argc,
184 char *const argv[]);
185int do_env_set_efi(struct cmd_tbl *cmdtp, int flag, int argc,
186 char *const argv[]);
187#endif
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203int setexpr_regex_sub(char *data, uint data_size, char *nbuf, uint nbuf_size,
204 const char *r, const char *s, bool global);
205
206
207
208
209
210
211
212
213
214enum command_ret_t {
215 CMD_RET_SUCCESS,
216 CMD_RET_FAILURE,
217 CMD_RET_USAGE = -1,
218};
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234int cmd_process(int flag, int argc, char *const argv[], int *repeatable,
235 unsigned long *ticks);
236
237void fixup_cmdtable(struct cmd_tbl *cmdtp, int size);
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255int board_run_command(const char *cmdline);
256
257int run_command(const char *cmd, int flag);
258int run_command_repeatable(const char *cmd, int flag);
259
260
261
262
263
264
265
266
267
268
269
270
271int run_command_list(const char *cmd, int len, int flag);
272#endif
273
274
275
276
277#define CMD_FLAG_REPEAT 0x0001
278#define CMD_FLAG_BOOTD 0x0002
279#define CMD_FLAG_ENV 0x0004
280
281#ifdef CONFIG_AUTO_COMPLETE
282# define _CMD_COMPLETE(x) x,
283#else
284# define _CMD_COMPLETE(x)
285#endif
286#ifdef CONFIG_SYS_LONGHELP
287# define _CMD_HELP(x) x,
288#else
289# define _CMD_HELP(x)
290#endif
291
292#ifdef CONFIG_NEEDS_MANUAL_RELOC
293#define U_BOOT_SUBCMDS_RELOC(_cmdname) \
294 static void _cmdname##_subcmds_reloc(void) \
295 { \
296 static int relocated; \
297 \
298 if (relocated) \
299 return; \
300 \
301 fixup_cmdtable(_cmdname##_subcmds, \
302 ARRAY_SIZE(_cmdname##_subcmds)); \
303 relocated = 1; \
304 }
305#else
306#define U_BOOT_SUBCMDS_RELOC(_cmdname) \
307 static void _cmdname##_subcmds_reloc(void) { }
308#endif
309
310#define U_BOOT_SUBCMDS_DO_CMD(_cmdname) \
311 static int do_##_cmdname(struct cmd_tbl *cmdtp, int flag, \
312 int argc, char *const argv[], \
313 int *repeatable) \
314 { \
315 struct cmd_tbl *subcmd; \
316 \
317 _cmdname##_subcmds_reloc(); \
318 \
319 \
320 if (argc < 2 || argc > CONFIG_SYS_MAXARGS) \
321 return CMD_RET_USAGE; \
322 \
323 subcmd = find_cmd_tbl(argv[1], _cmdname##_subcmds, \
324 ARRAY_SIZE(_cmdname##_subcmds)); \
325 if (!subcmd || argc - 1 > subcmd->maxargs) \
326 return CMD_RET_USAGE; \
327 \
328 if (flag == CMD_FLAG_REPEAT && \
329 !cmd_is_repeatable(subcmd)) \
330 return CMD_RET_SUCCESS; \
331 \
332 return subcmd->cmd_rep(subcmd, flag, argc - 1, \
333 argv + 1, repeatable); \
334 }
335
336#ifdef CONFIG_AUTO_COMPLETE
337#define U_BOOT_SUBCMDS_COMPLETE(_cmdname) \
338 static int complete_##_cmdname(int argc, char *const argv[], \
339 char last_char, int maxv, \
340 char *cmdv[]) \
341 { \
342 return complete_subcmdv(_cmdname##_subcmds, \
343 ARRAY_SIZE(_cmdname##_subcmds), \
344 argc - 1, argv + 1, last_char, \
345 maxv, cmdv); \
346 }
347#else
348#define U_BOOT_SUBCMDS_COMPLETE(_cmdname)
349#endif
350
351#define U_BOOT_SUBCMDS(_cmdname, ...) \
352 static struct cmd_tbl _cmdname##_subcmds[] = { __VA_ARGS__ }; \
353 U_BOOT_SUBCMDS_RELOC(_cmdname) \
354 U_BOOT_SUBCMDS_DO_CMD(_cmdname) \
355 U_BOOT_SUBCMDS_COMPLETE(_cmdname)
356
357#ifdef CONFIG_CMDLINE
358#define U_BOOT_CMDREP_MKENT_COMPLETE(_name, _maxargs, _cmd_rep, \
359 _usage, _help, _comp) \
360 { #_name, _maxargs, _cmd_rep, cmd_discard_repeatable, \
361 _usage, _CMD_HELP(_help) _CMD_COMPLETE(_comp) }
362
363#define U_BOOT_CMD_MKENT_COMPLETE(_name, _maxargs, _rep, _cmd, \
364 _usage, _help, _comp) \
365 { #_name, _maxargs, \
366 _rep ? cmd_always_repeatable : cmd_never_repeatable, \
367 _cmd, _usage, _CMD_HELP(_help) _CMD_COMPLETE(_comp) }
368
369#define U_BOOT_CMD_COMPLETE(_name, _maxargs, _rep, _cmd, _usage, _help, _comp) \
370 ll_entry_declare(struct cmd_tbl, _name, cmd) = \
371 U_BOOT_CMD_MKENT_COMPLETE(_name, _maxargs, _rep, _cmd, \
372 _usage, _help, _comp);
373
374#define U_BOOT_CMDREP_COMPLETE(_name, _maxargs, _cmd_rep, _usage, \
375 _help, _comp) \
376 ll_entry_declare(struct cmd_tbl, _name, cmd) = \
377 U_BOOT_CMDREP_MKENT_COMPLETE(_name, _maxargs, _cmd_rep, \
378 _usage, _help, _comp)
379
380#else
381#define U_BOOT_SUBCMD_START(name) static struct cmd_tbl name[] = {};
382#define U_BOOT_SUBCMD_END
383
384#define _CMD_REMOVE(_name, _cmd) \
385 int __remove_ ## _name(void) \
386 { \
387 if (0) \
388 _cmd(NULL, 0, 0, NULL); \
389 return 0; \
390 }
391
392#define _CMD_REMOVE_REP(_name, _cmd) \
393 int __remove_ ## _name(void) \
394 { \
395 if (0) \
396 _cmd(NULL, 0, 0, NULL, NULL); \
397 return 0; \
398 }
399
400#define U_BOOT_CMDREP_MKENT_COMPLETE(_name, _maxargs, _cmd_rep, \
401 _usage, _help, _comp) \
402 { #_name, _maxargs, 0 ? _cmd_rep : NULL, NULL, _usage, \
403 _CMD_HELP(_help) _CMD_COMPLETE(_comp) }
404
405#define U_BOOT_CMD_MKENT_COMPLETE(_name, _maxargs, _rep, _cmd, _usage, \
406 _help, _comp) \
407 { #_name, _maxargs, NULL, 0 ? _cmd : NULL, _usage, \
408 _CMD_HELP(_help) _CMD_COMPLETE(_comp) }
409
410#define U_BOOT_CMD_COMPLETE(_name, _maxargs, _rep, _cmd, _usage, _help, \
411 _comp) \
412 _CMD_REMOVE(sub_ ## _name, _cmd)
413
414#define U_BOOT_CMDREP_COMPLETE(_name, _maxargs, _cmd_rep, _usage, \
415 _help, _comp) \
416 _CMD_REMOVE_REP(sub_ ## _name, _cmd_rep)
417
418#endif
419
420#define U_BOOT_CMD(_name, _maxargs, _rep, _cmd, _usage, _help) \
421 U_BOOT_CMD_COMPLETE(_name, _maxargs, _rep, _cmd, _usage, _help, NULL)
422
423#define U_BOOT_CMD_MKENT(_name, _maxargs, _rep, _cmd, _usage, _help) \
424 U_BOOT_CMD_MKENT_COMPLETE(_name, _maxargs, _rep, _cmd, \
425 _usage, _help, NULL)
426
427#define U_BOOT_SUBCMD_MKENT_COMPLETE(_name, _maxargs, _rep, _do_cmd, \
428 _comp) \
429 U_BOOT_CMD_MKENT_COMPLETE(_name, _maxargs, _rep, _do_cmd, \
430 "", "", _comp)
431
432#define U_BOOT_SUBCMD_MKENT(_name, _maxargs, _rep, _do_cmd) \
433 U_BOOT_SUBCMD_MKENT_COMPLETE(_name, _maxargs, _rep, _do_cmd, \
434 NULL)
435
436#define U_BOOT_CMD_WITH_SUBCMDS(_name, _usage, _help, ...) \
437 U_BOOT_SUBCMDS(_name, __VA_ARGS__) \
438 U_BOOT_CMDREP_COMPLETE(_name, CONFIG_SYS_MAXARGS, do_##_name, \
439 _usage, _help, complete_##_name)
440
441#endif
442